| name | latitude-ui-and-hud-lifecycle |
| description | Rules for when Latitude UI screens and HUD overlays may render or open. Prevents screens auto-opening in-world, enforces debug gating, and codifies “world creation only” flows. |
Latitude — UI & HUD Lifecycle (Authoritative)
This skill prevents UI regressions such as:
- spawn/band picker screens opening automatically after joining a world
- debug screens appearing without explicit user action
- HUD overlays rendering over menus/inventories unintentionally
Screen-opening rules (absolute)
- No Latitude config screen may auto-open in-world after joining/spawning.
- Screens that configure worldgen (spawn band picker, presets, etc.) are World Creation only.
- The only allowed in-world screen opens are:
- explicit keybind action by the player, or
- explicit debug flag enabled (dev-only), or
- explicit command-driven open (if the mod provides commands).
Default must be OFF for any auto-open behavior.
Approved gates for dev-only auto-open
If a developer convenience auto-open exists, it must be gated by a JVM property:
-Dlatitude.debugOpenSpawnPicker=true (default false)
Rules:
- Must never be enabled by default.
- Must be clearly labeled “debug” in code comments.
HUD overlay rendering rules
- HUD overlays must not render when a GUI screen is open unless explicitly intended.
- Default: if
MinecraftClient.currentScreen != null, skip overlay rendering.
- Exceptions must be explicit (e.g., a dedicated “HUD Studio” preview screen).
Event lifecycle rules (client)
Do not open screens from:
- join world callbacks
- first tick hooks
- network handler init
- world load events
If a screen must be shown on world creation, it must be launched from:
- world creation UI integration points only
Required assistant behavior
When asked to add a screen or overlay, the assistant must:
- state the allowed opening triggers
- specify the exact gate (keybind / debug property / world creation)
- confirm “default OFF” for any auto-open
- include a rollback plan
Forbidden behaviors
- “Open this screen on join for convenience” unless gated behind a debug flag
- Rendering overlays over inventory/menus by default
- Shipping releases with debug auto-open enabled
