1 Server Grand Fantasia
official-markus-maurer edited this page 2026-07-16 16:12:39 +02:00

Grand Fantasia — X-Legend Legacy Profiles

Field Value
Internal ID xlegend-grand-fantasia
Manager module gsm-mod-xlegend
Support status Experimental
Profiles grand-fantasia-074-autoinstall, grand-fantasia-751-autoinstall, grand-fantasia-761-autoinstall
Preserved mirror Six immutable server/client archives plus a pinned GFArchives Git bundle on the Pi
Preservation level P1 server/client artifacts and command history; layout/database smoke verified; matched-login P3 pending
Runtime verification All three layouts and database sets verified on Raspberry Pi 5 on 2026-07-16; matched-client login not yet completed
Database PostgreSQL; separate profile-specific database sets
Runtime Legacy multi-world services through QEMU user-mode; tmux
Preservation root /opt/gsm/assets/xlegend
Prepared releases /opt/gsm/servers/xlegend/releases/<profile>/server
Last documentation review 2026-07-16
Owner Ryuu

Supported version mapping

The three AutoInstaller releases are separate profiles with matching immutable client archives. The 0.751/0.761 labels follow archive chronology and the encoded-versus-decoded data lineage; original filenames remain part of the evidence.

Version/profile Server archive Server SHA-256 Matching client Client SHA-256
grand-fantasia-074-autoinstall AUTOINSTALL_006.074.64.64.rar 7074d8bc43797ba413ca42777ed03720287358fb100e8f7547a198f669a2bb45 074.zip d59bdd3e34d49bb43ed29246d86870f6f5f0647828009ae12d8122a6b7f26497
grand-fantasia-751-autoinstall gf_server.zip 486f09c093fb9bef031eb999e67343c8bbb67f9e3ee824843313a263751a5f8b MyClient.rar 28d6f04a1eb5f4ea02808efae3e3f3aea260278d0e1840ce9efaf8cf62635b05
grand-fantasia-761-autoinstall gf_server (1).zip b8b66379d8ce35848d20f1a9747d526cb5ae1a4a55b7c393d077ee210398029f X-Legend.zip f330f6d9f8a230fbe41752de945cd418e05eccfcac6a2c4d023216f8fb2aaddd

All six archives passed full decompression/CRC testing plus local and remote SHA-256 verification. They are stored read-only under /opt/gsm/assets/xlegend/original.

The older grand-fantasia-v761 profile backed by server_dj_v761.zip remains a separate incomplete historical artifact. It is not interchangeable with the prepared 0.761 AutoInstaller profile because it lacks the separately published member database and complete runtime configuration pack.

Complete ZoneServer command reference

The complete GFArchives cmds.md reference is preserved with its repository history:

Item Verified value
Pinned commit f21a2253c07e0c1b2433a416a969c700a4249593
cmds.md SHA-256 8cfc1032e21ba99038696685b50addf9be5f06b0cbcfcfd1dfe3dda07b8f0d99
File size inventory 1,559 lines
Command grouping inventory 431 *** group separators in the pinned document
Preserved Git bundle /opt/gsm/assets/xlegend/sources/gfarchives.bundle
Preserved command file /opt/gsm/assets/xlegend/sources/gfarchives/cmds.md
Pinned-revision marker /opt/gsm/assets/xlegend/sources/gfarchives/COMMIT

The manager action Open - Grand Fantasia ZoneServer commands opens the preserved command file. Each prepared Grand Fantasia release also receives a copy at .gsm-docs/ZoneServer-commands.md, so its operational documentation travels with the derived server without modifying the original archives.

Preparation and safety repairs

  • The manager normalizes each server to /opt/gsm/servers/xlegend/releases/<profile>/server and changes only a derived working copy.
  • The stale MissionServer, WorldServer, and ZoneServer address offsets shipped with the 0.74 installer were replaced with offsets verified against the actual binaries.
  • Every binary write checks the expected preimage and refuses an unknown layout instead of blindly patching an offset.
  • All three database sets imported successfully in isolated PostgreSQL smoke-test databases.
  • Packaged *_schema_alter histories remain preserved but are not replayed wholesale over complete base snapshots.
  • The Windows-native archive uploader was tested successfully with filenames containing spaces and parentheses, including gf_server (1).zip.
  • Original one-click installers and their unsafe root permissions, fixed paths, or broad database behavior are not executed.

Operational state and profile selection

  • No X-Legend service, process, tmux session, or boot unit was left running after validation.
  • PostgreSQL remains disabled/manual at boot.
  • The 0.761 profile was the selected release at the conclusion of the Grand Fantasia validation. The manager's current link is intentionally mutable and may point to a subsequently prepared profile; durable prepared copies remain under their versioned release paths.
  • Starting a profile is always an explicit manager action and does not enable boot startup.

Implementation and validation

  • Profile definitions and the command-reference action: gui/crates/gsm-mod-xlegend/src/manifest.rs.
  • Archive manifests, preparation, guarded binary offsets, database import, and service sequencing: gui/crates/gsm-mod-xlegend/src/scripts.rs.
  • Windows-native upload and local/remote verification: gui/tauri/src-tauri/src/commands/client_assets.rs.

Validation completed for this integration:

  • 11 X-Legend Rust module tests passed at the Grand Fantasia milestone.
  • 41 frontend unit tests and the production frontend build passed.
  • Generated Bash actions passed syntax validation.
  • All six server/client archives passed decompression and local/remote checksum verification.
  • All three database sets imported successfully.
  • Cleanup checks found no temporary databases, roles, extracted test files, processes, tmux sessions, or boot units.

Remaining compatibility milestone

The preserved client/server pairing is stronger evidence than the older incomplete archive, but the final Experimental blocker remains an end-to-end matched-client login, character selection, and world-entry test for each of 0.74, 0.751, and 0.761. Record each combination independently; success with one version must not be generalized to the other two.

References