Changelog
Replace the jar and restart. Your config is kept as it is.
- A developer API, so other plugins can work with zChat: a punishment plugin can mute players in chat and private messages and show its own reason, other plugins can send announcements in zChat’s style (skipping players who hid chat), add their own placeholders to chat formats, and listen for chat messages (before other plugins have their say, and once they’re sent), filter catches, private messages and mentions. See Developer API. It costs nothing unless a plugin uses it: chat takes the same time per message as before.
/zchat reloadworks on an empty server. Paper pauses a server that’s been empty for a minute, and the reload waited for the next player to join.
Replace the jar and restart. Your config is kept as it is.
- Chat keeps what another plugin added to a message before zChat, like an
[item]tag with its hover or a custom emoji. Before, zChat rebuilt the message from its plain text and those were lost. The filter still checks the words; if it censors any, the message is shown as plain text, as before.
Replace the jar and restart. Your config is kept as it is.
- The smart filter catches a word split into pieces of one or two letters, like
ba dw or d. Before, only pieces of one letter (b a d w o r d) were caught. The pieces have to make a whole filter word together, so ordinary short words aren’t censored, and words with a*aren’t looked for this way. - A player who vanishes just as someone mentions them is never pinged. The check for whether the sender can see them now happens again on the main thread, right before the ping.
Replace the jar and restart. Your config is kept, with the new filter.command settings added.
/filtermanages the chat filter in game:/filter add <word>,/filter remove <word>,/filter list, and/filter test <message>to see what the filter would do. Changes are saved toconfig.yml, comments kept, and apply at once. Staff only (zchat.command.filter).
Changed
Section titled “Changed”- The colon in private messages is easier to see: the default formats use
<gray>for it instead of<dark_gray>, which barely showed against chat’s background. New configs get it; to update yours, change<dark_gray>:</dark_gray>to<gray>:</gray>inprivate-messages.msg.format-sentandformat-received. - Chat formats with PlaceholderAPI placeholders do a little less work on every message, and notice PlaceholderAPI being enabled or disabled after zChat.
- Only players allowed Minecraft’s selectors (
minecraft.command.selector, operators by default) can use them in/msg. Before, any player could message everyone with/msg @a, or run a costly@e[...]search. - Turning
/mutechatoff while chat is muted now unmutes it. Before, chat stayed muted until a restart, with no command left to undo it. - A player’s chat state is always cleared when they leave, even when their last message or private message was still being sent as they quit.
- A config file that can’t be saved back (a read-only folder, or a mounted volume that can’t replace files in one step) no longer loses your settings: they’re used as written, with a warning, and backups don’t pile up on every start.
- Clicking the link in the update notice now opens the new version’s Modrinth page. Before, it opened nothing.
A rewrite. Replace the jar and restart: your zChat 2 config is carried forward, and the old file is kept as config.yml.bak-v1. A zChat 1.x config can’t be carried forward: it’s kept as config.yml.old, and a fresh config is written.
Needs Paper 1.21.11 or newer (Purpur and Folia too) and Java 21. zChat 2 ran on 1.20.6 and newer.
Everything applies on reload
Section titled “Everything applies on reload”/zchat reloadnow applies every setting. Turning a command on or off, its aliases and permission no longer need a restart. The mute, hidden chat and reply targets last through it.- A config file that isn’t valid YAML no longer loses your settings: zChat says where the error is and keeps running with the settings it had (or the defaults, at startup) until it’s fixed.
/zchat reloadsays how many settings fell back to their defaults, and/zchat infoshows which commands are on, whether an update is out, and any config problems./zcis short for/zchat.
- A smarter filter.
wordsare matched as whole words, so innocent words like class are left alone, and withsmart: true(the default) the filter also catches s p a c e d, b4dw0rd, baaadword, bädword, full-width letters and invisible characters. It censors exactly what was typed. Colour tags can’t hide a word from it.patternsstill take regular expressions. - Anti-repeat: stops a player sending the same, or nearly the same, message again within 30 seconds.
- Mentions: a player’s name in chat is highlighted and pings them.
@everyonefor players withzchat.mention.everyone. - Private messages:
/msg(replacing Minecraft’s/msg,/telland/w, selectors included on Paper),/replyand/socialspy. The filter applies to them. /togglechatremembers a player’s choice when they rejoin (togglechat.remember).- A
themeat the top of the config: a prefix and four colours zChat’s own messages use. If you never changed a zChat 2 message, it gets the new look; any you changed are kept. - An update checker, and bStats anonymous usage statistics. See Privacy for exactly what each sends, and how to turn them off.
Changed
Section titled “Changed”- The
zchat.group.*permissions no longer go to operators by default. Give your ranks their group permission; an operator no longer gets the admin format just for being an operator. - PlaceholderAPI values now go into a format as text, after it’s read, so a placeholder showing something a player chose, such as a nickname, can’t add clickable links or hover text to chat.
%placeholders%in formats work as before. <displayname>keeps a nickname’s colours but not its clicks or hovers.- Mentions ping, and messages count toward the cooldown and anti-repeat, only once no other plugin has cancelled them.
/clearchatsends its blank lines as one message rather than one per line.- The example
filter.patternsare now examplewords. If you still had zChat 2’sbadword1andbadword2patterns, they’re replaced; your own patterns are kept. - Each chat line is drawn once and the same line sent to everyone who sees it.
cooldown.secondscan have decimals.- Players you can’t see count as offline for
/msgand tab completion, so vanished staff stay hidden.