X-Legend Legacy Server Collection

Field	Value
Internal ID	xlegend-legacy
Manager module	gsm-mod-xlegend
Support status	Experimental
Preserved mirror	No dedicated repository mirror assigned yet; immutable supplied archives and generated manifests are stored on the Pi
Preservation level	P1 artifacts plus verified layout/base-schema preparation; matched-client P3 baselines pending
Runtime verification	Eight-profile normalization and PostgreSQL 18 schema smoke test completed on 2026-07-16; no matched-client login baseline promoted
Default profile	astral-realm-v1249
Database	PostgreSQL; profile-specific isolated databases
Runtime	Legacy i386/x86-64 services through QEMU user-mode; tmux
Default installation	/opt/gsm/servers/xlegend
Preservation store	/opt/gsm/assets/xlegend
Compatibility ledger	/opt/gsm/assets/xlegend/compatibility-gaps.tsv
Target verified	Raspberry Pi 5 / Ubuntu Server
Last documentation review	2026-07-17
Owner	Ryuu

Scope and meaning of support

The manager supports preservation, integrity verification, layout normalization, profile-specific PostgreSQL provisioning, base-schema import, configuration generation, and explicit tmux lifecycle actions for the supplied X-Legend server family. Running an installation prepares only the selected profile under /opt/gsm/servers/xlegend; immutable originals remain in /opt/gsm/assets/xlegend/original.

This does not claim that every profile has a matched client or a verified authentication/login path. The module remains Experimental, and the compatibility ledger is authoritative for those gaps.

Eight supplied releases

All eight primary ZIPs were SHA-256 verified, passed archive CRC testing, were normalized successfully, and had their available base database snapshots imported successfully on PostgreSQL 18.

Game / title mapping	Profile	Original archive and SHA-256	Current compatibility state
Astral Realm / Twin Saga	astral-realm-v1249	server_ar_v1249.zip — 7735554b3d90032b183ca4bd2ddc71a123ad208b90dae868479b0805954c8a84	Prepared; verified public configuration pack preserved. Matched-client login remains untested.
Grand Fantasia	grand-fantasia-v761	server_dj_v761.zip — 95d005e7ad9074c844fd832f165c0c8ae82b9260823ea6f887404f34f50659eb	Layout and available base schemas verified; incomplete because the separately published member database and complete runtime configuration are absent.
Dream Journey Mobile	dream-journey-mobile-v959	server_djm_v959.zip — 14f32a89c20e916fa27ff033abcb2aa428585b86f1208ed64cc44252e722d7ad	Layout and available base schemas verified; mobile router and authentication data are missing.
Dragon Slayer / Dragomon Hunter	dragon-slayer-1512021530	server_dso_1512021530.zip — cbbfdd8a4bc212382f55fd3f49b94dd101607b0488940a8ab09331f8c6411d29	Prepared with Gateway schema; matched-client login remains untested.
Fantasy Frontier / Aura Kingdom V15	aura-kingdom-v15-xlegend	server_ff_v15.zip — c3e19f57056adee51eb357630bed7f8f81607cc4fe62415ebf17bfcea92f6164	Prepared as a separate X-Legend release; never merge it with the AKF/V7 Aura Kingdom profiles or databases.
Fantasy Frontier Online 2	fantasy-frontier-2-v32005	server_ff2_v32005.zip — 1a398a63f8a4140a728c64f1390ccd168bd4075d1befb093d51a3ecc35e73343	Layout and available base schemas verified; matching client and independently verified public title mapping are absent.
If Only: Once Again	if-only-once-again	server_io.zip — eb665032ad23dc6099fe1594cf3da093e79f867d303a9a9260f6a4921af6ed72	Layout and available base schemas verified; matching client and authentication workflow are absent.
Seventh Dark / LaPlace	seventh-dark-v45110	server_lao.zip — c10ba1a0abed938d23d33ab23a7ea4fbded8ac0970b2ae1202e993a3b8c4e817	Layout and available base schemas verified; the publicly documented client is incompatible with this mixed server build.

Database and migration handling

• Every available complete base snapshot imports on PostgreSQL 18 using a temporary, profile-isolated smoke-test environment.
• Packaged *_schema_alter files are versioned migration histories, not a linear SQL stream. They are preserved and inventoried but are not replayed wholesale over already complete base snapshots.
• Dream Journey Mobile and Fantasy Frontier 2 include additional mobile/router service assumptions and may still require title-specific data or authentication repair.
• Temporary smoke-test databases, roles, and extracted working files were removed after validation.

Pi preservation and operational state

• The eight primary ZIPs are stored read-only with mode 0440 under /opt/gsm/assets/xlegend/original.
• /opt/gsm/assets/xlegend/compatibility-gaps.tsv records each profile as prepared or incomplete with its exact blocker.
• No X-Legend game server is currently running.
• No X-Legend boot service was created. PostgreSQL remains disabled/manual at boot.
• The Pi remained stable throughout the eight-profile preparation and schema tests, with more than seven hours uptime during validation and more than ten hours at the follow-up documentation check.

Manager implementation

• Profile definitions, workflow phases, warnings, and operator actions: gui/crates/gsm-mod-xlegend/src/manifest.rs.
• Preservation manifests, compatibility ledger, normalization, database import, configuration, QEMU, and service sequencing: gui/crates/gsm-mod-xlegend/src/scripts.rs.
• Controller-to-server archive synchronization with size/hash verification: gui/tauri/src-tauri/src/commands/client_assets.rs.

The archive synchronization action accepts any recognized subset, verifies each source before upload, verifies it again on the Pi, and makes the preserved destination read-only. Original installers are never executed directly.

Additional represented profiles

The module also keeps later, more specific preservation profiles separate from the eight primary releases:

• Astral Realm TW 012.1.01.49_8, with exact service binaries, supplied account/game snapshots, four pinned compatibility sources, and recoverable official 20180525 InstallShield client media. Client extraction is verified; matched login and world entry remain untested.
• Grand Fantasia 0.74, 0.751, and 0.761 AutoInstaller profiles with paired immutable clients and the complete pinned ZoneServer command reference; the older grand-fantasia-v761 archive remains a distinct incomplete artifact.
• LaPlace AutoInstaller 2024-09, a separate decoded multi-world release whose unsafe root installer is replaced by managed preparation.

Grand Fantasia's complete ZoneServer command reference and history are preserved at /opt/gsm/assets/xlegend/sources/gfarchives/cmds.md. See the Grand Fantasia profile page for exact server/client hashes, version mapping, command provenance, and verification evidence. The selected Astral Realm profile exposes its live ZoneServer/GMCmd.ini through the manager.

Validation evidence

• Full non-Tauri Rust workspace tests and checks passed.
• All generated X-Legend Bash actions passed syntax validation.
• 41 frontend unit tests and the production frontend build passed.
• All eight primary layouts normalized successfully.
• All eight available base-schema sets passed the PostgreSQL 18 smoke-test procedure.
• Cleanup checks confirmed that no temporary databases, roles, extracted smoke-test files, X-Legend processes, or boot units remained.

Reference sources

• X-Legend server-file collection and title mapping
• Twin Saga one-click installer discussion
• TwinSaga-Oneclick-Installer archive
• Grand Fantasia 0.74/0.751/0.761 release discussion
• Grand Fantasia command archive

Remaining promotion criteria

1. Recover and checksum matching clients and authentication data for incomplete profiles.
2. Perform a sanitized login/character/world handshake test for each exact client/server pair.
3. Record service ports, logs, resource use, shutdown, and clean-restart evidence per profile.
4. Repeat from immutable originals in a clean environment before promoting any profile from Experimental.