Skip to main content

BetterFood Behavior

BetterFood now uses hunger-aware food selection instead of simply eating the most nutritious item first.

Selection Rules​

When the plugin needs to restore hunger, it prefers food that:

  1. fits the missing hunger exactly, or stays under it
  2. uses saturation as a tiebreaker
  3. falls back to the smallest overflow if nothing fits cleanly

That means the current plugin is trying to avoid wasting strong food where possible.

Protected Items​

The current code protects much more than just renamed or lore-bearing food. BetterFood will avoid auto-consuming food if it has custom-item characteristics such as:

  • custom name or item name
  • lore
  • custom model data
  • enchantments
  • attribute modifiers
  • unbreakable state
  • persistent data container tags

This is intended to reduce the chance of consuming plugin items or decorative items by mistake.

Container Remainders​

If a consumed food leaves a remainder item, BetterFood preserves it.

Examples include bowls or other container-returning foods. The remainder is returned to inventory or dropped at the player if inventory space is unavailable.