Menu Info Pages

📖 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, 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.

---

🖼️ 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
}

Available modes:

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.

---

📦 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 a page with: /infopages newpage <name> <command>
5. Place custom PNG images inside: mods/MenuInfoPages/images/
6. Apply configuration changes with: /infopages reload

For additional configuration details and examples, see:

mods/MenuInfoPages/README.txt

---

✅ Compatibility

✔ Hytale Server 0.5.x
✔ Tested on Hytale Server 0.5.9
✔ Native Hytale-style UI
✔ Independent JSON pages
✔ Player and console command execution
✔ Designed for multiplayer servers
✔ 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
✔ Left-side navigation buttons
✔ Multilingual page support
✔ Per-player language handling
✔ Language fallback support
✔ More advanced guide structures

View MenuInfoPages Full Version on BuiltByBit