PlaceholderAPI

CrateForge integrates with PlaceholderAPI to expose player data for use in scoreboards, chat, GUIs, and other plugins.

Requirements

Dependency	Version
PlaceholderAPI	2.11+

Note: PAPI is optional. CrateForge works without it — placeholders are simply unavailable.

Placeholder	Returns	Example Value
`%crateforge_opens%`	Total number of crates opened by this player (all crates combined)	`142`
`%crateforge_tokens_<type>%`	Token balance of the specified type for this player	`500`

Returns the total count of all crate opens this player has ever performed across all crate types.

# Example scoreboard line
Total Opens: %crateforge_opens%

Example values: - 0 — Player has never opened a crate - 50 — Player has opened 50 crates total - 142 — Player has opened 142 crates total

Returns the player's balance for the specified token type. Replace <type> with your token type ID.

# Check premium tokens
%crateforge_tokens_premium%

# Check vote tokens
%crateforge_tokens_vote%

# Check event tokens
%crateforge_tokens_event%

Example values: - 0 — No tokens of this type - 500 — Player has 500 premium tokens

# Test placeholders in-game
/papi parse me %crateforge_opens%
/papi parse me %crateforge_tokens_premium%

lines:
  - "&6Crate Opens: &e%crateforge_opens%"
  - "&bTokens: &f%crateforge_tokens_premium%"

[Opens: %crateforge_opens%] {player}: {message}

{papi: %crateforge_opens%} total opens

# Show a "VIP" tag if player has 100+ opens
condition: "%crateforge_opens% >= 100"

# Configure a leaderboard for %crateforge_opens%
# using plugins like LeaderHeads or HolographicLeaderboards