MessagesPlus

MessagesPlus

A comprehensive chat and messaging plugin for Hytale servers, designed to enhance player communication and server announcements completely customizable via JSON.

Features

Custom Chat Formatting: Configure chat formats based on permissions (groups) with priority support.

Join & Leave Messages: Customizable join, first-join, and leave messages. Suppresses default server join messages so only yours are seen.

Scheduled Announcements: Set up automated broadcast messages with configurable intervals.

Hex Color Support: Full support for RGB Hex colors (&#RRGGBB) and legacy codes (&a, &l).

Rich Text Styling: Supports Bold (&l), Italic (&o), Underline (&n), Strikethrough (&m), and Obfuscated (&k).

Reloadable: Reload configurations on-the-fly without restarting the server.

Placeholders: Built-in placeholder support for dynamic messages.

Installation

Manual Installation

Download: Get the latest MessagesPlus-x.x.x.jar from the Releases page.

Install: Drop the JAR file into your Hytale server's mods (or plugins) directory.

Run: Start your server. The default configuration files will be generated in the plugin's data directory.

Commands

Main Command

Aliases: /messagesplus or /mp

Subcommands

1. General

/mp reload: Reloads all configuration files (welcome-leave.json, chat-format.json, scheduled.json) immediately.

2. Scheduling

Manage automated broadcast messages directly from in-game or console.

/mp schedule list: Lists all active scheduled messages with their IDs and intervals.

/mp schedule add <interval_seconds> <message>: Adds a new scheduled message. Example: /mp schedule add 300 &aDon't forget to join our Discord!

Note: Intervals are in seconds.

/mp schedule remove <id>: Removes a scheduled message by its ID (found in /mp schedule list).

Configuration

The plugin generates the following configuration files in its data folder:

1. chat-format.json

Defines chat formats based on permissions. The plugin checks formatting rules from top to bottom. The first rule for which the player has the permission will be applied.

{ "owner": { "format": "&8[&cOwner&8] &c%playername%&8: &f%message%", "permission": "messagesplus.owner" }, "admin": { "format": "&8[&cAdmin&8] &c%playername%&8: &f%message%", "permission": "messagesplus.admin" }, "default": { "format": "&7%playername%: &7%message%" } }

Tip: Place higher priority groups (like Owner/Admin) at the top of the file.

2. welcome-leave.json

Configures messages for player connection events.

{ "first_join_message": "&eWelcome &b%playername%&e to the server for the first time!", "join_message": "&e%playername% &ejoined the game.", "leave_message": "&e%playername% &eleft the game.", "debug": false }

first_join_message: Broadcast only when a player joins for the very first time.

join_message: Broadcast for returning players.

leave_message: Broadcast when a player disconnects.

3. scheduled.json

Stores the scheduled announcements. While you can edit this manually, we recommend using the /mp schedule commands.

{ "messages": [ { "id": 1, "interval": 300, "text": "&aCheck out our website at example.com!", "lastSent": 123456789 } ] } Placeholders

You can use these placeholders in chat formats, join/leave messages, and broadcasts:

Placeholder Description

%playername% The player's username.

%uuid% The player's unique ID.

%world% The name of the world the player is currently in.

%message% The chat message content (Chat Formats only).

%health% (Coming Soon) The player's health.

Color Codes

Legacy Colors

Standard Minecraft-style color codes using &.

&0 Black, &1 Dark Blue, &2 Dark Green, &3 Dark Aqua

&4 Dark Red, &5 Dark Purple, &6 Gold, &7 Gray

&8 Dark Gray, &9 Blue, &a Green, &b Aqua

&c Red, &d Light Purple, &e Yellow, &f White

Formatting

&l Bold

&o Italic

&n Underline

&m Strikethrough

&k Obfuscated

Hex Colors

Use modern RGB hex codes for precise colors.

Format: &#RRGGBB

Example: &#FF5555This is a custom red!

License

MIT License