THE OPERATIVE · NO ONE LIVES FOREVER · PORT

Játékadatok: REZ és társai

Honnan veszi a motor a pályákat, textúrákat, hangokat és szövegeket

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ájlMéretMi ez
NOLF.REZ618 MBAz 1. CD fő archívuma: pályák, textúrák, modellek, hangok.
NOLF2.REZ301 MBA 2. CD archívuma; ebben van az alap CRES.DLL is.
nolfu003.rez18 MBAz 1.003-as patch felülírásai (pl. egy újabb Attributes\FX.txt).
NOLFGOTY.REZ170 MBA Game of the Year bővítés: új küldetés, javított CRES.DLL (6031 szöveg).
startup.txt199 BMegadja, mely archívumok és milyen sorrendben töltődnek be.
autoexec.cfg10 KBAlapbeállítások és billentyűk. A port csak olvassa.
defctrls.cfg5 KBAz „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.
A *cres.rez fájlok: a 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):

xxd 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ásMezőJelentés
0CR LFHogy a type paranccsal kiírva is olvasható legyen.
2FileType[60]„RezMgr Version 1 Copyright (C) 1995 MONOLITH INC.”
62CR LF
64UserTitle[60]„LithTech Resource File”
124CR LF EOFA 0x1A miatt a DOS type itt megáll.
127DWORD FileFormatVersionPontosan 1 kell legyen.
131DWORD RootDirPos, RootDirSizeA gyökérkönyvtár-blokk helye és mérete.
139…7 további DWORDRootDirTime, NextWritePos, Time, LargestKeyAry, LargestDirNameSize, LargestRezNameSize, LargestCommentSize
167BYTE IsSortedÖsszesen 168 bájt.
engine/kernel/io/ltrezfile.cpp:160
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

engine/kernel/io/ltrezfile.cpp:205 (ReadDirectory)
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 kell
A meglepetés: a kiterjesztés visszafelé van. Egy REZ bejegyzés nem FX.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:

engine/kernel/io/ltrezfile.cpp:109 (NormalisePath, kivonat)
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).

engine/kernel/io/ltfilemgr.cpp:393 (OpenFile)
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:

No One Lives Forever/startup.txt
[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 mindent
engine/kernel/io/ltfilemgr.cpp:219 (InitFromGameDirs)
int 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:

NOLFGOTY.REZ nolfu003.rez NOLF2.REZ NOLF.REZ a játék könyvtára ◀ ERŐSEBB ················· a keresés iránya ················· GYENGÉBB ▶
A laza fájlok NEM írják felül a REZ-t. A játék könyvtára került be elsőként, ezért a leggyengébb. Csak olyan fájlt ad, amilyet egyik archívum sem tartalmaz, például az 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

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ípusMi ezDekóderMegjegyzés
.PCXA teljes 2D felület: menük, képek és a 12 bitmap betű (INTERFACE\FONTS\*.PCX).kernel/tex/ltpcx.cppRLE-kibontás RGBA8888-ra. Kiterjesztés nélküli névnél .pcx-szel újrapróbálja.
.DTXPálya- és modelltextúrák.kernel/tex/ltdtx.cpp164 bájtos fejléc, verzió −5. 4166 fájlból 2657 S3TC-tömörített (DXT1/DXT5), a kód kibontja.
.SPRSprite: animált kép.kernel/tex/ltspr.cppNem kép: képkockaszám, fps, jelzők, színkulcs és DTX-nevek listája.
.ABCModellek (szereplők, fegyverek).model/ltabc.cppNevesített chunkok abszolút „következő” eltolással, a végét 0xFFFFFFFF jelzi. Nulláról írt kód (a Jupiterben nincs ABC).
.DATPályák (v66).world/ltworld.cppGeometria, lightmapek, objektumlista. Kiterjesztés nélküli névnél .dat-tal próbálja.
.WAVHangok, beszéd.sound/ltwav.cpp76%-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.cppAz eredeti ButeMgrNoMFC.lib újraírása. A játék a GameButeMgr.cpp:117-ben a motoron keresztül nyitja meg.
.sgt .sty .dlsDirectMusic zene: szegmensek, stílusok, hangszerbankok (113 bank, 39,7 MB).sound/ltdmfiles.cpp, ltdls.cpp, ltdmsynth.cppSaját DirectMusic-csere. A pályák Music\<dir>\<név>.txt vezérlőfájlja mondja meg, mi szóljon.
CRES.DLLA játék összes szövege.kernel/res/ltperes.cppWindows 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.

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:

  1. 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).
  2. ltperes.cpp: ellenőrzi a 0x3C eltolá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 az RT_STRING = 6 típust tartja meg.
  3. Egy szövegblokk pontosan 16 szöveget tartalmaz, az azonosítót a pozíció adja: id = (blokkId − 1) · 16 + i.
  4. 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.
engine/kernel/res/ltperes.cpp:171 – egy 16-os blokk
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}
MIÉRT nem a ClientRes.rc forrásfájlból? A repóban lévő 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

MiLinuxmacOS
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)
Ismert apróság: a 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.