TinyMsg

A lightweight, powerful rich text parser for Hytale servers.

TinyMsg allows you to use simple tags to create gradients, hex colors, clickable links, and nested styles in Hytale chat messages, similar to Minecraft's MiniMessage.

Features

Gradients: <gradient:red:blue>Hello</gradient> or multi-color <gradient:gold:red:black>...
Hex Colors: <color:#FF55FF>Custom Colors</color> or <color:red>Named Colors</color>
Standard Styles: Bold, Italic, Underline, <mono>Monospace</mono>
Clickable Links: <link:https://google.com>Click me!</link>
Nested Styling: Tags can be nested indefinitely.

Installation for server owners:

Download the TinyMessage.jar

Download the latest TinyMessage.jar from the releases page and place it in your server's mods folder.

Installation for developers:

Temporary until hytale plugin repository is available.
Create libs folder in your plugin directory and place the TinyMsg jar file there.
project/libs/TinyMessage-2.0.1-SNAPSHOT.jar

manifest.json

"Dependencies": {
  "Zoltus:TinyMessage": "*"
},

For Gradle

repositories {
    maven { url = uri("https://jitpack.io") }
}

dependencies {
    compileOnly("com.github.Zoltus:TinyMessage:2.0.1")
}

For Maven

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.Zoltus</groupId>
    <artifactId>TinyMessage</artifactId>
    <version>2.0.1</version>
    <scope>provided</scope>
</dependency>

Usage

Basic Example

import fi.sulku.hytale.TinyMsg;
import com.hypixel.hytale.server.core.Message;

// Parse a formatted string into a Message
Message message = TinyMsg.parse("<gradient:red:blue>Hello World!</gradient>");

player.sendMessage(message);

// Multiple styles
TinyMsg.parse("<b><color:gold>Bold Gold Text</color></b>");

TinyMsg.parse("<link:https://example.com><gradient:aqua:blue>Click me!</gradient></link>");

// Complex nested styling
TinyMsg.parse("<b>Bold <i>and italic <color:red>and red</color></i></b>");

// Reset styles mid-text
TinyMsg.parse("<b>Bold <reset>normal text");

API Reference

`TinyMsg.parse(String text)`

Parses a string with TinyMsg tags and returns a Message object.

Parameters:

text - The string to parse

Returns:

Message - A Hytale Message object ready to be sent to players

Supported Tags

Tag	Aliases	Example	Description
`<color:X>`	`<c:X>`, `<colour:X>`	`<color:red>text</color>`	Sets text color (named or hex)
`<gradient:X:Y:Z>`	`<grnt:X:Y:Z>`	`<gradient:red:blue>text</gradient>`	Creates a color gradient
`<bold>`	`<b>`	`<b>text</b>`	Makes text bold
`<italic>`	`<i>`, `<em>`	`<i>text</i>`	Makes text italic
`<underline>`	`<u>`	`<u>text</u>`	Underlines text
`<monospace>`	`<mono>`	`<mono>text</mono>`	Uses monospace font
`<link:URL>`	`<url:link>`	`<link:https://google.com>click</link>`	Creates clickable link
`<reset>`	`<r>`	`<b>bold<reset>normal`	Resets all formatting

Named Colors

black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white

License

MIT License - feel free to use in your projects!

TinyMessage