AK-Tools — v1.0

Field	Value
Purpose	Windows editor and operator utility for Aura Kingdom/X-Legend data, rates, Fortune Bag exports, accounts, and GM command reference
Version	Tag v1.0; source commit 8a9049eeec4c9e4c51ca99906e58cd7ed9c98b9d
Platforms	Windows 10/11 with .NET Framework 4.8; portable WinForms application
Authoritative source	aditbaco/aurakingdom-tools, v1.0 release
Preserved artifacts	Controller: %LOCALAPPDATA%\GameServerManager\preservation\ak-tools\v1.0; server preservation store: /opt/gsm/assets/aura-kingdom/tools/ak-tools/v1.0
License	NOASSERTION — the v1.0 tag contains no license file; it credits GPL-3.0 LegendToolX
Access/redistribution	Preserve the untouched upstream archives and metadata; do not merge or redistribute derived source until licensing is clarified
Release checksum	AK-Tools-v1.0.zip: SHA-256 ee4d0e61a3541f085e7b06a5f9eb3bfd9cbbda3f319f237c4807034d82657e19
Source checksum	GitHub v1.0 source ZIP: SHA-256 82ba74e7f033786b31d0d922f079e0013cbb720d3860e67c2fcc87e78f6c12f5
Acquired	2026-07-16

Manager workflow

Select an Aura Kingdom instance and open Settings → AK-Tools v1.0 controller utility.

1. Install or update AK-Tools downloads both pinned archives, verifies SHA-256 before extraction, stores the binary and source separately, and installs the portable release under %LOCALAPPDATA%\GameServerManager\tools\ak-tools\v1.0.
2. Launch with managed DB tunnel verifies the selected SSH host key, opens 127.0.0.1:15432 on the Windows controller to 127.0.0.1:5432 on the server, starts AK-Tools, waits for it to close, and then terminates the tunnel.
3. In AK-Tools DB Admin, use host 127.0.0.1, port 15432, and the configured Aura PostgreSQL user. Retrieve the password from the manager's secret workflow; never add it to this wiki.

PostgreSQL remains bound to loopback on the server. Do not add a LAN listen_addresses setting or a broad pg_hba.conf rule for this utility.

Compatibility and boundaries

Capability	Managed V7	Managed V15	Guidance
INI editor	Format-compatible evidence; end-to-end edit not yet declared	Upstream-tested family	Work on a copied file and retain the generated .bak.
S_DropItem.ini rate changer	149-column format observed	149-column format observed; upstream tested on V15	Prefer the manager's native preview/apply/rollback action for server-side changes.
DB Admin	Supported only with canonical databases FFMember, FFAccount, FFDB1	Unsafe with release-isolated names such as ffmember_v15	The managed launcher refuses noncanonical names because v1.0 hard-codes its database names.
Fortune Bag	Compatible semantic columns, but the server order differs from AK-Tools	Incompatible: the observed V15 table adds custom_id and v1.0 would misclassify its 11-column shape	Database - Export compatible Fortune Bag table normalizes only the verified V7 shape and fails closed on unknown layouts.
GM commands	Bundled catalog is not authoritative for every release	Bundled catalog is not authoritative for every release	Use Info - Search live GM commands, which reads the selected release's ZoneServer/GMCmd.ini.

The v1.0 release is upstream-tested only on V15. A file-format match is not proof of a complete workflow on another release.

Native manager alternatives

The Aura module independently provides:

• Interactive account creation with compensating rollback if the second database insert fails.
• Password reset in both login databases.
• Character privilege/GM changes using the selected instance's world database.
• Account and character browsing without displaying password fields.
• Live GM-command search from the selected server release.
• Drop-rate preview, range report, timestamped backup, integrity marker, apply, and rollback.
• Fortune Bag compatibility detection and SQL export only when public.fortune_bag exists.

These implementations do not copy AK-Tools source.

Verification

• Confirm both preserved archive hashes before extraction.
• Confirm .gsm-release-sha256 and .gsm-source-commit exist in the controller installation.
• Confirm the SSH tunnel listens only on controller address 127.0.0.1.
• Confirm ss -ltn on the server does not expose PostgreSQL on a LAN address.
• Close AK-Tools and confirm local port 15432 closes.
• Test edits on a disposable copy or snapshot before modifying a prepared release.

Risks

• The portable executable is unsigned and the upstream release has no explicit license file.
• The DB Admin tab performs direct writes. Snapshot the instance first and verify the selected database names.
• AK-Tools stores its connection profile beside the executable using Windows data protection. Do not copy that profile into preservation archives.
• Its bundled GM catalog and schema assumptions can drift from V7, V15, or other X-Legend releases.
• Never point the utility at an official service or files you are not authorized to modify.

Replacement/export path

The source ZIP, exact commit, checksums, and portable binary are preserved independently. Server changes can be reproduced with the manager's native actions and timestamped backups if the external utility becomes unavailable.