Saturation Plus

Saturation Plus - Patch Notes (1.3.0)

- The Saturation status effect has been tweaked to account for mods that apply the effect for long periods of time.
    - Rather than adding 1 saturation each tick, the rate of saturation decreases exponentially (decays) after a player reaches 20.
        - For example, a player receives 0.125/tick at 21 saturation, 0.025/tick at 22 saturation, and so on.
    - This rate of decrease can be tweaked through the saturationEffectDecayRate gamerule.

- Added three customizable game rules:
    - alwaysHungry: Determines whether players can eat any food regardless of hunger level in Survival or Adventure mode.
    - maxExhaustion: Controls the max exhaustion level before hunger or saturation depletion. Set to 0 to disable exhaustion.
    - saturationEffectDecayRate: Controls the decay rate of a player's saturation gain through status effects. Larger numbers means higher decay rate; set to 0 to keep saturation gain as constant.
        - Traditional Minecraft settings: alwaysHungry = false, maxExhaustion = 4, saturationEffectDecayRate = 0.
        - Note that disabling exhaustion means players will never lose hunger or saturation. To prevent infinitely increasing saturation, set a maxSaturation if exhaustion is disabled.

- Saturation and exhaustion stats now appear as visuals beside the hunger meter.
    - Saturation is displayed in yellow text and is updated constantly through server packets.
    - Exhaustion is displayed in gray text as a percentage that is dependent on the world's maxExhaustion game rule.
    - Both displays are disabled if the mod is not detected on the server (this mod must be installed on both client and server).

    - Concerning the AppleSkin mod (used for displaying saturation and exhaustion), the following issues were noted:
        - The saturation display projection when holding food does not take into account the extra saturation gained from overflowed hunger.
        - If maxSaturation is set below 20, the projection mechanic can still display beyond the set limit.
        - If alwaysEat is set to true, the projection does not appear when holding any food that would otherwise be uneatable if alwaysEat was false.
        - The exhaustion display is always relative to the vanilla limit of 4.0, and does not scale for larger or smaller maxExhaustion values
    - AppleSkin can still be used for the food projection mechanic, but the visual stats provided by SaturationPlus may be preferable if both mods are installed.

- Many internal optimizations (mostly concerning how saturation display from commands is formatted).