/CommonLibSF

A collaborative reverse-engineered library for Starfield

Primary LanguageC++GNU General Public License v3.0GPL-3.0

CommonLibSF

A collaborative reverse-engineered library for Starfield

C++23 Platform Game version VCPKG_VER Main CI

Build Dependencies

  • CMake v3.26+ or XMake v2.8.2+
    • Add this to your PATH
  • vcpkg (optional, non-vcpkg build presets are provided which use CPM.cmake instead)
    • Create a Windows environment variable called VCPKG_ROOT with the value as the path to your vcpkg install directory
  • Visual Studio 2022 with "Desktop development with C++" workload
    • clang-cl toolset and build support if using clang-cl configurations
  • PowerShell

Developing with CommonLibSF

Using the CommonLibSF plugin templates

Please see the Using CommonLibSF wiki page for more information about using CommonLibSF.

End-User Dependencies

Notes

CommonLibSF is intended to replace SFSE as a static dependency. However, the runtime component of SFSE is still required.

You may download the PDB for the latest build of CommonLibSF via the Update PDB workflow. This is useful for importing the latest type information into IDA using the "import PDB" feature.

License

GPL-3.0-or-later WITH Modding Exception AND GPL-3.0 Linking Exception (with Corresponding Source).

Specifically, the Modded Code is Starfield (and its variants) and Modding Libraries include SFSE (GitHub link).

It is recommended to read the FSF FAQ for a full explanation on what this license requires.

The main requirement of this license is: if you link your mod against CommonLibSF, and you distribute the binaries for that mod, you must also distribute the source code under the same license as CommonLibSF along with the source code for any other libraries you link against, with the exception of the Modded Code and Modding Libraries defined above.

Contributors

DK Angad powerof3 Qudix nikitalita TommInfinite Madeesh Kannan shad0wshayd3 Alan Tse FlayaN Ian Patterson Bobbyclue Gary McGovern lStewieAl

Credits

This work is based on CommonLibSSE created by Ryan-rsm-McKenzie under an MIT License. Without him putting that together, much of the joint Bethesda RE scene would be drastically different. The MIT License is kept for historical purposes only and the GPL governs this work. To the extent that you want the MIT licensed code, please reference CommonLibSSE and its forks.