Mob Rewards

The mob-rewards section defines what players receive when they kill a mob.

---

Structure

Basic reward structure

mob-rewards:
  1:
    reward-type: currency
    reward-currency: money
    reward-amount: 100
    hologram:
      enabled: true
      lines:
        - '&e+%phantomdungeons_math_format_{amount}% &6Money'
  
  2:
    reward-type: command
    command: 'crate givekey {player} common 1'
    requirement: '%phantomdungeons_random_0_100% < 25'

---

Reward Types

Currency Rewards

Give players in-game currency when they kill the mob.

Currency reward

mob-rewards:
  1:
    reward-type: currency
    reward-currency: money
    reward-amount: 100

Properties:

Property	Description	Example
reward-type	Must be currency	currency
reward-currency	The currency ID from economies	money, souls, essence
reward-amount	Amount to give (supports math expressions)	100, 100*%player_level%

Dynamic Amounts

Use math expressions and placeholders:

Fixed Amount

reward-amount: 100

Scaled by Level

Random Range

Complex Formula

---

Command Rewards

Execute a command when the mob is killed.

Command reward

mob-rewards:
  1:
    reward-type: command
    command: 'give {player} diamond 5'

Properties:

Property	Description	Example
reward-type	Must be command	command
command	Command to execute (without /)	give {player} diamond 5

Available Placeholders:

• {player} - Player's username

• {amount} - Reward amount (if applicable)

• Any PlaceholderAPI placeholder

Examples

Give Item

command: 'give {player} diamond 5'

Crate Key

Permission

Multiple Commands

---

Reward Requirements

Add conditional requirements to rewards using the requirement field.

Conditional reward

mob-rewards:
  1:
    reward-type: currency
    reward-currency: money
    reward-amount: 100
    requirement: '%player_level% >= 10'
  
  2:
    reward-type: command
    command: 'crate givekey {player} rare 1'
    requirement: '%phantomdungeons_random_0_100% < 25'

Requirement Syntax

Use condition operators:

Operator	Description	Example
>=	Greater than or equal	%player_level% >= 10
<=	Less than or equal	%player_level% <= 50
>	Greater than	%vault_eco_balance% > 1000
<	Less than	%phantomdungeons_random_0_100% < 25
=	Equal to	%player_world% = world
!=	Not equal to	%player_gamemode% != CREATIVE

Common Patterns

Level Requirement

requirement: '%player_level% >= 20'

Only give reward if player is level 20 or higher.

Drop Chance

Permission Check

Multiple Conditions

---

Holograms

Display floating text above the mob when it dies showing the reward.

Hologram configuration

mob-rewards:
  1:
    reward-type: currency
    reward-currency: money
    reward-amount: 100
    hologram:
      enabled: true
      lines:
        - '&e+%phantomdungeons_math_format_{amount}% &6Money'

Properties

Property	Description
enabled	Enable or disable the hologram
lines	List of text lines to display

Hologram Variables

Special variables available in hologram lines:

Variable	Description	Example
{amount}	The reward amount	100
{player}	Player's username	Notch

Note: Use %phantomdungeons_math_format_{amount}% to format large numbers with suffixes (K, M, B, etc.)

Examples

Currency Hologram

hologram:
  enabled: true
  lines:
    - '&e+%phantomdungeons_math_format_{amount}% &6Money'

Multi-Line

Command Reward

No Hologram

---

Troubleshooting

Common Issues

No Rewards Given

Problem: Player doesn't receive rewards when killing mob

Solutions:

• Check reward-type is valid (currency or command)

• Verify reward-currency exists in your economy

• Ensure requirements are met

Hologram Not Showing

Problem: Hologram doesn't appear

Solutions:

• Check enabled: true

• Verify lines is not empty

• Ensure placeholder syntax is correct

# WRONG
hologram:
  enabled: true
  lines: []  # Empty!

# CORRECT
hologram:
  enabled: true
  lines:
    - '&e+{amount} Money'

Requirements Not Working

Problem: Conditional rewards always/never trigger

Solutions:

• Test placeholder values with /papi parse me %placeholder%

• Check operator syntax (<, >, =, etc.)

• Verify PlaceholderAPI expansions are installed

---