https://github.com/nazdridoy/rpgmtool

A Python 3 command-line tool for working with RPG Maker archives(RGSS Archives). Supports RPG Maker XP, VX, VX Ace, and MV formats.
https://github.com/nazdridoy/rpgmtool

rgss rgss3 rpg-maker rpgmaker rpgmakermv rpgmakervx rpgmakervxace rpgmakerxp

Last synced: 5 days ago
JSON representation

A Python 3 command-line tool for working with RPG Maker archives(RGSS Archives). Supports RPG Maker XP, VX, VX Ace, and MV formats.

• Host: GitHub
• URL: https://github.com/nazdridoy/rpgmtool
• Owner: nazdridoy
• License: mit
• Created: 2024-12-14T16:28:34.000Z (20 days ago)
• Default Branch: main
• Last Pushed: 2024-12-14T16:36:20.000Z (20 days ago)
• Last Synced: 2024-12-14T17:26:17.572Z (20 days ago)
• Topics: rgss, rgss3, rpg-maker, rpgmaker, rpgmakermv, rpgmakervx, rpgmakervxace, rpgmakerxp
• Language: Python
• Homepage:
• Size: 0 Bytes
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# rpgmtool

A Python 3 command-line tool for working with RPG Maker archives(RGSS Archives). Supports RPG Maker XP, VX, VX Ace, and MV formats.

## Features

- List contents of RGSS archives

- Extract files from archives

- Create new archives

- Support for encrypted RPG Maker MV files

- Configurable encryption keys

- Verbose debug output

![2024-12-14_22-35](https://github.com/user-attachments/assets/e2f80f46-2b23-44e9-a69e-3f54b563b009)

To extract (or decrypt) files from an archive (`file.rgss3a`) to the current directory, use:

```bash

    rpgmtool.py -x file.rgss3a

```

To create an archive (`file.rgss3a`, RPG Maker VX Ace by default) from the contents of a directory (`Data/`), use:

```bash

    rgsstool.py -c -d Data file.rgss3a

```

For RPG Maker XP format, use the -1 flag:

```bash

    rgsstool.py -c -1 file.rgssad Data/ Graphics/

```

For RPG Maker MV games, specify the game directory to extract encrypted files:

```bash

    rgsstool.py --rpgmv game_directory/

```

Additional options:

- `-l, --list`: List files in archive (default mode)

- `-x, --extract`: Extract files from archive  

- `-c, --create`: Create new archive from files

- `-d DIR, --dir DIR`: Directory to extract to or add files from

- `-k KEY, --key KEY`: Encryption key in hexadecimal (default: deadcafe)

- `-v, --verbose`: Show detailed debug information

- `--exts`: Comma-separated list of encrypted file extensions for RPG Maker MV 

  (default: .rpgmvp,.rpgmvm,.rpgmvo,.png_,.m4a_,.ogg_)

Use `--help` for full usage details.