Development

Build and validation

Requirements, commands and the difference between checking and linking.

Requirements

Use Windows, Git Bash, MinGW and the existing dependencies under work/vendor. The default compiler directory is D:/gcc/bin. CXX and CC can override compiler paths. KETAMIN_BUILD_OUT changes the output directory.

Check without producing a DLL

# From the repository root
.\internal\build.ps1 -Check
python internal/tools/check_layout.py

The check visits every active internal C++ and C translation unit with syntax-only compilation. It does not run the linker or the game.

Standard build entry

.\internal\build.ps1

The output path remains internal/dist/ketamin-fivem-internal.dll. The layout change does not alter Electron packaging.

Explicit source manifest

build-sources.txt lists C++ units relative to src/. The C unit platform/fx_safe_call.c is included explicitly in build.sh. Headers are included as needed; new source files do not enter the build automatically.

Include conventions

#include "ui/menu_motion.hpp"

Use paths relative to src/, rather than adding every subdirectory to the include search path.