Admin GUI

The PrimeChat Admin GUI provides a user-friendly graphical interface for managing chat settings and performing administrative tasks.

Accessing the GUI

Command: /chat gui Permission: primechat.gui Interface: Inventory-based GUI system

Main Panel

Overview

The main panel serves as the central hub for all administrative functions:

  • Quick Actions: Common tasks like lock/unlock, clear chat

  • Settings Management: Toggle features on/off

  • Configuration Access: Direct access to key settings

  • Status Indicators: Visual feedback for current states

Actions Panel

Chat Control

Lock/Unlock Chat

  • Item: Red/Green Concrete

  • Function: Toggle chat lock status

  • Visual: Color changes based on current state

  • Effect: Immediately applies lock/unlock

States:

  • 🔴 Red: Chat is locked

  • 🟢 Green: Chat is unlocked

Clear Chat

  • Item: Sponge

  • Function: Clear chat for all players

  • Confirmation: Click to execute

  • Effect: Instant chat clearing

Reload Configuration

  • Item: Command Block

  • Function: Hot-reload all config files

  • Feedback: Success/error messages

  • Safety: Backup configs before reload

Game Management

Send Chat Game

  • Item: Written Book

  • Function: Manually trigger trivia question

  • Cooldown: Respects game timing settings

  • Selection: Random question from pool

Game Statistics

  • Item: Item Frame

  • Function: View game performance stats

  • Data: Win rates, popular categories, player participation

Settings Panel

Chat Features

Message Centering

  • Control: Toggle on/off

  • Effect: Enables/disables message centering

  • Visual: Eye of Ender (enabled) / Ender Pearl (disabled)

Visual States:
  Enabled: "&#00FF00✓ &#FFFFFFMessage centering: &#00FF00ON"
  Disabled: "&#FF0000✗ &#FFFFFFMessage centering: &#FF0000OFF"

Hover Effects

  • Control: Toggle hover information

  • Effect: Shows/hides player info on hover

  • Configuration: Links to hover settings

PlaceholderAPI Integration

  • Status: Shows if PlaceholderAPI is detected

  • Control: Toggle placeholder processing

  • Performance: Shows processing speed

Security Settings

Anti-Spam Protection

  • Control: Enable/disable anti-spam

  • Settings: Adjust cooldown time

  • Statistics: Show blocked messages count

Cooldown Adjustment:

  • Left Click: Decrease by 1 second

  • Right Click: Increase by 1 second

  • Shift+Click: ±5 second adjustments

  • Range: 1-60 seconds

Blocked Words Filter

  • Control: Toggle word filtering

  • Management: Add/remove blocked words

  • Statistics: Blocked attempts counter

Word Management:

Anti-Advertising

  • Toggle IPv4 Detection: Block IP addresses

  • Toggle Domain Detection: Block website domains

  • Toggle Link Detection: Block full URLs

  • Detection Scope: Configure chat/commands/signs

Detection Settings

Configure where security features are active:

Chat Detection

  • Control: Monitor public chat

  • Status: Shows detection rate

  • Performance: Processing time stats

Command Detection

  • Control: Monitor command arguments

  • Scope: Configurable command list

  • Bypass: Staff exemption settings

Sign Detection

  • Control: Monitor sign text

  • Events: Creation and modification

  • Integration: WorldGuard region support

GUI Configuration

Customization Options

Panel Titles

gui:
  titles:
    main: "&#FFD700&lPrimeChat &#FFFFFF&lAdmin Panel"
    actions: "&#FF6B6B&lChat Actions"
    settings: "&#00BFFF&lPlugin Settings"

Item Materials

gui:
  items:
    lock-chat:
      locked: "RED_CONCRETE"
      unlocked: "GREEN_CONCRETE"
    clear-chat: "SPONGE"
    reload: "COMMAND_BLOCK"
    chat-games: "WRITTEN_BOOK"

Display Names and Lore

gui:
  items:
    anti-spam:
      name: "&#FFD700Anti-Spam Protection"
      lore:
        - "&#FFFFFF• Status: %status%"
        - "&#FFFFFF• Cooldown: %cooldown%s"
        - "&#FFFFFF• Blocked: %blocked_count%"
        - ""
        - "&#00FF00Left Click: &#FFFFFFToggle"
        - "&#00FF00Right Click: &#FFFFFFAdjust cooldown"

Slot Positioning

Control item placement in GUI:

gui:
  slots:
    main-panel:
      lock-chat: 11
      clear-chat: 13
      settings: 15
      chat-games: 17
    settings-panel:
      anti-spam: 10
      blocked-words: 12
      anti-advertising: 14
      hover-effects: 16

Interactive Features

Click Actions

Single Clicks

  • Left Click: Primary action (toggle, execute)

  • Right Click: Secondary action (settings, info)

Combined Clicks

  • Shift + Left: Advanced options

  • Shift + Right: Quick configuration

  • Ctrl + Click: Bypass confirmations

Real-Time Updates

Status Indicators

  • Green Items: Feature enabled/active

  • Red Items: Feature disabled/inactive

  • Yellow Items: Warning/attention needed

  • Blue Items: Information/statistics

Dynamic Lore

Item descriptions update in real-time:

  • Current settings values

  • Statistics and counters

  • Status messages

  • Performance data

Value Adjustments

Numerical Settings

  • Left/Right Click: ±1 adjustment

  • Shift + Click: ±5 adjustment

  • Ctrl + Click: ±10 adjustment

  • Middle Click: Reset to default

List Management

  • Left Click: Add item to list

  • Right Click: Remove item from list

  • Shift + Left: Bulk add

  • Shift + Right: Clear list

Advanced Features

Multi-Page Support

Navigation

  • Previous/Next Buttons: Browse multiple pages

  • Page Indicators: Show current page

  • Search Function: Find specific settings

Organization

  • Categories: Group related settings

  • Favorites: Pin frequently used options

  • Recent: Show recently modified settings

Permission Integration

Access Control

  • Different GUI sections based on permissions

  • Hide unavailable options

  • Show permission requirements

Staff Levels

gui:
  access-levels:
    admin: ["all"]
    moderator: ["actions", "basic-settings"]
    helper: ["view-only"]

Confirmation Dialogs

Destructive Actions

  • Clear Chat: "Are you sure?"

  • Reload Config: "This will restart systems"

  • Bulk Changes: "Confirm mass operation"

Safety Features

  • Undo Actions: Reverse recent changes

  • Backup Status: Show backup availability

  • Lock Changes: Prevent accidental edits

Performance Optimization

Memory Management

  • Session Cleanup: Remove inactive sessions

  • Item Caching: Reuse item stacks

  • Lazy Loading: Load sections on demand

Update Efficiency

  • Batch Updates: Group multiple changes

  • Smart Refresh: Only update changed items

  • Async Processing: Heavy operations off main thread

Network Optimization

  • Minimal Packets: Reduce client-server traffic

  • Compressed Data: Efficient item serialization

  • Client Caching: Reduce redundant updates

Troubleshooting

Common Issues

  1. GUI Not Opening

    • Check primechat.gui permission

    • Verify plugin is enabled

    • Look for inventory conflicts

  2. Items Not Updating

    • Check for GUI session conflicts

    • Restart GUI session

    • Clear cache and reload

  3. Click Actions Not Working

    • Verify event handling

    • Check for plugin conflicts

    • Review error logs

  4. Visual Glitches

    • Check item material availability

    • Verify color code support

    • Update display settings

Debug Information

Enable GUI debugging:

debug:
  gui: true
  gui-clicks: true
  gui-updates: true

This logs:

  • GUI open/close events

  • Click processing

  • Update operations

  • Error conditions

Best Practices

Administrative Usage

  • Regular Checks: Monitor settings periodically

  • Staff Training: Educate team on GUI usage

  • Permission Review: Audit GUI access regularly

  • Backup Settings: Save configs before changes

Performance Guidelines

  • Minimize Sessions: Close unused GUIs

  • Batch Operations: Group multiple changes

  • Monitor Performance: Watch for lag impact

  • Update Regularly: Keep plugin versions current

PreviousChat GamesNextMain Configuration

Last updated