Mi van a játék könyvtárában?
Egy telepített NOLF GOTY könyvtárban (Linuxon alapból ~/workspace/No One Lives Forever) a port számára ezek számítanak:
| Fájl | Méret | Mi ez |
|---|---|---|
NOLF.REZ | 618 MB | Az 1. CD fő archívuma: pályák, textúrák, modellek, hangok. |
NOLF2.REZ | 301 MB | A 2. CD archívuma; ebben van az alap CRES.DLL is. |
nolfu003.rez | 18 MB | Az 1.003-as patch felülírásai (pl. egy újabb Attributes\FX.txt). |
NOLFGOTY.REZ | 170 MB | A Game of the Year bővítés: új küldetés, javított CRES.DLL (6031 szöveg). |
startup.txt | 199 B | Megadja, mely archívumok és milyen sorrendben töltődnek be. |
autoexec.cfg | 10 KB | Alapbeállítások és billentyűk. A port csak olvassa. |
defctrls.cfg | 5 KB | Az „Alapértelmezések visszaállítása” gomb forrása a vezérlés menüben. |
Movies/*.bik | – | Bink logóvideók. A port nem játssza le őket. A „videók” a játékban motoron belüli jelenetek, a feliratok azok alatt jelennek meg. |
*.flt, *.m3d, *.asi, NOLF.exe | – | Windowsos Miles hangszűrők és az eredeti exe. A port nem használja őket. |
NOLFCRES003.REZ, nolf003cres.rez és nolfu003cres.rez megvan a könyvtárban, de nincs benne a startup.txt-ben, ezért a motor sosem csatolja fel őket.A REZ archívum bájtról bájtra
A REZ a Monolith 1995-ös „RezMgr” formátuma: egy fejléc, utána a nyers fájltartalmak, végül egy könyvtárfa. Az olvasó a engine/kernel/io/ltrezfile.cpp (CLTRezArchive), a GPL-es Jupiter rezmgr.cpp alapján, de újraírva és csak olvasásra.
A NOLF.REZ eleje (xxd -l 176 NOLF.REZ):
00000000: 0d0a 5265 7a4d 6772 2056 6572 7369 6f6e ..RezMgr Version↳ CR LF, majd FileType[60]00000010: 2031 2043 6f70 7972 6967 6874 2028 4329 1 Copyright (C)00000020: 2031 3939 3520 4d4f 4e4f 4c49 5448 2049 1995 MONOLITH I00000030: 4e43 2e20 2020 2020 2020 2020 2020 0d0a NC. ..↳ szóközzel kitöltve, CR LF00000040: 4c69 7468 5465 6368 2052 6573 6f75 7263 LithTech Resourc↳ UserTitle[60]00000050: 6520 4669 6c65 2020 2020 2020 2020 2020 e File00000060: 2020 2020 2020 2020 2020 2020 2020 202000000070: 2020 2020 2020 2020 2020 2020 0d0a 1a01 ............↳ CR LF EOF(0x1A) = 127 bájt; 0x7F: verzió = 100000080: 0000 0098 7dda 2456 0000 0018 0100 00dc ....}.$V......↳ RootDirPos, RootDirSize, RootDirTime ...00000090: afd4 2494 0efa 6a00 0000 000e 0000 0020 ..$...j........↳ ... NextWritePos, Time, Largest* mezők000000a0: 0000 0000 0000 0001 0600 4865 6164 6572 ..........Header↳ IsSorted (168. bájt), utána már adat| Eltolás | Mező | Jelentés |
|---|---|---|
| 0 | CR LF | Hogy a type paranccsal kiírva is olvasható legyen. |
| 2 | FileType[60] | „RezMgr Version 1 Copyright (C) 1995 MONOLITH INC.” |
| 62 | CR LF | |
| 64 | UserTitle[60] | „LithTech Resource File” |
| 124 | CR LF EOF | A 0x1A miatt a DOS type itt megáll. |
| 127 | DWORD FileFormatVersion | Pontosan 1 kell legyen. |
| 131 | DWORD RootDirPos, RootDirSize | A gyökérkönyvtár-blokk helye és mérete. |
| 139… | 7 további DWORD | RootDirTime, NextWritePos, Time, LargestKeyAry, LargestDirNameSize, LargestRezNameSize, LargestCommentSize |
| 167 | BYTE IsSorted | Összesen 168 bájt. |
unsigned int nVersion = rd32(hdr + 127);↳ kis-endian 32 bit a 127. bájttólunsigned int nRootPos = rd32(hdr + 131);unsigned int nRootSize = rd32(hdr + 135);// ⚠️ An EQUALITY test, exactly as the donor does.↳ EGYENLŐSÉG, nem >=: ismeretlen verziótif (nVersion != kRezFormatVersion)↳ inkább elutasít, mint hogy rosszul olvassa{ Close(); return false;}m_Path = pPath;if (!ReadDirectory(nRootPos, nRootSize, std::string(), 0))↳ a gyökértől rekurzívan felépíti a fát{ Close(); return false;}return true;A fejlécet a kód nem struct-ként olvassa be, hanem mezőnként, eltolással. Így nem számít a fordító igazítása (padding) és a processzor bájtsorrendje sem.
A könyvtárblokk rekordjai
if (o + 4 > size) return false;unsigned int nType = rd32(&blk[o]); o += 4;↳ minden rekord egy típussal kezdődikif (nType == kEntryDirectory) // 1 = alkönyvtár{ if (o + 12 > size) return false; unsigned int dPos = rd32(&blk[o]); ↳ az alkönyvtár blokkja hol van unsigned int dSize = rd32(&blk[o + 4]); o += 12; // pos, size, time unsigned int nameStart = o; while (o < size && blk[o] != 0) ++o; // nullával lezárt név if (o >= size) return false; // unterminated name std::string sName((const char*)&blk[nameStart], o - nameStart); ++o; SubDir sd; sd.pos = dPos; sd.size = dSize; sd.prefix = sPrefix + sName + "\\"; ↳ DOS-útvonal: "WORLDS\" + ... subdirs.push_back(sd); ↳ a blokk végén rekurzívan bejárja (max. 32 mélység)}else if (nType == kEntryResource) // 0 = fájl{ if (o + 24 > size) return false; unsigned int rPos = rd32(&blk[o]); ↳ hol kezdődik az adat az archívumban unsigned int rSize = rd32(&blk[o + 4]); // hány bájt unsigned int rTime = rd32(&blk[o + 8]); unsigned int rExt = rd32(&blk[o + 16]); // ID at +12, Type at +16 ↳ a KITERJESZTÉS egy uint32-ben! unsigned int nKeys = rd32(&blk[o + 20]); o += 24; unsigned int nameStart = o; while (o < size && blk[o] != 0) ++o; ↳ a név kiterjesztés NÉLKÜL, pl. "FX" if (o >= size) return false; std::string sName((const char*)&blk[nameStart], o - nameStart); ++o; while (o < size && blk[o] != 0) ++o; ↳ megjegyzés-szöveg: átugorja if (o >= size) return false; ++o; if ((unsigned long)o + (unsigned long)nKeys * 4 > (unsigned long)size) return false; o += nKeys * 4; // nKeys darab kulcs: nem kellFX.TXT-t tárol, hanem FX-et és egy külön uint32 Type-ot, amelyben a „TXT” karakterei fordított sorrendben vannak becsomagolva (pType[2]='T' pType[1]='X' pType[0]='T'). A TypeToExt() (ltrezfile.cpp:60–79) rakja vissza.Megnyitáskor a teljes fa egyetlen unordered_map-be lapul. A kulcs a teljes, nagybetűs DOS-útvonal, például ATTRIBUTES\FX.TXT. A legnagyobb archívum 4871 bejegyzést tartalmaz. A keresés egy hash-lekérdezés, előtte normalizálással:
for (const char* p = pIn; *p; ++p){ char c = *p; if (c == '/') c = '\\'; // a / jelet \-re cseréli sOut.push_back((char)toupper((unsigned char)c)); ↳ nagybetűsít: a REZ-ben nem számít a kis/nagybetű}Olvasáskor a motor új FILE*-ot nyit az archívumra, és egy CLTFileStream csak a bejegyzés bájttartományát (pos, size) látja belőle (ltfilemgr.cpp:353–363). Nincs kicsomagolás és nincs ideiglenes fájl.
A fák verme és a keresési sorrend
A CLTFileMgr (engine/kernel/io/ltfilemgr.cpp) „fák” listáját kezeli. Egy fa vagy egy .rez archívum, vagy egy könyvtár, a stat() dönti el. Szabály: amit utoljára adtunk hozzá, azt keresi először. Az eredeti motor is így működött (dl_Insert).
ILTStream* CLTFileMgr::OpenFile(const char* pFilename){ if (!pFilename || !pFilename[0]) return 0; // ⚠️ Reverse of add order. See ltfilemgr.h. for (int i = (int)m_Trees.size() - 1; i >= 0; --i) ↳ HÁTULRÓL előre: a legutóbbi fa nyer { ILTStream* pStream = OpenInTree(m_Trees[i], pFilename); ↳ REZ: hash-keresés; könyvtár: lemez if (pStream) { ++m_nOpened; if (LTFile_TraceEnabled() || LTRecord_Enabled()) ↳ LT_TRACE_FILE=1 esetén naplóz { unsigned long nLen = 0; pStream->GetLen(&nLen); const char* pTree = LTRecord_BaseName(m_Trees[i].m_Path.c_str()); if (LTFile_TraceEnabled()) fprintf(stderr, "[LTFILE] %-40s %8lu bytes <- %s\n", ↳ név, méret, MELYIK fából pFilename, nLen, pTree); LTRecord_Event("file", "%s %lu %s", pFilename, nLen, pTree); } return pStream; // első találat nyer }A startup.txt
A felcsatolás sorrendjét nem a port találja ki, hanem a játék saját startup.txt-je mondja meg:
[Rez]Rez0 = "nolf" # könyvtár (itt nincs ilyen: kihagyja)Rez1 = "nolf.rez" # 1. CDRez2 = "nolf2.rez" # 2. CDRez3 = "nolfdll.rez"↳ nincs meg: "[LTFILE] tree not found (skipped)"Rez4 = "nolfl.rez"Rez5 = "nolfu003.rez" # patchRez6 = "nolfc001.rez"Rez7 = "nolfc002.rez"Rez8 = "nolfgoty.rez" # utolsó = legerősebb: a GOTY felülír mindentint CLTFileMgr::InitFromGameDirs(const char* const* pDirs, int nDirs){ int nAdded = 0; // The directories themselves, first, so they end up LOWEST priority. ↳ a könyvtárak ELŐSZÖR -> leggyengébbek for (int i = 0; i < nDirs; ++i) { if (PathIsDir(pDirs[i]) && AddTree(pDirs[i])) ++nAdded; } std::vector<std::string> names; for (int i = 0; i < nDirs && names.empty(); ++i) ↳ az első könyvtár, amelyben van startup.txt { std::string sStartup = ResolveOnDisk(pDirs[i], "startup.txt"); ↳ kis/nagybetű-független keresés if (sStartup.empty()) continue; FILE* fp = fopen(sStartup.c_str(), "rb"); if (!fp) continue; fprintf(stderr, "[LTFILE] reading tree list from %s\n", sStartup.c_str()); char line[512]; while (fgets(line, sizeof(line), fp)) { const char* p = strchr(line, '='); // kell benne '=' if (!p) continue; if (strncasecmp(line, "Rez", 3) != 0) continue; ↳ és "Rez"-zel kell kezdődnie const char* q1 = strchr(p, '"'); ↳ az érték az idézőjelek között if (!q1) continue; const char* q2 = strchr(q1 + 1, '"'); if (!q2) continue; names.push_back(std::string(q1 + 1, (size_t)(q2 - q1 - 1))); } fclose(fp); }Ha nincs startup.txt, a motor minden *.rez-et felcsatol név szerinti sorrendben, és figyelmeztet. A tényleges erősorrend ezen a gépen:
autoexec.cfg-t. Ha módosított fájlt akarsz betenni, egy könyvtárat kell az archívumok után felsorolnod a startup.txt-ben.NOLF_GAME_DIR, és a kis- és nagybetűk
- A
NOLF_GAME_DIRkettősponttal elválasztott lista, legfeljebb 16 könyvtárral. Így a GOTY CD-k külön könyvtárban is lehetnek:disc1/Data:disc2/Data:disc2/Game. A Mac indító pontosan ezt rakja össze. - Archívumnevenként mindig az első könyvtár nyer, amelyikben a fájl megvan (ltfilemgr.cpp:309).
- A játék Windows-útvonalakat kér (
INTERFACE\FONTS\font_med_0.pcx). Könyvtárfában aDosToPosixa\jelet/-re cseréli. AResolveOnDiskelőbb simastat()-ot próbál; ha az nem talál, komponensenkéntreaddir+strcasecmpkeresést végez. Így Linuxon (ahol számít a kis- és nagybetű) is megtalálja aWorlds/helyett kértWORLDS\-t. - Hibakereséshez:
LT_TRACE_FILE=1minden megnyitott fájlt kiír:[LTFILE] Attributes\FX.txt 123456 bytes <- NOLFGOTY.REZ. Ez fontos, mert pl. aFx.txta nolf2.rez-ben és a nolfu003.rez-ben 5003 bájttal eltér, és csak így látszik, melyik töltődött be. - Ha egy fa sem csatolódik fel:
NO GAME RESOURCES. Set NOLF_GAME_DIR...
Fájltípusok és dekóderek
Minden betöltő a CLTFileMgr-en keresztül nyit fájlt, ezért mindegyikre ugyanaz a fasorrend érvényes.
| Típus | Mi ez | Dekóder | Megjegyzés |
|---|---|---|---|
.PCX | A teljes 2D felület: menük, képek és a 12 bitmap betű (INTERFACE\FONTS\*.PCX). | kernel/tex/ltpcx.cpp | RLE-kibontás RGBA8888-ra. Kiterjesztés nélküli névnél .pcx-szel újrapróbálja. |
.DTX | Pálya- és modelltextúrák. | kernel/tex/ltdtx.cpp | 164 bájtos fejléc, verzió −5. 4166 fájlból 2657 S3TC-tömörített (DXT1/DXT5), a kód kibontja. |
.SPR | Sprite: animált kép. | kernel/tex/ltspr.cpp | Nem kép: képkockaszám, fps, jelzők, színkulcs és DTX-nevek listája. |
.ABC | Modellek (szereplők, fegyverek). | model/ltabc.cpp | Nevesített chunkok abszolút „következő” eltolással, a végét 0xFFFFFFFF jelzi. Nulláról írt kód (a Jupiterben nincs ABC). |
.DAT | Pályák (v66). | world/ltworld.cpp | Geometria, lightmapek, objektumlista. Kiterjesztés nélküli névnél .dat-tal próbálja. |
.WAV | Hangok, beszéd. | sound/ltwav.cpp | 76%-uk valójában MP3 egy RIFF-burokban (format tag 85); 886 PCM, 250 IMA ADPCM. Az MP3-at Linuxon a dr_mp3, Macen az ExtAudioFile bontja ki. |
.TXT (Attributes) | A játék „bute” attribútumfájljai: fegyverek, FX, küldetések. | libs/butemgr/butemgr_impl.cpp | Az eredeti ButeMgrNoMFC.lib újraírása. A játék a GameButeMgr.cpp:117-ben a motoron keresztül nyitja meg. |
.sgt .sty .dls | DirectMusic zene: szegmensek, stílusok, hangszerbankok (113 bank, 39,7 MB). | sound/ltdmfiles.cpp, ltdls.cpp, ltdmsynth.cpp | Saját DirectMusic-csere. A pályák Music\<dir>\<név>.txt vezérlőfájlja mondja meg, mi szóljon. |
CRES.DLL | A játék összes szövege. | kernel/res/ltperes.cpp | Windows PE-fájl, a motor a szövegtábláját olvassa ki, lásd lent. |
GM hangszerbank (zene)
A NOLF saját DLS bankjai szinte mindent lefednek, de néhány hangszert a General MIDI alapbankból vár. Windowson ez a DirectX része volt.
- Mac: az Apple saját bankja,
/System/Library/Components/CoreAudio.component/Contents/Resources/gs_instruments.dls. - Linux (
sound/ltdmhost.cpp:39–57), ebben a sorrendben:LT_GMBANK→~/.local/share/NOLF1/gm.dls→gm.sf2→GeneralUser-GS.sf2→/usr/share/sounds/sf2/FluidR3_GM.sf2→/usr/share/soundfonts/FluidR3_GM.sf2→/usr/share/soundfonts/default.sf2. A SoundFont 2 fájlt azengine/linux/ltsf2.cppegy DLS-gyűjteménnyé alakítja, így a szintetizátor ugyanúgy szól, mint a Macen.
A szövegek: CRES.DLL
A játék minden szövege (menük, küldetések, feliratok) egy Windows DLL erőforrásában, STRINGTABLE-ként van. A port nem futtatja a DLL-t, csak beolvassa mint adatfájlt:
skeleton_host.cpp:3409:pSM->LoadResourceDll(LTGetFileMgr(), "CRES.DLL"). A fasorrend szerint a GOTY példánya nyer (774 144 bájt, 6031 szöveg a NOLF2.REZ 5876 szövegével szemben).ltperes.cpp: ellenőrzi a0x3Celtolásnál lévőe_lfanew-t és a"PE\0\0"aláírást, majd bejárja a háromszintű erőforráskönyvtárat, és csak azRT_STRING = 6típust tartja meg.- Egy szövegblokk pontosan 16 szöveget tartalmaz, az azonosítót a pozíció adja:
id = (blokkId − 1) · 16 + i. - A szöveg UTF-16LE, a motor CP1252-re alakítja, ahogy az angol Windows is tette. Így a „kacskaringós” idézőjelek megmaradnak.
unsigned int o = 0;for (unsigned int i = 0; i < 16; ++i) // blokkonként mindig 16 hely{ if (o + 2 > nSize) break; unsigned int n = rd16(p + o); ↳ a szöveg hossza (UTF-16 karakterben) o += 2; if (n == 0) continue; // üres hely: ilyen azonosító nincs if (o + n * 2 > nSize) return false; std::string s; CLTPEStringTable::Utf16ToCP1252((const unsigned short*)(p + o), n, s, &m_nLossy); ↳ UTF-16LE -> CP1252 o += n * 2; m_Strings[(int)((nBlockId - 1) * 16 + i)] = s; ↳ az azonosító a pozícióból adódik}NOLF/ClientRes/ClientRes.rc csak részhalmaz: 75 GOTY-azonosító hiányzik belőle. A kiadott DLL a hiteles forrás.A formázó szövegek a Windows FormatMessage nyelvtanát követik (%1!s!, %2!d!), nem a printf-ét. A cserét két lépésben kell elvégezni, mert például a 603-as szöveg "Picked up %2!s! ( %1!d! )" fordított sorrendben használja a paramétereket. Ismeretlen azonosítóra a motor szándékosan NULL-t ad, nem üres szöveget.
A magyar fordítás ezután, ugyanebben a függvényben töltődik rá a táblára: 5. fejezet.
Beállítások és mentések
| Mi | Linux | macOS |
|---|---|---|
A játékos beállításai (autoexec.cfg) | ~/.local/share/NOLF1/autoexec.cfg | ~/Library/Application Support/NOLF1/autoexec.cfg |
| „Registry” (RegMgr) | …/NOLF1/<Company>/<App>/settings.cfg | |
Mentések (Save\Quick.sav stb.) | A munkakönyvtárhoz képest: build-linux/Save/ (a play_linux.sh ide lép be) | ~/Library/Application Support/NOLF1/Profile/Save/ (az indító ezt állítja be munkakönyvtárnak) |
| Napló | ~/.local/share/NOLF1/utolso_futas.log (+ .log.1) | ~/Library/Logs/NOLF1/game-*.log (az utolsó 20) |
- A telepített játékot a port soha nem írja. Az eredeti
autoexec.cfg-t csak olvassa, a játékosé rátöltődik. - Íráskor a config először egy
.tmpfájlba kerül, majdrename()cseréli a régit, így egy összeomlás nem hagy félig írt fájlt (ltbindings.cpp:616–659). - A mentés eleje a
"NLF1SAVE"varázsszó. A szerver a\jelet/-re cseréli, létrehozza a könyvtárat, és relatív útvonalon nyit (ltserverhost.cpp:3067–3086). LT_CONFIGDIR=<dir>máshová teszi a configot;LT_NOUSERCONFIG=1kikapcsolja.
build-linux/-ban két fájl neve szó szerint visszaperjelet tartalmaz (Save\Summary.sav, Save\intel.sav). Valamelyik INI-író útvonal (valószínűleg a PlayerSummary.cpp / IntelItemMgr.cpp WinWritePrivateProfileString-je) nem alakítja át a jelet. Működési hibát nem okoz.