Booster Configuration

Booster System

The booster system allows you to create temporary or permanent multipliers for various actions like gaining money, souls, damage, or even specific enchant effects. Boosters can be items that players consume or "virtual" boosters provided by other modules (like Masks).

---

Overview

The booster system is divided into global settings and individual booster items:

/plugins/PhantomDungeons/boosters/
  ├─ items/
  │  ├─ money-booster-1.yml
  │  ├─ damage-booster-1.yml
  │  └─ (your custom boosters)
  ├─ commands.yml
  ├─ messages.yml
  └─ settings.yml

---

Quick Start

1

Create a Booster Item

Create a new .yml file in the items/ folder. You can copy an existing one as a template.

2

Configure Multiplier & Duration

Set how much the boost is (e.g., 0.25 for +25%) and how long it lasts in seconds.

3

Design the Item

Customize the display name, lore, and material (supports Player Heads with Base64).

4

Reload the Plugin

Use /pd reload to apply your changes and make the new booster available.

---

Upgrading an Existing Permanent Booster

If you gave a player a permanent booster with a known created ID, you can later upgrade that exact booster instead of granting a brand new one.

Example command:

/boosters upgradeperm <player> <booster_id> <increase_by>

Example:

/boosters upgradeperm Ben rebirth-money 0.10

That adds 0.10 to the existing multiplier, so a 1.25x permanent booster becomes 1.35x.

This is useful for rebirth upgrades, milestone rewards, or menu buttons that target a stored permanent booster ID.

Stacking Modes

You can define how multiple boosters of the same type interact.

Official Modes

• EXTEND: Reapplying adds duration to the existing temporary booster. The defaults for this mode can be overriden, allow you to set a duration time cap.

• DENY: Cannot apply if the same temporary booster type is already active.

Beta Modes

As it says above, these modes are in their BETA stage, and they may be removed in future versions or pushed to our official modes. These modes haven't been heavily tested, so there may be bugs or unwanted behavior.

• REPLACE

• STACK_ADDITIVE

• STACK_MULTIPLICATIVE

Limits & Overrides

You can set default limits for all boosters or override them per type:

settings.yml

default-limits:
  max-stack-count: 1
  max-multiplier: 5.0
  max-duration: 86400 # 24 hours

booster-type-overrides:
  money:
    stacking-mode: EXTEND
    max-stack-count: 5