Skip to content

Permissions.md

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

🔐 Permissions Reference

Overview

SpawnChestPlugin uses a permission-based system to control access to commands and features.

Default Permissions

By default, all players have access to:

  • /nextchest - Check spawn timer
  • /mystats - View statistics
  • /leaderboard - View leaderboards
  • /cooldowns - Check item cooldowns
  • /cheststats - View plugin stats
  • Opening chests and using legendary items

Admin Permissions

Full Admin Access

spawnchest.admin

Grants:

  • /chestnow - Spawn chest immediately
  • /putintothechest - Custom loot GUI editor
  • All configuration commands

Recommended for: Server owners, head admins

Configuration Management

spawnchest.config

Grants:

  • /chestconfig - All config management
  • /togglelegendary - Toggle legendary items
  • /togglefeature - Toggle features
  • /reloadchestconfig - Reload configurations

Recommended for: Admins, moderators

Timer Control

spawnchest.setchesttimer

Grants:

  • /setchesttimer <seconds> - Change spawn interval

Recommended for: Event managers

spawnchest.resettimer

Grants:

  • /resettimer - Reset timer to spawn soon

Recommended for: Event managers

Item Management

spawnchest.giveapple

Grants:

  • /giveapple <player> [amount] - Give summoner apples

Recommended for: Admins, event hosts

spawnchest.getlegendaryitems

Grants:

  • /getlegendaryitems - Get all legendary items

Recommended for: Testing, admin use only

Reload Permission

spawnchest.reloadchestconfig

Grants:

  • /reloadchestconfig - Reload all configs

Recommended for: Admins

Testing Tools

spawnchest.testchestzone

Grants:

  • /testchestzone - Test spawn zone settings

Recommended for: Admins, developers

Permission Groups Setup

LuckPerms Example

Owner/Admin Group:

/lp group admin permission set spawnchest.admin true

Moderator Group:

/lp group mod permission set spawnchest.config true
/lp group mod permission set spawnchest.reloadchestconfig true

VIP Group (can use apples):

/lp group vip permission set spawnchest.giveapple true

Event Manager:

/lp group event permission set spawnchest.setchesttimer true
/lp group event permission set spawnchest.resettimer true
/lp group event permission set spawnchest.admin true

PermissionsEx Example

groups.yml:

groups:
  default:
    permissions: []
    
  vip:
    permissions:
      - spawnchest.giveapple
    inheritance:
      - default
      
  moderator:
    permissions:
      - spawnchest.config
      - spawnchest.reloadchestconfig
    inheritance:
      - vip
      
  admin:
    permissions:
      - spawnchest.admin
      - spawnchest.*
    inheritance:
      - moderator

GroupManager Example

groups.yml:

groups:
  Default:
    permissions: []
    
  VIP:
    permissions:
      - spawnchest.giveapple
    inheritance:
      - Default
      
  Moderator:
    permissions:
      - spawnchest.config
      - spawnchest.reloadchestconfig
    inheritance:
      - VIP
      
  Admin:
    permissions:
      - spawnchest.*
    inheritance:
      - Moderator

Wildcard Permissions

Give All Permissions

spawnchest.*

Grants: All plugin permissions

⚠️ Warning: Only give to trusted admins!

Permission Hierarchy

spawnchest.*
├── spawnchest.admin
│   ├── /chestnow
│   └── /putintothechest
├── spawnchest.config
│   ├── /chestconfig
│   ├── /togglelegendary
│   └── /togglefeature
├── spawnchest.giveapple
│   └── /giveapple
├── spawnchest.getlegendaryitems
│   └── /getlegendaryitems
├── spawnchest.setchesttimer
│   └── /setchesttimer
├── spawnchest.resettimer
│   └── /resettimer
├── spawnchest.reloadchestconfig
│   └── /reloadchestconfig
└── spawnchest.testchestzone
    └── /testchestzone

Permission Nodes Table

Permission Commands Default
spawnchest.admin /chestnow, /putintothechest OP
spawnchest.config /chestconfig, /togglelegendary, /togglefeature OP
spawnchest.giveapple /giveapple OP
spawnchest.getlegendaryitems /getlegendaryitems OP
spawnchest.setchesttimer /setchesttimer OP
spawnchest.resettimer /resettimer OP
spawnchest.reloadchestconfig /reloadchestconfig OP
spawnchest.testchestzone /testchestzone OP

Common Setups

Public Server (Everyone can use)

# Give all players basic access
permissions:
  default: true  # Minecraft default permissions
  
# Only ops get admin commands

Semi-Private Server (Trusted players)

# VIPs can spawn chests with apples
vip:
  - spawnchest.giveapple
  
# Admins have full control
admin:
  - spawnchest.*

Event Server (Controlled spawning)

# Players: nothing special
# Event hosts: can spawn chests
event-host:
  - spawnchest.admin
  - spawnchest.setchesttimer
  - spawnchest.resettimer

Testing Permissions

Check if player has permission:

/lp user <player> permission check spawnchest.admin

Grant temporary permission:

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

Remove permission:

/lp user <player> permission unset spawnchest.admin

Security Recommendations

  1. ✅ Never give spawnchest.* to regular players
  2. ✅ Limit spawnchest.admin to trusted staff
  3. ✅ Use spawnchest.giveapple carefully - apples can spam chests
  4. ✅ Monitor /getlegendaryitems usage - very powerful items
  5. ✅ Keep spawnchest.config for admins only

Troubleshooting

Player can't use command:

  1. Check permission: /lp user <player> permission check spawnchest.<permission>
  2. Check inheritance: /lp user <player> permission info
  3. Reload permissions: /lp sync

Command works in console but not in-game:

  • Add permission to player's group
  • Check for permission conflicts

Permission not working after adding:

  • Run /lp sync or /pex reload
  • Player may need to rejoin

Clone this wiki locally