Skip to content

Commands.md

Jump to bottom
Fragmer2 edited this page Feb 3, 2026 · 4 revisions

Commands Reference

Player Commands

/nextchest

Description: Check time until next chest spawn
Permission: None (available to all players)
Usage:

/nextchest

Output:

 Next chest will spawn in 5 minutes and 23 seconds

/mystats

Description: View your personal statistics
Permission: None
Usage:

/mystats

Output:

━━━━━━━ Your Statistics ━━━━━━━
 Chests Opened: 47
  ├─ Common: 25
  ├─ Rare: 18
  └─ Legendary: 4
 Legendary Items Found: 3
 Guardians Killed: 12
 Summoner Apples Used: 2
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

/leaderboard

Description: View top 10 players by chests opened
Permission: None
Aliases: /chesttop, /chesttop10
Usage:

/leaderboard

Output:

 Top 10 Chest Hunters 
1. Player1 - 156 chests
2. Player2 - 142 chests
3. Player3 - 98 chests
...

/cooldowns

Description: Check cooldowns for legendary items
Permission: None
Usage:

/cooldowns

Output:

━━━━━━━ Item Cooldowns ━━━━━━━
 Dragon Slayer Sword: Ready
 Master Pickaxe: 12s left
 Titan Axe (Combat): Ready
 Titan Axe (Tree): 4s left
 Guardian Bow: Ready
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Admin Commands

/chestnow

Description: Spawn a chest immediately
Permission: spawnchest.admin
Aliases: /spawnchestnow
Usage:

/chestnow

Notes:

  • Resets the spawn timer
  • Clears countdown warnings
  • Useful for testing or events

/setchesttimer <seconds>

Description: Change spawn interval
Permission: spawnchest.setchesttimer
Usage:

/setchesttimer 300    # 5 minutes
/setchesttimer 1800   # 30 minutes
/setchesttimer 60     # 1 minute

/resettimer

Description: Reset timer so chest spawns in 10 seconds
Permission: spawnchest.resettimer
Usage:

/resettimer

/putintothechest

Description: Open custom loot GUI editor
Permission: spawnchest.admin
Usage:

/putintothechest

Opens: Custom Loot Main Menu with all tiers

/giveapple <player> [amount]

Description: Give Summoner Apple to player
Permission: spawnchest.giveapple
Usage:

/giveapple Steve          # Give 1 apple
/giveapple Steve 5        # Give 5 apples
/giveapple @a 1           # Give to all players

/getlegendaryitems

Description: Get all legendary items
Permission: spawnchest.getlegendaryitems
Usage:

/getlegendaryitems

Gives:

  • Dragon Slayer Sword
  • Master Pickaxe
  • Titan Axe
  • Void Shovel
  • Storm Hammer
  • Guardian Bow
  • Wisdom Book
  • Phoenix Feather
  • Poseidon's Trident
  • Summoner Apple
  • 64 Arrows

/chestconfig <action> [args]

Description: Manage plugin configuration
Permission: spawnchest.config
Subcommands:

Get Value

/chestconfig get <path>

Example:

/chestconfig get settings.spawn-interval-seconds
→ Value: 600

Set Value

/chestconfig set <path> <value>

Examples:

/chestconfig set settings.spawn-interval-seconds 1200
/chestconfig set features.guardians.enabled true
/chestconfig set legendary-items.dragon-slayer-sword.bonus-damage 6.0

Toggle Boolean

/chestconfig toggle <path>

Examples:

/chestconfig toggle features.effects.particles
/chestconfig toggle legendary-items.enabled

List Settings

/chestconfig list <section>

Sections: features, legendary-items, loot, abilities, statistics

Examples:

/chestconfig list features
/chestconfig list legendary-items

Reload Config

/chestconfig reload

/togglelegendary [item]

Description: Toggle legendary items on/off
Permission: spawnchest.config
Usage:

/togglelegendary                    # Toggle all legendary items
/togglelegendary dragon-slayer-sword
/togglelegendary master-pickaxe
/togglelegendary titan-axe

/togglefeature <feature>

Description: Toggle specific features
Permission: spawnchest.config
Features:

  • guardians - Mob guardians
  • particles - Particle effects
  • sounds - Sound effects
  • lightning - Lightning on legendary
  • announcements - Broadcast messages
  • titles - Title notifications
  • pvp-protection - Legendary item PvP protection
  • cooldown-messages - Show cooldown messages
  • activation-messages - Show ability activation messages
  • statistics - Statistics system

Usage:

/togglefeature particles
/togglefeature guardians
/togglefeature pvp-protection

/cheststats

Description: View plugin statistics
Permission: None
Usage:

/cheststats

Output:

━━━━━ Chest Statistics ━━━━━
Chest Chances:
  Common: 50.0%
  Rare: 35.0%
  Legendary: 15.0%

Features:
  Guardians: ON
  Legendary Items: ON
  PvP Protection: ON
  Particles: ON
  Sounds: ON
  Statistics: ON

Active Chests: 1
━━━━━━━━━━━━━━━━━━━━━━━━━━

/reloadchestconfig

Description: Reload all configurations
Permission: spawnchest.reloadchestconfig
Usage:

/reloadchestconfig

Reloads:

  • config.yml
  • All language files
  • Spawn interval
  • Custom loot tables

/testchestzone

Description: Test spawn zone settings
Permission: spawnchest.testchestzone
Usage:

/testchestzone

Output:

━━━━━ Spawn Zone Test ━━━━━
Min/Max Distance: 400-2000 blocks
Bury in Ground: true
Enabled Worlds: [world, world_nether]

Example Locations:
  1. X=825 Z=-1456 (dist=1685)
  2. X=-423 Z=1002 (dist=1086)
  3. X=1789 Z=245 (dist=1806)
━━━━━━━━━━━━━━━━━━━━━━━━━━

Command Summary Table

Command Permission Description
/nextchest None Check time to next spawn
/mystats None View your statistics
/leaderboard None View top players
/cooldowns None Check item cooldowns
/chestnow spawnchest.admin Spawn chest now
/setchesttimer spawnchest.setchesttimer Set spawn interval
/resettimer spawnchest.resettimer Reset spawn timer
/putintothechest spawnchest.admin Custom loot GUI
/giveapple spawnchest.giveapple Give summoner apple
/getlegendaryitems spawnchest.getlegendaryitems Get all items
/chestconfig spawnchest.config Manage config
/togglelegendary spawnchest.config Toggle legendary items
/togglefeature spawnchest.config Toggle features
/cheststats None View statistics
/reloadchestconfig spawnchest.reloadchestconfig Reload configs
/testchestzone spawnchest.testchestzone Test spawn zone

Tab Completion

All commands support tab completion for:

  • Command names
  • Subcommands
  • Player names
  • Config paths
  • Feature names
  • Item names

Clone this wiki locally