Skip to content

Permissions.md

Jump to bottom
Fragmer2 edited this page Apr 8, 2026 · 3 revisions

Permissions Reference

Player Permissions (default: everyone)

Permission Grants
spawnchest.use /nextchest · /mystats · /leaderboard · /cooldowns
spawnchest.legendary Receive and use legendary items from chests
spawnchest.apple Eat any Summoner Apple

Notification Permissions (default: everyone)

All spawnchest.notify.* nodes default to true. On servers where all permissions are denied by default, grant these to the default group.

Permission Controls
spawnchest.notify.spawn Spawn announcement, chest-activated, countdown, opened-by, batch, world-apple messages
spawnchest.notify.coordinates Coordinates inside spawn announcements — without this players see "appeared somewhere in the world"
spawnchest.notify.disappear Chest disappear announcements
spawnchest.notify.countdown Pre-spawn countdown warnings
spawnchest.notify.bossbar BossBar visibility (requires features.bossbar.enabled: true)

Grant to default group (LuckPerms):

/lp group default permission set spawnchest.notify.spawn true
/lp group default permission set spawnchest.notify.coordinates true
/lp group default permission set spawnchest.notify.countdown true
/lp group default permission set spawnchest.notify.disappear true
/lp group default permission set spawnchest.notify.bossbar true

Admin Permissions (default: OP)

spawnchest.admin

Full admin access. Inherits all sub-permissions below.

Grants: /chestnow · /putintothechest · /cheststats and everything in the children list.

spawnchest.config

Grants: /chestconfig · /togglelegendary · /togglefeature

spawnchest.reloadchestconfig

Grants: /reloadchestconfig

spawnchest.setchesttimer

Grants: /setchesttimer <seconds>

spawnchest.resettimer

Grants: /resettimer

spawnchest.giveapple

Grants: /giveapple <random|common|rare|legendary> <player> [amount]

spawnchest.getlegendaryitems

Grants: /getlegendaryitems

spawnchest.testchestzone

Grants: /testchestzone

spawnchest.bypass

Bypass legendary item cooldowns.

Permission Hierarchy

spawnchest.*
├── spawnchest.use
├── spawnchest.legendary
├── spawnchest.apple
├── spawnchest.bypass
├── spawnchest.notify.spawn
├── spawnchest.notify.coordinates
├── spawnchest.notify.disappear
├── spawnchest.notify.countdown
├── spawnchest.notify.bossbar
└── spawnchest.admin
    ├── spawnchest.config
    │     /chestconfig · /togglelegendary · /togglefeature
    ├── spawnchest.reloadchestconfig
    │     /reloadchestconfig
    ├── spawnchest.setchesttimer
    │     /setchesttimer
    ├── spawnchest.resettimer
    │     /resettimer
    ├── spawnchest.giveapple
    │     /giveapple
    ├── spawnchest.getlegendaryitems
    │     /getlegendaryitems
    └── spawnchest.testchestzone
          /testchestzone

Full Reference Table

Permission Commands Default
spawnchest.use /nextchest /mystats /leaderboard /cooldowns Everyone
spawnchest.legendary Receive legendary items Everyone
spawnchest.apple Use Summoner Apples Everyone
spawnchest.bypass Bypass cooldowns OP
spawnchest.notify.spawn Spawn broadcasts Everyone
spawnchest.notify.coordinates Coordinates in broadcasts Everyone
spawnchest.notify.disappear Disappear broadcasts Everyone
spawnchest.notify.countdown Countdown warnings Everyone
spawnchest.notify.bossbar BossBar Everyone
spawnchest.admin All admin commands OP
spawnchest.config /chestconfig /togglelegendary /togglefeature OP
spawnchest.reloadchestconfig /reloadchestconfig OP
spawnchest.setchesttimer /setchesttimer OP
spawnchest.resettimer /resettimer OP
spawnchest.giveapple /giveapple OP
spawnchest.getlegendaryitems /getlegendaryitems OP
spawnchest.testchestzone /testchestzone OP

Setup Examples

LuckPerms

# Admin
/lp group admin permission set spawnchest.admin true
 
# Moderator — reload config, no spawning
/lp group mod permission set spawnchest.config true
/lp group mod permission set spawnchest.reloadchestconfig true
 
# VIP — can give apples to themselves
/lp group vip permission set spawnchest.giveapple true
 
# Event host
/lp group event permission set spawnchest.admin true
/lp group event permission set spawnchest.setchesttimer true
/lp group event permission set spawnchest.resettimer true
 
# Default group — notifications on restricted servers
/lp group default permission set spawnchest.notify.spawn true
/lp group default permission set spawnchest.notify.coordinates true
/lp group default permission set spawnchest.notify.countdown true
/lp group default permission set spawnchest.notify.disappear true
/lp group default permission set spawnchest.notify.bossbar true

PermissionsEx (groups.yml)

groups:
  default:
    permissions:
      - spawnchest.use
      - spawnchest.legendary
      - spawnchest.apple
      - spawnchest.notify.spawn
      - spawnchest.notify.coordinates
      - spawnchest.notify.countdown
      - spawnchest.notify.disappear
      - spawnchest.notify.bossbar
 
  vip:
    inheritance:
      - default
    permissions:
      - spawnchest.giveapple
 
  moderator:
    inheritance:
      - vip
    permissions:
      - spawnchest.config
      - spawnchest.reloadchestconfig
 
  admin:
    inheritance:
      - moderator
    permissions:
      - spawnchest.*

Testing Permissions

/lp user <player> permission check spawnchest.admin
/lp user <player> permission set spawnchest.admin true
/lp user <player> permission unset spawnchest.admin

Troubleshooting

Player can't use command:

  1. /lp user <player> permission check spawnchest.<node>
  2. /lp user <player> permission info — check inheritance
  3. /lp sync

Notifications not showing:

  • Check spawnchest.notify.spawn is granted
  • On restricted servers all notify.* nodes must be explicitly granted to the default group

Clone this wiki locally