ZStaffChatPro

» What is ZStaffChatPro?

ZStaffChatPro is a powerful and lightweight staff chat plugin designed for Minecraft server networks. It allows your staff team to communicate privately across multiple servers using customizable chat channels. Whether you run a small survival server or a large network with dozens of servers, ZStaffChatPro provides the tools your staff needs to coordinate effectively.

The plugin supports all major server platforms including Spigot, Paper, Folia, BungeeCord, Waterfall, and Velocity. It works on Minecraft versions from 1.8 all the way to the latest 1.21+ releases.

» Why Choose ZStaffChatPro?

• Multi-Platform Support - Single plugin works on Spigot, Paper, Folia, BungeeCord, Waterfall, and Velocity
• Unlimited Custom Channels - Create as many staff channels as you need (Admin, Mod, Builder, Helper, etc.)
• Discord Integration - Two modes: Full Bot (bidirectional) or simple Webhook (one-way)
• Modern Minecraft Support - Full support for 1.8 - 1.21+ including Folia servers
• LuckPerms Integration - Automatic prefix/suffix/rank display from LuckPerms
• HEX Colors & Gradients - Modern color formatting for 1.16+ servers
• Lightweight & Fast - Optimized code with minimal server impact
• Easy Configuration - Simple YAML configuration with extensive documentation
• Auto-Update Config - New config options are automatically added on plugin update
• Global Mode - Optional single channel mode for simpler setups
• Server Aliases - Custom server display names for proxy networks
• Staff Playtime Tracking - Track staff online time with /stafftime command
• AFK Detection - Automatic AFK detection with configurable timeout
• PremiumVanish Integration - Hide vanished staff from /stafflist for non-staff players
• bStats Integration - Anonymous plugin statistics

» Detailed Features

Unlimited Custom Channels

Create unlimited staff chat channels, each fully customizable with its own settings:

Example Channel Configuration:

channels:
  staff:
    display-name: "Staff"
    prefix: "&c[Staff] "
    permission: "zstaffchat.staff"
    format: "&c[Staff] &7{player}: &f{message}"
    command: "staffchat"
    aliases:
      - "sc"
    chat-prefix: "!"
    enabled: true

  admin:
    display-name: "Admin"
    prefix: "&4[Admin] "
    permission: "zstaffchat.admin"
    format: "&4[Admin] {lp_prefix}&7{player}: &f{message}"
    command: "adminchat"
    aliases:
      - "ac"
    chat-prefix: "#"
    enabled: true

Format Placeholders

Basic Placeholders:

LuckPerms Placeholders (requires LuckPerms):

HEX Color Support (1.16+)

Formatting with HEX colors:

# Bold red text
format: "&l{#FF0000}Bold Red Text"

# Bold gradient
format: "{#FF0000>>#0000FF}&lBold Gradient{/}"

Staff Playtime Tracking

Track how long your staff members are online:

• Today's playtime - Track daily activity
• Weekly playtime - Track weekly activity
• Total playtime - All-time statistics
• AFK time tracking - Separate AFK time from active time
• Permission-based - Only track players with specific permission

Commands:

• /stafftime - View your own playtime
• /stafftime <player> - View another player's playtime

AFK Detection

Automatic detection of inactive staff members:

• Configurable timeout - Set AFK threshold (default: 5 minutes)
• [AFK] prefix in /stafflist - Easy identification of inactive staff
• AFK time tracking - Track how long staff is AFK in playtime stats
• Chat activity detection - Any chat activity resets AFK timer

AFK Configuration:

afk:
  enabled: true
  timeout-minutes: 5

» Discord Integration

Bot Mode (Bidirectional)

Full Discord bot integration with two-way communication:

• Bidirectional messaging - Messages sync both ways (Minecraft ↔ Discord)
• Staff can respond from Discord - Your team can chat from mobile or desktop
• Separate Discord channel per staff channel - Map each Minecraft channel to its own Discord text channel
• Role-based permissions - Restrict who can send messages from Discord
• Runtime library loading - JDA library downloads automatically (keeps JAR small)

Bot Mode Setup:

discord:
  mode: "bot"
  bot-token: "YOUR_BOT_TOKEN_HERE"

  channels:
    staff: "1234567890123456789"
    admin: "9876543210987654321"

  format:
    to-discord: "**[{channel}]** {player}: {message}"
    to-minecraft: "&7[&9Discord&7] &7{player}: &f{message}"

  required-roles:
    - "Staff"
    - "Admin"

Webhook Mode (Simple)

Lightweight one-way integration for basic Discord logging:

• One-way sync - Messages go from Minecraft to Discord only
• No bot setup required - Just create a webhook in Discord
• Per-channel webhooks - Each channel can have its own Discord webhook
• Lightweight - No external libraries needed

Webhook Mode Setup:

discord:
  mode: "webhook"

  webhook:
    channels:
      staff: "https://discord.com/api/webhooks/..."
      admin: "https://discord.com/api/webhooks/..."
    username: "StaffChat"
    format: "**[{channel}]** {player}: {message}"

» Commands & Permissions

Command Reference

Default Channel Commands:

• /staffchat or /sc - Staff channel
• /adminchat or /ac - Admin channel
• /builderchat or /bchat - Builder channel

Permission Reference

» Supported Platforms

Important Notes:

• The main JAR (ZStaffChatPro.jar) works on Spigot, Paper, BungeeCord, Waterfall, and Velocity
• Folia requires a separate JAR (ZStaffChatPro-Folia.jar) due to different API requirements
• For proxy setups (BungeeCord/Velocity), install the plugin on the proxy server only
• HEX colors and gradients require Minecraft 1.16+ clients

» Installation Guide

Single Server (Spigot/Paper)

1. Download ZStaffChatPro.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Edit configuration files in plugins/ZStaffChatPro/
5. Use /zstaffchat reload to apply changes

Folia Server

1. Download ZStaffChatPro-Folia.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Configure as normal

Proxy Network (BungeeCord/Velocity)

1. Download ZStaffChatPro.jar
2. Place it in your proxy's plugins folder (NOT on backend servers)
3. Restart your proxy
4. Messages will sync across all connected servers automatically

» Feature Comparison

» Plugin Statistics