Commands

Complete reference for all available commands.

Player Commands

/achievements

Opens the Achievement Gallery UI.

/achievements
/ac              # Alias
/achievement     # Alias

Permission: None (available to all players)

Features:

• Browse all achievements
• Filter by category
• Search by name
• View progress
• See requirements and rewards

/titles

Opens the Title Selection UI.

/titles
/title           # Alias

Permission: None (available to all players)

Features:

• View unlocked titles
• Select active title
• Clear current title
• See title source (which achievement)

Admin Commands

/achievementadmin

Base command for all admin operations.

/achievementadmin <subcommand> [args]
/acadmin <subcommand> [args]    # Alias

Permission: achievements.admin

list

List all unlocked achievements for a player.

/achievementadmin list <player>

Arguments:

Argument	Type	Description
player	string	Target player name

Example:

/achievementadmin list Steve

Output:

Steve's Achievements (47/487):
- first_blood (Combat)
- spider_hunter_1 (Combat)
- miner_1 (Progression)
...

grant

Grant an achievement to a player.

/achievementadmin grant <player> <achievement_id>

Arguments:

Argument	Type	Description
player	string	Target player name
achievement_id	string	Achievement ID to grant

Example:

/achievementadmin grant Steve spider_hunter_5

Notes:

• Bypasses prerequisites (configurable in admin.bypassPrerequisites)
• Grants rewards immediately
• Player receives notification
• Updates title availability

revoke

Revoke an achievement from a player.

/achievementadmin revoke <player> <achievement_id>

Arguments:

Argument	Type	Description
player	string	Target player name
achievement_id	string	Achievement ID to revoke

Example:

/achievementadmin revoke Steve spider_hunter_5

Notes:

• Can cascade revoke dependent achievements (configurable)
• Shows warning before cascade revoke
• Does NOT remove granted rewards
• Removes title if it was from this achievement

Cascade Revoke

If admin.cascadeRevoke is enabled, revoking spider_hunter_3 will also revoke spider_hunter_4 and spider_hunter_5 (achievements that require it).

simulate

Simulate trigger events for testing.

/achievementadmin simulate <type> [count]

Arguments:

Argument	Type	Default	Description
type	string	-	Trigger type to simulate
count	number	1	Number of events

Available Types:

• blocks_mined
• blocks_placed
• kills
• player_kills
• chat_messages

Examples:

# Simulate mining 100 blocks
/achievementadmin simulate blocks_mined 100

# Simulate 10 mob kills
/achievementadmin simulate kills 10

# Simulate 1 player kill
/achievementadmin simulate player_kills

Use Cases:

• Testing achievement thresholds
• Debugging trigger issues
• Quick progression for testing

Permissions

Permission	Description	Default
achievements.admin	Access to all admin commands	OP
achievements.admin.grant	Grant achievements	OP
achievements.admin.revoke	Revoke achievements	OP
achievements.admin.list	List player achievements	OP
achievements.admin.simulate	Simulate trigger events	OP

Command Examples

Testing a New Achievement Chain

# Check current progress
/achievementadmin list TestPlayer

# Grant first achievement
/achievementadmin grant TestPlayer my_chain_1

# Simulate progress for second
/achievementadmin simulate blocks_mined 500

# Verify unlock
/achievementadmin list TestPlayer

Event Management

# Grant event achievement to winners
/achievementadmin grant Winner1 summer_event_champion
/achievementadmin grant Winner2 summer_event_champion
/achievementadmin grant Winner3 summer_event_champion

# Revoke if needed (e.g., rule violation)
/achievementadmin revoke Cheater summer_event_champion

Debugging

# Player claims achievement didn't unlock
# Check their current achievements
/achievementadmin list PlayerName

# Simulate the trigger to test
/achievementadmin simulate kills 1

# Manually grant if bugged
/achievementadmin grant PlayerName first_blood

Tab Completion

All commands support tab completion:

• Player names from online players
• Achievement IDs from loaded achievements
• Trigger types for simulate command

Error Messages

Error	Cause	Solution
Player not found	Player offline or typo	Check spelling, player must be online
Achievement not found	Invalid achievement ID	Check ID in achievements.json
Already unlocked	Player has achievement	No action needed
Not unlocked	Cannot revoke what isn't owned	Check with list first
Prerequisites not met	Grant without bypass	Enable bypassPrerequisites or grant prerequisites first