Skip to main content

BetterFood Compatibility

Runtime Targets

The current repo targets:

  • Plugin version: 1.4.0
  • Bukkit api-version: 1.21.4
  • Spigot API build target: 1.21.4-R0.1-SNAPSHOT
  • Java: 21

Commands

The plugin uses:

  • /betterfood
  • /bf

Player-facing subcommands focus on toggling:

  • automatic eating (toggleEating, or just /betterfood with no arguments)
  • consumption feedback messages on the action bar (toggleMessage)

Admin subcommands (require betterfood.admin) expose the shared Nightbreak tooling:

  • setup — opens the in-game setup menu
  • recommendedplugins — shows plugins that pair well with BetterFood
  • downloadpluginupdate / downloadall — downloads a plugin update if one is available
  • downloadallcontent — reports that BetterFood has no content packs

Tab completion suggests toggleEating, toggleMessage, downloadpluginupdate, downloadall, downloadallcontent, setup, and recommendedplugins. The two player toggles are player-only — the explicit toggleEating / toggleMessage subcommands refuse non-player senders with "BetterFood settings can only be changed in-game.", while the bare /betterfood command points console senders to the update command instead.

Permissions

  • betterfood.user (default true) — gates the auto-eat listener and the player toggles.
  • betterfood.admin (default op) — gates the plugin update download, setup menu, and recommended-plugins commands.

Other Integrations

  • bStats metrics are enabled (plugin id 4557) — disable globally via the bStats configuration if you want to opt out.
  • BetterFood now ships the shared MagmaCore tooling. On boot it checks nightbreak.io for a newer release and generates a config.yml with the nightbreak.autoDownloadPluginUpdates toggle (default false). BetterFood passes no SpigotMC resource ID, so there is no SpigotMC version fallback.
  • No external plugin dependencies; the food logic listens only to vanilla FoodLevelChangeEvent.