THE OPERATIVE · NO ONE LIVES FOREVER · PORT

Teljes build, szájbarágósan

Nulláról a futó játékig, és minden eszköz: mit csinál, miért kell, vagy miért NEM kell

Ez a fejezet a gyakorlat. Végigmegyünk egy üres Linux-gépről a futó, magyar NOLF-ig. Minden használt eszköznél leírjuk, mire való, és ami ugyanilyen fontos: melyik szokásos eszközt nem használja ez a build, és miért nem. A Mac-es út a végén van.

Az eszközök egyenként

Röviden: bash + clang + pkg-config + Python 3, plusz két fejlesztői könyvtár (SDL3, FreeType). Ennyi kell a fordításhoz. Nincs make, nincs CMake, és nincs szükség bisonra vagy flexre.

Telepítendő függőségek: egy sorban, másolható

Debian 13 / Ubuntu 25.04+ (ezen a listán minden csomag ellenőrizve: Ubuntu 26.04):

Terminal
sudo apt install clang pkg-config python3 libsdl3-dev libfreetype-dev fonts-dejavu-core git unzip

Fedora (a pkg-config parancsot a pkgconf-pkg-config adja, a sima pkgconf nem):

Terminal
sudo dnf install clang pkgconf-pkg-config python3 SDL3-devel freetype-devel dejavu-sans-fonts git unzipexport NOLF_FONT=/usr/share/fonts/dejavu-sans-fonts/DejaVuSansCondensed-Bold.ttf↳ ezt a betűhelyet a motor magától nem nézi

Arch:

Terminal
sudo pacman -S --needed clang pkgconf python sdl3 freetype2 ttf-dejavu git unzip

Nem kötelező, de hasznos (Debian/Ubuntu ; Fedora ; Arch):

Terminal
sudo apt install fluid-soundfont-gm↳ Fedora: fluid-soundfont-gm ; Arch: soundfont-fluidsudo apt install flex bison↳ csak a parser újragenerálásához (lásd lent), mindhárom disztribúción így hívják

macOS: csak az Xcode 16+ kell az App Store-ból (a teljes Xcode, a Command Line Tools egymagában nem elég, mert az xcodebuild projekt-builddel és a SwiftUI indítóval csak a teljes Xcode boldogul). Homebrew-csomag nem kell; a git az Xcode-dal jön.

Terminal (macOS)
sudo xcode-select -s /Applications/Xcode.app && sudo xcodebuild -runFirstLaunch

Csomag → mire kell (a fenti egysorosok tartalma)

Debian/UbuntuFedoraArchMire kell
clangclangclangC/C++ fordító és linkelő (behúzza a binutils-t és a libstdc++ fejlesztői csomagját is).
pkg-configpkgconf-pkg-configpkgconfAz SDL3 és a FreeType fordítási/linkelési kapcsolói (build_linux.sh, forditas.sh ellenoriz).
python3python3pythonengine/linux_case_links.py (csak a szabványos os, re, sys modulokat használja, pip-csomag nem kell).
libsdl3-devSDL3-develsdl3Ablak, OpenGL, bemenet, hang; függőségként hozza az OpenGL-fejléceket (GL/glcorearb.h: Debianon libgl-dev, Fedorán és Archon a libglvnd).
libfreetype-devfreetype-develfreetype2Élsimított menü- és feliratbetű (ft2build.h, -lfreetype).
fonts-dejavu-coredejavu-sans-fontsttf-dejavuFutáskor: a DejaVuSansCondensed-Bold.ttf betűfájl.
gitgitgitA forrás klónozása (a linux-port ág).
unzipunzipunzipAz offline forráscsomag kicsomagolása (2. lépés, 7. fejezet).
fluid-soundfont-gmfluid-soundfont-gmsoundfont-fluidNem kötelező: GM SoundFont a zene hiányzó hangszereihez; a motor magától megtalálja (/usr/share/sounds/sf2/ ill. /usr/share/soundfonts/FluidR3_GM.sf2).
flex, bisonflex, bisonflex, bisonNem kötelező: csak ha az AnimationLex.l / AnimationParse.y módosul.
(Mesa, alapból fent)(alapból fent)mesa (vagy a GPU saját drivere)Futáskor: OpenGL 4.6 meghajtó.
(alapból fent)(alapból fent)(alapból fent)bash, coreutils (nproc), grep, sed; az asztali ikonhoz (./forditas.sh ikon) az xdg-user-dir parancs (xdg-user-dirs csomag), de nélküle is működik, csak az Asztalra nem másol.

✔ Ami KELL

EszközCsomag (Debian/Ubuntu)Mit csinál, és miért kell
bash(alapból fent van)A forditas.sh és a build_linux.sh bash-szkript. A bash vezérli az egészet: fájlokat keres (for f in engine/libs/*/*.cpp), párhuzamosan indít fordítókat (&, wait), dátumokat hasonlít össze (-nt). Bash-specifikus elemeket is használ (compgen -G, local, ${x%.*}), ezért sh-val (dash) nem fut.
clang++clangA C++ fordító: a .cpp forrásból .o gépi kódú tárgyfájlt készít (-c), a végén a .o-kból futtatható fájlt és .so-t linkel. A build_linux.sh ezt hívja (CXX="${CXX:-clang++}"), kb. 440-szer. Miért nem a gcc? Lásd lent.
clang (C)clangEgyetlen C fájlhoz: engine/compat/windows_compat.c (a Win32-pótló függvények törzsei). -std=c11 -D_DEFAULT_SOURCE, mert ez C, nem C++.
pkg-configpkg-configMegmondja, hol vannak egy telepített könyvtár fejlécei és milyen kapcsolóval kell linkelni. pkg-config --cflags sdl3 freetype2 → -I/usr/include/SDL3 -I/usr/include/freetype2 …; pkg-config --libs sdl3 freetype2 → -lSDL3 -lfreetype. Így a szkriptbe nem kell beégetni a disztribúciófüggő útvonalakat.
Python 3python3Egyetlen feladatra: a engine/linux_case_links.py létrehozza a kis- és nagybetűs include-szimlinkeket (3. fejezet). A fordítás maga nem Pythonnal megy.
SDL3 fejlesztői csomaglibsdl3-devAblak, OpenGL-környezet, billentyűzet, egér, hang. A -dev csomag a fejléceket (SDL3/SDL.h) és a .pc fájlt adja a pkg-confignak; futáskor a libSDL3.so.0 kell. Függőségként behúzza a libgl-dev-et, amely a <GL/glcorearb.h> fejlécet adja.
FreeType fejlesztői csomaglibfreetype-devBetűképek rajzolása TrueType fontból az élsimított menü- és feliratbetűkhöz.
DejaVu betűkfonts-dejavu-coreFutáskor kell, nem fordításkor: a DejaVuSansCondensed-Bold.ttf, amelyből a FreeType a magyar betűket rajzolja. Nélküle a játék a régi bitmap betűket használja.
Mesa (OpenGL 4.6 driver)(asztali gépen alapból fent van)Csak futáskor kell. A GPU-meghajtó adja az OpenGL 4.6-ot. Az ltgl.cpp az SDL_GL_GetProcAddress-szel futáskor kéri le a függvényeket, ezért nincs -lGL.
a háttérben: GNU ld, libstdc++binutils, libstdc++-dev (a clang függőségei)Az Ubuntu clangja nem hoz saját linkert és C++ könyvtárat: a binutils /usr/bin/ld-jét és a GCC libstdc++-át használja (std::string, std::vector …). Ezeket az apt a clanggal együtt automatikusan telepíti, külön nem kell velük foglalkozni.
coreutils, grep, sed(alapból fent van)nproc (magok száma = párhuzamos fordítások száma), grep "^SOURCE=" (fájllista a .dsp-ből), sed (a play_linux.sh configolvasója).

✘ Ami NEM kell, és miért nem

EszközMire való általábanMiért nincs rá szükség itt
make / MakefileBuild-rendszer: szabályok alapján eldönti, mit kell újrafordítani, és párhuzamosan futtat (make -j8).Nincs Makefile a repóban. A build_linux.sh maga végzi ugyanezt egyszerűbben: a „mit kell újrafordítani” kérdést a [ "$obj" -nt "$src" ] (újabb-e a .o?) dönti el, a párhuzamosságot a & és a throttle (legfeljebb nproc egyszerre) adja. Hátránya: a fejlécfüggőségeket nem követi (ezért kell fejlécmódosítás után tiszta build). Előnye: egy fájl, nincs mit tanulni.
CMake, Ninja, Meson, autotoolsBuild-rendszer generátorok.Ugyanaz az ok. A fájllistát az eredeti Visual C++ projektfájlokból veszi (Object.dsp, ClientShellDLL.dsp SOURCE= sorai), illetve globbal. Így a 2000-es projekt a „hiteles forrás”, nem egy kézzel karbantartott lista.
gcc / g++A GNU C/C++ fordító.A build kifejezetten clang-ot használ, mert (1) a Mac-es port is clanggal készült (Apple clang), így a kód ugyanazokra a fordítói viselkedésekre épül; (2) a -fdeclspec (MSVC __declspec elfogadása) clang-kapcsoló, a gcc nem ismeri; (3) a -Wno-everything is clang-kapcsoló. CXX=g++-szal megpróbálható, de nincs tesztelve, és valószínűleg nem fordul. (A gcc könyvtárait, a libstdc++-t viszont használja, lásd fent.)
bison (yacc)Parsergenerátor: nyelvtanfájlból (.y) C kódot generál, amely szöveget elemez.Az ObjectDLL-ben van egy nyelvtan: NOLF/ObjectDLL/AnimationParse.y. Ez az AI animációs leíró szövegfájljait elemzi. A generált kimenet (engine/generated/AnimationParse.cpp, „A Bison parser, made by GNU Bison 2.3”, 1685 sor) be van kommitolva, a build csak lefordítja. Bison csak akkor kell, ha a .y fájlt módosítod.
flex (lex)Lexergenerátor: .l fájlból tokenizáló C kódot generál.Ugyanígy: AnimationLex.l → engine/generated/AnimationLex.cpp (2187 sor), bekommitolva. Csak a .l módosításakor kell.
NOLF/bison.exe, flex.exeA Monolith 2000-es Windows-binárisai a repóban.Windows-programok, Linuxon és Macen nem futnak. Történeti emlék: a .dsp „custom build step” ezekkel generált.
Wine, MinGW, Visual StudioWindows-programok futtatása, illetve fordítása.Semmi nem fut Windows-kódként. A játék C++ forrása natívan fordul, a Win32 API-t az engine/compat pótolja.
-lGL, GLEW, GLADOpenGL-függvények betöltése.Az ltgl.cpp X-makró listája és az SDL_GL_GetProcAddress végzi ugyanezt.
libmpg123, FluidSynth, fontconfigMP3, MIDI, betűkeresés.MP3: a beépített dr_mp3.h. MIDI/DLS: a saját szintetizátor. Betű: rögzített útvonallista (és NOLF_FONT).

Ha mégis újra kell generálni a parsert (bison + flex)

Csak ha a NOLF/ObjectDLL/AnimationLex.l vagy az AnimationParse.y fájlt módosítod:

engine/generated/gen_parsers.sh (kivonat)
command -v flex  >/dev/null || { echo "flex not found";  exit 1; }↳ sudo apt install flex bisoncommand -v bison >/dev/null || { echo "bison not found"; exit 1; }cd "$SRC"  # NOLF/ObjectDLLflex -Pyyanimation -o "$HERE/AnimationLex.cpp" AnimationLex.l↳ -P: a yy* nevek -> yyanimation* (nem ütközik más parserrel)bison --defines="$HERE/AnimationParse.h" -v -pyyanimation \↳ --defines: tokenfejléc; -p: ugyanaz az előtag      -o "$HERE/AnimationParse.cpp" AnimationParse.ycp "$HERE/AnimationParse.h" "$HERE/AnimationLexSymbols.h"↳ az Object.dsp így nevezte; a .l ezt include-olja# + a szkript hozzáfűzi a hiányzó "int yyanimationparse(void);" prototípust

Utána ./forditas.sh. A parancssorok az eredeti Object.dsp „custom build” lépéseiből származnak.

A többi generátor (ezeket se futtasd feleslegesen)

Lépésről lépésre: üres Linuxtól a játékig

  1. Csomagok telepítése (egyszer; ehhez kell internet):
    Terminal
    sudo apt install clang pkg-config python3 libsdl3-dev libfreetype-dev fonts-dejavu-core git unzip↳ Debian 13 / Ubuntu 25.04+ (SDL3 itt van)
    Ha a disztribúcióban még nincs libsdl3-dev (régebbi Ubuntu/Debian), az SDL3-at forrásból kell fordítani (CMake-kel, ez az egyetlen hely, ahol CMake előkerülhet), vagy újabb kiadásra kell frissíteni. A Fedora és az Arch egysorosa (és a Fedorán szükséges NOLF_FONT) fent van, a Telepítendő függőségek dobozban.
  2. A forrás beszerzése: git clone -b linux-port <repó-URL> ~/workspace/nolf1, vagy töltsd le és csomagold ki az offline forrást a 7. fejezetből:
    Terminal
    mkdir -p ~/workspace && cd ~/workspaceunzip nolf1-forras-8fc7270.zip  # a letöltött offline forráscsomagcd nolf1chmod +x forditas.sh play_linux.sh engine/build_linux.sh↳ zipből a futtatási jog elveszhet@@</li><li><strong>A játékadat helye</strong>: másold a telepített NOLF GOTY mappát ide: <code>~/workspace/No One Lives Forever</code>. Ha máshol van, add meg: <code>export NOLF_GAME_DIR=/út/a/mappához</code>. Kell benne: <code>NOLF.REZ, NOLF2.REZ, NOLFGOTY.REZ, startup.txt, autoexec.cfg</code> (lásd <a href="02-adatok.html">2. fejezet</a>).</li><li><strong>Ellenőrzés</strong>:@@kod Terminal | sh./forditas.sh ellenoriz  OK   clang  # zöld OK minden sorban: mehet  OK   clang++  OK   pkg-config  OK   python3  OK   SDL3 3.4.2  OK   FreeType 26.5.20 (élsimított betűk)  OK   magyar nyelvi fájl (launcher/hu.txt)  ↳ ha hiányzik: rossz ágon vagy (git checkout linux-port)@@</li><li><strong>Fordítás</strong>:@@kod Terminal | sh./forditas.sh  # első alkalommal: pár perc, az összes magon== 1/3 Függőségek ellenőrzése  # ugyanaz, mint az ellenoriz== 2/3 Kis-/nagybetűs include linkek (egyszer kell, de ártani nem árt)↳ python3 engine/linux_case_links.py== 3/3 Fordítás (pár perc, a gép összes magját használja)↳ engine/build_linux.sh, minden kimenet a naplóbaKÉSZ: build-linux/nolf1 + build-linux/libnolfobject.soIndítás: ./play_linux.sh        (angolul: NOLF_LANG=en ./play_linux.sh)@@</li><li><strong>Indítás</strong>: <code>./play_linux.sh</code> (vagy <code>./play_linux.sh 1920x1080</code>). Asztali ikonhoz: <code>./forditas.sh ikon</code>.</li></ol><h3>Mi történik a 3/3. lépésben? (folyamatábra)</h3><div class="abra"><svg viewBox="0 0 900 470" role="img" aria-label="Build folyamat"><defs><marker id="ny" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0L10 5L0 10z" fill="#fff"/></marker></defs><g font-family="Barlow Condensed" font-weight="800" text-anchor="middle" font-size="17"><rect x="10" y="10" width="200" height="70" rx="20" fill="#fff6dc" stroke="#0a1f7a" stroke-width="3"/><text x="110" y="40">engine/libs/*</text><text x="110" y="62" font-weight="600" font-size="14">ButeMgr, RegMgr, mfc…</text><rect x="230" y="10" width="200" height="70" rx="20" fill="#fff6dc" stroke="#0a1f7a" stroke-width="3"/><text x="330" y="40">engine/* motor</text><text x="330" y="62" font-weight="600" font-size="14">kernel render world sound linux…</text><rect x="450" y="10" width="200" height="70" rx="20" fill="#fff6dc" stroke="#0a1f7a" stroke-width="3"/><text x="550" y="40">ClientShellDLL + Shared</text><text x="550" y="62" font-weight="600" font-size="14">-D_CLIENTBUILD (.dsp lista)</text><rect x="670" y="10" width="220" height="70" rx="20" fill="#fff6dc" stroke="#0a1f7a" stroke-width="3"/><text x="780" y="40">ObjectDLL + Shared</text><text x="780" y="62" font-weight="600" font-size="14">+ generated/ parser (.dsp lista)</text><g fill="#38d0f5" stroke="#0a1f7a" stroke-width="3"><rect x="10" y="130" width="200" height="50" rx="25"/><rect x="230" y="130" width="200" height="50" rx="25"/><rect x="450" y="130" width="200" height="50" rx="25"/><rect x="670" y="130" width="220" height="50" rx="25"/></g><text x="110" y="161">obj/support/*.o</text><text x="330" y="161">obj/libs + compat</text><text x="550" y="161">obj/csh + shared_csh</text><text x="780" y="161">obj/obj + shared</text><g stroke="#fff" stroke-width="3" marker-end="url(#ny)"><path d="M110 80V128"/><path d="M330 80V128"/><path d="M550 80V128"/><path d="M780 80V128"/></g><text x="450" y="112" fill="#fff" font-size="15">clang++ -c  (párhuzamosan, nproc szálon)</text><rect x="150" y="260" width="300" height="80" rx="40" fill="#ffe14d" stroke="#0a1f7a" stroke-width="3"/><text x="300" y="295" font-size="22">build-linux/nolf1</text><text x="300" y="320" font-weight="600" font-size="14">clang++ -rdynamic … -lSDL3 -lfreetype</text><rect x="520" y="260" width="330" height="80" rx="40" fill="#ee7a2e" stroke="#0a1f7a" stroke-width="3"/><text x="685" y="295" font-size="22">build-linux/libnolfobject.so</text><text x="685" y="320" font-weight="600" font-size="14">clang++ -shared -Wl,-Bsymbolic</text><g stroke="#fff" stroke-width="3" fill="none" marker-end="url(#ny)"><path d="M110 180L250 258"/><path d="M330 180L300 258"/><path d="M550 180L380 258"/><path d="M110 180Q400 230 600 258"/><path d="M780 180L700 258"/></g><rect x="300" y="390" width="300" height="60" rx="30" fill="#b9cc5f" stroke="#0a1f7a" stroke-width="3"/><text x="450" y="426" font-size="20">futás: dlopen(libnolfobject.so)</text><g stroke="#fff" stroke-width="3" fill="none" marker-end="url(#ny)"><path d="M300 340L400 388"/><path d="M685 340L520 388" stroke-dasharray="7 5"/></g></g></svg></div><p>Számokban (ezen a gépen, 8 mag): 9 support, 60 motor, 1 compat, 164 kliens, 31+31 Shared, 143 szerver objektumfájl. Az eredmény egy 30 MB-os <code>nolf1</code> és egy 13 MB-os <code>libnolfobject.so</code> (hibakereső szimbólumokkal, <code>-g</code>).</p><h3>Kézzel, a forditas.sh nélkül</h3>@@kod Terminal | shcd ~/workspace/nolf1python3 engine/linux_case_links.py  # kis- és nagybetűs szimlinkekNOLF_OBJ=$PWD/build-linux/obj NOLF_BIN=$PWD/build-linux/nolf1 ./engine/build_linux.sh↳ [clean] [-j N]NOLF_GAME_DIR="$HOME/workspace/No One Lives Forever" ./play_linux.sh↳ vagy közvetlenül:cd build-linux && NOLF_GAME_DIR=... NOLF_LANG_FILE=../launcher/hu.txt LT_WINDOW=1 LT_REALTIME=1 LT_SCREEN=1440x900 ./nolf1
    VáltozóMit állít a build_linux.sh-ban
    NOLF_OBJAz objektumfájlok könyvtára (alap: build-linux/obj).
    NOLF_BINA kimeneti futtatható fájl. Ha nincs megadva, a nolfbin.sh dönti el (../../NOLF1/build/nolf1 vagy /tmp/nolf_skeleton), ezért a forditas.sh mindig megadja.
    NOLF_SERVERA .so helye (alap: a nolf1 mellett).
    CXXMás fordító, pl. CXX=clang++-21.
    NOLF_ASAN=1AddressSanitizer: lassú, de memóriahibánál pontos helyet mond.
    clean, -j NParaméterek: tiszta build; N párhuzamos fordítás.

    Hibaelhárítás

    TünetOk és megoldás
    HIÁNYZIK SDL3 fejlesztői csomagsudo apt install libsdl3-dev. Ha a disztribúcióban nincs ilyen csomag, újabb kiadás vagy forrásból fordított SDL3 kell.
    fatal error: 'LTGuiMgr.h' file not foundLefutott a linux_case_links.py? A forditas.sh automatikusan futtatja.
    Furcsa fordítási hiba egy fejlécmódosítás után./forditas.sh tiszta: a build nem követi a fejlécfüggőségeket.
    [SERVER] cannot load …libnolfobject.soA .so nincs a nolf1 mellett, vagy hiányzik belőle egy szimbólum (a hibaüzenet megnevezi). Tiszta build.
    OpenGL 4.6 context: …A GPU-meghajtó nem tud GL 4.6-ot. LT_SOFTWARE=1 ./play_linux.sh (szoftveres renderelő).
    NO GAME RESOURCES. Set NOLF_GAME_DIRRossz a NOLF_GAME_DIR, vagy nincsenek ott a REZ fájlok.
    Angol a szövegHiányzik a launcher/hu.txt, vagy NOLF_LANG=en van beállítva. A naplóban keresd a [LTSTR] translation sort.
    Csúnya, kocka betűkfonts-dejavu-core hiányzik (a naplóban: no TrueType font found).
    Összeomlás~/.local/share/NOLF1/utolso_futas.log vége: [LTFATAL] + verem; addr2line -f -C -e build-linux/nolf1 <cím>.
    Hiányzó hangszer a zenébensudo apt install fluid-soundfont-gm (a motor magától megtalálja), vagy tegyél egy GM SoundFontot ide: ~/.local/share/NOLF1/GeneralUser-GS.sf2 (vagy LT_GMBANK=).
    Git: a kb. 53 kis- és nagybetűs szimlink ??-ként látszik a git status-ban. Soha ne add hozzá őket (git add -A helyett nevezd meg a fájlokat). A tiszta csak a build-linux/obj-ot törli, a mentéseket (build-linux/Save/) nem.

    A Mac-es build röviden

    Részletesen a 2. témában. Eszközök:

    EszközMiért
    Xcode 16+ (benne Apple clang, ld, Swift fordító, codesign)A NOLF1.xcodeproj mindent leír: a C++/Objective-C++ motort, a dylib-et és a SwiftUI indítót. Más build-eszköz nem kell.
    xcodebuildAz Xcode parancssori változata (automatizáláshoz, ad-hoc aláíráshoz).
    codesign (az Xcode hívja)A macOS csak aláírt kódot futtat hardened runtime-mal; az „Embed Game” lépés CodeSignOnCopy.
    ditto, hdiutilCsak DMG készítéséhez.
    Homebrew, SDL, FreeTypeNem kell. Macen minden rendszer-keretrendszerből jön: Cocoa, Metal, AudioToolbox, AppKit (NSFont).
    Python, bison, flexNem kell. Macen nincs szükség a betűméret-szimlinkekre (a fájlrendszer nem különbözteti meg a kis- és nagybetűt), a parser pedig be van kommitolva.
    Terminal (macOS)
    xcode-select -p↳ /Applications/Xcode.app/Contents/Developer kell legyenxcodebuild -project NOLF1.xcodeproj -scheme "NOLF1 Launcher" -configuration Release \  -derivedDataPath build-mac CODE_SIGN_IDENTITY=- CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM= buildopen build-mac/Build/Products/Release/NOLF1.app↳ Choose… -> GOTY mappa -> Play