Consumables

Consumables

Consumables are food, potions, and other items consumed on use. They can restore health, hunger, saturation, apply effects, and use charges.

Files

• Settings: modules/consumables/settings.yml

• Items: burger.yml, small_health_potion.yml, small_loot_potion.yml in items/

• Bundled resources on GitHub

Commands and permissions

Alias: consumables, consumes. Shared list, get, give, drop, and reload commands require divinity.admin.

Configuration and example

consuming.allow-on-full-health and allow-on-full-food decide whether a player can consume at full values.

Administrator notes

• Decide whether consumption at full health or food should spend a charge; test both settings before players receive valuable items.
• Validate potion names, durations, class requirements, and level ranges against the installed server version and class provider.
• Balance healing, saturation, effects, cooldowns, and charges together to prevent combat or economy exploits.
• Test main hand, off-hand, stacked items, the final charge, cancelled consumption, death, and reconnect.

items/burger.yml — bundled food item

material: PLAYER_HEAD
name: '&6Burger on a Plate'
tier: common
level:
  min: 1
  max: 3
effects:
  health: 5
  hunger: 5
  saturation: 3
user-requirements-by-level:
  level:
    '1': 10
  class:
    '1': Warrior,Berserker
uses-by-level:
  '1': 1
  '2': 2
  '3': 3

See Modules and Commands and Permissions.