ZStaffChatPro

---

The most advanced staff communication plugin for Minecraft networks.

Wiki & Documentation | Bridge Addon | Discord

---

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.8.x — 1.21.x and 26.1.1.

---

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:

Staff (2): player1, player2

Grouped — One player per line:

Staff (2)
  player1
  player2

Server — Grouped by backend server (proxy only):

Staff (3)
  Hub (1)
    player1
  Survival (2)
    player2
    player3

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. Full hex color support including &#RRGGBB format.

PremiumVanish / SuperVanish — Vanished players are shown with a [Vanished] tag in the staff list and vanish events are tracked in the activity log. Cross-server sync via Bridge addon.

Chat Filter — Built-in word 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 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.8.x — 1.21.x and 26.1.1
Folia	1.19.4+
BungeeCord / Waterfall	All versions
Velocity	3.0+

---

Need help? Visit the Wiki or join our Discord.