Commands and Permissions

Commands and Permissions

Commands

All commands use the /pq (or /pistonqueue) prefix and work only when connected through the proxy.

Player Commands

Command	Description
/pq help	Shows available commands
/pq version	Shows the current PistonQueue version
/pq stats	Shows how many players are in each queue

Admin Commands

These require the queue.admin permission (configurable).

Command	Description
/pq reload	Reloads the configuration
/pq slotstats	Shows how many players of each type are on the target server vs reserved slots
/pq shadowban <player> <duration>	Shadow ban a player for a specified duration
/pq unshadowban <player>	Remove a shadow ban from a player

Shadow Ban Duration Format

The duration parameter supports:

• d - Days (e.g., 2d = 2 days)
• h - Hours (e.g., 12h = 12 hours)
• m - Minutes (e.g., 30m = 30 minutes)
• s - Seconds (e.g., 60s = 60 seconds)

Examples:

/pq shadowban PlayerName 7d      # Ban for 7 days
/pq shadowban PlayerName 24h     # Ban for 24 hours
/pq shadowban PlayerName 30m     # Ban for 30 minutes

---

Permissions

Proxy Permissions

Permission	Default	Description
queue.bypass	none	Completely bypass the queue
queue.priority	none	Access the priority queue
queue.veteran	none	Access the veteran queue
queue.admin	none	Access admin commands

Note: Permission nodes for queue types are configurable in the config. The above are the defaults.

Bukkit Permissions (Queue Server)

Permission	Default	Description
queue.admin	op	Override queue movement restrictions and other protections

---

Permission Setup Examples

LuckPerms (Recommended)

Give a player priority queue access:

/lp user <player> permission set queue.priority true

Give a group priority queue access:

/lp group <group> permission set queue.priority true

Give admin permissions:

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

Allow a player to bypass the queue entirely:

/lp user <player> permission set queue.bypass true

PermissionsEx

Give priority queue access:

/pex user <player> add queue.priority
/pex group <group> add queue.priority

---

Custom Permission Nodes

You can customize permission nodes in the configuration:

# Proxy config
queueBypassPermission: "queue.bypass"
adminPermission: "queue.admin"

# Queue types can have custom permissions
queueTypes:
  VIP:
    permission: "myserver.queue.vip"
  DONOR:
    permission: "myserver.queue.donor"
  REGULAR:
    permission: "default"  # No permission required

---

Tab Completion

Tab completion is enabled by default for all commands. You can disable it in the config:

registerTab: false

When enabled:

• Regular players see: help, version, stats
• Admins additionally see: slotstats, reload, shadowban, unshadowban
• Player names are suggested for shadowban/unshadowban commands