{"id":21179,"library":"dolphin-memory-engine","title":"Dolphin Memory Engine","description":"Python library for reading and writing the memory of running Dolphin (GameCube/Wii emulator) processes. Provides a high-level interface to access game memory addresses, supporting both GameCube and Wii titles. Current version is 1.3.1, with limited API wheels and Python 3.9+ support. The project is actively maintained.","status":"active","version":"1.3.1","language":"python","source_language":"en","source_url":"https://github.com/henriquegemignani/py-dolphin-memory-engine","tags":["dolphin","memory","gamecube","wii","emulator","cheat-engine"],"install":[{"cmd":"pip install dolphin-memory-engine","lang":"bash","label":"Standard install"}],"dependencies":[{"reason":"Legacy package name, no longer updated; use dolphin-memory-engine instead","package":"py-dolphin-memory-engine","optional":false}],"imports":[{"note":"The class is named DolphinMemoryEngine, not the module name","wrong":"from dolphin_memory_engine import dolphin_memory_engine","symbol":"DolphinMemoryEngine","correct":"from dolphin_memory_engine import DolphinMemoryEngine"},{"symbol":"read_word","correct":"from dolphin_memory_engine import read_word"},{"symbol":"write_word","correct":"from dolphin_memory_engine import write_word"},{"symbol":"hook","correct":"from dolphin_memory_engine import hook"},{"symbol":"unhook","correct":"from dolphin_memory_engine import unhook"},{"symbol":"is_hooked","correct":"from dolphin_memory_engine import is_hooked"},{"symbol":"get_status","correct":"from dolphin_memory_engine import get_status"}],"quickstart":{"code":"from dolphin_memory_engine import hook, is_hooked, read_word\n\nhook()\nif is_hooked():\n    # Example: read word from address 0x80000000\n    value = read_word(0x80000000)\n    print(f\"Value at 0x80000000: {value}\")\nelse:\n    print(\"Failed to hook into Dolphin. Is Dolphin running?\")\nunhook()","lang":"python","description":"Basic hook and memory read. Ensure Dolphin emulator is running before calling hook()."},"warnings":[{"fix":"Install 'dolphin-memory-engine' instead of 'py-dolphin-memory-engine'.","message":"The package was renamed from 'py-dolphin-memory-engine' to 'dolphin-memory-engine' in v1.3.0. The old package may still exist but is outdated.","severity":"breaking","affected_versions":">=1.3.0"},{"fix":"Wrap hook() in a try-except or call is_hooked() immediately after hook().","message":"hook() will raise an exception if Dolphin is not running or if the emulated game is not started. Always check is_hooked() after hook() or use try/except.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade Python to 3.9 or later.","message":"Python 3.8 support was dropped in v1.3.0. If you are on Python 3.8, you must upgrade to Python 3.9+.","severity":"deprecated","affected_versions":">=1.3.0"},{"fix":"Use a supported platform (Linux or Windows) or build from source.","message":"The library uses ctypes and a C extension, which may not be available on all platforms. macOS wheels are provided but not tested; if import fails, install from source or use Linux/Windows.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from dolphin_memory_engine import read_word' instead of importing the class.","cause":"Importing the class name instead of the top-level functions.","error":"DolphinMemoryEngine' object has no attribute 'read_word'"},{"fix":"Ensure Dolphin is running and the game is started. On Linux, you may need to run the script with appropriate permissions (e.g., sudo).","cause":"Dolphin emulator is not running or the game process is not accessible (e.g., running as different user).","error":"dolphin_memory_engine.hook() -> Exception: Failed to hook"},{"fix":"Import functions directly: 'from dolphin_memory_engine import read_word, write_word, hook, unhook'.","cause":"Using an outdated import path (treating the module as a function).","error":"ImportError: cannot import name 'dolphin_memory_engine' from 'dolphin_memory_engine' (unknown location)"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}