{"id":27137,"library":"maseya-z3pr","title":"maseya-z3pr","description":"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.","status":"active","version":"1.0.0rc1","language":"python","source_language":"en","source_url":"https://github.com/maseya/z3pr-py","tags":["zelda","palette","randomizer","retro"],"install":[{"cmd":"pip install maseya-z3pr==1.0.0rc1","lang":"bash","label":"Install release candidate"}],"dependencies":[],"imports":[{"note":"Main class for randomizing palettes.","symbol":"Z3Randomizer","correct":"from z3pr import Z3Randomizer"},{"note":"Enum for available palette modes.","symbol":"PaletteMode","correct":"from z3pr import PaletteMode"}],"quickstart":{"code":"from z3pr import Z3Randomizer, PaletteMode\n\n# Create randomizer instance\nrandomizer = Z3Randomizer()\n\n# Generate a randomized palette (e.g., inverted mode)\nresult = randomizer.randomize(PaletteMode.INVERTED)\n\nprint(result)  # Output: randomized palette data","lang":"python","description":"Basic usage of the library to randomize a palette."},"warnings":[{"fix":"Pin version to rc1 if stability is required; expect breaking changes in future.","message":"Library is a release candidate (1.0.0rc1). API may change before stable release.","severity":"gotcha","affected_versions":"1.0.0rc1"},{"fix":"Check examples/ directory on GitHub for usage patterns.","message":"Documentation is minimal; developers should refer to the GitHub README and source code.","severity":"gotcha","affected_versions":"*"},{"fix":"Upgrade Python to 3.4 or later.","message":"Library depends on Python >=3.4. On older systems, install may fail.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Ensure you have installed the package: pip install maseya-z3pr==1.0.0rc1, then import using 'from z3pr import ...'.","cause":"Library is installed as maseya-z3pr but imported as z3pr.","error":"ModuleNotFoundError: No module named 'z3pr'"},{"fix":"Import directly from the package: 'from z3pr import Z3Randomizer'.","cause":"Incorrect import path (e.g., trying 'from maseya_z3pr import ...').","error":"AttributeError: module 'z3pr' has no attribute 'Z3Randomizer'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}