Metadata-Version: 2.1
Name: open-dread-rando
Version: 1.2.1
Summary: An open source randomizer patcher for Metroid Dread.
Home-page: https://github.com/randovania/open-dread-rando
Author: Henrique Gemignani
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Provides-Extra: test
License-File: LICENSE

# Open Dread Rando
Open Source randomizer patcher for Metroid Dread. Intended for use in [Randovania](https://github.com/randovania).
Currently supports patching item pickups, starting items, and elevator/shuttle/teleportal destinations.

## Installation
`pip install open-dread-rando`

## Usage
You will need to provide JSON data matching the [JSON schema](https://github.com/randovania/open-dread-rando/blob/main/open_dread_rando/files/schema.json) in order to successfully patch the game. 

The patcher expects a path to an extracted romfs directory of Metroid Dread 1.0.0 as well as the desired output directory. Output files are in the Atmosphere format and should be compatible with Ryujinx and Yuzu.

With a JSON file:
`python -m open-dread-rando --input-path ~/dread/romfs --output-path ~/your-ryujinx-mod-folder/rando --input-json ~/dreadrando/patcher.json`

From stdin:
`python -m open-dread-rando --input-path ~/dread/romfs --output-path ~/your-ryujinx-mod-folder/rando`

## Game Versions

Only versions 1.0.0 and the latest version are supported long term. Other versions might be compatible at any given point, but new releases are free to remove that.

Currently, the following versions are supported:
- 1.0.0
- 2.0.0
- 2.1.0
