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

1. Place the plugin JAR file in your server's mods folder
2. Start or restart your Hytale server
3. The plugin will automatically create a mods/EtherTitle directory
4. 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:

1. Retrieves all currently online players from the Universe
2. Validates each player reference
3. Sends the title message to each valid player
4. 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)

---