{"id":22941571,"url":"https://github.com/robthepcguy/underworld-overseer-save-mapper","last_synced_at":"2025-04-01T20:49:05.565Z","repository":{"id":267035734,"uuid":"900087766","full_name":"RobThePCGuy/Underworld-Overseer-Save-Mapper","owner":"RobThePCGuy","description":"A WIP Save Game Map Visualizer for Underworld Overseer.","archived":false,"fork":false,"pushed_at":"2025-01-30T02:29:54.000Z","size":137,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T10:59:54.809Z","etag":null,"topics":["dungeon-map","game-map","game-tool","html","interactive-map","python","save-file-analyzer","save-mapper","underworld-overseer","utility","visualization"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RobThePCGuy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-12-07T20:36:33.000Z","updated_at":"2025-02-08T02:30:37.000Z","dependencies_parsed_at":"2024-12-07T21:36:16.935Z","dependency_job_id":null,"html_url":"https://github.com/RobThePCGuy/Underworld-Overseer-Save-Mapper","commit_stats":null,"previous_names":["robthepcguy/underworld-overseer-save-mapper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FUnderworld-Overseer-Save-Mapper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FUnderworld-Overseer-Save-Mapper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FUnderworld-Overseer-Save-Mapper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RobThePCGuy%2FUnderworld-Overseer-Save-Mapper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RobThePCGuy","download_url":"https://codeload.github.com/RobThePCGuy/Underworld-Overseer-Save-Mapper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246709914,"owners_count":20821298,"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","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":["dungeon-map","game-map","game-tool","html","interactive-map","python","save-file-analyzer","save-mapper","underworld-overseer","utility","visualization"],"created_at":"2024-12-14T13:44:22.226Z","updated_at":"2025-04-01T20:49:05.544Z","avatar_url":"https://github.com/RobThePCGuy.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Underworld Overseer Save Mapper\r\n\r\n[![Project Status](https://img.shields.io/badge/Status-Beta-orange)](https://www.repostatus.org/#beta)\r\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\r\n\r\n## Description\r\n\r\nThis tool visualizes save files from the game **Underworld Overseer** as interactive HTML maps. It allows you to:\r\n\r\n*   **View your dungeon layout:** See the rooms, paths, and features of your Underworld Overseer save in a web browser.\r\n*   **Customize appearance:**  Adjust colors for different map elements via a legend in the HTML output.\r\n*   **Search and highlight:**  Quickly find specific map features (like \"Heart Center\" or \"Secret Basement\") using the search bar.\r\n*   **Zoom and pan:** Easily navigate large maps using zoom controls and scrolling.\r\n*   **Dark mode:**  Switch between light and dark themes for comfortable viewing.\r\n\r\nThis mapper is useful for:\r\n\r\n*   **Planning your dungeon layout.**\r\n*   **Sharing your dungeon progress with others.**\r\n*   **Analyzing game mechanics and map generation.**\r\n\r\n## Installation (For running from source - Python required)\r\n\r\nIf you want to run the script directly (Python is needed), follow these steps:\r\n\r\n1.  **Clone the repository:**\r\n    ```bash\r\n    git clone https://github.com/RobThePCGuy/Underworld-Overseer-Save-Mapper.git\r\n    cd Underworld-Overseer-Save-Mapper\r\n    ```\r\n\r\n2.  **Install required Python packages:**\r\n    ```bash\r\n    pip install pandas matplotlib pathlib\r\n    ```\r\n\r\n## Usage\r\n\r\n1.  **Run the script:** Execute the `main.py` script:\r\n    ```bash\r\n    python main.py\r\n    ```\r\n\r\n2.  **Select a save file:** The script will list available Underworld Overseer save files from the default saves directory.\r\n    *   Choose a save file by entering its number.\r\n    *   Alternatively, you can enter a custom file path to a `.json` save file.\r\n\r\n3.  **Open the HTML map:** After processing, the script will generate an HTML file (e.g., `Besieged.html`) in the same directory as `main.py`. Open this HTML file in your web browser (Chrome, Firefox, etc.) to view the interactive map.\r\n\r\n## Usage (Running the Executable - No Python needed)\r\n\r\n1.  **Download the Executable:** Download the the .exe from\r\n2.  **Run the Executable:**  Place the app exe in a convenient location and run it.\r\n3.  **Follow on-screen instructions:** The executable will guide you through selecting a save file and generating the HTML map.\r\n\r\n## Configuration\r\n\r\n*   **`CONFIG_CUSTOM_COLORS` and `CONFIG_CUSTOM_LABELS`:** You can customize the colors and labels of map elements by editing these dictionaries in the `main.py` script before generating the EXE or running from source.\r\n\r\n##  License\r\n\r\nThis project is licensed under the [MIT License](LICENSE) - see the `LICENSE` file for details.\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please fork the repository and submit a pull request with your enhancements or bug fixes.\r\n\r\n## Issues and Feature Requests\r\n\r\nIf you encounter any issues or have suggestions for new features, please open an issue on the [GitHub issue tracker]([link to your repo's issues]).\r\n\r\n## Acknowledgements\r\n\r\n*   This tool was inspired by and built for the game **Underworld Overseer** by Myron Software.\r\n*   Uses [pandas](https://pandas.pydata.org/), [matplotlib](https://matplotlib.org/), and [PyInstaller](https://pyinstaller.org/).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthepcguy%2Funderworld-overseer-save-mapper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobthepcguy%2Funderworld-overseer-save-mapper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobthepcguy%2Funderworld-overseer-save-mapper/lists"}