Commands

Main Commands

/chat - Primary Command

Aliases: /primechat, /pchat Usage: /chat <subcommand> Description: Main plugin command with various subcommands

Available Subcommands:

Subcommand	Description	Permission	Usage
help	Show help message	primechat.help	/chat help
reload	Reload configuration	primechat.reload	/chat reload
gui	Open admin GUI	primechat.gui	/chat gui
lock	Lock the chat	primechat.lock	/chat lock
unlock	Unlock the chat	primechat.unlock	/chat unlock
clearchat	Clear chat for all	primechat.clearchat	/chat clearchat
spy [on/off]	Toggle spy mode	primechat.spy	/chat spy or /chat spy on
chatgames	Send chat game	primechat.chatgames	/chat chatgames

/message - Private Messages

Aliases: /msg, /tell, /w Usage: /message <player> <message> Permission: None (available to all players) Description: Send a private message to another player

Examples:

/msg Steve Hello there!
/tell Alex How are you doing?
/w notch Thanks for creating Minecraft!

/reply - Quick Reply

Aliases: /r Usage: /reply <message> Permission: None (available to all players) Description: Reply to the last private message received

Examples:

/r I'm doing great, thanks!
/r Sure, I can help you with that

Command Details

Chat Management Commands

/chat lock

• Purpose: Prevent regular players from chatting

• Effect: Only players with primechat.bypass.lock can send messages

• Visual: Shows centered "Chat is now locked!" message

• Status: Saved in configuration for persistence

/chat unlock

• Purpose: Return chat to normal operation

• Effect: All players can chat again

• Visual: Shows centered "Chat is now unlocked!" message

• Status: Updates configuration automatically

/chat clearchat

• Purpose: Clear chat history for all players

• Effect: Sends multiple blank lines to push old messages up

• Visual: Shows centered "Chat has been cleared!" message

• Scope: Affects all online players

Configuration Commands

/chat reload

• Purpose: Reload all plugin configurations without restart

• Scope: Reloads all YAML files:

  • config.yml

  • messages.yml

  • gui.yml

  • chatgames.yml

  • sounds.yml

• Benefits: Apply changes instantly without server restart

/chat gui

• Purpose: Open the admin control panel

• Interface: Interactive inventory GUI

• Features:

  • Toggle settings visually

  • Quick access to common actions

  • Real-time configuration updates

Monitoring Commands

/chat spy

• Purpose: Monitor private messages between players

• Usage Options:

  • /chat spy - Toggle spy mode

  • /chat spy on - Enable spy mode

  • /chat spy off - Disable spy mode

• Effect: See all /msg and /reply commands

• Format: Custom spy message format in config

/chat chatgames

• Purpose: Manually trigger a chat game

• Effect: Sends a random trivia question to chat

• Rewards: Automatic reward distribution to winners

• Cooldown: Respects game timing settings

Private Messaging System

How It Works

1. Send Message: Player uses /msg <target> <message>

2. Reply Mapping: System remembers conversation pairs

3. Quick Reply: Recipient can use /r <message>

4. Bidirectional: Both players can reply to each other

5. Spy Integration: Admins with spy mode see all messages

Message Formatting

Sender View

sender-format: "&#FF69B4&o(To %receiver%)&r&#D3D3D3: %message%"

Receiver View

receiver-format: "&#FF69B4&o(From %sender%)&r&#D3D3D3: %message%"

Spy View

Custom spy format shows:

• Sender name

• Receiver name

• Message content

• Timestamp

Reply System Features

• Automatic Mapping: No need to remember usernames

• Conversation Tracking: Handles multiple conversations

• Session Persistence: Remembers conversations across sessions

• Error Handling: Clear messages when no recent conversation

Command Examples

Administrative Tasks

# Lock chat during events
/chat lock

# Clear spam from chat
/chat clearchat

# Check private messages
/chat spy on

# Reload after config changes
/chat reload

# Open admin panel
/chat gui

Player Communication

# Send private message
/msg PlayerName Hey, want to team up?

# Reply to received message
/r Sure! Meet at spawn?

# Another reply
/r On my way there now

Staff Moderation

# Enable message monitoring
/chat spy on

# Send educational game
/chat chatgames

# Lock chat during announcements
/chat lock

# Clear chat after spam
/chat clearchat

# Unlock when done
/chat unlock

Command Permissions Integration

LuckPerms Examples

# Give admin all chat permissions
lp group admin permission set primechat.admin true

# Give moderator basic moderation
lp group mod permission set primechat.lock true
lp group mod permission set primechat.unlock true
lp group mod permission set primechat.clearchat true

# Give VIP formatting permissions
lp group vip permission set primechat.color true
lp group vip permission set primechat.hex true

GroupManager Examples

# Admin permissions
permissions:
  - primechat.admin
  - primechat.gui
  - primechat.spy

# Moderator permissions  
permissions:
  - primechat.lock
  - primechat.unlock
  - primechat.clearchat
  - primechat.chatgames

Tab Completion

PrimeChat provides intelligent tab completion:

/chat Command

• Shows available subcommands based on permissions

• Filters options player can actually use

• Provides helpful command hints

/message Command

• Tab completes online player names

• Shows only players the sender can message

• Respects vanish and ignore settings

Command Aliases

All commands support multiple aliases for convenience:

• /chat = /primechat = /pchat

• /message = /msg = /tell = /w

• /reply = /r

Error Handling

Common Error Messages

• No Permission: "You don't have permission to use this command"

• Invalid Player: "Player 'PlayerName' is not online"

• No Recent Conversation: "You have no one to reply to"

• Command Cooldown: "Please wait X seconds before using this command"

• Chat Locked: "Chat is currently locked by an administrator"

Debug Mode

Enable debug mode in config for detailed command logging:

debug: true

This shows:

• Command execution details

• Permission check results

• Error stack traces

• Performance timing