GaiaLabs is a comprehensive suite of tools for Illusion of Gaia (Gaia Gensouki) ROM hacking, reverse engineering, and modification. This toolkit enables complete game analysis, asset extraction, editing, and ROM rebuilding with modern enhancements including decompressed loading, MSU-1 audio support, and quality-of-life improvements.

Illusion of Gaia: Retranslated - A complete retranslation of Illusion of Gaia featuring L Thammy's acclaimed translation work, built using the GaiaLabs toolkit. This project showcases the full capabilities of the toolset with enhanced dialogue, restored Japanese assets, MSU-1 audio support, and numerous gameplay improvements.

The foundational C# library powering the entire toolkit:

• Complete ROM Analysis - Parse and understand Illusion of Gaia ROM structure
• Asset Extraction - Graphics, music, palettes, tilemaps, and assembly code
• Multi-Region Support - US, Japanese, and other regional ROM variants
• Advanced Compression - Built-in decompression/compression algorithms
• Assembly Processing - 65816 code analysis and manipulation
• Database Architecture - JSON-driven ROM structure definitions

Python port of core GaiaLib functionality

Complete Godot-based visual editing environment:

• Tilemap Editor - Visual level editing with mouse/keyboard controls
• Tileset Editor - Tile property editing with mirroring and collision
• Sprite Editor - Comprehensive sprite and animation management
• Palette Bundle Tool - Interactive color palette editing
• Real-time Preview - Immediate visual feedback for all edits

Command-line tool for ROM compilation and asset management:

• ROM Building - Compile modified ROMs with custom assets
• Patch Integration - Apply assembly code modifications
• Transform System - Regex-based assembly code fixes
• Asset Management - Handle all game resource types
• MSU-1 Integration - CD-quality audio streaming support

Standalone compression tool implementing the game's custom algorithm:

• File compression using original game format
• Batch processing support
• Compression analysis and optimization

RESTful API for remote ROM manipulation:

• HTTP endpoints for ROM operations
• Swagger documentation
• Integration support for web applications

• .NET 8.0+ Runtime (Download)
• Unheadered Illusion of Gaia (USA) ROM file

1. Download the latest BaseROM Toolkit from GaiaLabs Releases
2. Extract the release file to your desired location
3. Update the project.json file with your ROM location
4. Run GaiaPacker --unpack to extract game content

1. Extract ROM Data: Use GaiaPacker --unpack to extract all game assets
2. Edit Assets: Use GaiaLabs visual editor or modify files directly
3. Apply Patches: Include assembly modifications for new features
4. Build ROM: Use GaiaPacker to compile everything into a modified ROM file
5. Test & Play: Enjoy your customized Illusion of Gaia experience

• 🚀 Decompressed Assets - Eliminate loading times with uncompressed data
• ⚡ Scene Transitions - Near-instant area transitions
• 💾 4MB ROM Support - Expanded ROM size with 1MB free space

• 🎵 MSU-1 Support - CD-quality 16-bit stereo audio at 44.1kHz
• 🎶 Music Packs - Download professional orchestral arrangements
• 🔊 Audio Optimization - Improved BGM loading and processing

• 🏃 Run Button - Sprint using Y button for faster movement
• 📦 Item Stacking - Visual counters for Red Jewels, Herbs, and Crystals
• ⚡ Item Hotswapping - Quick switching with shoulder buttons
• 🎒 Equipped Indicators - Visual item status in inventory
• 🔄 New Game Plus - Enhanced replay functionality

• Extract and modify game text with encoding support
• Support multiple languages and character sets
• Automated script processing and insertion

• Replace sprites, backgrounds, and UI elements
• Create custom animations and sprite sets
• Modify color palettes for visual themes

• Insert custom background music via MSU-1
• Extract original tracks for analysis/remixing
• Modify sound effects and audio cues

• Alter game logic through assembly patches
• Add new features like run buttons and item stacking
• Modify character stats, abilities, and progression
• Create custom areas and level layouts

• Study classic SNES game architecture
• Understand compression algorithms and data structures
• Analyze memory organization and technical implementation

GaiaLabs/
├── GaiaLib/           # Core ROM modification library (.NET)
├── GaiaLabs/          # Visual editor suite (Godot + C#)
├── GaiaPacker/        # ROM builder and patcher (CLI)
├── GaiaApi/           # Web API interface
└── docs/              # Technical documentation

• 💬 Discord: Join our community
• 📧 Issues: GitHub Issues
• 🎵 MSU-1 Music: Zeldix Database

The Illusion of Gaia: Retranslated project demonstrates the full power of GaiaLabs:

• Complete story retranslation with improved coherence
• Restored Japanese visual assets and animations
• MSU-1 audio support with orchestral music packs
• Quality-of-life improvements and modern features
• Enhanced accessibility and user experience

"This project showcases what's possible when passionate ROM hackers have access to comprehensive, well-designed tools."

GaiaLabs is designed for use with legally obtained ROM files. Users must own a legitimate copy of Illusion of Gaia to use this toolkit. This project is not affiliated with Square Enix, Nintendo, or the original developers.

Ready to begin your Illusion of Gaia ROM hacking journey?

1. 🔗 Check out the Retranslation Project to see what's possible
2. 📥 Download the BaseROM Toolkit to get started
3. 📚 Read the GaiaLib documentation to understand the core library
4. 🎨 Try the Visual Editor for immediate hands-on experience
5. ⚙️ Use GaiaPacker to build your first modified ROM
6. 💬 Join our Discord community for support and collaboration

Rediscover the world of Illusion of Gaia with modern tools and unlimited possibilities.