feat: guided game-save import with help dialog #6

Merged
ryan.mcgee merged 1 commit from feat/game-save-guide into main 2026-11-19 03:42:29 +00:00
Owner

Summary

  • Make the game-save import self-explanatory and less clunky: an info button opens a dialog that walks through making the mapping and importing, and the mapping and the save are now separate steps instead of two files picked at once.
  • Ship the tooling players need to make the mapping.

Changes

  • Info icon next to "Import game save" opens a native <dialog> (Esc, the close button or a backdrop click closes it) describing: getting the game files, running gamemap.py, loading the mapping, and choosing the save, plus where saves live.
  • The dialog shows the stored mapping's size, game build and date, and has "Load gamemap.json" and "Choose character save" buttons (the latter disabled until a mapping is loaded). With a mapping stored, the toolbar button goes straight to the save picker; without one it opens the dialog.
  • static/tools/gamemap.py (moved from scripts/) is now a standalone tool served at /tools/gamemap.py: Python 3.8+ stdlib only; downloads retoc v0.1.5 for the platform and verifies a pinned SHA-256 (linux x64/arm64, windows x64, macOS x64/arm64); extracts only the item, data-asset, quest and string-table assets to a temp folder it deletes; matches them to the site's /items-index.json (or --index FILE); writes gamemap.json labelled with the game build and date. Clean errors for a missing folder or no game files.
  • scripts/build.py also writes static/items-index.json (ids and names only, gitignored); CI passes the path.
  • README updated.

Verification

  • node --check, py_compile, zola build: OK
  • gamemap.py end to end in a clean python:3.13-slim container against the updated server install (build 26670300): downloaded retoc, 1353 items and 37 quests mapped in 11 s, output identical to the earlier manual run; correct build label; clean errors on bad folders
  • Browser: toolbar button opens the dialog with no mapping; Esc and close button work; info icon opens it; a non-mapping file is rejected with a message; a valid mapping enables the save button and shows size/build/date; importing via the dialog ticked 363 items and 23 completed quests; with a mapping stored the toolbar button does not open the dialog; state persists across reload; no console errors; 390px layout OK
  • No game ids in any tracked file

Notes

  • Only the Linux x64 retoc build was run; the Windows/macOS/arm builds are pinned by checksum but untested.
  • The tool defaults to the live site's /items-index.json, which exists once this is deployed.
  • A client install may be encrypted or differ; the dedicated server is the tested source.
## Summary - Make the game-save import self-explanatory and less clunky: an info button opens a dialog that walks through making the mapping and importing, and the mapping and the save are now separate steps instead of two files picked at once. - Ship the tooling players need to make the mapping. ## Changes - Info icon next to "Import game save" opens a native `<dialog>` (Esc, the close button or a backdrop click closes it) describing: getting the game files, running `gamemap.py`, loading the mapping, and choosing the save, plus where saves live. - The dialog shows the stored mapping's size, game build and date, and has "Load gamemap.json" and "Choose character save" buttons (the latter disabled until a mapping is loaded). With a mapping stored, the toolbar button goes straight to the save picker; without one it opens the dialog. - `static/tools/gamemap.py` (moved from `scripts/`) is now a standalone tool served at `/tools/gamemap.py`: Python 3.8+ stdlib only; downloads retoc v0.1.5 for the platform and verifies a pinned SHA-256 (linux x64/arm64, windows x64, macOS x64/arm64); extracts only the item, data-asset, quest and string-table assets to a temp folder it deletes; matches them to the site's `/items-index.json` (or `--index FILE`); writes `gamemap.json` labelled with the game build and date. Clean errors for a missing folder or no game files. - `scripts/build.py` also writes `static/items-index.json` (ids and names only, gitignored); CI passes the path. - README updated. ## Verification - `node --check`, `py_compile`, `zola build`: OK - `gamemap.py` end to end in a clean `python:3.13-slim` container against the updated server install (build 26670300): downloaded retoc, 1353 items and 37 quests mapped in 11 s, output identical to the earlier manual run; correct build label; clean errors on bad folders - Browser: toolbar button opens the dialog with no mapping; Esc and close button work; info icon opens it; a non-mapping file is rejected with a message; a valid mapping enables the save button and shows size/build/date; importing via the dialog ticked 363 items and 23 completed quests; with a mapping stored the toolbar button does not open the dialog; state persists across reload; no console errors; 390px layout OK - No game ids in any tracked file ## Notes - Only the Linux x64 retoc build was run; the Windows/macOS/arm builds are pinned by checksum but untested. - The tool defaults to the live site's `/items-index.json`, which exists once this is deployed. - A client install may be encrypted or differ; the dedicated server is the tested source.
feat: guided game-save import with help dialog
All checks were successful
deploy / build (pull_request) Successful in 47s
4dff4ee122
- info button next to "Import game save" opens a dialog that explains
  making the mapping and importing, with the mapping and save as
  separate steps instead of picking two files at once
- once a mapping is stored the button goes straight to the save
- gamemap.py is now a standalone cross-platform tool served from the
  site: it fetches a pinned, checksum-verified retoc, extracts the
  assets, matches them against the site's item index and writes
  gamemap.json labelled with the game build
- build.py also writes static/items-index.json (ids and names only)
ryan.mcgee deleted branch feat/game-save-guide 2026-11-19 03:42:29 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
UltraVu-Studios/rsdclog!6
No description provided.