{"id":35214398,"url":"https://github.com/wiztailworks/wiz_codex","last_synced_at":"2026-05-22T07:04:40.361Z","repository":{"id":296433019,"uuid":"993387032","full_name":"wiztailworks/wiz_codex","owner":"wiztailworks","description":"Unofficial map tool for Wizardry: The Five Ordeals / 五つの試練用マップ支援ツール","archived":false,"fork":false,"pushed_at":"2025-06-25T11:59:48.000Z","size":3602,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T12:47:27.803Z","etag":null,"topics":["five-ordeals","map-viewer","overlay-tool","steam-game","tkinter","unofficial","wizardry"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wiztailworks.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-30T17:46:33.000Z","updated_at":"2025-06-25T11:59:51.000Z","dependencies_parsed_at":"2025-06-14T08:20:14.450Z","dependency_job_id":null,"html_url":"https://github.com/wiztailworks/wiz_codex","commit_stats":null,"previous_names":["wiztailworks/wiz_codex"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/wiztailworks/wiz_codex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiztailworks%2Fwiz_codex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiztailworks%2Fwiz_codex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiztailworks%2Fwiz_codex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiztailworks%2Fwiz_codex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wiztailworks","download_url":"https://codeload.github.com/wiztailworks/wiz_codex/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wiztailworks%2Fwiz_codex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28121157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-29T02:00:07.021Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["five-ordeals","map-viewer","overlay-tool","steam-game","tkinter","unofficial","wizardry"],"created_at":"2025-12-29T21:01:11.465Z","updated_at":"2025-12-29T21:04:46.690Z","avatar_url":"https://github.com/wiztailworks.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wiz Codex: Lifebook\r\n\r\n❤️ Battle companion tool for *Wizardry: The Five Ordeals (Steam)*.  \r\nEnter party HP during combat to lock → enemy HP becomes visible.  \r\nDisplays party HP with optional life bars, plus Always-on-Top mode.\r\n\r\n---\r\n\r\n# Wiz Codex: Mapbook\r\n\r\n\r\n🧭 A lightweight companion tool to automatically capture and organize dungeon maps  \r\nfor *Wizardry: The Five Ordeals (Steam)* explorers.\r\n\r\n---\r\n\r\n## 💡 Features at a Glance\r\n\r\n- Auto-captures the in-game map only when opened\r\n- Floating minimap overlay (always on top, draggable)\r\n- Scenario-based map folders\r\n- English/Japanese toggle (🌐)\r\n- Read-only memory scan (safe, non-intrusive)\r\n  \r\n![Wiz Codex: Mapbook UI](./screenshot_main_ui.png)\r\n\r\n*Main UI showing position, direction, floor, and map capture options.*\r\n\r\n![Wiz game screen with overlay](./screenshot_overlay.png)\r\n\r\n*Minimap overlaying the game screen (drag to move, always on top).*\r\n\r\n---\r\n\r\n## 🚀 Quick Start\r\n\r\n1. Launch *Wizardry: The Five Ordeals* (Steam)\r\n2. Start **Wiz Codex: Mapbook** *after* the game is running\r\n3. Perform a **rescan** inside a dungeon if the game was restarted\r\n\r\n→ Full guide and FAQ below 👇\r\n\r\n---\r\n\r\n## Overview\r\n\r\nIf this map refuses to cooperate, even magic might not help.  \r\nA lightweight companion tool for explorers wandering the dungeons of *Wizardry: The Five Ordeals (Steam)*.\r\n\r\nThis tool automatically captures, organizes, and displays dungeon maps.  \r\nIt supports scenario folders, a floating minimap overlay, and both English/Japanese UI.\r\n\r\n## Quick Start\r\n\r\n1. **Launch Wizardry: The Five Ordeals (Steam).**\r\n2. **Start Wiz Codex: Mapbook *after* the game is running.**  \r\n   If the game is not running, this tool cannot connect and will not function properly.\r\n3. **Perform an address rescan** the first time, or whenever the game has been restarted.  \r\n   Make sure you are inside a dungeon (exploration mode) when doing this.\r\n   - You do *not* need to rescan after returning to the title screen or resetting in-game.\r\n   - A rescan is needed only after fully restarting the game application, as memory addresses change each time.\r\n4. When the scan succeeds, your **direction**, **X/Y coordinates**, and **floor** will be displayed.\r\n5. Select your current scenario from the dropdown menu.\r\n   - Use the ➕ button to create a new scenario folder.\r\n   - Click the 📂 button to open the folder where maps are saved.\r\n6. Enable **Auto Map Capture** to save a screenshot automatically  \r\n   when you open the in-game map screen (not during normal gameplay).\r\n7. To display the minimap, enable the **Minimap** checkbox.  \r\n   The minimap window stays always on top and can be freely dragged.\r\n8. Click the 🌐 button to switch between English and Japanese.\r\n9. To exit, simply close the window.\r\n\r\n\u003e **Note:**\r\n\u003e - Administrator rights may be required. If you see access errors, try running as administrator.\r\n\u003e - Windows only. Not compatible with other operating systems.\r\n\u003e - Game updates may affect compatibility; continued support is not guaranteed.\r\n\u003e - This tool is read-only. It does *not* modify game data or interfere with gameplay.\r\n\u003e - PyAutoGUI is used for automation and screenshots. Some antivirus software may flag this.\r\n\u003e - Use at your own risk.\r\n\r\n## Features\r\n\r\n- Multiple scenario folders (map images are organized per scenario)\r\n- Floating minimap overlay (always on top, draggable)\r\n- Address rescan:\r\n  - Fast mode using known tail-hex patterns from CSV\r\n  - Full scan fallback (10–30 sec) if needed\r\n  - Game input is locked during scanning to prevent changes\r\n- Auto map capture: triggered only when the in-game map is open\r\n- Manual map capture and scenario management\r\n- English/Japanese language toggle (🌐)\r\n- Theming available via code (for advanced users)\r\n\r\n## FAQ\r\n\r\n- **Which game version is supported?**  \r\n  Verified with the Steam version. Compatibility with future updates is not guaranteed.\r\n- **Can I manage multiple scenarios?**  \r\n  Yes. Each scenario has its own folder. Use the ➕ button to create new ones.\r\n- **Will there be updates or new features?**  \r\n  Maybe. No promises.\r\n- **What are the dependencies?**  \r\n  pymem\r\n  pyautogui\r\n  Pillow\r\n  pywin32\r\n\r\n- **Is there an EXE version?**  \r\n  Yes, see the Releases section.\r\n- **Can I change the theme or icon?**  \r\n  Not officially supported. Advanced users may edit the code directly.\r\n- **What if it doesn’t work?**  \r\n  Make sure to scan addresses while inside a dungeon.  \r\n  If problems persist, restart the tool and try again.\r\n- **Open Source / PRs?**  \r\n  MIT licensed. Suggestions and PRs are welcome, but may not be reviewed or merged.\r\n\r\n## License\r\n\r\nThis tool is released under the [MIT License](LICENSE).  \r\nFeel free to explore, modify, and share—just like a true adventurer would.\r\n\r\n---\r\n\r\n# 日本語版\r\n\r\n## 概要\r\n\r\nIf this map refuses to cooperate, even magic might not help.  \r\n『Wizardry外伝 五つの試練』（Steam）探索中のダンジョンマップを、  \r\n自動でキャプチャ・整理・表示できる軽量ツールです。\r\n\r\nシナリオ別フォルダ、ミニマップオーバーレイ、日本語／英語UI切替に対応しています。\r\n\r\n## 使い方\r\n\r\n1. **まず『五つの試練』（Steam版）を起動してください。**\r\n2. **ゲーム起動後に本ツール（Wiz Codex: Mapbook）を起動します。**  \r\n   ゲームが起動していないと、正常に動作しません。\r\n3. **初回またはゲームを再起動したときは、**  \r\n   ダンジョン内（探索中）で「アドレス再スキャン」を行ってください。\r\n   - タイトル画面に戻っただけなら再スキャンは不要です。\r\n   - 完全にゲームを再起動した場合（Steamウィンドウから再起動など）は、  \r\n     メモリアドレスが変わるためスキャンが必要です。\r\n4. スキャンが成功すると、「向き」「X/Y座標」「フロア」が表示されます。\r\n5. コンボボックスでプレイ中のシナリオを選んでください。\r\n   - 「➕」で新規シナリオフォルダを作成できます。\r\n   - 「📂」を押すと、マップ画像の保存先フォルダが開きます。\r\n6. **「マップ自動保存」にチェックを入れると、**  \r\n   ゲーム内マップ画面を開いたときにだけ自動で画像が保存されます。\r\n7. ミニマップを表示したい場合は「ミニマップ」チェックをONにしてください。  \r\n   ウィンドウは常に最前面に表示され、自由に移動できます。\r\n8. 「🌐」ボタンでUIの言語を切り替えられます（日本語／英語）。\r\n9. 終了するには、ウィンドウを閉じるだけです。\r\n\r\n\u003e **注意事項:**\r\n\u003e - アクセスエラー時は「管理者として実行」してください。\r\n\u003e - Windows専用です。他のOSでは動作しません。\r\n\u003e - ゲームのアップデートにより動作しなくなる可能性があります。\r\n\u003e - 本ツールは読み取り専用で、ゲームデータを変更したり干渉したりしません。\r\n\u003e - スクリーンショットや一部自動化には PyAutoGUI を使用しています。  \r\n\u003e   一部のウイルス対策ソフトで警告が出ることがあります。\r\n\u003e - ご利用は自己責任でお願いいたします。\r\n\r\n## 主な機能\r\n\r\n- シナリオ別フォルダによるマップ整理\r\n- ミニマップ表示（常に最前面・ドラッグ移動可能）\r\n- アドレス再スキャン機能\r\n  - 既知の末尾16進コード（CSV）による高速スキャン\r\n  - 見つからない場合はフルスキャン（10～30秒）\r\n  - スキャン中はアドレス変動防止のため入力を一時ロック\r\n- 自動マップ保存（マップ画面を開いた時のみ保存）\r\n- 手動保存、シナリオ管理対応\r\n- 日本語／英語切替ボタン（🌐）\r\n- テーマ変更はコード編集で可能（上級者向け）\r\n\r\n## よくある質問\r\n\r\n- **対応バージョンは？**  \r\n  Steam版で動作確認済み。将来的なアップデートで動作しなくなる可能性があります。\r\n- **複数シナリオの管理はできる？**  \r\n  可能です。シナリオごとに個別フォルダで保存されます。\r\n- **今後のアップデート予定は？**  \r\n  未定です。\r\n- **依存モジュールは？**  \r\n  pymem\r\n  pyautogui\r\n  Pillow\r\n  pywin32\r\n\r\n- **EXE版はある？**  \r\n  Releases ページで配布予定です。\r\n- **見た目やアイコンの変更は？**  \r\n  公式には対応していません。コード編集できる方は自由にどうぞ。\r\n- **うまく動かないときは？**  \r\n  必ず「ダンジョン内」で再スキャンしてください。  \r\n  それでも動作しない場合は、ツールを再起動してみてください。\r\n- **OSS／PRについて**  \r\n  MITライセンスです。意見・PR歓迎ですが、必ず対応できるとは限りません。\r\n\r\n## ライセンス\r\n\r\nこのツールは [MITライセンス](LICENSE) に基づき公開されています。  \r\n自由に使って、改造して、冒険に役立ててください。\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiztailworks%2Fwiz_codex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwiztailworks%2Fwiz_codex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwiztailworks%2Fwiz_codex/lists"}