Menu Conditions

Conditions allow you to control item visibility and clickability based on requirements.

Condition Types

Condition Type	Purpose
view-requirement	Controls whether the item is visible in the menu
click-requirement	Controls whether the item is clickable when visible

View Requirements

Determines if an item should be displayed at all.

Basic Example

menu-items:
  'tier-5-sword':
    slot: '14'
    material: 'NETHERITE_SWORD'
    name: '&5&lTier 5 Sword'
    
    # Only visible if player has tier 4 or higher
    view-requirement: '%phantomdungeons_sword_tier% >= 4'

Multiple Conditions

If view-requirement evaluates to false, the item slot will be empty in the menu.

Click Requirements

Determines if a visible item can be clicked.

Basic Example

menu-items:
  'upgrade-button':
    slot: '22'
    material: 'EMERALD'
    name: '&a&lUpgrade Sword'
    lore:
      - '&7Cost: &f10,000 coins'
    
    # Only clickable if player has enough money
    click-requirement: '%vault_eco_balance% >= 10000'
    
    any-click-actions:
      - '[buy-sword-tier] wooden-sword 2'

With Feedback

If click-requirement is false, clicking the item will have no effect (no actions execute).

Operators

Use these operators in your conditions:

Operator	Description	Example
>=	Greater than or equal	%balance% >= 1000
<=	Less than or equal	%level% <= 10
>	Greater than	%tier% > 3
<	Less than	%page% < 5
=	Equal to	%status% = active
!=	Not equal to	%type% != beginner

Logical Operators

Combine multiple conditions using logical operators:

AND Conditions

Both conditions must be true.

Syntax

click-requirement: 'condition1 AND condition2'

Example

OR Conditions

At least one condition must be true.

Syntax

view-requirement: 'condition1 OR condition2'

Example

Complex Conditions

You can combine AND/OR for complex logic:

menu-items:
  'advanced-item':
    slot: '25'
    material: 'NETHER_STAR'
    name: '&5&lAdvanced Item'
    
    # Show if: (VIP OR level 100+) AND (balance >= 50k)
    view-requirement: '(%permission_phantom.vip% = true OR %player_level% >= 100) AND %vault_eco_balance% >= 50000'
    
    # Click if: correct tier AND enough money
    click-requirement: '%phantomdungeons_sword_tier% = 4 AND %vault_eco_balance% >= 50000'

Conditional Lore

Display different lore lines based on conditions using if(condition) then text syntax:

Simple If

lore:
  - '&7Price: &f10,000'
  - 'if(%vault_eco_balance% >= 10000) then &a✓ You can afford this!'
  - 'if(%vault_eco_balance% < 10000) then &c✗ Not enough money!'

Multiple Conditions

Status Display

Tip: Use conditional lore to provide clear feedback on why an item is locked or unavailable!

Number Formatting

The condition system supports abbreviated numbers for readability:

Suffix	Name	Value
k	Thousand	1,000
M	Million	1,000,000
B	Billion	1,000,000,000
T	Trillion	1,000,000,000,000
Qa	Quadrillion	1e15
Qi	Quintillion	1e18
Sx	Sextillion	1e21
Sp	Septillion	1e24
Dc	Decillion	1e33

Examples:

click-requirement: '%balance% >= 1.5M'  # 1,500,000
view-requirement: '%souls% >= 2.5B'     # 2,500,000,000
click-requirement: '%damage% >= 100k'   # 100,000

Common Patterns

Progressive Unlocks

# Tier 1 - Always visible
'tier-1':
  view-requirement: 'true'
  click-requirement: '%phantomdungeons_sword_tier% = 0'

# Tier 2 - Show after tier 1
'tier-2':
  view-requirement: '%phantomdungeons_sword_tier% >= 1'
  click-requirement: '%phantomdungeons_sword_tier% = 1'

# Tier 3 - Show after tier 2
'tier-3':
  view-requirement: '%phantomdungeons_sword_tier% >= 2'
  click-requirement: '%phantomdungeons_sword_tier% = 2'

Currency Gates

'premium-item':
  # Show if they can afford it OR already own it
  view-requirement: '%vault_eco_balance% >= 10000 OR %permission_phantom.premium% = true'
  
  # Can only buy if they don't own it and have money
  click-requirement: '%vault_eco_balance% >= 10000 AND %permission_phantom.premium% = false'

Permission Tiers

'vip-section':
  # Show to VIP or higher
  view-requirement: '%permission_phantom.vip% = true OR %permission_phantom.mvp% = true'
  
'mvp-section':
  # Only show to MVP
  view-requirement: '%permission_phantom.mvp% = true'

Time-Based

'daily-reward':
  # Only show if cooldown expired
  view-requirement: '%phantomdungeons_daily_cooldown% <= 0'
  
  # Can click once per day
  click-requirement: '%phantomdungeons_daily_cooldown% <= 0'

Troubleshooting

Condition Always False - Problem: Item never appears

Solutions:

• Check placeholder is returning expected value

• Verify operator is correct (>= vs >)

• Test placeholder with /papi parse me %placeholder%

Condition Always True - Problem: Item always clickable when shouldn't be

Solutions:

• Check for typos in condition string

• Ensure proper use of AND/OR

• Verify placeholder exists and isn't null

Conditional Lore Not Showing — Problem: `if()` statement appears as literal text

Solutions:

• Check syntax: if(condition) then text

• Ensure no extra spaces

• Verify condition is valid

Quick Reference

Usage	Example
View requirement	view-requirement: '%tier% >= 3'
Click requirement	click-requirement: '%balance% >= 1000'
AND condition	'%a% = 1 AND %b% = 2'
OR condition	'%a% = 1 OR %b% = 2'
Complex condition	'(%a% = 1 OR %b% = 2) AND %c% > 0'
Conditional lore	if(%tier% >= 5) then &aMax tier!
Abbreviated number	%balance% >= 1.5M