Az eredeti port Macre készült (Apple Silicon, „no emulation, no Wine, no virtual machine”). Itt nincs build-szkript: az egészet a NOLF1.xcodeproj írja le, és az Xcode (vagy parancssorból az xcodebuild) fordítja. A végeredmény egy közönséges NOLF1.app, benne a játékmotorral és a szerver modullal.

screenshots/ mappája.Követelmények
- macOS 15 vagy újabb (
MACOSX_DEPLOYMENT_TARGET = 15.0), lehetőleg Apple Silicon (M1–M4). - Xcode 16 vagy újabb, mert a projekt formátuma (
objectVersion = 77) szinkronizált mappákat használ. A szerző gépén Xcode 27.2 fordította. - Az első indítás után:
sudo xcode-select -s /Applications/Xcode.appéssudo xcodebuild -runFirstLaunch. - Saját NOLF GOTY játékadat (telepített mappa vagy a két CD átmásolva).
Az Xcode projekt: három target
| Target | Típus | Mit fordít | Mit NEM (membershipExceptions) |
|---|---|---|---|
| NOLF1Launcher | application → NOLF1.app | launcher/ (Swift + hu.txt erőforrásként), assets/Images.xcassets (ikon) | – |
| nolf1 | tool (parancssori Mach-O) | LT2, engine, NOLF mappák; Cocoa, Metal, QuartzCore, AudioToolbox, CoreFoundation keretrendszerek; -D_CLIENTBUILD | az összes ObjectDLL/*.cpp, ClientRes/main.cpp, NetInfo.cpp, PlayerData.cpp, generated/Animation*.cpp, ltengineobjects.cpp |
| nolfobject | dynamic library → libnolfobject.dylib | NOLF/ObjectDLL + Shared + engine/libs + engine/generated; linkelés: -undefined dynamic_lookup | szinte az egész motor és a teljes ClientShellDLL |
„Szinkronizált mappa” (Xcode 16+): a projekt nem sorolja fel a fájlokat egyenként, hanem azt mondja: „az
engine/ minden fájlja ennek a targetnek a része”, és csak a kivételeket (membershipExceptions) listázza. Ezért kell a Linux-fájlokban az #ifndef __APPLE__: különben a Mac-es build azokat is lefordítaná, és SDL-fejléc hiányában hibával leállna. Pontosan ez történt, a 00a55ff commit javította.Közös build-beállítások
Ugyanazok, mint Linuxon. Mindkét build ugyanabból az eredeti .dsp konfigurációból indul:
| Beállítás | Érték | Linuxos megfelelő |
|---|---|---|
CLANG_CXX_LANGUAGE_STANDARD | c++17, libc++ | -std=c++17 |
GCC_PREPROCESSOR_DEFINITIONS | NO_PRAGMA_LIBS _NOLFBUILD _REZFILE _FINAL NDEBUG _LITHTECH_ _LITHTECH2 STRICT | DEF= |
OTHER_CFLAGS | -fdeclspec -Wno-everything | ugyanaz |
HEADER_SEARCH_PATHS | engine/compat, include-shims, LT2/sdk/inc, lithshared/*, engine/* | SYS= |
USER_HEADER_SEARCH_PATHS | NOLF/Shared, ObjectDLL, ClientShellDLL | -iquote |
GCC_OPTIMIZATION_LEVEL | 2 | -O2 |
CLANG_ENABLE_OBJC_ARC | YES (a .mm fájlokhoz) | – |
Beágyazás és aláírás
199D298C53FEF3DAE8A463A8 /* Embed Game */ = { isa = PBXCopyFilesBuildPhase; // egy "fájlmásolás" build-lépés dstPath = Contents/Helpers; // ide: NOLF1.app/Contents/Helpers/ dstSubfolderSpec = 1; // 1 = az .app csomag gyökeréhez képest files = ( 1DC49E4B64415120128CDB28 /* nolf1 in Embed Game */, ↳ a játékmotor 750F0A84DA59D9B196C6B522 /* libnolfobject.dylib in Embed Game */, ↳ a szerver modul ); // mindkettő CodeSignOnCopy: másoláskor újraaláírja};Az eredmény:
NOLF1.app/ Contents/ MacOS/NOLF1 # a SwiftUI indító Helpers/nolf1 # a játék (motor + kliens) Helpers/libnolfobject.dylib ↳ a szerver modul, ezt dlopen-eli a nolf1 Resources/hu.txt # a magyar szövegtábla Resources/Assets.car # ikon<key>com.apple.security.cs.disable-library-validation</key>↳ könyvtár-ellenőrzés kikapcsolása<true/>MIÉRT kell ez a jogosultság? A
nolf1 „hardened runtime” alatt fut. Ilyenkor a macOS csak ugyanazzal a fejlesztői csapat-azonosítóval (Team ID) aláírt dylib-et engedi betölteni. Ad-hoc aláírásnál ez nem teljesül, a dlopen megtagadja a betöltést, és fekete képernyő az eredmény. Ez a kulcs kikapcsolja az ellenőrzést.Aláírás saját gépen: a projektben
DEVELOPMENT_TEAM = EJBTKE7CEJ áll, ez az eredeti szerző csapata. Te kétféleképpen fordíthatsz: (1) Xcode-ban a targeteknél Signing & Capabilities alatt kiválasztod a saját Team-edet vagy a „Sign to Run Locally”-t, a módosított pbxproj-t pedig nem kommitolod; (2) parancssorban ad-hoc aláírással, lásd lent.A Mac-es motorréteg
| Fájl | Mit csinál |
|---|---|
engine/platform/ltwindow.mm (836 sor) | Cocoa ablak egy LTFrameView : NSView-val (felülről lefelé számoló RGBA). Az egérmozgás deltái az LTInput_Push-ba mennek, a billentyűk az LTInput_MacKeyToVK-n át. Ctrl+Cmd+F: teljes képernyő. A finishLaunching-ot az ablak előtt kell hívni, különben nem jönnek billentyűesemények. A képkockák ütemét egy CADisplayLink adja saját szálon, ProMotion kijelzőn 120 Hz-cel (LT_MAXFPS korlátozza). |
engine/render/ltmetal.mm (2729 sor) | Metal renderelő CAMetalLayer-rel. A shaderek Metal Shading Language forrásként, C++ raw stringben vannak, és futáskor a newLibraryWithSource: fordítja őket: vs_world fs_world vs_env fs_env vs_skin és a kompozitor vs_full fs_comp vs_far fs_scale. Nincs külön .metal build-lépés. |
engine/sound/ltaudio.mm (207 sor) | AudioToolbox DefaultOutput AudioUnit, s16 sztereó 44100 Hz; a render callback a közös CLTMixer::Render-t hívja. Az MP3-at az ExtAudioFile bontja ki. |
engine/platform/ltsysfont.mm (68 sor) | Élsimított betűkép az NSFont boldSystemFontOfSize-ból, NSBitmapImageRep-be rajzolva; az alfa-csatorna lesz a fedettség. |
const CGFloat fSize = (CGFloat)nPixelHeight / 1.22;↳ sormagasság ≈ 1,22 × pontméretNSFont* font = [NSFont boldSystemFontOfSize:fSize];↳ a rendszer félkövér betűje (SF Pro)unichar ch = (unichar)cp;NSString* s = [NSString stringWithCharacters:&ch length:1];↳ egyetlen karakterNSDictionary* attrs = @{ NSFontAttributeName: font, NSForegroundColorAttributeName: [NSColor whiteColor] }; ↳ fehér: csak az alfa számítNSSize sz = [s sizeWithAttributes:attrs];int w = (int)ceil(sz.width);w += 1; // a column of air between glyphs↳ +1 oszlop levegő (Linuxon nincs)NSBitmapImageRep* rep = [[NSBitmapImageRep alloc] initWithBitmapDataPlanes:NULL pixelsWide:w pixelsHigh:nPixelHeight ...];↳ 8 bites RGBA kép...[s drawAtPoint:NSMakePoint(0, y) withAttributes:attrs];↳ AppKit rajzol, élsimítással...cov[(size_t)yy * w + xx] = px[yy * stride + xx * 4 + 3]; // alpha↳ csak az alfa-csatornát veszi kiKépjavítás (csak Mac, Metal)
Az fs_comp shader a 3D jelenetre (a menükre, a HUD-ra és a feliratra nem) három szűrőt tehet:
- Élesítés: unsharp mask 4 szomszéddal, ±0,12-re korlátozva (
NOLF_SHARPEN). - Színezés: +15% telítettség és enyhe S-görbe (
NOLF_GRADE). - Ragyogás: 2×8 mintavétel, 0,78-os küszöb (
NOLF_BLOOM).
static const float s_fx[3] = { // egyszer olvassa be, induláskor getenv("NOLF_SHARPEN") ? (float)atof(getenv("NOLF_SHARPEN")) : 0.0f, ↳ 0..1, alapból 0 = ki getenv("NOLF_GRADE") ? (float)atof(getenv("NOLF_GRADE")) : 0.0f, getenv("NOLF_BLOOM") ? (float)atof(getenv("NOLF_BLOOM")) : 0.0f };Közös kód __APPLE__-ágakkal
| Hely | Mac | Linux |
|---|---|---|
server/ltserverhost.cpp:57 | /libnolfobject.dylib | /libnolfobject.so |
platform/ltbindings.cpp:10, regmgr_impl.cpp:42 | /Library/Application Support/NOLF1 | /.local/share/NOLF1 |
sound/ltdmhost.cpp:33 | Apple gs_instruments.dls | SF2-keresési lista |
render/ltnullrender.cpp:95 | „Metal - macOS” | „OpenGL - Linux” |
render/ltnullrender.cpp:232 | a választott felbontást visszaírja az indító beállításaiba (CFPreferences) | – |
platform/ltbindings.cpp:1245 | billentyűnevek a Mac-kiosztásból | US billentyűnevek |
A SwiftUI indító (launcher/)
A NOLF1.app elindításakor nem a játék indul, hanem egy kis SwiftUI ablak: itt választod ki a játék mappáját, a felbontást, a nyelvet, majd megnyomod a Play-t.
| Fájl | Feladat |
|---|---|
NOLF1LauncherApp.swift | @main. Parancssori módok: --selftest <mappa> (automatikus teszt), --snapshot (képernyőkép az indítóról). |
ContentView.swift | A felület. A beállítások @AppStorage-ban maradnak meg. Kapcsolók: „Magyar szöveg és felirat” (alapból be), „Képjavítás” (alapból be, csak Metallal). Haladó beállítások: renderelő, küldetés feloldása, pályanézegető, részletes napló, „Fresh profile”. |
GameInstall.swift | Mappaellenőrzés: 4 szint mélyen keres *.rez, startup.txt és autoexec.cfg fájlokat; a CD-másolat elrendezését (disc1/Data, disc2/Data, disc2/Game) is felismeri. |
GameRunner.swift | Összeállítja a környezeti változókat, és Process-ként elindítja a Contents/Helpers/nolf1-et. |
Missions.swift | A küldetések és pályák táblázata a haladó menühöz. |
SelfTest.swift | Ablak nélküli teszt: 400 képkocka, betölt egy pályát, és a naplóban a mounted, [SERVER] loaded és LoadWorld( sorokat keresi. |
if !has("nolf.rez") { // nincs fő archívum gi.problems.append("NOLF.REZ, the main game archive, was not found.")}if !has("nolf2.rez") { // csak az 1. CD-t másoltad át gi.problems.append("NOLF2.REZ was not found. If you copied the game discs, copy BOTH discs into this folder.")}if autoexec == nil { // a billentyűk alapértékei kellenek gi.problems.append("autoexec.cfg was not found -- ...")}if !has("nolfgoty.rez") {↳ CSAK GOTY: a sima kiadás adataival az első pálya előtt összeomlik gi.problems.append("This is not the Game of the Year edition ...")}if gi.dirs.contains(where: { $0.path.contains(":") }) {↳ a ':' a NOLF_GAME_DIR elválasztója, gi.problems.append("A folder name contains a colon ...") ↳ (Finderben "/" névként jelenik meg)}if gi.dirs.count > 15 || gi.gameDirValue.count > 1900 {↳ a motor korlátai: 16 könyvtár, 2047 karakter gi.problems.append("The game data is spread over too many folders. ...")}func environment(gameDirs: [URL], headless: Bool = false, updates: Int = 0) -> [String: String] { var env = ProcessInfo.processInfo.environment.filter { !$0.key.hasPrefix("LT_") && !$0.key.hasPrefix("NOLF_") } ↳ tiszta lap: régi LT_/NOLF_ változók ki env["NOLF_GAME_DIR"] = gameDirs.map { $0.path }.joined(separator: ":") ↳ a megtalált mappák, ':'-tal if headless { // önteszt env["LT_UPDATES"] = String(updates) env["LT_STUB_QUIET"] = "1" env["LT_SCREEN"] = "640x480" } else { env["LT_WINDOW"] = "1" // ablakos futás env["LT_REALTIME"] = "1" env["LT_SCREEN"] = "\(width)x\(height)" ↳ a választott felbontás if software { env["LT_SOFTWARE"] = "1" } else { env["LT_METAL"] = "1" } } switch mode { case .play, .mission: break case .viewer: // pályanézegető: szerver nélkül env["LT_NOSERVER"] = "1" env["LT_WORLD"] = "WORLDS\\\(level.uppercased()).DAT" } if !bubbles { env["LT_NOPSRATE"] = "1" } ↳ buborékok az akváriumban if !bounce { env["LT_NOFLOORBOUNCE"] = "1" } ↳ szikrák pattannak-e a padlón if hungarian, let f = Self.hungarianFile { env["NOLF_LANG_FILE"] = f.path } ↳ a csomagolt hu.txt if enhance && !software { ↳ "Képjavítás" kapcsoló = mindhárom szűrő félerővel env["NOLF_SHARPEN"] = "0.5" env["NOLF_GRADE"] = "0.5" env["NOLF_BLOOM"] = "0.5" } return env}let p = Process()p.executableURL = exe // NOLF1.app/Contents/Helpers/nolf1p.currentDirectoryURL = Paths.profile↳ ~/Library/Application Support/NOLF1/Profile -> ide mennek a mentésekp.environment = options.environment(gameDirs: dirs)↳ minden beállítás környezeti változóként, argumentum nincsp.standardOutput = handle↳ ~/Library/Logs/NOLF1/game-ÉÉÉÉHHNN-ÓÓPPMM.logp.standardError = handlep.terminationHandler = { [weak self] proc in↳ kilépéskor: rendes vége vagy összeomlás (jel)? ... self.state = reason == .uncaughtSignal ? .crashed(status) : .ended(status)}try p.run()handOverFocus(to: p.processIdentifier)↳ macOS 14+: a fókuszt kifejezetten át kell adni a játéknakFordítás lépésről lépésre
A) Xcode grafikus felületén
git clone -b linux-port <repó> nolf1, vagy csomagold ki az offline forráscsomagot.- Nyisd meg a
NOLF1.xcodeproj-ot. - Felül a sémaválasztóban: NOLF1 Launcher, célként My Mac.
- Mindhárom targetnél: Signing & Capabilities → a saját Team-ed, vagy „Sign to Run Locally”.
- ⌘+B (Build), majd ⌘+R (Run). Az Xcode a függőségek miatt előbb a
nolfobject-et és anolf1-et fordítja, majd beágyazza őket. - Az indítóban: Choose… → a NOLF GOTY mappa → Play.
B) Parancssorból, ad-hoc aláírással
cd nolf1 # a repó gyökerexcodebuild -project NOLF1.xcodeproj -scheme "NOLF1 Launcher" -configuration Release \↳ a teljes app, Release-ben -derivedDataPath build-mac \ ↳ a kimenet a repón belül, nem a ~/Library/Developer alatt CODE_SIGN_IDENTITY=- CODE_SIGN_STYLE=Manual DEVELOPMENT_TEAM= \ ↳ "-" = ad-hoc aláírás, csapat nélkül build 2>&1 | grep -E "error:|BUILD" ↳ csak a hibák és a végeredményopen build-mac/Build/Products/Release/NOLF1.app # indításC) DMG készítése (terjesztéshez)
mkdir -p /tmp/dmg && rm -rf /tmp/dmg/* && ditto build-mac/Build/Products/Release/NOLF1.app /tmp/dmg/NOLF1.app↳ ditto: megőrzi az aláírást és a jogokatln -s /Applications /tmp/dmg/Applications↳ "húzd ide" parancsikon az Alkalmazások mappárahdiutil create -volname "NOLF1 magyar" -srcfolder /tmp/dmg -format UDZO -ov NOLF1-magyar.dmg↳ UDZO = tömörített, csak olvashatóA bare motor futtatása Xcode-ból: a
nolf1 sémát választva a motor közvetlenül indul, a sémában beállított LT_WINDOW=1 LT_METAL=1 LT_SCREEN=1024x768 LT_REALTIME=1 változókkal. A NOLF_GAME_DIR-t ehhez a séma Environment Variables részénél kell megadni. A billentyűk: gyorsmentés F6, gyorsbetöltés F9 (Mac-billentyűzeten fn+F6 / fn+F9).Mac és Linux: ugyanaz a forrás, két út
| macOS | Linux | |
|---|---|---|
| Build-eszköz | Xcode / xcodebuild | bash: forditas.sh → build_linux.sh |
| Fordító | Apple clang | clang (LLVM) |
| Fájllista | szinkronizált mappák + kivételek | glob + az eredeti .dsp SOURCE= sorai |
| Szerver modul | .dylib, -undefined dynamic_lookup | .so, -shared -Wl,-Bsymbolic, exe -rdynamic |
| Kis- és nagybetű | a fájlrendszer nem különbözteti meg | linux_case_links.py szimlinkjei |
| Indító | SwiftUI NOLF1.app | play_linux.sh (+ forditas.sh ikon asztali ikon) |
| GPU | Metal, MSL futásidőben fordítva | OpenGL 4.6, GLSL futásidőben fordítva |