MessagesPlus

![Discord](https://img.shields.io/badge/Discord-Join Us-7289da?logo=discord&logoColor=white)

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

Official Partners

We are partnered with Kinetic Host who help support the continuous development of this mod. Truly, a great host with really good prices and support.

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