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

1. Download: Get the latest MessagesPlus-x.x.x.jar from the Releases page.
2. Install: Drop the JAR file into your Hytale server's mods (or plugins) directory.
3. 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