Saturation Plus

Saturation Plus - Patch Notes (1.3.0)

This file does not work as intended (but can still be loaded) for Minecraft versions 1.20-1.20.1 due to an issue that has been resolved in mod version 1.3.1.

• 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).

This mod version is for Minecraft 1.20-1.20.4 only. For 1.20.5-1.20.6, use the other designated file available.