Booster Items

Boosters

A booster item is a consumable item that players can right-click to activate a multiplier for a specific duration. These are configured in boosters/items/*.yml.

Basic Structure

Every booster file follows this structure:

money-booster-1.yml

# Display name with color codes
display-name: '&2&l[&a&l!&2&l] &aMoney Booster'

# Item lore (supports color codes and placeholders)
lore:
  - " "
  - '&7Increases the amount of money'
  - '&7you gain from various sources.'
  - " "
  - "&aInformation:"
  - '&2 → &aMultiplier: &f+25%'
  - '&2 → &aDuration: &f10 minute(s)'
  - ''
  - '&7&o(( Right-Click to consume this &f&obooster &7&o))'

# Material type
material: PLAYER_HEAD

# Base64 texture for player heads (optional)
base-64: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMWI3YTFjNWRhMWQzNjJmYTM1N2RiOTg4OWZhNmEwNmE2MDMyZTI0NTA4NDgxZGFjYTkxNGU3NjI2NjBiOTQ4In19fQ=='

# ItemsAdder namespace (optional)
itemsadder-namespace: 'namespace:item_id'

# Custom model data (optional)
custom-model-data: 1001

# Item flags
item-flags:
  - HIDE_ATTRIBUTES
  - HIDE_POTION_EFFECTS

# Multiplier: The boost amount (0.25 = +25%, 1.0 = +100%, etc.)
multiplier: 0.25

# Duration: How long the booster lasts (in seconds)
# 600 = 10 minutes
duration: 600

# Currency boosters use the economy field
economy: "money"

Available Properties

Multiplier

The multiplier value defines the bonus percentage. For example:

• 0.25 is a 25% boost.

• 1.0 is a 100% (2.0x) boost.

• 0.5 is a 50% (1.5x) boost.

Duration

Duration is defined in seconds.

• 600 = 10 minutes

• 3600 = 1 hour

• 86400 = 24 hours

Booster Target

Every booster needs a target. The target decides what the booster affects when used.

There are four main target styles:

1. Economy booster

Use economy for currency-style boosters.

economy: "money"

Examples:

• money

• souls

• any other economy ID from your economies folder

2. Enchant booster

Use enchant to boost a specific enchant's proc-related behaviour.

enchant: "your-enchant-id"

This creates a booster for that specific enchant rather than for a currency.

3. Damage booster

Use damage: true for boosters that increase player damage.

damage: true

4. Attack-speed booster

Use attack-speed: true for boosters that increase attack speed.

attack-speed: true

Choose One Target Type

Each booster item should only use one target type.

For example, do not combine economy with damage: true in the same booster file.

Example Target Configurations

Currency booster

multiplier: 0.25
duration: 600
economy: "money"

Souls booster

multiplier: 0.55
duration: 1800
economy: "souls"

Damage booster

multiplier: 0.50
duration: 600
damage: true

Attack-speed booster

multiplier: 0.50
duration: 600
attack-speed: true

Look and Feel

• material: Any valid Bukkit Material (e.g., POTION, PAPER, DIAMOND).

• base-64: A Base64 skin texture for PLAYER_HEAD.

• custom-model-data: Used for server resource packs.

• itemsadder-namespace: Integration with ItemsAdder items.

• potion-color: Set color for POTION or TIPPED_ARROW materials.