Commands

Complete reference for all available commands.

Player Commands

/ksachievements

Opens the Achievement Gallery UI.

/ksachievements
/achievement     # Alias
/ac              # Alias

Permission: None (available to all players)

Features:

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

/kstitles

Opens the Title Selection UI.

/kstitles
/title           # Alias

Permission: None (available to all players)

Features:

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

/ksrewards

Opens the Rewards Inventory to collect pending rewards.

/ksrewards
/reward          # Alias
/rw              # Alias

Permission: None (available to all players)

Notes:

Only available when you have pending rewards
Rewards are granted when achievements are unlocked
Use this command to claim items that couldn’t be given directly

/kslootbags

Opens the Lootbag Inventory to open pending lootbags.

/kslootbags
/lootbag         # Alias
/lb              # Alias

Permission: None (available to all players)

Notes:

Only available when you have pending lootbags
Lootbags are granted as achievement rewards
Open lootbags to receive random items from weighted pools

/kslang

Set your preferred language for all KyuubiSoft plugins (Achievements, Info Hub, etc.).

/kslang <language>

Permission: None (available to all players)

Supported Languages:

Code	Language
`en-US`	English
`de-DE`	German
`fr-FR`	French
`es-ES`	Spanish
`pt-BR`	Portuguese (Brazil)
`it-IT`	Italian
`pl-PL`	Polish
`ru-RU`	Russian
`ja-JP`	Japanese

Notes:

Setting is saved per player and persists across sessions
Overrides the server’s default language setting from config.json
Affects all KyuubiSoft plugins that support per-player language
This command is provided by the KyuubiSoft Core plugin

Admin Commands

/ksachievementadmin

Base command for all admin operations.

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

Permission: achievements.admin

panel

Opens the Achievement Admin Panel UI for live configuration editing.

/ksachievementadmin panel

Permission: achievements.admin (player only)

Features:

Edit config.json settings live
View and manage achievements
Save changes without server restart

list

List all unlocked achievements for a player.

/ksachievementadmin list <player>

Arguments:

Argument	Type	Description
`player`	string	Target player name

Example:

/ksachievementadmin 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.

/ksachievementadmin grant <player> <achievement>

Arguments:

Argument	Type	Description
`player`	string	Target player name
`achievement`	string	Achievement ID to grant

Example:

/ksachievementadmin 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.

/ksachievementadmin revoke <player> <achievement>

Arguments:

Argument	Type	Description
`player`	string	Target player name
`achievement`	string	Achievement ID to revoke

Example:

/ksachievementadmin 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

:::warning 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.

/ksachievementadmin 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
/ksachievementadmin simulate blocks_mined 100

# Simulate 10 mob kills
/ksachievementadmin simulate kills 10

# Simulate 1 player kill
/ksachievementadmin 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 (grant, revoke, list, simulate)	OP

Command Examples

Testing a New Achievement Chain

# Check current progress
/ksachievementadmin list TestPlayer

# Grant first achievement
/ksachievementadmin grant TestPlayer my_chain_1

# Simulate progress for second
/ksachievementadmin simulate blocks_mined 500

# Verify unlock
/ksachievementadmin list TestPlayer

Event Management

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

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

Debugging

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

# Simulate the trigger to test
/ksachievementadmin simulate kills 1

# Manually grant if bugged
/ksachievementadmin 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