rpgxp-project

rpgm-tool

rpgm-tool is a CLI to read and write RPGMaker XP and VX game files. This includes rgssad and rxdata files. Currently, it is NOT capable of byte-for-byte round-tripping game files, but repacked files work normally in games. This is due to differences in compression and the fact that this library does not dedupe game assets as much as it needs to.

Usage

# Unpacking a game
rpgmxp-tool unpack path/to/game/dir unpacked

# Unpacking an rgssad
rpgmxp-tool unpack path/to/game/dir/Game.rgssad unpacked

# Packing a game
rpgmxp-tool pack unpacked path/to/new/dir

# Packing an rgssad
rpgmxp-tool pack unpacked path/to/new/dir/Game.rgssad

Notes

The following objects can be deduped inside an archive:

• String (what cases?)
• MoveCommands

VX Ace Archive creation is untested. String encoding for vx data types does not use encodings.

Resources

• https://github.com/selectivepaperclip/rpgm2renpy/blob/ff847ff9f9a00cabd6f6c894be4c72711d0c76fd/game/rpgm_constants.rpy
• https://github.com/cstrahan/open-rpg-maker
• https://www.rpg-maker.fr/dl/monos/aide/xp/index.html
• https://www.rpg-maker.fr/dl/monos/aide/vx/index.html
• https://rpgmaker.fixato.org/Manual/RPGVXAce/rgss/