
ZStaffChatPro
The most powerful and customizable staff chat plugin for your server!
ZStaffChatPro Folia 1.15.0
release18 февраля 2026 г.New Features:
-
Separate Discord Config — Discord configuration has been moved from
config.ymlto a dedicateddiscord.ymlfile for better organization. The new file has 4 clear top-level sections:webhook,webhook-activity-log,bot, andbot-activity-log. -
Stafflist AFK/Vanish Suffix — Added
stafflist-afk-suffixandstafflist-vanished-suffixto messages.yml, allowing status indicators to be displayed after player names (in addition to the existing prefix options). -
Chat Filter (Anti-Bad-Words) — Added a configurable chat filter in a dedicated
filter.ymlfile. Supports two modes:censor(replaces matched words with configurable replacements for Minecraft and Discord separately) andblock(prevents the message entirely). Supports plain word list with automatic word-boundary matching and raw regex patterns. Players with the bypass permission (zstaffchat.filter.bypass) skip filtering. -
Global Channel Toggle — Added
/zstaffchat toggle <channel>command to globally enable/disable channels. State persists toconfig.yml(survives restarts). Disabled channels block all messages (commands, chat prefixes, toggle mode) and show a configurablechannel-disabledmessage. Requireszstaffchat.togglepermission. Tab completion for channel IDs included. -
Grouped Stafflist Mode — Added
stafflist-modeconfig option (defaultorgrouped). Grouped mode displays rank as a title with players listed individually below, instead of comma-separated on one line. Fully customizable viastafflist-group-titleandstafflist-group-playerin messages.yml.
Improvements:
- Reduced config.yml size by ~250 lines (51% smaller) by moving Discord config to discord.yml
- Discord config now has its own version tracking (
discord-version) - Added /zscp command alias on all platforms
- Added
{prefix}placeholder support in all messages.yml messages — plugin prefix is no longer hardcoded, users can move or remove it from any message - Added Chat Filter status to startup message and
/zstaffchat aboutoutput on all platforms - Added Bridge Addon connection status to
/zstaffchat abouton proxy platforms (shows connected server names) - Added Discord bot name, owner, and server/guild name to
/zstaffchat aboutoutput (shows which bot is connected, who owns it, and to which Discord server) - Added
{server}and{server_alias}placeholder support in Discord bot and webhook message formats (text, embeds, footer, etc.) - Added
{server_alias}placeholder support in channel format (previously only{server}was available) - Empty
{server}placeholders now auto-clean surrounding brackets[]/()and double spaces - Removed dead code: unused methods, interface stubs, redundant logic across the codebase
Bug Fixes:
- Fixed hex colors ({#RRGGBB}) and gradients not working on BungeeCord — all commands and chat messages now use ColorUtil instead of ChatColor.translateAlternateColorCodes
- Fixed Kotlin compiler warnings: deprecated
description.version→pluginMeta.versionon Folia, unused event parameters on Velocity, redundant elvis operator in Folia AfkListener, unused parameter and redundant initializer in ConfigManager - Fixed
{server}placeholder not working in Discord bot/webhook messages (was missing from placeholder map) - Fixed player not seeing their own join/leave activity messages on proxy (BungeeCord/Velocity) — players without a backend server at login time were being skipped
- Fixed empty
{server}placeholder leaving extra spaces in channel format messages
ZStaffChatPro 1.15.0
release18 февраля 2026 г.New Features:
-
Separate Discord Config — Discord configuration has been moved from
config.ymlto a dedicateddiscord.ymlfile for better organization. The new file has 4 clear top-level sections:webhook,webhook-activity-log,bot, andbot-activity-log. -
Stafflist AFK/Vanish Suffix — Added
stafflist-afk-suffixandstafflist-vanished-suffixto messages.yml, allowing status indicators to be displayed after player names (in addition to the existing prefix options). -
Chat Filter (Anti-Bad-Words) — Added a configurable chat filter in a dedicated
filter.ymlfile. Supports two modes:censor(replaces matched words with configurable replacements for Minecraft and Discord separately) andblock(prevents the message entirely). Supports plain word list with automatic word-boundary matching and raw regex patterns. Players with the bypass permission (zstaffchat.filter.bypass) skip filtering. -
Global Channel Toggle — Added
/zstaffchat toggle <channel>command to globally enable/disable channels. State persists toconfig.yml(survives restarts). Disabled channels block all messages (commands, chat prefixes, toggle mode) and show a configurablechannel-disabledmessage. Requireszstaffchat.togglepermission. Tab completion for channel IDs included. -
Grouped Stafflist Mode — Added
stafflist-modeconfig option (defaultorgrouped). Grouped mode displays rank as a title with players listed individually below, instead of comma-separated on one line. Fully customizable viastafflist-group-titleandstafflist-group-playerin messages.yml.
Improvements:
- Reduced config.yml size by ~250 lines (51% smaller) by moving Discord config to discord.yml
- Discord config now has its own version tracking (
discord-version) - Added /zscp command alias on all platforms
- Added
{prefix}placeholder support in all messages.yml messages — plugin prefix is no longer hardcoded, users can move or remove it from any message - Added Chat Filter status to startup message and
/zstaffchat aboutoutput on all platforms - Added Bridge Addon connection status to
/zstaffchat abouton proxy platforms (shows connected server names) - Added Discord bot name, owner, and server/guild name to
/zstaffchat aboutoutput (shows which bot is connected, who owns it, and to which Discord server) - Added
{server}and{server_alias}placeholder support in Discord bot and webhook message formats (text, embeds, footer, etc.) - Added
{server_alias}placeholder support in channel format (previously only{server}was available) - Empty
{server}placeholders now auto-clean surrounding brackets[]/()and double spaces - Removed dead code: unused methods, interface stubs, redundant logic across the codebase
Bug Fixes:
- Fixed hex colors ({#RRGGBB}) and gradients not working on BungeeCord — all commands and chat messages now use ColorUtil instead of ChatColor.translateAlternateColorCodes
- Fixed Kotlin compiler warnings: deprecated
description.version→pluginMeta.versionon Folia, unused event parameters on Velocity, redundant elvis operator in Folia AfkListener, unused parameter and redundant initializer in ConfigManager - Fixed
{server}placeholder not working in Discord bot/webhook messages (was missing from placeholder map) - Fixed player not seeing their own join/leave activity messages on proxy (BungeeCord/Velocity) — players without a backend server at login time were being skipped
- Fixed empty
{server}placeholder leaving extra spaces in channel format messages
ZStaffChatPro Folia 1.12.0
release4 февраля 2026 г.Major Update — New Features, Improvements & Bug Fixes
⚠ Delete your old config.yml and messages.yml before updating.
Server-side Bridge addon for ZStaffChatPro. Install on Spigot/Paper/Folia backends to enable cross-server vanish sync, AFK detection, and player activity tracking on BungeeCord/Velocity proxies.
Download Here https://cdn.modrinth.com/data/IsXrdhkA/versions/OIzUqGkw/ZStaffChat-SpigotAddon-0.0.1.jar
New Features
- Automatic Config Migration — The plugin now tracks config versions internally. When you update, outdated config.yml and messages.yml are automatically backed up (e.g. config.yml.v0.bak) and a fresh default is generated. No more manual config deletion needed.
- Customizable Help Message — /zstaffchat help output is now fully customizable in messages.yml (help-output, help-channel-format) with {channels} placeholder for dynamic channel list.
- In-Game Activity Log — Staff members now receive join/leave/server-change/vanish/AFK notifications directly in-game through the channel system. Configurable per-event toggles and customizable formats in the ingame-activity-log section of config.yml.
- /staffafk Command — Manual AFK toggle command on all platforms (zstaffchat.afk permission). Activity log messages route through the player's highest priority channel.
- Player Activity Bridging — Bridge addon now sends movement data (throttled to 30s per player) to the proxy, enabling accurate AFK detection on BungeeCord/Velocity.
- LuckPerms in Stafflist & Stafftime — {lp_prefix}, {lp_suffix}, {lp_group}, {lp_rank} placeholders now work in stafflist-player-format and stafftime-output on all platforms.
- Customizable Discord Embeds — Full embed support for both bot and webhook mode: custom colors, titles, descriptions, footers, thumbnails, author fields, and timestamps. Also available for activity log events with per-event colors.
- Discord Role Prefixes — Map Discord role IDs to custom in-game prefixes via role-prefixes config. New {discord_role} and {prefix} placeholders in format-to-minecraft.
- Bot Presence — Configure bot status (online/idle/dnd/invisible) and activity (playing/watching/listening/competing) in config.
- JDA 6.3.0 Upgrade — Upgraded Discord bot library from 5.0.0-beta.18 to 6.3.0 with all updated dependencies.
- Modrinth Update Checker — Update checker now uses Modrinth API. Redesigned console output with box-style formatting.
- Unified Startup Banner — All platforms now display a consistent startup message showing plugin version, platform, channel count, Discord status, playtime and AFK status.
- YAML Error Handling — User-friendly error messages when config.yml has syntax errors, instead of raw stack traces.
Improvements
- Migrated library loading to Libby 1.3.1 — no more Unsafe warnings
- Bridge addon: ping/pong mechanism for proxy connection confirmation
- Bridge addon: separate VanishListener to prevent ClassNotFoundException without PremiumVanish
- Bridge addon: idle threshold for faster AFK cancellation on proxy
- Reorganized messages.yml with section headers, detailed placeholder docs, and usage examples
- Graceful JDA shutdown — no more zip file closed errors when stopping the server
Bug Fixes
- Fixed jackson-annotations version mismatch causing potential runtime errors
- Fixed JDA shutdown race condition causing IllegalStateException on server stop
- Removed unused dead code from Bungee/Velocity platforms
ZStaffChatPro 1.12.0
release4 февраля 2026 г.Major Update — New Features, Improvements & Bug Fixes
⚠ Delete your old config.yml and messages.yml before updating.
Server-side Bridge addon for ZStaffChatPro. Install on Spigot/Paper/Folia backends to enable cross-server vanish sync, AFK detection, and player activity tracking on BungeeCord/Velocity proxies.
Download Here https://cdn.modrinth.com/data/IsXrdhkA/versions/OIzUqGkw/ZStaffChat-SpigotAddon-0.0.1.jar
New Features
- Automatic Config Migration — The plugin now tracks config versions internally. When you update, outdated config.yml and messages.yml are automatically backed up (e.g. config.yml.v0.bak) and a fresh default is generated. No more manual config deletion needed.
- Customizable Help Message — /zstaffchat help output is now fully customizable in messages.yml (help-output, help-channel-format) with {channels} placeholder for dynamic channel list.
- In-Game Activity Log — Staff members now receive join/leave/server-change/vanish/AFK notifications directly in-game through the channel system. Configurable per-event toggles and customizable formats in the ingame-activity-log section of config.yml.
- /staffafk Command — Manual AFK toggle command on all platforms (zstaffchat.afk permission). Activity log messages route through the player's highest priority channel.
- Player Activity Bridging — Bridge addon now sends movement data (throttled to 30s per player) to the proxy, enabling accurate AFK detection on BungeeCord/Velocity.
- LuckPerms in Stafflist & Stafftime — {lp_prefix}, {lp_suffix}, {lp_group}, {lp_rank} placeholders now work in stafflist-player-format and stafftime-output on all platforms.
- Customizable Discord Embeds — Full embed support for both bot and webhook mode: custom colors, titles, descriptions, footers, thumbnails, author fields, and timestamps. Also available for activity log events with per-event colors.
- Discord Role Prefixes — Map Discord role IDs to custom in-game prefixes via role-prefixes config. New {discord_role} and {prefix} placeholders in format-to-minecraft.
- Bot Presence — Configure bot status (online/idle/dnd/invisible) and activity (playing/watching/listening/competing) in config.
- JDA 6.3.0 Upgrade — Upgraded Discord bot library from 5.0.0-beta.18 to 6.3.0 with all updated dependencies.
- Modrinth Update Checker — Update checker now uses Modrinth API. Redesigned console output with box-style formatting.
- Unified Startup Banner — All platforms now display a consistent startup message showing plugin version, platform, channel count, Discord status, playtime and AFK status.
- YAML Error Handling — User-friendly error messages when config.yml has syntax errors, instead of raw stack traces.
Improvements
- Migrated library loading to Libby 1.3.1 — no more Unsafe warnings
- Bridge addon: ping/pong mechanism for proxy connection confirmation
- Bridge addon: separate VanishListener to prevent ClassNotFoundException without PremiumVanish
- Bridge addon: idle threshold for faster AFK cancellation on proxy
- Reorganized messages.yml with section headers, detailed placeholder docs, and usage examples
- Graceful JDA shutdown — no more zip file closed errors when stopping the server
Bug Fixes
- Fixed jackson-annotations version mismatch causing potential runtime errors
- Fixed JDA shutdown race condition causing IllegalStateException on server stop
- Removed unused dead code from Bungee/Velocity platforms
ZStaffChatPro Folia 1.7.1
release14 января 2026 г.v1.7.1 - Stafflist Vanish Fix
Bug Fixes
- Stafflist Vanish Visibility - Now uses PremiumVanish/SuperVanish native
canSeeAPI instead of permission check
What Changed
- Previously, /stafflist used
zstaffchat.see-vanishedpermission to determine who can see vanished players - Now it respects PremiumVanish's own visibility logic (vanish levels, see permissions, etc.)
- Console can always see all players
Note: The zstaffchat.see-vanished permission is no longer used for /stafflist when PremiumVanish is installed.
Important: If you prefer the old permission-based behavior, stay on version 1.7.0.
