https://github.com/nathaniel-daniel/rpgmxp-project
A tool to edit RPGMaker XP game files
https://github.com/nathaniel-daniel/rpgmxp-project
rgssad rpgmaker rpgmakervx rpgmakerxp rust
Last synced: 5 months ago
JSON representation
A tool to edit RPGMaker XP game files
- Host: GitHub
- URL: https://github.com/nathaniel-daniel/rpgmxp-project
- Owner: nathaniel-daniel
- License: apache-2.0
- Created: 2023-11-07T02:27:28.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-08-01T22:50:17.000Z (11 months ago)
- Last Synced: 2025-08-02T00:36:13.689Z (11 months ago)
- Topics: rgssad, rpgmaker, rpgmakervx, rpgmakerxp, rust
- Language: Rust
- Homepage: https://nathaniel-daniel.github.io/rpgmxp-project/rpgmxp_types/
- Size: 2.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# 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
```bash
# 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/