Chat Interactions Plugin

Chat plugin for Hytale featuring Global/Local chat, private messaging, admin tools, a configurable local chat radius, an optional chat lockdown mode (allowlist), and a configurable periodic chat-mode warning.

Requirements (Dependencies)

ChatInteractions has no required dependencies to run.
TinyMessage / TinyMsg (Optional) If installed, it enables better colors and formatting in chat. Just drop tinymessage-*.jar into mods/.

Features

Global and Local chat channels
Local chat filtered by distance radius (same world)
Private messages with /msg (message is fully pink). Private messages can be disabled via /chatdisable msg.
Admin command to clear the chat (Global + Local)
Admin command to inspect/debug chat variables (mode, locks, admin/op, warning, ping)
Admin-only local radius setting (persists after restart)
Per-channel chat disable: /chatdisable global|local|msg (alias: /cdb)
Chat Admin allowlist: only ChatAdmins can talk while chat is disabled; they can also use /chatdisable and /chatwarning (even without admin/op)
Periodic chat-mode warning (per-player):
- Sends a private reminder telling the player whether they are in LOCAL or GLOBAL
- Fully colored when TinyMessage/TinyMsg is installed
- Clean plain-text fallback when TinyMessage is not present
- Configurable interval (or disabled) via /chatwarning / /cw
Optional TinyMessage/TinyMsg support for better colors/formatting

Installation

Build the plugin and get the generated .jar.
Move the plugin .jar to:
- mods/
(Optional, recommended) Install TinyMessage/TinyMsg:
- Move tinymessage-*.jar to mods/
Restart the server.

With TinyMessage/TinyMsg installed, chat colors and formatting look better.

How It Works

When a player joins, their default chat channel is Local.

Local chat is only delivered to players:
- in the same world
- within the configured radius (in blocks)

When chat is disabled via /chatdisable global|local|msg (alias: /cdb), only ChatAdmins can send messages for that channel (Global/Local/Msg).
/chatdisable msg blocks only private messages (/msg).
Important security note: /chatdisable (/cdb) requires Admin/Op (console allowed). ChatAdmins can also execute it without admin/op.
Periodic chat warning (optional):
- Each player can receive a private reminder message every X minutes.
- ChatAdmins can change the interval or disable it using /cw <minutes> even without admin/op. Admins/Ops can also execute it.

]

"Mini" Tutorial

Commands

Everyone (no permission required)

/g
- Switches you to the Global chat channel.
/l
- Switches you to the Local chat channel (distance-based).
/msg <player> <message...>
- Sends a private message to another player (fully pink).
- Example: /msg player2 hi how are you?

Staff commands (Admin/Op; console allowed)

All commands below require Admin/Op unless noted. ChatAdmins can also use /chatdisable and /chatwarning even without admin/op.

/localradius <number>
- Admin/Op only.
- Sets the Local chat radius in blocks.
- Default is 50.
- This value is saved/persistent after restart.
- Example: /localradius 80
/clearchat
- Admin/Op only.
- Clears the game chat for all online players (Global + Local).
- Alias: /cc
/chatdebug
- Displays debug information / variables related to the server chat (useful for verifying current settings/state).
- Alias: /cdg
/chatdisable global|local|msg
- Toggles chat lockdown per channel (Global, Local, or private messages).
- Usable by Admin/Op or ChatAdmin.
- Alias: /cdb
- Examples: /chatdisable global, /chatdisable local, /chatdisable msg
/chatadmin
- Admin/Op only (console allowed).
- Manages the Chat Admin allowlist (players who can talk while chat is disabled).
- Variants:
- /chatadmin add (<Player> or <UUID>)
- Adds chat-admin permission to the chosen player (allow to talk even if chat is disabled).
- Example: /chatadmin add PlayerName
- Example: /chatadmin add 123e4567-e89b-12d3-a456-426614174000
- /chatadmin remove (<Player> or <UUID>)
- Removes chat-admin permission from the chosen player.
- /chatadmin list
- Lists all players (and their UUIDs) who currently have chat-admin permission.
/chatwarning <minutes>
- Executable by Admin/Op and ChatAdmins (chatadmins do not need admin/op).
- Configures the periodic chat-mode warning (private reminder).
- <minutes> is the interval in minutes.
- Use 0 to disable the warning.
- Alias: /cw
- Examples:
- /cw 5 (send every 5 minutes)
- /cw 0 (disable)

Permissions / Access

This plugin uses these access levels:

Everyone (permission zero):
- /g, /l, /msg
Admin/Op (and console):
- Required for all other commands
ChatAdmin (allowlist):
- Can use /chatdisable (/cdb) and /chatwarning (/cw) even without admin/op
- Only ChatAdmins can talk when chat is disabled

Additionally:

Chat Admin (allowlist) is managed via /chatadmin add/remove/list.

Persistence (Local Radius / Chat Admins / Warning Interval)

Settings are saved to a config file and persist after a restart.

Default fallback path: ./plugins/com.example_ChatInteractions/localglobalchat.properties

Stored keys example:

localRadius=50
chatAdmins=<uuid1>,<uuid2>,...
chatWarningMinutes=5

Notes

Local chat filtering:
- Same world
- Distance ≤ configured radius
The plugin automatically uses TinyMsg if installed (otherwise clean plain text is used).