Instrukcja Kompilacji (Build Guide)

Projekt opiera się o system budowania CMake.

• System zbudowany pod C++17 (lub wyżej).
• CMake (minimum w wersji 3.15).
• Połączenie z siecią podczas pierwszej kompilacji (CMake używa modułu FetchContent, aby automatycznie pobrać i podpiąć bibliotekę GLFW3 z repozytorium GitHub).

1. Kompilacja pod System Windows (Visual Studio)

Silnik wymusza statyczne linkowanie (MultiThreaded), dzięki czemu pliki .exe działają na innych komputerach bez konieczności dogrywania pakietów VCRUNTIME.dll.

1. Upewnij się, że masz zainstalowane Visual Studio (workload „C++ Desktop Development") oraz CMake dodany do zmiennej PATH.
2. Uruchom przygotowany skrypt:

build_win.bat

1. Skrypt utworzy i skonfiguruje katalog build/, zbuduje silnik w trybie Release, po czym przeniesie gotowy plik wykonywalny do podfolderu Game/ wraz z niezbędnymi zasobami (font.ttf, skybox.png).

2. Kompilacja pod System macOS

Na systemach Apple konieczne jest wcześniejsze doinstalowanie CMake oraz GLFW za pomocą Homebrew:

brew install cmake glfw

Następnie uruchom przygotowany skrypt, który nada odpowiednie uprawnienia, odpali CMake i zbuduje projekt:

chmod +x build_darwin.sh
./build_darwin.sh

3. Kompilacja pod System Linux (Ubuntu / Debian)

Wymagane jest środowisko GCC wraz z paczkami graficznymi (Mesa / Xorg).

1. Zainstaluj zależności deweloperskie:

sudo apt update
sudo apt install build-essential cmake libglfw3-dev libgl1-mesa-dev xorg-dev

1. Skompiluj silnik przy użyciu dedykowanego skryptu:

chmod +x build_linux.sh
./build_linux.sh

Automatyzacja (CI/CD)

Projekt ma skonfigurowane GitHub Actions w pliku .github/workflows/ci.yml. Przy każdym pushu na gałęzie main lub test-deploy wirtualna maszyna Ubuntu odpala skrypty Pythona budujące MkDocs, a następnie łączy się z zewnętrznym serwerem na platformie HestiaCP przez FTP, aktualizując produkcyjną wersję dokumentacji.