Research & Community
Swordigo Desktop exists because of years of reverse engineering, binary analysis, and community knowledge. This page documents the sources, discoveries, and people that made a Linux-native port possible.
Research Sources
The external projects and techniques that provided the foundation for SRE development.
SwMini Mod Loader
Decompiled the Swordigo engine source, identified function signatures and object layouts. Critical for SRE hook development — provided the roadmap for intercepting GameSceneView::Update, MusicPlayer commands, and GUI view hierarchies.
Swordigo Vita Port
First ARM → desktop porting research for Swordigo. Identified JNI entry points, GL translation patterns, and proved the engine could run outside Android. Established the viability of the entire SwordigoDesktop approach.
Binary Analysis
Direct decompilation of libswordigo.so (ARM64 v1.4.12). Symbol maps, function tracing, vtable reconstruction, and cross-referencing with SwMini's decompiled source to build the complete native engine map.
Key Discoveries
Critical findings from reverse engineering that directly shaped the runtime architecture.
ARM64 exclusive store instructions (STXR / LDXR) causing infinite loops on single-threaded emulation. The atomics never succeed because no other thread releases the exclusive monitor. Required SRE to NOP-patch or rewrite these sequences.
Shared memory command interface pattern discovered through tracing. The game uses a ring buffer of music commands (play, stop, fade) that the MusicPlayer thread consumes. SRE intercepts this to route audio through native PulseAudio/PipeWire.
GUIView hierarchy with reconstructed offsets: +0x58 superview, +0x100 label text, +0x60 subview list. Enabled direct manipulation of the HUD without modifying engine code.
~400-line function responsible for all HUD rendering — health bars, magic meter, item slots, minimap. Understanding this function was essential for adding custom overlays and the FPS counter without breaking the render pipeline.
GameOverViewController::ShowAdMaybe → calls into the ad SDK which attempts network access and hangs indefinitely without connectivity. SRE hooks this to skip the ad path entirely, restoring instant respawn behavior.
Heavy ARM64 emulation path in the Wastelands zone causing infinite stalls. A tight atomic loop in the physics thread deadlocks when the emulator serializes execution. Fixed by identifying and short-circuiting the contended lock.
Research Documents
Key engineering documents from the project's research archive, hosted on GitHub.
Community Credits
The people and teams whose work made this project possible.
SwordigoDesktop is an independent community project. It would not exist without the reverse engineering efforts of SwMini, the porting research from the Vita community, and the original game created by Touch Foo. We are deeply grateful for their work.