Skip to content

GUI Release Checklist

alexisleder edited this page Nov 8, 2026 · 2 revisions

GUI/QoL release validation

Target: 1.5.0. Do not mark a platform as runtime-tested based on compilation.

Automated

Run gradle test shadowJar with the project's dependencies. Tests cover layouts, malformed input, protected slot mappings, reload rollback, texture URL validation, optional HDB/cache/clone behavior with mocks, unsafe click types, inspection permissions and read-only WG comparisons. Mock tests are not gameplay tests.

Runtime checklist for your deployment

  • Start a disposable Spigot server with compatible WorldEdit/WorldGuard. Confirm all 22 menu definitions load; create a protection and open every reachable menu.
  • Repeat on a supported Paper build. Record exact MC/Java/WG/WE versions.
  • Reorder main/management controls, shrink paginated lists and navigate all pages; confirm the selected protection/member always matches what was displayed.
  • Change ownership/members while another player has a menu open. Their old view must close/reject actions; no stale permission or stale record is persisted.
  • Try shift-click, number keys, offhand swap, double click, drop, drag and creative interactions. No icons can leave menus and player inventory contents stay intact.
  • Repeatedly confirm shop purchases/upgrades, test insufficient funds/full inventory, and inspect final money/item counts. Changing a display icon must never change the purchased protection stone or its persistent metadata.
  • Test HDB absent, installed/loading, ready, invalid ID and catalog reload. Review fallback icons, warning rate and recovery on the next opening.
  • Test direct texture hash/Base64 on a real client, including a cold texture cache.
  • Send a matching resource pack; test accepted, declined and failed download. Check glyph alignment and fallback titles/materials on each targeted client version.
  • Edit menus.yml with a collision/unknown action; reload must preserve the previous valid theme. Restore valid config and verify old windows close.
  • Test /lep inspect as owner/co-owner/member/visitor/admin and from console; unauthorized IDs must not appear in completion. Modify WG data manually in the test server and confirm /lep check reports drift without repairing it.
  • Measure normal and head-themed menu openings using the menu timings in /lep check. Record counts and average/max; compare under similar server load. No benchmark improvement is claimed until these measurements are performed.

Folia, native item-provider adapters, pack distribution and per-player layout editing are outside this release scope.

External-pack-only release checks

  • Fresh install: mode off, ordinary items, no download prompt, no local HTTP port.
  • Upgrade from auto/local/standalone: warning, no delivery, existing files untouched.
  • Upgrade menus using retired LP glyphs/models: readable fallback, original file and customized slots preserved. Replace old references explicitly after backing up.
  • External mode: exact UUID success enables models; unrelated status events do not. Decline/failure/discard disables matching styling. Reconnect after changing UUID.
  • Try all three docs/examples menu fragments; verify native stone info and permissions.
  • Validate third-party managers and Bedrock in-game before claiming compatibility.

Clone this wiki locally