HynfinityMenu

Hytale Server 2026.03.26 or later

A configurable in-game menu system for Hytale servers with a built-in web-based visual editor. Design menus, pages, buttons, and actions — then preview them in a pixel-perfect Hytale UI replica directly in your browser.

Quick Start

1. Download the latest HynfinityMenu-*.jar from Releases
2. Drop it in your server's mods/ directory
3. Start the server
4. Open the menu in-game with /menu

Features

In-game menus

• Fully configurable menus with pages, buttons, and chained actions
• Auto-open on first join (configurable)
• /menu command to reopen any time
• 8 action types: message, command, open_url, open_page, open_menu, status, close, noop
• closeBefore / closeAfter flags for fine-grained control

Web builder

• Visual drag-and-drop menu editor at http://your-server-ip:8180/builder/
• Live preview using real Hytale UI textures (pixel-perfect DecoratedContainer)
• Inline localization editing — switch language in the toolbar to translate
• Action simulation — click buttons in the preview to see what each action does
• Undo/redo, import/export, in-game reload without restarting
• Token-based authentication with brute-force protection

Localization

• Built-in language packs: en, fr, es
• Per-player language preference stored persistently
• Dot-notation translation keys with fallback chain: player language → default language → base text from menus.json
• Add custom languages by dropping <code>.json files into lang/

Commands

Alias: /welcome.

Permissions

LuckPerms example:

lp group default permission set hynfinity.menu true

Configuration

menus.json

The menu config is created on first run in the plugin data folder:

mods/com.hynfinity_menu/menus.json

Structure:

{
  "localization": {
    "defaultLanguage": "en",
    "enabledLanguages": ["en", "fr", "es"]
  },
  "command": {
    "name": "menu",
    "aliases": ["welcome"]
  },
  "messages": { ... },
  "firstJoin": {
    "enabled": true,
    "menu": "welcome",
    "page": "home"
  },
  "commandMenu": {
    "menu": "welcome",
    "page": "home"
  },
  "menus": [
    {
      "id": "welcome",
      "title": "Server Welcome",
      "subtitle": "",
      "defaultPage": "home",
      "pages": [
        {
          "id": "home",
          "title": "Welcome",
          "lines": ["Line 1", "Line 2"],
          "status": "Status text",
          "hint": "Hint text",
          "buttons": [
            {
              "label": "Button",
              "actions": [
                { "type": "message", "text": "Hello!" }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Action types

All action types except close and noop support optional closeBefore and closeAfter boolean flags.

builder.json

The web builder config is created on first run alongside menus.json:

mods/com.hynfinity_menu/builder.json

{
  "enabled": false,
  "httpPort": 8180,
  "httpHost": "0.0.0.0",
  "threadPoolSize": 2,
  "authToken": ""
}

Set "enabled": true and restart the server. The generated token is printed in the server logs — use it to log in at http://your-server-ip:8180/builder/.

Localization files

Built-in language packs are extracted on first run to:

mods/com.hynfinity_menu/lang/

Files: en.json, fr.json, es.json.

Translation keys use dot-notation matching the config structure:

menus.{menuId}.title
menus.{menuId}.pages.{pageId}.title
menus.{menuId}.pages.{pageId}.lines.{index}
menus.{menuId}.pages.{pageId}.buttons.{index}.label
messages.playerOnly
messages.noPermission
...

Fallback order: player language → default language → base text from menus.json.

Web builder API

The builder exposes a REST API (all routes require Authorization: Bearer <token>):

Data files

Player state is stored in:

mods/com.hynfinity_menu/welcomed.json

• welcomed: UUID list of players that saw the first-join menu
• languages: per-player preferred language code

Build

./gradlew shadowJar

Output: releases/HynfinityMenu/HynfinityMenu-<version>.jar

Requires Kotlin 1.9.x, Java 21, and the Hytale Server JAR in resources/server-jars/.