Permissions

Complete guide to PrimeChat permissions for administrators and server owners.

Permission Categories

Administrative Permissions

Core Admin Access

• primechat.admin

  • Description: Master permission granting access to all admin commands

  • Default: op

  • Includes: All other admin permissions

  • Usage: Grant to server administrators only

GUI and Interface

• primechat.gui

  • Description: Access to the admin GUI panel

  • Default: op

  • Command: /chat gui

  • Features: Visual configuration interface

Configuration Management

• primechat.reload

  • Description: Reload plugin configuration files

  • Default: op

  • Command: /chat reload

  • Effect: Hot-reloads all config files without restart

Chat Control Permissions

Chat Lock System

• primechat.lock

  • Description: Lock the public chat

  • Default: op

  • Command: /chat lock

  • Effect: Only bypass users can speak

• primechat.unlock

  • Description: Unlock the public chat

  • Default: op

  • Command: /chat unlock

  • Effect: Returns chat to normal operation

Chat Maintenance

• primechat.clearchat

  • Description: Clear chat for all players

  • Default: op

  • Command: /chat clearchat

  • Effect: Removes visible chat history

Monitoring Permissions

Social Spy

• primechat.spy

  • Description: Monitor all private messages

  • Default: op

  • Command: /chat spy [on/off]

  • Privacy: Staff monitoring feature

Chat Games

• primechat.chatgames

  • Description: Manually send chat games

  • Default: op

  • Command: /chat chatgames

  • Effect: Triggers trivia questions

Bypass Permissions

Security Bypasses

• primechat.bypass.spam

  • Description: Bypass anti-spam cooldown

  • Default: op

  • Effect: No delay between messages

  • Typical Users: Staff, VIPs

• primechat.bypass.blockedwords

  • Description: Bypass blocked word filter

  • Default: op

  • Effect: Can use filtered words

  • Caution: Use carefully

• primechat.bypass.advertising

  • Description: Bypass anti-advertising filter

  • Default: op

  • Effect: Can share links and IPs

  • Use Case: Staff announcements

• primechat.bypass.lock

  • Description: Speak when chat is locked

  • Default: op

  • Effect: Ignore chat lock restrictions

  • Essential: For emergency communication

Formatting Permissions

Basic Formatting

• primechat.color

  • Description: Use classic color codes (&c, &a, etc.)

  • Default: op

  • Usage: &cRed text, &aGreen text

  • Compatible: All Minecraft versions

Advanced Formatting

• primechat.hex

  • Description: Use hex color codes

  • Default: op

  • Usage: &#FF0000Red text, &#00FF00Green text

  • Requirement: Minecraft 1.16+

• primechat.gradient

  • Description: Use gradient color effects

  • Default: op

  • Usage: <#FF0000>Gradient</#FF5500>

  • Advanced: Creates smooth color transitions

Help and Information

• primechat.help

  • Description: Access help command

  • Default: true (all players)

  • Command: /chat help

  • Basic: Essential for all users

Permission Groups Setup

LuckPerms Configuration

Administrator Group

# Create admin group with full access
lp group admin permission set primechat.admin true

# Or grant individual permissions
lp group admin permission set primechat.gui true
lp group admin permission set primechat.reload true
lp group admin permission set primechat.spy true
lp group admin permission set primechat.lock true
lp group admin permission set primechat.unlock true
lp group admin permission set primechat.clearchat true
lp group admin permission set primechat.chatgames true

# Formatting permissions
lp group admin permission set primechat.color true
lp group admin permission set primechat.hex true
lp group admin permission set primechat.gradient true

# Bypass permissions
lp group admin permission set primechat.bypass.spam true
lp group admin permission set primechat.bypass.blockedwords true
lp group admin permission set primechat.bypass.advertising true
lp group admin permission set primechat.bypass.lock true

Moderator Group

# Chat control permissions
lp group moderator permission set primechat.lock true
lp group moderator permission set primechat.unlock true
lp group moderator permission set primechat.clearchat true
lp group moderator permission set primechat.chatgames true

# Monitoring
lp group moderator permission set primechat.spy true

# Basic formatting
lp group moderator permission set primechat.color true
lp group moderator permission set primechat.hex true

# Essential bypasses
lp group moderator permission set primechat.bypass.spam true
lp group moderator permission set primechat.bypass.lock true

VIP Group

# Formatting permissions for VIP players
lp group vip permission set primechat.color true
lp group vip permission set primechat.hex true

# Quality of life bypasses
lp group vip permission set primechat.bypass.spam true

# Optional: gradient colors for premium VIPs
lp group vip+ permission set primechat.gradient true

Default Group

# Only help access for regular players
lp group default permission set primechat.help true

GroupManager Configuration

groups.yml Example

groups:
  admin:
    permissions:
    - primechat.admin
    - primechat.*
  
  moderator:
    permissions:
    - primechat.lock
    - primechat.unlock
    - primechat.clearchat
    - primechat.spy
    - primechat.color
    - primechat.hex
    - primechat.bypass.spam
    - primechat.bypass.lock
  
  vip:
    permissions:
    - primechat.color
    - primechat.hex
    - primechat.bypass.spam
  
  default:
    permissions:
    - primechat.help

PermissionsEx Configuration

permissions.yml Example

groups:
  admin:
    permissions:
    - primechat.admin
  
  mod:
    permissions:
    - primechat.lock
    - primechat.unlock
    - primechat.clearchat
    - primechat.spy
    - primechat.bypass.spam
  
  vip:
    permissions:
    - primechat.color
    - primechat.bypass.spam

Permission Inheritance

Hierarchical Setup

# LuckPerms inheritance example
lp group admin parent set moderator
lp group moderator parent set vip  
lp group vip parent set default

This creates:

• Admin: Gets all permissions (admin + mod + vip + default)

• Moderator: Gets mod + vip + default permissions

• VIP: Gets vip + default permissions

• Default: Gets only basic permissions

Weight-Based Priority

# Set group weights (higher = more important)
lp group admin parent setweight moderator 100
lp group moderator parent setweight vip 50
lp group vip parent setweight default 10

Context-Based Permissions

World-Specific Permissions

# Allow hex colors only in creative world
lp group builder permission set primechat.hex true server=creative

# Disable spam bypass in PvP world
lp group vip permission set primechat.bypass.spam false server=pvp

Server-Specific Permissions

# Different permissions per server in network
lp group vip permission set primechat.gradient true server=lobby
lp group vip permission set primechat.gradient false server=survival

Temporary Permissions

Event-Based Access

# Grant temporary admin access for events
lp user PlayerName permission settemp primechat.admin true 1h

# Temporary formatting for competitions
lp user WinnerName permission settemp primechat.gradient true 1d

Punishment Integration

# Remove formatting permissions as punishment
lp user BadPlayer permission set primechat.color false

# Restore after appeal
lp user BadPlayer permission unset primechat.color

Permission Testing

In-Game Testing

# Check player's permissions
/lp user PlayerName permission check primechat.color

# View effective permissions
/lp user PlayerName permission info

# Test permission inheritance
/lp user PlayerName parent info

Permission Debugging

Enable debug mode in plugin config:

debug:
  permissions: true

This logs:

• Permission checks

• Group inheritance

• Context evaluation

• Cache hits/misses

Best Practices

Security Guidelines

1. Minimal Permissions: Grant only necessary permissions

2. Regular Audits: Review permissions monthly

3. Bypass Caution: Limit bypass permissions carefully

4. Staff Training: Educate staff on permission impact

5. Documentation: Maintain permission documentation

Performance Optimization

1. Use Inheritance: Avoid duplicate permission grants

2. Cache Settings: Configure permission plugin caching

3. Group Efficiency: Use groups instead of individual grants

4. Context Limiting: Minimize context-based permissions

Common Permission Combinations

New Staff Member

# Basic staff package
primechat.lock
primechat.unlock
primechat.clearchat
primechat.color
primechat.bypass.spam
primechat.bypass.lock

Trial Moderator

# Limited moderation
primechat.lock
primechat.unlock
primechat.clearchat
primechat.color
primechat.hex

Event Coordinator

# Event management
primechat.chatgames
primechat.lock
primechat.unlock
primechat.clearchat
primechat.gradient

Troubleshooting Permissions

Common Issues

1. Permission Not Working

   • Check spelling and case sensitivity

   • Verify group inheritance

   • Clear permission cache

   • Restart server if needed

2. Conflicts Between Plugins

   • Check permission plugin priority

   • Review meta permissions

   • Test with single permission plugin

3. Inheritance Problems

   • Verify parent-child relationships

   • Check weight settings

   • Review context applications

Debug Commands

# LuckPerms debugging
/lp verbose on
/lp user PlayerName permission check primechat.color
/lp verbose paste

# Check effective permissions
/lp user PlayerName permission info
/lp group GroupName permission info