Werchat

Channel-based chat system for Hytale servers. Multiple channels, quick-chat routing, private messaging, nicknames, and moderation — all in one plugin.

Discord

Features

Channel System — Multiple channels with custom colors, nicknames, distance-based and world-restricted delivery.

Quick Chat — Prefix symbols to route messages to any channel without switching. ! for Global, ~ for Trade.

Private Messaging — /msg and /r with reply tracking, ignore lists, and offline detection.

Player Nicknames — Custom display names up to 20 characters with hex colors and two-color gradients.

Mention System — @player highlighting with configurable color and bold formatting.

Moderation Tools — Per-channel ban, mute, moderators, word filter (censor/block modes), and chat cooldown.

Permission Integration — HyperPerms and LuckPerms prefix/suffix support with hex color codes.

PlaceholderAPI Integration — Supports external %...% placeholders in channel format text and includes a built-in %werchat_*% expansion.

Plugin API — Exposes a lightweight WerchatAPI for other plugins to query channels, manage membership/focus, and submit chat through Werchat's pipeline.

Message Colors — Independent message text colors and gradients, separate from nickname colors.

Persistent Storage — JSON-based data with dirty + debounced saves (20s) and a final flush on shutdown.

Quick Start

1. Drop Werchat-1.1.9.jar in your mods/ folder
2. Start your server — four default channels are created automatically
3. Use /ch list to see channels, /ch join <channel> to join one
4. Type !hello to quick-chat in Global or ~hello for Trade

/ch list                    # List all channels
/ch global                  # Switch to Global channel
/ch join trade              # Join the Trade channel
/msg Steve Hey!             # Send a private message
/ch playernick CoolName     # Set your nickname

Default Channels

Commands

Player Commands

Messaging Commands

Admin / Moderator Commands

Channel moderators can use admin commands on their own channels without needing global permission nodes.

Players with werchat.* or * also bypass cooldowns and the word filter.

Per-channel permission nodes:

• werchat.channel.<channel>.join
• werchat.channel.<channel>.speak
• werchat.channel.<channel>.read (primary receive/read node)

These nodes are enforced in normal /ch + chat flow only when channelPermissions.enforce is enabled.  

Configuration

Config file: mods/com.werchat_Werchat/config.json

 View full config 

{
  "defaultChannelName": "Global",
  "autoJoinDefault": true,
  "showJoinLeaveMessages": true,
  "allowPrivateMessages": true,
  "channelPermissions": {
    "enforce": false
  },
  "banMessage": "You have been banned from {channel}",
  "muteMessage": "You have been muted in {channel}",
  "wordFilter": {
    "enabled": false,
    "mode": "censor",
    "replacement": "***",
    "notifyPlayer": true,
    "warningMessage": "Your message contained inappropriate language.",
    "words": ["..."]
  },
  "cooldown": {
    "enabled": false,
    "seconds": 3,
    "message": "Please wait {seconds}s before sending another message.",
    "bypassPermission": "werchat.cooldown.bypass"
  },
  "mentions": {
    "enabled": true,
    "color": "#FFFF55"
  },
  "ignoreChatCancellations": false
}

When channelPermissions.enforce is enabled:

• join checks run in /ch join and /ch <channel> auto-join.
• speak checks run before sending messages.
• read checks run for sender selection and per-recipient delivery.
• Password checks still apply; permission nodes never bypass channel passwords.  

Channel Format Placeholders

Custom channel message formats support these placeholders:

Default format: {nick} {sender}: {msg}

Format literals also support PlaceholderAPI placeholders when PlaceholderAPI is installed.

Werchat also registers a built-in PlaceholderAPI expansion with identifier werchat. You can find all possible ones in the Github ReadMe

Links

• Discord — Support & community
• Issues — Bug reports & features
• Releases — Downloads

Part of the HyperSystems suite: HyperPerms | HyperHomes | HyperFactions | Werchat