Gizmo

Gizmo allows for creating custom welcome, rules, guide, and information screens with layouts, clickable items, navigation, conditions, messages, commands, sounds, and fades. Screens are rendered without clearing, saving, restoring, or writing to a player's real inventory.

FEATURES

• Named, reusable screens — define as many screens as needed and assign them to events.

• Join and first-join events — first-time players can receive their own screen, layout, colors, actions, and items.

• Screen navigation — use an item to open another configured screen without firing the previous screen's close actions.

• Conditions — restrict events, screens, or items by permission and world.

• 54 safe screen slots — Gizmo never clears, saves, restores, or writes to the player's actual inventory.

• ProtocolLib inventory masking — player inventory slots are hidden client-side while a screen is open.

• Custom items — material, slot, display name, lore, custom model data, and hidden item flags.

• Item actions — run player commands, console commands, or send messages from clicked items.

• Per-screen close actions — run commands, send messages, play sounds, and show a fade when a screen closes.

• Hex and legacy color support — supports & and &#RRGGBB color formatting.

• Resource-pack safeguards — optional blindness and invulnerability while the pack prompt is active.

• Decline handling — optionally kick players who decline or fail to download the required pack, with configurable multi-line text.

• Provider detection — supports vanilla server packs and detects Nexo, ItemsAdder, and Oraxen.

• Join/quit message controls — optionally hide standard server join and quit announcements.

• Config validation — validates screen mappings, layouts, item slots, materials, commands, navigation targets, sounds, and conditions at startup and reload.

• Once-per-restart screens — optionally show an event screen only once per player during a server session.

• Debug mode — resource-pack status diagnostics for troubleshooting.