Hunger Effects - Barebones Framework

What it is

[[Designed for as a barebones framework for modders to flesh out!]]

A small code mod: it does not replace the game. It reads the vanilla food/satiety bar (the same hunger / currentsaturation / maxsaturation the base game uses), maps that to one kind of server consequence here (walkspeed on a named stat layer), and shows a teach panel on the Character (C) screen in the same style as HealthEffects (not a separate keybind). This allows you to bind a stat to the hunger bar. The vision is: the more full you are you get buffs. The less full you are, you get debuffs. 

Purpose

Intent is the link between how full the hunger bar is and how the character is allowed to move—not the specific numbers, which are loud, testable placeholders. The “vision” is a reusable bridge: one fullness read, one place for your policy (curves + steps), one server application point, one layer so other mods and yours don’t trample each other, and an optional client block that matches the server for honesty.

How it works (in the doc)

• Fullness = clamped current / max satiety.
• Policy: “smooth” buff above 50% (one linear formula in code), step debuff below 50% (by integer % bands), 0 at 50%.
• Server tick: Entity.Stats walkspeed on layer hungereffects (or clear if no hunger data).
• Client attaches a composer when the character dialog is open, refreshes text, stacks under the HealthEffects panel if that mod is there.

Flavor

Flavor is your story on top of the belly: feels like fed enough you move well, hungry enough to slog;

License / use
Free to use, copy, modify, and redistribute this mod and derived works for any purpose (including commercial packs), provided you credit the original author (Squidbat) in your readme, ModDB page, or in-repo credits so others can find the upstream author for questions, debugging, or merge requests. Provide link to my profile. Same caveat as above regarding formal licenses if you need one.

Github Link: https://github.com/19HarryHaller27/-Hunger-Effects