{"id":13530476,"url":"https://github.com/csinkers/ualbion","last_synced_at":"2026-01-22T20:34:43.782Z","repository":{"id":38128236,"uuid":"235252160","full_name":"csinkers/ualbion","owner":"csinkers","description":"A remake of the 1995 RPG Albion (requires data from an install of the original game)","archived":false,"fork":false,"pushed_at":"2025-11-18T14:50:15.000Z","size":9542,"stargazers_count":154,"open_issues_count":45,"forks_count":11,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-11-18T16:36:50.021Z","etag":null,"topics":["classic-game","cross-platform","game-dev","linux-gaming","remake"],"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/csinkers.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":"2020-01-21T03:59:08.000Z","updated_at":"2025-11-18T14:50:20.000Z","dependencies_parsed_at":"2025-08-31T17:34:15.877Z","dependency_job_id":null,"html_url":"https://github.com/csinkers/ualbion","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/csinkers/ualbion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csinkers%2Fualbion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csinkers%2Fualbion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csinkers%2Fualbion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csinkers%2Fualbion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/csinkers","download_url":"https://codeload.github.com/csinkers/ualbion/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/csinkers%2Fualbion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28670385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T19:36:09.361Z","status":"ssl_error","status_checked_at":"2026-01-22T19:36:05.567Z","response_time":144,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["classic-game","cross-platform","game-dev","linux-gaming","remake"],"created_at":"2024-08-01T07:00:50.421Z","updated_at":"2026-01-22T20:34:43.763Z","avatar_url":"https://github.com/csinkers.png","language":"C#","funding_links":[],"categories":["RPG"],"sub_categories":[],"readme":"# UAlbion\nA remake of the 1995 RPG Albion \n\nPrerequisites: \n* [.NET 9](https://docs.microsoft.com/en-us/dotnet/core/install/)\n* Game data from an install of the original game ([full version](https://www.gog.com/game/albion) or [demo](https://archive.org/details/Albidemo))\n\n## Screenshots\n\u003cdetails\u003e\n  \u003csummary\u003eClick to expand\u003c/summary\u003e\n\n  ![Example Screenshot 1](/.github/screenshots/1_FirstLevel.png?raw=true)\n  ![Example Screenshot 2](/.github/screenshots/2_3DWorld.png?raw=true)\n  ![Example Screenshot 3](/.github/screenshots/3_Outdoors.png?raw=true)\n  ![Example Screenshot 4](/.github/screenshots/4_Inventory.png?raw=true)\n  ![Example Screenshot 5](/.github/screenshots/5_MainMenu.png?raw=true)\n\u003c/details\u003e\n\n## Current Status\n\nThings that are at least somewhat implemented:\n- Rendering of 2D and 3D environments\n- Player movement and collision detection in 2D environments\n- Interaction with the environment, e.g. examining objects, accessing chests and opening doors\n- GUI system for menus, dialogs, inventory etc\n- Inventory management\n- Conversations\n- Sound effects and music\n- Loading/saving saved games\n- Video playback\n- Exporting assets\n- Day/night cycle\n- NPC movement\n\nCurrently unimplemented:\n- Lighting model for 3D levels\n- Event handling and collision detection in 3D environments\n- Automap for 3D environments\n- Combat system\n- Magic system\n\nPlanned improvements / changes from the original gameplay:\n- Add hotkeys to streamline the interface, reduce the amount of right clicking required etc\n- Add some pathfinding logic to make mouse-based movement easier\n- Add a take-all button when looting chests / fallen foes (done)\n- Graphical improvements in 3D environments\n- Fix bugs in original game (with option to toggle when there is a gameplay impact)\n- Modding support\n- A built-in editor for modifying and adding assets\n\n## Getting started\n\n### Game data\n\nYou need to have the original Albion game files. These days, Albion can be bought cheaply on [GOG](https://www.gog.com/game/albion).\n\nIf you have the GOG version of the game, extract the required game files as follows:\n\n#### Linux:\n1. Ensure `wine` and `dosbox` are installed\n1. Download the [Albion installer for Windows from GOG](https://www.gog.com/game/albion)\n1. Run the installer using wine (`wine setup_albion_1.38_\\(28043\\).exe`). Note that the installer may show some errors, but if the game can be launched in the end, it's okay.\n1. Run `dosbox`\n1. Run the following commands in dosbox to extract the data files. Replace `~/ualbion` with wherever you cloned the ualbion repository. Replace `~/.wine/drive_c/GOG Games/Albion/` with wherever you installed your GOG version of Albion. Note the double quotes (`\"`), they are necessary if your path contains spaces.\n    1. `mount C \"~/ualbion\"`\n    1. `mount D \"~/.wine/drive_c/GOG Games/Albion/\"`\n    1. `C:\\src\\Tools\\GOG_EXTR.BAT`\n\n#### Windows:\n1. Download the [Albion installer from GOG](https://www.gog.com/game/albion)\n1. Run installer\n1. Open the Albion install directory in file explorer (e.g. `C:\\GOG Games\\Albion`)\n1. Go into the `DOSBOX` directory and run `DOSBOX.exe`\n1. Run the following commands in dosbox to extract the data files. Replace `C:\\Git\\ualbion` with wherever you cloned the ualbion repository. Replace `C:\\GOG Games\\Albion` with wherever you installed your GOG version of Albion. Note the double quotes (`\"`), they are necessary if your path contains spaces.\n    1. `mount C \"C:\\Git\\ualbion\"`\n    1. `mount D \"C:\\GOG Games\\Albion\"`\n    1. `C:\\src\\Tools\\GOG_EXTR.BAT`\n\nIf you're not using the GOG version or want to select your game files manually, you can either copy the files into an \"ALBION\" subdirectory manually or configure `data/config.json` to set the paths for the files. The files can also be manually extracted from the GOG version by mounting the `game.gog` file using CDemu (it's just a raw binary dump of the CD contents) and then copy the ALBION directory into your UAlbion folder.\n\n### Compile and run\n\nTo compile and run the project the easiest way is to use the run script (i.e. `run.bat` on Windows and `run.sh` on Linux).\n- To start with default options, use `run` without parameters\n- To show available options: `run -h` or `run --help`\n- To run with Vulkan: `run -vk`\n- To run with OpenGL: `run -gl`\n- To run with Direct3D: `run -d3d`\n- To extract all game resources into modern formats under the mods/Unpacked dir: `run -b Albion Unpacked`\n- To repack the (possibly modified) assets in mods/Unpacked back into the original binary formats: `run -b Unpacked Repacked` (outputs to mods/Repacked)\n\nFor developers, any C# IDE should work (e.g. VS Code, Visual Studio, Rider etc). The available solutions are:\n- `src/ualbion.nodeps.sln`: Loads ualbion with dependencies from NuGet (recommended for getting started)\n- `src/ualbion.full.sln`: Loads ualbion with local dependencies (requires `get_dependencies` to have been run, recommended for advanced development, e.g. if debugging into the dependencies is required)\n- `src/ualbion.ci.sln`: A solution for use by the continuous integration environment in github. Excludes tests that rely on the original assets being present.\n\n## Attributions\nMany thanks to Florian Ziesche and the other contributers to the [freealbion wiki](https://github.com/freealbion/freealbion/wiki) for their efforts in discovering and documenting the Albion file formats.\n\nThanks to IllidanS4 for the ILBM loading code in [AlbLib](https://github.com/IllidanS4/AlbLib) (MIT License) which my InterlacedBitmap implementation was based on.\n\nThanks also to the authors of and contributers to the dependencies of this project:\n- [Veldrid](https://github.com/mellinoe/veldrid) graphics API abstraction by Eric Mellino et al\n- [ImGui](https://github.com/ocornut/imgui/) immediate mode graphics library by Omar Cornut et al\n- [OpenAL](https://www.openal.org/) audio abstraction API from Loki Entertainment / Creative Technology\n- [OpenAL-CS](https://github.com/flibitijibibo/OpenAL-CS) C# wrapper for OpenAL (using the NuGet package of the [OpenRA](https://github.com/OpenRA/OpenAL-CS) fork)\n- [AdlMidi](https://github.com/Wohlstand/libADLMIDI) OPL-3 synthesiser library by Vitaly Novichkov, Joel Yliluoma et al\n- [Superpower](https://github.com/datalust/superpower) C# parsing library by Nicholas Blumhardt et al\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsinkers%2Fualbion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcsinkers%2Fualbion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcsinkers%2Fualbion/lists"}