Legacy Puyo Tools

A command line tool for modding older Puyo Puyo games (Yes, the name is using a reversed naming scheme).

This project is still in development, expect major breaking changes over its lifetime.

Why

Puyo Text Editor, fntedit, and other tools already can modify file formats used by older Puyo Puyo games. However, there are advantages to rewrite them in Python:

• Better cross compatibility with Linux.

• Easier migration when upgrade away from end of life language versions.

• File formats are stored in an intermediate representation before conversion.

This project also aims to document how these formats work, so others can reimplement them if needed.

Support Progress

Current progress on implementing conversion and creation support for file formats that are used by the older Puyo Puyo games. Includes regression testing and documentation. Additional file formats may be added if there is a need to modify other Puyo Puyo games.

• Legend:

  • ✅ Fully Supported

  • ⚠️ Partially Supported

  • ❌ Unsupported

File Formats

Format	Conversion	Creation	Testing	Documentation
fmp	✅	✅	✅	✅
fnt	✅	✅	❌	✅
fpd	✅	✅	✅	✅
mtx	⚠️	❌	❌	❌

Compression Algorithms

Algorithm	Compression	Decompression	Testing	Documentation
LZ11/COMP	❌	✅	❌	❌

Table of Contents

• Installation
• Usage

Modding Reference

• Supported Games
• File Formats
  • The fmp format
  • The fnt format
  • The fpd format
  • The mtx format

Development Reference

• API Reference
• Contributing
• Code of Conduct
• Changelog
• Contributors
• License

Useful Links

• PyPI
• GitHub

On this page

• Legacy Puyo Tools
  • Why
  • Support Progress
    • File Formats
    • Compression Algorithms
  • Table of Contents