maseya-z3pr

1.0.0rc1 verified Fri May 01 auth: no python

Python library for randomizing palette data in The Legend of Zelda: A Link to the Past. Currently at version 1.0.0rc1 (release candidate). Licensed under MIT, supports Python >=3.4.

pip install maseya-z3pr==1.0.0rc1

Common errors

error ModuleNotFoundError: No module named 'z3pr' ↓

cause Library is installed as maseya-z3pr but imported as z3pr.

fix

Ensure you have installed the package: pip install maseya-z3pr==1.0.0rc1, then import using 'from z3pr import ...'.

error AttributeError: module 'z3pr' has no attribute 'Z3Randomizer' ↓

cause Incorrect import path (e.g., trying 'from maseya_z3pr import ...').

fix

Import directly from the package: 'from z3pr import Z3Randomizer'.

Warnings

gotcha Library is a release candidate (1.0.0rc1). API may change before stable release. ↓

fix Pin version to rc1 if stability is required; expect breaking changes in future.

gotcha Documentation is minimal; developers should refer to the GitHub README and source code. ↓

fix Check examples/ directory on GitHub for usage patterns.

gotcha Library depends on Python >=3.4. On older systems, install may fail. ↓

fix Upgrade Python to 3.4 or later.

Imports

Z3Randomizer
```
from z3pr import Z3Randomizer
```
Main class for randomizing palettes.
PaletteMode
```
from z3pr import PaletteMode
```
Enum for available palette modes.

Quickstart

Basic usage of the library to randomize a palette.

from z3pr import Z3Randomizer, PaletteMode

# Create randomizer instance
randomizer = Z3Randomizer()

# Generate a randomized palette (e.g., inverted mode)
result = randomizer.randomize(PaletteMode.INVERTED)

print(result)  # Output: randomized palette data