EtherTitle

EtherTitle is a Hytale server plugin that allows administrators to create, manage, and display custom title messages to players. Titles appear in the center of the player's screen, similar to achievement notifications or event announcements.

Features

Create multiple named title configurations

Set custom main title and subtitle text

Display titles to all connected players

Persistent storage using JSON

Simple command-based interface

Installation

Place the plugin JAR file in your server's mods folder

Start or restart your Hytale server

The plugin will automatically create a mods/EtherTitle directory

A titles.json file will be generated with default examples

Commands

Main Command

/ethertitle

Displays the help menu with all available subcommands.

Create a Title

/ethertitle create <name>

Creates a new empty title configuration with the specified name.

Example:

/ethertitle create hola

Output:

Title 'hola' created successfully! Now you can configure it: /ethertitle addtitle hola <text> /ethertitle addsubtitle hola <text>

Add Main Title Text

/ethertitle addtitle <name> <text>

Sets the main title text (large text displayed in the center).

Example:

/ethertitle addtitle hola Welcome!

Output:

Main title added to 'hola' Preview: Welcome!

Add Subtitle Text

/ethertitle addsubtitle <name> <text>

Sets the subtitle text (smaller text displayed below the main title).

Example:

/ethertitle addsubtitle hola Enjoy your stay

Output:

Subtitle added to 'hola' Preview: Enjoy your stay

Show Title to Players

/ethertitle show <name>

Displays the configured title to all online players.

Example:

/ethertitle show hola

Output:

Title 'hola' shown!

What players see:

Main title: "Welcome!" (large text, center screen)

Subtitle: "Enjoy your stay" (smaller text below)

Default timing: 0.5s fade in, 3.5s display, 1s fade out

List All Titles

/ethertitle list

Shows all created title configurations.

Example Output:

=========================== Titles (2) ===========================

> hola Title: Welcome! Subtitle: Enjoy your stay

> welcome Title: WELCOME! Subtitle: Enjoy your stay on the server ===========================

Delete a Title

/ethertitle delete <name>

Removes a title configuration permanently.

Example:

/ethertitle delete hola

Output:

Title 'hola' deleted!

Reload Titles

/ethertitle reload

Reloads all titles from the titles.json file.

Example Output:

Titles reloaded! Total: 2 titles

Complete Usage Example

Here's a step-by-step example creating a title named "hola":

# Step 1: Create the title configuration /ethertitle create hola # Output: Title 'hola' created successfully!

# Step 2: Set the main title text /ethertitle addtitle hola Welcome to the Server! # Output: Main title added to 'hola' # Output: Preview: Welcome to the Server!

# Step 3: Set the subtitle text /ethertitle addsubtitle hola Have fun and enjoy your adventure # Output: Subtitle added to 'hola' # Output: Preview: Have fun and enjoy your adventure

# Step 4: Display the title to all players /ethertitle show hola # Output: Title 'hola' shown! # All online players will see the title on their screen

# Step 5: Verify it was created /ethertitle list # Output shows: # > hola # Title: Welcome to the Server! # Subtitle: Have fun and enjoy your adventure

Data Storage

File Location

mods/EtherTitle/titles.json

JSON Structure

{ "hola": { "title": "Welcome to the Server!", "subtitle": "Have fun and enjoy your adventure", "fadeIn": 10, "stay": 70, "fadeOut": 20 }, "welcome": { "title": "WELCOME!", "subtitle": "Enjoy your stay on the server", "fadeIn": 10, "stay": 70, "fadeOut": 20 } }

Timing Values

fadeIn: Ticks for fade-in animation (10 ticks = 0.5 seconds)

stay: Ticks to display the title (70 ticks = 3.5 seconds)

fadeOut: Ticks for fade-out animation (20 ticks = 1 second)

Default Titles

The plugin comes with two example titles:

1. "hello"

Title: Hello World!

Subtitle: Welcome to the server

2. "welcome"

Title: WELCOME!

Subtitle: Enjoy your stay on the server

Technical Details

How Titles Are Displayed

The plugin uses Hytale's EventTitleUtil.showEventTitleToPlayer() method to display titles directly in the center of each player's screen. This is the same system used for event notifications and achievements.

Player Targeting

When using /ethertitle show <name>, the plugin:

Retrieves all currently online players from the Universe

Validates each player reference

Sends the title message to each valid player

Uses the configured timing values (fadeIn, stay, fadeOut)

Persistence

All title configurations are automatically saved to titles.json

Changes are saved immediately after each command

The file is loaded when the plugin starts

Use /ethertitle reload to manually refresh from disk

Error Messages

Message Cause Solution

The title 'hola' does not exist! Trying to modify/show a non-existent title Create it first with /ethertitle create hola

The title 'hola' already exists! Trying to create a duplicate title Use a different name or delete the existing one

Error showing the title! Internal error during display Check server logs for details

Permissions

Currently, the plugin does not implement a permission system. All commands can be executed by any player with command access. This can be modified in future versions.

Version Information

Plugin Version: 1.0.0

Hytale API: Compatible with Hypixel Hytale Server API

Dependencies: None (uses only core Hytale APIs)