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

Download the latest HynfinityMenu-*.jar from Releases
Drop it in your server's mods/ directory
Start the server
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

Command	Description	Permission
`/menu`	Open the default menu	`hynfinity.menu`
`/menu <menuId>`	Open a specific menu	`hynfinity.menu`
`/menu <menuId> <pageId>`	Open a specific page	`hynfinity.menu`
`/menu lang`	Show current language and available codes	`hynfinity.menu`
`/menu lang <code>`	Change your language	`hynfinity.menu`
`/menu reload`	Reload config from disk	`hynfinity.menu.admin`

Alias: /welcome.

Permissions

Permission	Description
`hynfinity.menu`	Access to `/menu` and `/welcome`
`hynfinity.menu.admin`	Reload config

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

Type	Fields	Description
`close`	—	Close the menu
`message`	`text`	Send a chat message to the player
`command`	`command` or `commands`	Execute server command(s)
`open_url`	`url`, `text`	Open a URL (sends clickable message + raw URL)
`open_page`	`page`	Navigate to another page in the same menu
`open_menu`	`menu`, `page`	Open a different menu (optionally at a specific page)
`status`	`text`	Update the status bar text
`noop`	—	No operation (placeholder)

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": ""
}

Setting	Default	Description
`enabled`	`false`	Enable the web builder server
`httpPort`	`8180`	Web server port
`httpHost`	`0.0.0.0`	Bind address
`threadPoolSize`	`2`	HTTP worker thread pool size
`authToken`	`""`	Auth token; auto-generated on first run if empty (logged to console)

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>):

Method	Endpoint	Description
`POST`	`/builder/api/auth`	Validate token
`GET`	`/builder/api/config`	Read `menus.json`
`PUT`	`/builder/api/config`	Write `menus.json` (validated before save)
`GET`	`/builder/api/lang`	List available language files
`GET`	`/builder/api/lang/:code`	Read a language file
`PUT`	`/builder/api/lang/:code`	Write a language file
`POST`	`/builder/api/reload`	Reload config in-game

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/.