No description
Find a file
2024-04-07 16:11:58 -05:00
.circleci
android
assets
cmake
custom-git-commands alias-bootstrap.sh: rewrite git build alias for new build system 2024-04-05 22:09:33 -07:00
debian-template
deployer
docs Adjust readme disclaimer, add logo 2024-04-07 16:11:58 -05:00
scripts Add macOS universal app convenience script 2024-04-01 23:05:42 -05:00
src Update win32 resource strings to refer to KKD 2024-04-07 15:29:04 -05:00
thirdparty
tools Add tools/export-drpc-faces.c 2024-03-22 21:54:52 -07:00
.clang-format
.editorconfig
.gitattributes
.gitignore
.travis.yml
alias-bootstrap.sh alias-bootstrap.sh: rewrite git build alias for new build system 2024-04-05 22:09:33 -07:00
Android.mk
appveyor.yml
CMakeLists.txt
CMakePresets.json Set OSX arch and dep. target in presets 2024-04-01 23:05:42 -05:00
comptime.bat
comptime.sh
debian_template.sh
LICENSE
LICENSE-3RD-PARTY.txt
README.md Adjust readme disclaimer, add logo 2024-04-07 16:11:58 -05:00
srb2.png
srb2banner.png
vcpkg-configuration.json
vcpkg.json

Dr. Robotnik's Ring Racers

Dr. Robotnik's Ring Racers logo

Dr. Robotnik's Ring Racers is a kart racing video game originally based on the 3D Sonic the Hedgehog fangame Sonic Robo Blast 2, itself based on a modified version of Doom Legacy.

Ring Racers' source code is available to users under the GNU General Public License version 2.0 or higher.

Disclaimer

Dr. Robotnik's Ring Racers is a work of fan art made available for free without intent to profit or harm the intellectual property rights of the original works it is based on. Kart Krew Dev is in no way affiliated with SEGA Corporation. We do not claim ownership of any of SEGA's intellectual property used in Dr. Robotnik's Ring Racers.

Development

Building from Source

Ring Racers is built using a compatible C++ toolchain (GCC, MinGW, Clang and Apple Clang as of this writing), CMake, and Microsoft vcpkg. The compiler and runtime libraries must support the ISO C++17 standard and ISO C11 standard.

On Linux platforms, you will need the following libraries available on the system.

  • libcurl
  • libfmt
  • zlib
  • libpng
  • libogg
  • libvorbis
  • libvpx
  • libyuv
  • SDL2

On Windows and macOS, you will need to install vcpkg instead to build these dependencies alongside the game.

To configure and build the game, there are CMake presets (declared in CMakePresets.json). These presets require the ninja build script tool in addition to cmake and your C++ toolchain. Here is a non-exhaustive list of them:

  • ninja-debug: non-optimized, assertions enabled
  • ninja-develop: optimized, assertions enabled
  • ninja-release: optimized
  • ninja-x86_mingw_static_vcpkg-debug
  • ninja-x86_mingw_static_vcpkg-develop
  • ninja-x86_mingw_static_vcpkg-release
  • ninja-x64_osx_vcpkg-debug
  • ninja-x64_osx_vcpkg-develop
  • ninja-x64_osx_vcpkg-release
  • ninja-arm64_osx_vcpkg-debug
  • ninja-arm64_osx_vcpkg-develop
  • ninja-arm64_osx_vcpkg-release

These presets depend on the VCPKG_ROOT environment variable being specified before the first run of the cmake command. Their build directories are pre-configured as subdirectories of build/.

After all prerequisites are set-up, configure and build using the following commands, adjusting according to your target system:

cmake --preset ninja-x86_mingw_static_vcpkg-develop
cmake --build --preset ninja-x86_mingw_static_vcpkg-develop

Contributing

We welcome external contributions from the community. If you are planning on making a large feature you intend to contribute to the project, please consider reaching out to us in the Kart Krew Dev public Discord server so we can coordinate with you.

Our primary source repository is hosted on the SRB2 Gitlab. The Github repository is a mirror of this. If you submit a Pull Request to the Github repository, please keep in mind that we do not consistently monitor that mirror and may not see your request.

All contributions must be made available under the GPL General Public License version 2.0, or public domain. Integrations for third party code must be made to code which is compatibly licensed.