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 fully customizable chat channels.

Whether you run a small survival server or a large network with dozens of backends, ZStaffChatPro provides everything your staff needs — private channels, playtime tracking, AFK detection, Discord integration, and much more.

The plugin works on Spigot, Paper, Folia, BungeeCord, and Velocity, supporting Minecraft 1.13 - 1.21+.


Features

Unlimited Custom Channels

Create as many staff chat channels as you need — Staff, Admin, Builder, Helper, or anything you can think of. Each channel is fully independent with its own:

• Display name and color prefix
• Permission node
• Command and aliases (e.g. /sc, /ac, /bchat)
• Chat prefix shortcut (e.g. type !hello in chat to send "hello" to the Staff channel)
• Message format with full placeholder support
• Priority system for staff list ordering

Want just one channel? Keep only "staff" in the config and you're done.


Cross-Network Support

Full BungeeCord and Velocity proxy support. Staff can chat across all backend servers seamlessly.

• See which server each staff member is on
• Track server switches in the activity log
• Disable staff chat on specific servers (e.g. lobby, minigames)
• Custom server display names via aliases (e.g. hub-01 shows as Hub)
• Bridge addon for accurate AFK detection and signed chat support on backends

Discord Integration

Connect your staff chat to Discord with two available modes:

Webhook Mode — Simple one-way setup (Minecraft -> Discord). Just paste a webhook URL and you're done. Each channel can have its own Discord channel. Supports rich embeds with customizable colors, authors, and footers.

Bot Mode — Full two-way integration (Minecraft <-> Discord). Staff can send messages from Discord directly into the in-game staff chat. Supports role-based permissions, custom bot status, and rich embeds.

Both modes include an Activity Log that sends staff joins, leaves, server switches, vanish, and AFK events to Discord — with per-event embed colors.


Staff List

View all online staff members with /stafflist. Three display modes available:

Default — Compact, one line per channel:
Grouped — One player per line:
Server — Grouped by backend server (proxy only):
Player format is fully customizable — show LuckPerms prefix, server name, or any combination.


Staff Management

Playtime Tracking — Track how long each staff member spends online. View daily, weekly, and total playtime with AFK breakdown using /stafftime.

AFK Detection — Automatically marks inactive staff as AFK after a configurable timeout. AFK status is shown in the staff list and reported in the activity log. Staff can also manually toggle AFK with /staffafk.

Spy Mode — Allows authorized staff to see messages from all channels, even ones they don't have permission for. Toggle with /staffspy.

Toggle Mode — Use /sc without a message to toggle auto-redirect. When enabled, all your regular chat messages are automatically sent to that staff channel.

Activity Log — Track staff activity directly in the staff chat channel:

• Player joins and leaves
• Server switches (with previous and current server)
• Vanish on/off
• AFK on/off

No extra permission needed — works for any player with access to a channel.


Integrations

LuckPerms — Automatic support for prefix, suffix, group, and rank placeholders. Use {luckperms_prefix}, {luckperms_rank}, etc. in any message format.

PremiumVanish / SuperVanish — Vanished players are shown with a [Vanished] tag in the staff list and vanish events are tracked in the activity log.

Chat Filter — Built-in anti-bad-words filter with two modes: censor (replace with obfuscated text or custom string) or block (prevent the message entirely). Supports word lists and regex patterns.


Customization

Everything is configurable. Clean LuckPerms-style config files with detailed comments for every option.

• Full hex color support ({#FF5555}text)
• Gradient support ({#FF0000>>#0000FF}text{/})
• 20+ placeholders across all formats
• Multi-line message support
• Customizable help, about, and staff list output
• Auto-backup and regeneration when config version changes

Quick Start

1. Drop the plugin JAR into your server's plugins/ folder
2. For proxy setups: install on the proxy + Bridge addon on each backend server
3. Start the server — default channels work out of the box
4. Customize channels, formats, and features in config.yml

For detailed setup guides, all configuration options, and troubleshooting visit the Wiki.


Commands

Command	Description
/sc <message>	Send a message to the Staff channel
/ac <message>	Send a message to the Admin channel
/stafflist	View all online staff members
/staffspy	Toggle spy mode (see all channels)
/stafftime [player]	View playtime statistics
/staffafk	Toggle AFK status
/zscp reload	Reload all configuration files
/zscp about	Show plugin info and status

Full command list, permissions, and placeholders available on the Wiki.


Supported Platforms

Platform	Versions
Spigot / Paper	1.13+
Folia	1.19+
BungeeCord / Waterfall	Latest
Velocity	3.3+