NightExpress's Plugins Wiki

Allows you to create custom food with custom effects! For vanilla foods and potions it will have the vanilla eat animation.

Overfeed Control:

  • Allow/Disallow consuming on full hunger bar.
  • Allow/Disallow consuming on full health bar.​

Player Requirements:

  • Define the class requirements to consume the item.
  • Define the level requirements to consume the item.​

Item Saturation:

  • Define the amount of health restore on conusme.
  • Define the amount of hunger restore on consume.​​

Portions:

  • Define how many times item can be consumed depends on item level.
  • Or make it unlimited!​

Custom Actions:

  • Define the custom actions on item consume.
  • Execute commads.​
  • Play sounds and particles.​
  • Add potion effects.
  • And a lot more! Check the Actions Guide...

Media:

Settings.yml

Default module settings are described HERE.

command-aliases: consumables,consumes
messages-output: ACTION_BAR

general:
  # Allow/Disallow consuming item on full health bar.
  allow-eat-on-full-health: true
  # Allow/Disallow consuming item on full hunger bar.
  allow-eat-on-full-hunger: true

item-format:
  name: '%item_name%'
  lore:
  - '%item_lore%'

Items

Default module item settings and placeholders are described HERE.

# Default item settings
material: 'PLAYER_HEAD:0:1'
name: '&6Burger on a Plate'
lore:
- '&7Definitely a hearty burger.'
- '&7Portions: &f%uses%&7/&f%uses-max%'
- ''
- '%LEVEL%'
- '%CLASS%'
- ''
- '&f• &7Health: &6+5❤&7.'
- '&f• &7Saturation: &6+5☕&7.'
- '&f• &7Absorption I: &645 sec&7.'
skull-hash: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjZkM2E3ZTA3ZjVkYWRkNDdiYWRiMTM4MmE1YjE2Mjc4MThlZTE2YTE5YTdjMGJmMjc2OGFlNjI2MjczN2I2In19fQ==\'
color: '240,240,20'

# Player requirements
user-requirements:
  level: 10
  classes: 'Warrior,Berserker'

effects:
  # How many health item will restore
  health: 5
  # How many hunger item will restore
  hunger: 5

# Amount of uses
uses-by-level:
 '1': 2

# Min. and max. item level
min-level: 1
max-level: 1

# Custom Actions
# Check the Actions Guide HERE.
usage:
  # Usage key.
  # Allowed values: RIGHT, LEFT, SHIFT_RIGHT, SHIFT_LEFT
  RIGHT:
    # Usage cooldown in seconds.
    cooldown: 10
    actions:
      target-selectors:
        self:
        - '[SELF]'
      action-executors:
      - '[POTION] ~name: ABSORPTION; ~amount: 1; ~duration: 900; ~target: self;'
      - '[PARTICLE_SIMPLE] ~name: ITEM_CRACK:BREAD; ~offset: 0.1,0.1,0.1; ~speed: 0.1; ~amount: 40; ~target: self;'
      - '[SOUND] ~name: ENTITY_GENERIC_EAT; ~target: self;'
Navigation