libultraship

libultraship (LUS) is a library meant to provide reimplementations of libultra (n64 sdk) functions that run on modern hardware.

LUS uses an asset loading system where data is stored separately from the executable in an archive file ending in .otr or .o2r. .otr files are .mpq compatible files. .o2r files are .zip compatible files. This separation of data from executable follows modern design practices which are more mod friendly. All one needs to do is supply a patch .otr or .o2r and the system will automatically replace the data.

Contributing

LUS accepts any and all contributions. You can interact with the project via PRs, issues, email ([email protected]), or Discord. Please see CONTRIBUTING.md file for more information.

Versioning

We use semantic versioning. We have defined the API as: every C linkage function, variable, struct, class, public class method, or enum included from libultraship.h.

Building on Linux/Mac

cmake -H. -Bbuild
cmake --build build

Generating a Visual Studio .sln on Windows

# Visual Studio 2022
& 'C:\Program Files\CMake\bin\cmake' -DUSE_AUTO_VCPKG=true -S . -B "build/x64" -G "Visual Studio 17 2022" -T v142 -A x64
# Visual Studio 2019
& 'C:\Program Files\CMake\bin\cmake' -DUSE_AUTO_VCPKG=true -S . -B "build/x64" -G "Visual Studio 16 2019" -T v142 -A x64

To build on Windows

& 'C:\Program Files\CMake\bin\cmake' --build .\build\x64

Sponsors

Thank you to JetBrains for providing their IDE CLion to me for free!

License

LUS is licensed under the MIT license.

LUS makes use of the following third party libraries and resources:

• Fast3D (MIT) render display lists.
• ImGui (MIT) display UI.
• StormLib (MIT) create and read .mpq compatible archive files.
• StrHash64 (MIT, zlib, BSD-3-Clause) provide crc64 implementation.
• ZAPD (MIT) asset utilities.
• metal-cpp (Apache 2.0) interface to the Apple Metal rendering backend.
• nlohmann-json (MIT) json parsing and saving.
• spdlog (MIT) logging
• stb (MIT) image conversion
• thread-pool (MIT) thread pool for the resource manager
• tinyxml2 (zlib) parse XML files for resource loaders
• zlib (zlib) compression used in StormLib
• bzip2 (bzip2) compression used in StormLib
• sdl2 (zlib) window manager, controllers, and audio player
• glew (modified BSD-3-Clause and MIT) OpenGL extension loading library.
• libzip (BSD-3-Clause) read .zip compatible archives
• glob_match (Dual MIT/GPL) Glob pattern matching.