{"id":13530151,"url":"https://github.com/AbyssEngine/AbyssEngine","last_synced_at":"2025-04-01T17:32:10.690Z","repository":{"id":232056400,"uuid":"783346587","full_name":"AbyssEngine/AbyssEngine","owner":"AbyssEngine","description":"Abyss Engine clean-room reimplementation of Diablo 2, written in C. The goal is to recreate the original game engine, but on a portable platform that can also easily be modded and extended.","archived":false,"fork":false,"pushed_at":"2024-04-13T20:39:31.000Z","size":3087,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-04-13T20:56:53.808Z","etag":null,"topics":["c","diablo","diablo2","game-engine"],"latest_commit_sha":null,"homepage":"","language":"C","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/AbyssEngine.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}},"created_at":"2024-04-07T16:32:32.000Z","updated_at":"2024-04-17T02:57:38.052Z","dependencies_parsed_at":"2024-04-17T02:57:37.156Z","dependency_job_id":"5cad0b1b-931d-457a-b1fa-60bb5af305fc","html_url":"https://github.com/AbyssEngine/AbyssEngine","commit_stats":null,"previous_names":["abyssengine/abyssengine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbyssEngine%2FAbyssEngine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbyssEngine%2FAbyssEngine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbyssEngine%2FAbyssEngine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AbyssEngine%2FAbyssEngine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AbyssEngine","download_url":"https://codeload.github.com/AbyssEngine/AbyssEngine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222748291,"owners_count":17031898,"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":["c","diablo","diablo2","game-engine"],"created_at":"2024-08-01T07:00:44.769Z","updated_at":"2024-11-02T16:31:47.100Z","avatar_url":"https://github.com/AbyssEngine.png","language":"C","readme":"# Abyss Engine\n\nAbyss Engine clean-room reimplementation of **Diablo 2**, written in C.\nThe goal is to recreate the original game engine, but on a portable platform that can also easily be modded and\nextended.\n\nThis is **not** a reverse-engineering project, and no original code from the game is used. It will also not be\ncompaible with the original game's save files or multiplayer systems.\n\nBefore running the engine, make sure it is [configured](#configuration) properly.\n\nYou can hang out with the developers and other community members on `#AbyssEngine` at `irc.libera.chat`.\nWe no longer maintain a Discord presence. Any such servers are not affiliated with this project.\n\n## Supported Platforms\n\n* Windows 10+ (x64, Arm64)\n* macOS (Arm64)\n* Linux (x64, Arm64)\n\nOther platforms may work, but are not officially supported.\n\n## Building\n\n### Prerequisites\n\n* CMake 3.20 or later\n* A C99 compliant compiler (GCC, Clang, MSVC)\n\nPlease make sure you recursively pull the submodules when cloning the repository:\n\n```bash\ngit submodule update --init --recursive\n```\n\n### Compiling\n\n#### Visual Studio 2022 / Clion / VSCode (with CMake Tools extensions)\n\nOpen the root project folder in the IDE and build the solution.\n\n#### XCode\n\nGenerate an XCode project with cmake:\n\n```bash\nmkdir build\ncd build\ncmake .. -G Xcode\n```\n\nThen load the generated Xcode project and build it.\n\n#### Command Line\n\n```bash\nmkdir build\ncd build\ncmake .. -DCMAKE_BUILD_TYPE=Release\n```\n\n### Running\n\nOn **Linux** and **Windows**, you can run the engine by executing the `abyss` executable in the build directory.\n\nFor **macOS**, you can run the engine by executing the `Abyss Engine.app` bundle in the build directory.\n\nPlease note that the engine requires the `abyss.ini` configuration file. If you haven't set it,\nplease refer to the [Configuration](#configuration) section below.\n\n### Output Logs\n\nIf you run AbyssEngine from the command line, it will output logs to the console.\nOn **macOS**, you will need to run the binary directly by executing the binary inside\nof the app bundle on the command line:\n\n```bash\n./AbyssEngine.app/Contents/MacOS/AbyssEngine\n```\n\n## Configuration\n\n### MPQ files\n\nThis engine requires the original Diablo 2+LOD MPQ files to run. These files are not included in the repository.\nYou can legally obtain them by purchasing a physical copy of the game, or from a digital distribution platform\nsuch as battle.net.\n\nThere are a lot of pirated versions of the game available online, but we do not condone piracy, and most of them\nare modded in a way that is not supported by the engine. Please don't waste developer resources by reporting issues\nwhile using pirated versions of the game.\n\n### abyss.ini\n\nIn order for Abyss Engine to run, it needs to load abyss.ini. A template of this file is located at\n`/content/abyss.ini` in the source repo, and should be placed in the local settings folder for abyss\nbased on the platform:\n\n- Windows: `%APPDATA%/abyss/abyss.ini`\n- Linux: `~/.config/abyss/abyss.ini`\n- MacOS: `~/Library/Application Support/abyss/abyss.ini`\n\nPlease make sure that you have copied the template file into that location, and updated it to match your system.","funding_links":[],"categories":["游戏","RPG"],"sub_categories":["网络服务_其他"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAbyssEngine%2FAbyssEngine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAbyssEngine%2FAbyssEngine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAbyssEngine%2FAbyssEngine/lists"}