Saturation Plus

Added compatibility with NeoForge for Minecraft 26.1-26.1.2

Includes mod implementations up to v1.3:

Commands:

• /getSaturation - shows current saturation level.
• /addSaturation - adds (or subtracts, using negative input) saturation.
• /setSaturation - directly changes saturation to a fixed amount.

Gamerules:

• hungerLimitsSaturation: Controls whether hunger affects saturation. If true, limit the player's saturation level to never exceed the current hunger level.
  • Set to false to allow saturation levels above 20.
• maxSaturation: Controls the max saturation limit for players. Set to -1 or lower to disable this limit.
  • Can set below the food limit (between 0 and 20), with 0 disabling the saturation mechanic entirely.
• 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.
  • Note that disabling exhaustion means players will never lose hunger or saturation. To prevent infinitely increasing saturation, set a maxSaturation if exhaustion is disabled.
• 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: hungerLimitsSaturation = true, maxSaturation = 20, alwaysHungry = false, maxExhaustion = 4, saturationEffectDecayRate = 0.

Hunger stat visuals:

• Saturation is displayed in yellow text beside the hunger bar and is updated constantly through server packets.
• Exhaustion is displayed in gray text under saturation as a percentage value based on the world's maxExhaustion game rule.
• This mod must be installed on both client and server, otherwise it will not run correctly and all hunger stat visuals will be disabled.

Added compatibility with Fabric for Minecraft 26.1-26.1.2

Includes mod implementations up to v1.3:

Commands:

• /getSaturation - shows current saturation level.
• /addSaturation - adds (or subtracts, using negative input) saturation.
• /setSaturation - directly changes saturation to a fixed amount.

Gamerules:

• hungerLimitsSaturation: Controls whether hunger affects saturation. If true, limit the player's saturation level to never exceed the current hunger level.
  • Set to false to allow saturation levels above 20.
• maxSaturation: Controls the max saturation limit for players. Set to -1 or lower to disable this limit.
  • Can set below the food limit (between 0 and 20), with 0 disabling the saturation mechanic entirely.
• 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.
  • Note that disabling exhaustion means players will never lose hunger or saturation. To prevent infinitely increasing saturation, set a maxSaturation if exhaustion is disabled.
• 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: hungerLimitsSaturation = true, maxSaturation = 20, alwaysHungry = false, maxExhaustion = 4, saturationEffectDecayRate = 0.

Hunger stat visuals:

• Saturation is displayed in yellow text beside the hunger bar and is updated constantly through server packets.
• Exhaustion is displayed in gray text under saturation as a percentage value based on the world's maxExhaustion game rule.
• This mod must be installed on both client and server, otherwise it will not run correctly and all hunger stat visuals will be disabled.

This update implements the remaining features of Fabric 1.3 for Minecraft NeoForge 1.21.11.

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.

This update implements the remaining features of Fabric 1.3 for Minecraft NeoForge 1.20.2-1.20.4.

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.

This update implements the remaining features of Fabric 1.3 for Minecraft NeoForge 1.21-1.21.1.

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.

This update implements the remaining features of Fabric 1.3 for Minecraft NeoForge 1.20.5-1.20.6.

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.

This update implements the remaining features of Fabric 1.3 for Minecraft NeoForge 1.20.2-1.20.4.

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.

This update implements the remaining features of Fabric 1.3 for Minecraft Forge 1.21.11.

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.