📖 MenuInfoPages

MenuInfoPages is a lightweight information-page system for Hytale Server.

Create in-game guides, rules, tutorials, help pages, server information, announcements, and interactive menus using simple JSON files.

Each page has its own command and can include formatted text, images, sections, action buttons, player or console commands, and optional automatic opening behavior.

No Java coding is required.

✨ Features

✔ Native Hytale-style interface
✔ Simple JSON page configuration
✔ One player command for every page
✔ Rich text formatting
✔ Up to 5 images, 5 sections and 5 action buttons
✔ Optional images inside sections
✔ Local and remote PNG images
✔ Player and console commands
✔ {player} and {uuid} placeholders
✔ Primary, secondary and danger button styles
✔ Optional command delays and close behavior
✔ Once, always and dismissible auto-open modes
✔ Optional world and instance filtering
✔ /infopages reload
✔ /infopages newpage <name> <command>
✔ Built-in example page and README documentation

🚀 Getting Started & Creating Pages

Place MenuInfoPages-1.1.6.jar inside your server mods folder and start the server once.

MenuInfoPages creates:

mods/MenuInfoPages/
├── pages/
├── images/
├── reload.yml
└── README.txt

Every .json file inside:

mods/MenuInfoPages/pages/

represents an independent page.

Example:

{
  "command": "rules",
  "title": "SERVER RULES",
  "intro": "Please read the rules before playing.",
  "images": [],
  "sections": [],
  "buttons": [],
  "footer": "Have fun!"
}

This creates:

/rules

The filename and command do not need to be identical.

You can also create a new page directly from the server:

/infopages newpage <name> <command>

Example:

/infopages newpage rules rules

This creates rules.json and immediately registers /rules.

The included example page can be opened with:

/guide

The generated example.json contains a working example showing the main configuration options.

For additional configuration details and examples, see:

mods/MenuInfoPages/README.txt

🖼️ Images & Sections

Local Images

Place PNG images inside:

mods/MenuInfoPages/images/

Example:

mods/MenuInfoPages/images/logo.png

Then reference them using only the filename:

"images": [
  "logo.png"
]

Remote Images

You can also use a direct HTTP/HTTPS PNG URL:

"images": [
  "https://example.com/banner.png"
]

Remote JPG/JPEG images are not supported.

A page can display up to 5 top images.

It can also contain up to 5 sections, each with a title, text, and optional image:

"sections": [
  {
    "title": "STARTING OUT",
    "text": "Begin your adventure by visiting the spawn area."
  },
  {
    "title": "ECONOMY",
    "text": "Earn money while playing and spend it in server shops.",
    "image": "economy.png"
  }
]

Section images can use either local PNG filenames or remote PNG URLs.

🔘 Buttons & Commands

Each page supports up to 5 action buttons.

Example:

{
  "text": "SPAWN",
  "command": "spawn",
  "runAs": "player",
  "close": true,
  "delayMs": 250,
  "style": "primary"
}

Available styles: primary • secondary • danger

Commands can run as: player • console

Console commands can use:

{player} — Player name • {uuid} — Player UUID

Example:

{
  "text": "CLAIM REWARD",
  "command": "reward give {player}",
  "runAs": "console",
  "close": true,
  "style": "primary"
}

The leading / in commands is optional.

Buttons can also use a configurable delay or simply close the page without executing a command:

{
  "text": "CLOSE",
  "close": true,
  "style": "secondary"
}

🚪 Automatic Page Opening

Pages can optionally open automatically.

Example:

"autoOpen": {
  "enabled": true,
  "mode": "dismissible",
  "version": 1,
  "worlds": [],
  "delayMs": 1500
}

once • Shows the page once per player and page version.
always • Opens whenever the configured conditions are met.
dismissible • Opens automatically but allows the player to select Do not show again.

The version value can be increased when you want players to receive an updated page again.

The worlds setting can optionally limit automatic opening to specific worlds or instances.

🔄 Reloading Pages & Images

After editing page files, use:

/infopages reload

Most page changes can be applied without restarting the server, including:

✔ Titles and text
✔ Sections
✔ Buttons
✔ Commands
✔ Auto-open settings
✔ Added or removed pages

JSON files are validated before the reload is applied. If an invalid page is detected, the currently working configuration remains active.

Image reload behavior is configured inside:

mods/MenuInfoPages/reload.yml

Recommended production setting:

reload-images: false

With this setting, normal page configuration still reloads instantly, while new or changed images become available after the next server restart.

While actively creating pages, you can optionally enable:

reload-images: true

This allows local and remote PNG image changes to be applied with /infopages reload.

Live image reload is currently experimental but functional. Players already connected may temporarily see incorrect or missing UI/HUD textures after a live image update. Reconnecting restores the normal interface.

🔐 Commands & Permissions

/infopages reload
Reloads page JSON files and configuration without restarting the server.

Permission: newt.infopages.reload

/infopages newpage <name> <command>
Creates a new JSON page template and immediately registers its page command.

Permission: newt.infopages.newpage

Every configured page also receives its own player command based on the command field in its JSON file.

📦 Installation

1. Place MenuInfoPages-1.1.6.jar inside the server mods folder.
2. Start the server.
3. Open the example page with /guide.
4. Edit mods/MenuInfoPages/pages/example.json or create additional pages with /infopages newpage <name> <command>.
5. Place custom PNG images inside mods/MenuInfoPages/images/.
6. Apply normal configuration changes with /infopages reload.

✅ Compatibility

Hytale Server 0.5.x • Tested on Hytale Server 0.5.9 • Server-side • Native Hytale-style UI • Independent JSON pages • Player and console command execution • Multiplayer ready • No permanent HUD overlay

AI Disclosure

ChatGPT assisted with cover artwork, logo artwork, documentation, code-cleanup suggestions, and general review.

All implementation, testing, configuration choices, edits, and release decisions were manually reviewed by me.

⭐ MenuInfoPages Full Version

The CurseForge edition is the free version of MenuInfoPages.

For servers that need more advanced page systems, MenuInfoPages Full is available on BuiltByBit and includes additional features such as:

✔ Advanced multi-page navigation
✔ Up to 24 content sections
✔ Up to 24 left-side navigation buttons
✔ Up to 6 bottom action buttons
✔ Automatic multilingual page handling
✔ 25 supported languages
✔ Per-player client-language detection
✔ Language fallback support
✔ Translated example guides
✔ More advanced multi-page guide structures

View MenuInfoPages Full Version on BuiltByBit