ZStaffChatPro 1.16.1 - Changelog

Configuration Overhaul

• Complete config rewrite - All 4 config files (config.yml, messages.yml, discord.yml, filter.yml) rewritten in my style formatting with clear section headers and detailed per-option comments
• Removed global mode - staff-chat-global and global-channel removed. Users who want a single channel simply keep one channel in the channels section
• Removed features.chat-prefixes - Chat prefix is now controlled per-channel via chat-prefix: "!" (set to "" to disable)
• Proxy settings grouped - disabled-servers and server-aliases moved under proxy: section
• New prefix style - Default prefix changed to &8(&cZStaffChatPro&8) &f with white message text
• Cleaner messages - All messages use {prefix} consistently, enabled/disabled states shown in green/red
• Help/About redesigned - Clean indented style with version display, no more &m--- separators

New Features

• {server_previous} placeholder - Shows the display name of the previous server in server-change events
• {server_raw_previous} placeholder - Shows the raw name of the previous server
• {server_raw} placeholder - Renamed from {server} for clarity
• "server" stafflist mode - New display mode that groups players by their backend server within each channel (proxy only)
• {version} placeholder in help - Help command now shows plugin version
• PlaceholderUtil - New centralized placeholder system. Adding a new placeholder is now a single line of code

Bug Fixes

• Fixed signed chat kick (1.19.1+) - Chat prefixes (!hello) and toggle mode no longer disconnect players on Velocity/BungeeCord. Uses Bridge plugin messaging to cancel chat on backend instead of proxy-side denied()
• Fixed "Unknown command" on missing permission - All commands (zscp, stafflist, staffspy, stafftime, staffafk, channel commands) now show proper no-permission message instead of vanilla "Unknown or incomplete command"
• Fixed empty brackets in activity log - Cleanup regex now handles color codes inside brackets (e.g. &8(&b&8) properly cleaned)
• Fixed duplicate AFK messages - isAfk() no longer has side effects. AFK detection moved to periodic checkAfkStatus() task (every 10s)
• Fixed activity log server name - Activity log now passes server name to channel format, so ({server_alias}) in channel format works correctly

Improvements

• Bridge handshake - Proxy now initiates the handshake (sends PING when player connects to backend). No more waiting for backend to send first PING
• Bridge signed chat cancel - New TYPE_CANCEL_CHAT message type allows proxy to tell backend Bridge to cancel a chat message (for chat prefixes on 1.19.1+)
• Placeholder refactor - LuckPerms placeholders renamed from {lp_*} to {luckperms_*} for consistency
• Reduced AFK throttle - Bridge activity throttle reduced from 30s to 10s, idle threshold from 5s to 3s for faster AFK detection
• Movement listener on Spigot/Folia - Added PlayerMoveEvent listener for standalone setups (previously only tracked via chat)
• Removed bStats global_mode chart - No longer needed after removing global mode

Code Quality

• PlaceholderUtil - Centralized placeholder resolution with resolve(), buildLuckPermsPlaceholders(), buildServerPlaceholders(), cleanEmptyBrackets()
• Simplified platform code - Removed global mode branching from all 4 platform files, ChannelManager, ConfigManager
• Consistent permission handling - All commands check permissions in execute() instead of relying on platform-level permission gates

Breaking Changes

• Config version bumped (auto-backup + regenerate for existing users)
• {server} renamed to {server_raw}
• {lp_prefix} etc. renamed to {luckperms_prefix} etc.
• staff-chat-global / global-channel removed
• features.chat-prefixes removed
• ingame-activity-log.sender-name removed
• disabled-servers / server-aliases moved under proxy:

ZStaffChatPro 1.16.1 - Changelog

Configuration Overhaul

• Complete config rewrite - All 4 config files (config.yml, messages.yml, discord.yml, filter.yml) rewritten in my style formatting with clear section headers and detailed per-option comments
• Removed global mode - staff-chat-global and global-channel removed. Users who want a single channel simply keep one channel in the channels section
• Removed features.chat-prefixes - Chat prefix is now controlled per-channel via chat-prefix: "!" (set to "" to disable)
• Proxy settings grouped - disabled-servers and server-aliases moved under proxy: section
• New prefix style - Default prefix changed to &8(&cZStaffChatPro&8) &f with white message text
• Cleaner messages - All messages use {prefix} consistently, enabled/disabled states shown in green/red
• Help/About redesigned - Clean indented style with version display, no more &m--- separators

New Features

• {server_previous} placeholder - Shows the display name of the previous server in server-change events
• {server_raw_previous} placeholder - Shows the raw name of the previous server
• {server_raw} placeholder - Renamed from {server} for clarity
• "server" stafflist mode - New display mode that groups players by their backend server within each channel (proxy only)
• {version} placeholder in help - Help command now shows plugin version
• PlaceholderUtil - New centralized placeholder system. Adding a new placeholder is now a single line of code

Bug Fixes

• Fixed signed chat kick (1.19.1+) - Chat prefixes (!hello) and toggle mode no longer disconnect players on Velocity/BungeeCord. Uses Bridge plugin messaging to cancel chat on backend instead of proxy-side denied()
• Fixed "Unknown command" on missing permission - All commands (zscp, stafflist, staffspy, stafftime, staffafk, channel commands) now show proper no-permission message instead of vanilla "Unknown or incomplete command"
• Fixed empty brackets in activity log - Cleanup regex now handles color codes inside brackets (e.g. &8(&b&8) properly cleaned)
• Fixed duplicate AFK messages - isAfk() no longer has side effects. AFK detection moved to periodic checkAfkStatus() task (every 10s)
• Fixed activity log server name - Activity log now passes server name to channel format, so ({server_alias}) in channel format works correctly

Improvements

• Bridge handshake - Proxy now initiates the handshake (sends PING when player connects to backend). No more waiting for backend to send first PING
• Bridge signed chat cancel - New TYPE_CANCEL_CHAT message type allows proxy to tell backend Bridge to cancel a chat message (for chat prefixes on 1.19.1+)
• Placeholder refactor - LuckPerms placeholders renamed from {lp_*} to {luckperms_*} for consistency
• Reduced AFK throttle - Bridge activity throttle reduced from 30s to 10s, idle threshold from 5s to 3s for faster AFK detection
• Movement listener on Spigot/Folia - Added PlayerMoveEvent listener for standalone setups (previously only tracked via chat)
• Removed bStats global_mode chart - No longer needed after removing global mode

Code Quality

• PlaceholderUtil - Centralized placeholder resolution with resolve(), buildLuckPermsPlaceholders(), buildServerPlaceholders(), cleanEmptyBrackets()
• Simplified platform code - Removed global mode branching from all 4 platform files, ChannelManager, ConfigManager
• Consistent permission handling - All commands check permissions in execute() instead of relying on platform-level permission gates

Breaking Changes

• Config version bumped (auto-backup + regenerate for existing users)
• {server} renamed to {server_raw}
• {lp_prefix} etc. renamed to {luckperms_prefix} etc.
• staff-chat-global / global-channel removed
• features.chat-prefixes removed
• ingame-activity-log.sender-name removed
• disabled-servers / server-aliases moved under proxy:

Bug Fixes:

• Fixed LuckPerms prefix/suffix hex colors (&#RRGGBB format) not rendering — showed raw text like #FF0000Nickname instead of colored text. Added &#RRGGBB / §#RRGGBB format support to ColorUtil.

Bug Fixes:

• Fixed LuckPerms prefix/suffix hex colors (&#RRGGBB format) not rendering — showed raw text like #FF0000Nickname instead of colored text. Added &#RRGGBB / §#RRGGBB format support to ColorUtil.

New Features:

• Separate Discord Config — Discord configuration has been moved from config.yml to a dedicated discord.yml file for better organization. The new file has 4 clear top-level sections: webhook, webhook-activity-log, bot, and bot-activity-log.

• Stafflist AFK/Vanish Suffix — Added stafflist-afk-suffix and stafflist-vanished-suffix to 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.yml file. Supports two modes: censor (replaces matched words with configurable replacements for Minecraft and Discord separately) and block (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 to config.yml (survives restarts). Disabled channels block all messages (commands, chat prefixes, toggle mode) and show a configurable channel-disabled message. Requires zstaffchat.toggle permission. Tab completion for channel IDs included.

• Grouped Stafflist Mode — Added stafflist-mode config option (default or grouped). Grouped mode displays rank as a title with players listed individually below, instead of comma-separated on one line. Fully customizable via stafflist-group-title and stafflist-group-player in 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 about output on all platforms
• Added Bridge Addon connection status to /zstaffchat about on proxy platforms (shows connected server names)
• Added Discord bot name, owner, and server/guild name to /zstaffchat about output (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.version on 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