Harepacker-resurrected provides a suite of tools, HaCreator and HaRepacker, for comprehensive editing of MapleStory game files, specifically .wz files and game maps. This project targets MapleStory modders and developers seeking a unified platform to manipulate game assets, offering advanced editing capabilities for game development and customization.

How It Works

The project integrates HaCreator for level design and HaRepacker for .wz file management, sharing common functionalities via HaSharedLibrary. It leverages external libraries such as Spine-Runtime for 2D animations and Real-ESRGAN for AI-powered 2D image upscaling. The architecture is documented, detailing its approach to WZ file format handling, data management, and IMG filesystem operations.

Quick Start & Requirements

• Build: Requires Microsoft Visual Studio 2022 with the "Desktop development with C++" workload and Git.
• Run: Requires .NET 8.0.
• OS: Windows 10/11 (version 1607+) or Windows Server 2016+.
• Architecture: x64, ARM64, x86.
• RAM: 8GB minimum recommended.
• Graphics: DirectX 12 with 2GB VRAM minimum.
• Cloning: Clone the repository and initialize submodules: git clone https://github.com/lastbattle/Harepacker-resurrected.git followed by git submodule update --init --recursive.
• Dependencies: Spine-Runtime, MapleLib, WzImg-MCP-Server (optional, for OpenAI Codex).
• Documentation: Links to technical documentation for internals, WZ File Format, and architecture are available.

Highlighted Details

• AI-driven 2D image upscaling using Real-ESRGAN.
• Integration with the Spine-Runtime 2D animation library.
• Extensive internal documentation covering WZ file format, architecture, and data systems.
• Optional integration with OpenAI Codex via a self-hosted WzImg MCP server.

Maintenance & Community

This is a community-driven project maintained in the author's free time, meaning issue resolution and feature additions may be slow. Support for development is accepted via Bitcoin donations. No specific community channels (like Discord/Slack) or roadmaps are explicitly linked in the README.

Licensing & Compatibility

The project is released under the MIT license, which permits commercial use and modification. It includes copyright notices from original contributors dating back to 2010.

Limitations & Caveats

Development pace is dictated by the author's free time, potentially leading to delays in updates and bug fixes. The APNG image format support is currently noted as unused. Integration of the optional WzImg MCP server requires manual building and configuration.