uxmEssentials

uxmEssentials 0.4.0

A huge release. 0.4.0 turns uxmEssentials into a full GUI platform, rebuilds RTP from the ground up, adds a new Poses module, and hardens the whole plugin against faults.

Requires Paper 26.1.2+ on Java 25.

Custom Menu Engine data-driven GUIs

A complete, config-driven menu system: build any GUI from HOCON, no code required.

• Click actions send messages, run commands, give money/items, move/teleport players, play sounds, open other menus, edit player-data each with per-action delay, chance and deny modifiers, and generic id:value action tokens.
• Requirements & conditions permissions, money, placeholders, items, and numeric / spatial / string / integration checks. Gate a whole menu (view-level) or a single click, with deny routing, inversion, optional, stop-at-success, and else / nested-else fallback chains.
• Placeholders a full PlaceholderAPI bridge, plus player-data, math, time, inventory and statistic placeholders, global and per-menu operator-defined placeholders, and an %argument% / executor context for menus opened for another player.
• Item rendering native rich meta and data-components, skull & equipment icons, and icon providers for ItemsAdder, Oraxen, Nexo, MMOItems and HeadDatabase; lore append modes; serialized / water-bottle / light item sources.
• Layouts matrix layouts, fill items, reusable item patterns (local & global) with variable substitution, non-chest inventory types, chest auto-sizing, timed refresh, and 90-slot bottom-inventory menus.
• Ready-made sources online players, worlds, LuckPerms groups, and read-only inventory / ender-chest viewers.
• Open commands give any menu its own command with typed, autocompleting arguments, greedy args, open-for-another-player, and an open-requirement gate + open-actions.
• Openers & history opener items (give-on-join, swap-offhand) and a back-stack menu history; /menu last reopens your last menu.
• Bedrock Floodgate players get native forms: Simple / Modal / Custom forms, paged buttons, icons and lore, and per-menu form overrides.
• Anti-dupe & anti-spam rendered items are marked and escaped copies stripped; a click cooldown; drop / double-click support and item-drag slots.
• Developer API cancellable MenuOpenEvent / MenuClickEvent, a public MenuApi registration facade + item builder, and runtime IconProvider registration.
• Importers one-shot converters for DeluxeMenus, zMenu, OGUI and GUIPlus.
• Admin tooling /menu execute, dump, meta, and per-target reload.

In-game menu editor

Build and edit every custom menu from inside the game no config files.

• /menu editor browser: create, duplicate, rename, delete.
• A visual slot grid: drag items straight from your inventory onto slots (it copies, it never eats your items), "stamp" with the cursor, or shift-click to append to the next free slot.
• A full item editor (material, name, lore, amount, glow, flags, type, slots) and click-action / requirement builders driven by the live plugin, so you can only pick things that exist.
• Menu-wide settings (title, size, inventory type, open command, open/close actions, refresh…).
• Item capture from your hand + /menu captureitem, an edit lock so two people can't clobber the same menu, and a live preview of your unsaved work.
• Every save is validated and hot-reloaded a typo is caught before it's written.

RTP, rebuilt

The old /rtp was replaced with an async, leak-free, Folia-safe engine.

• Never loads a chunk on the server thread (build-enforced) no more TPS drops or memory leaks.
• A pre-warmed, disk-persisted safe-location pool serves /rtp instantly and survives restarts.
• A bounded, tick-sliced safe-search with per-search attempt / chunk / time budgets.
• An arrival grace window (Resistance + Slow-Falling + no fall damage) and charge-after- success a player is never billed or put on cooldown for a failed search.
• Biome-targeted /rtp biome <biome> with a passive rare-biome hotspot map.
• /rtp <world>, /rtp <player> (staff), an RTP world-picker GUI (now the default for /rtp), respawn & first-join RTP, and cooldown / radius permission tiers.
• Respects land claims and WorldGuard regions.

New module: Poses

Sitting and poses (the 24th module).

• /sit (including on stairs & slabs), sit on other players, /lay, /bellyflop, /spin.
• Respects land claims and WorldGuard flags; a settings menu and a cooldown tier.

Reliability

Fault isolation so one broken module or event can never take the server down.

• Per-module load, teardown and command-registration faults are isolated.
• An unexpected command error becomes a friendly localized message instead of a stack trace.
• Self-rescheduling tick loops survive a throwing tick.
• Orphan-prone async I/O paths are bounded and guarded.
• The warp visitor-counter write moved off the region thread.

Fixes

• The empty-slot placeholder in the menu editor no longer renders as a stray glyph box.