{"id":13441762,"url":"https://github.com/calref/cboe","last_synced_at":"2026-01-11T03:39:37.531Z","repository":{"id":8632726,"uuid":"10279084","full_name":"calref/cboe","owner":"calref","description":"Classic Blades of Exile","archived":false,"fork":false,"pushed_at":"2023-02-04T23:54:07.000Z","size":51800,"stargazers_count":161,"open_issues_count":176,"forks_count":41,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-04-14T02:20:21.774Z","etag":null,"topics":["game","rpg"],"latest_commit_sha":null,"homepage":"http://spiderwebforums.ipbhost.com/index.php?/forum/12-blades-of-exile/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/calref.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","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":"2013-05-25T03:25:59.000Z","updated_at":"2024-03-29T03:40:41.000Z","dependencies_parsed_at":"2023-02-16T14:45:56.302Z","dependency_job_id":null,"html_url":"https://github.com/calref/cboe","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calref%2Fcboe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calref%2Fcboe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calref%2Fcboe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calref%2Fcboe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/calref","download_url":"https://codeload.github.com/calref/cboe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244611432,"owners_count":20481189,"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":["game","rpg"],"created_at":"2024-07-31T03:01:37.777Z","updated_at":"2026-01-11T03:39:37.450Z","avatar_url":"https://github.com/calref.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"[![CI status](https://github.com/calref/cboe/actions/workflows/ci.yml/badge.svg)](https://github.com/calref/cboe/actions/workflows/ci.yml)\n\nOpen Blades of Exile\n====================\n\nThis project hosts the source code to the classic RPG creator Blades of\nExile after it was released\nby [Spiderweb Software](http://www.spiderwebsoftware.com/) under GPLv2.\nIt is a svn-git transfer from the\n[Google Code Project](http://code.google.com/p/openexile/); all issues\nand trunk code has been ported.\n\nThe primary purpose of this project is to provide bug fixes to Blades of\nExile\nso that it can compile and run on modern operating systems. The\nsecondary purpose is\nto generalize and extend its functionality while maintaining backwards\ncompatibility.\n\nContributions are accepted primarily via pull request. See\n[CONTRIBUTING.md](./CONTRIBUTING.md) for more guidelines.\n\nBefore Building\n---------------\n\nThe most common error when building Open Blades of Exile is to try\nbuilding without initializing the submodules first. When you are obtaining\nthe source code, don't download the zip file directly from GitHub. The best way\nto get started is: `git clone --recursive https://github.com/calref/cboe`\n(replacing the URL with your fork's address if you forked the repo to make\ncontributions).\n\nIf you already cloned this repo without the `--recursive` flag, use this command:\n`git submodule update --init`. This will also fix the problem.\n\nBuilding\n--------\n\nThere are currently three ways to build Blades of Exile:\n\n- XCode 4 or later\n- Microsoft Visual Studio 2013/2017\n- scons\n\nThe officially supported method is scons. It's set up to work on any platform\nwith any toolset, but only the following have been tested:\n\n- Mac with Xcode tools\n- Windows with Microsoft Cl\n- Linux with clang or gcc\n\nThe script is currently a work-in-progress and\nas such may be a little fragile, but we're working on that.\nWith luck, just running `scons` will simply do the right thing and\nbuild a working executable under _build/Blades of Exile_.\nIf not, though, you may have to adjust a few things.\n\nYou can pass the following parameters to scons:\n\n- OS=windows|darwin - Override platform auto-detection (only partially implemented)\n- LIBPATH=pathlist - Specify where to look for non-system dynamic libraries to link\n  against.\n- FRAMEWORKPATH=pathlist (Mac only) - Specify where to look for non-system frameworks.\n- INCLUDEPATH=pathlist - Specify where to look for non-system header files.\n\nIf you can't get that to work, you can copy the required dependencies into _deps/lib_ (for\ndynamic libraries and frameworks) or _deps/include_ (for headers). That means that\n_deps/include_ would have two subfolders _boost/_ and _SFML/_.\n\nSome dependencies are supplied automatically as submodules. You can obtain them by cloning\nthe repository with `git clone --recursive` or by calling `git submodule update --init`\nafter making your clone. (**This notice is repeated because it is the MOST COMMON problem\nwhen building Open Blades of Exile.**)\n\nThe following dependencies are required:\n\n- [SFML 2](http://www.sfml-dev.org/) - all components except sfml-net.\n- [Boost 1.85](http://www.boost.org/) - Filesystem and System, plus several header-only\n  libraries; if you're picky, you can run scons and see it enumerate exactly which\n  libraries are needed\n- ZLib - This is included with the system on the Mac.\n\nFor Linux builds, the following additional dependencies are required:\n- [TGUI](https://tgui.eu/) - version 0.9, **built with C++14** as shown [here](./.github/workflows/scripts/linux/install-tgui.sh)\n  - or, if cmake is available when you call `scons`, TGUI will be built from source automatically\n- zenity command-line tools\n\nIf you are using the Visual Studio toolset, we recommend installing\n[vcpkg](https://github.com/Microsoft/vcpkg) to manage these dependencies.\n\nUse the following command to install the required dependencies. Note: You must call it from one of\nthe Visual Studio project directories, `cboe/proj/vs2013` or `cboe/proj/vs2017`.\n\nFor 32-bit builds:\n\n    vcpkg install --triplet=x86-windows\n\nFor 64-bit builds:\n\n    vcpkg install --triplet=x64-windows\n\nIf this is the first time installing packages with vcpkg since install you will need to run the `integrate` command:\n\n    vcpkg integrate install\n\nIf you're using XCode, you may need to adjust the project file settings to specify the\ncorrect place to search. For example, if you installed Boost via Homebrew, you may need to\nadd something like the following to the Project Build Settings, under Linking-\u003eOther\nLinking Flags:\n\n    -lboost_filesystem -lboost_system -L/usr/local/Cellar/boost/1.57.0/lib\n\nAgain with Homebrew, you may also need to add the following to Apple LLVM Custom\nCompiler Flags -\u003e Other C++ Flags:\n\n    -isystem/usr/local/Cellar/boost/1.57.0/include\n\nNotes and oddities:\n\n- The XCode build uses SFML frameworks, while the scons build on the Mac uses\n  SFML dynamic libraries.\n- On Windows, scons assumes that Boost is statically linked and thus does not copy\n  the dlls into the program directory. However, on the Mac, scons links dynamically with\n  Boost.\n\nContributing\n------------\n\nIf you want to contribute code to the project, please open a pull request.\nBe sure to read the [style guide](StyleGuide.md) before coding.\n\nThis project targets the subset of C++11 supported by both Xcode 4 and Visual Studio 2013.\nThat means that generally you can use C++11, but the following features (at least) are not permitted:\n\n* Ref-qualifiers\n* Attributes\n* Inheriting constructors (via `using`)\n* Unicode string literals\n* User-defined literals\n\nHelpful Links\n-------------\n* [BoE Forum at Spiderweb Software](http://spiderwebforums.ipbhost.com/index.php?/forum/12-blades-of-exile/)\n* [Official IRC channel](https://web.libera.chat/#openboe) (or join\n#openboe on irc.libera.chat)\n* [Original Game Source](http://www.spiderwebsoftware.com/blades/opensource.html) - Where\n  it all began. Warning: Terrifying code.\n* [Experimental Windows/Mac Builds](http://pentalithia.ca/oboe/?C=M;O=D) - will be put\n  up whenever Celtic Minstrel feels like it.\n* [Official Web Site](https://openboe.com/) - The hub for all things OpenBoE. The documentation is also in viewable format, and there is an archive of all known scenarios that could be located.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalref%2Fcboe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalref%2Fcboe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalref%2Fcboe/lists"}