promotional bannermobile promotional banner
premium banner

Chat Interactions Plugin

Various commands and interactions with the chat

Description

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

  1. Build the plugin and get the generated .jar.

  2. Move the plugin .jar to:

    • mods/

  3. (Optional, recommended) Install TinyMessage/TinyMsg:

    • Move tinymessage-*.jar to mods/

  4. 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.

image

  • Local chat is only delivered to players:

    • in the same world
    • within the configured radius (in blocks)

image

image

  • 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

image

image

image

image

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).