🎮 Game Formats ================================================== .. include:: _links.rst .. warning:: Formats specifications are based on **reverse-engineering efforts** and may contain inaccuracies. Subject to change. ---------------------------------------- 🧊 Model Formats ---------------------------------------- .. list-table:: :header-rows: 0 * - ``.mcsa`` - **Scene Assets** (MCSA.bt_) • Configuration: Flags, Scales. • Geometry: Name, Material, Vertex Position, UVs, Normals, Polygons. • Optional: Skeleton bones, Animation clips. * - ``.mcsb`` - **Scene Bundle** (MCSA.bt_) • Identical to ``.mcsa`` but with integrity check. • Contains leading hash to prevent tampering. * - ``.mcvd`` - **Vector Dynamic** (MCSA.bt_) • Simplified low-poly geometry. • Includes animation data. • Used for physics/collision trace detection. * - ``.mcal`` - **Animation Library** (MCAL.bt_) • Metadata: frame count, bone count. • Technical skeletal animation transforms (per bone). • Model-specific (requires matching skeleton). * - ``.mcws`` - **World Slice** (`AES Encrypted `_) • Slices of safezone (world as 3D model). • Used in safezone workbench rendering. ---------------------------------------- 🧱 Texture Formats ---------------------------------------- ``.ol`` Object Layer (OL.bt_) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Standard ``.dds`` (`DirectDraw Surface `_). | Has simplified structure and `mipmaps `_ are compressed using `LZ4`_. | Some `normal maps `_ textures can be inverted. | Some textures can be `cube maps `_. (OLCUBEMAP.bt_) | Mainly located in: ``gloomycore/sky``, ``effects/textures``, ``stalker/gui``. .. list-table:: Texture Suffix Conventions :header-rows: 1 * - Suffix - Map - Type - Purpose * - ``_diff`` - Diffuse - Base Color / Albedo - Contains raw surface color without lighting or reflections. * - ``_spek`` - Specular - Reflectivity Control - Defines intensity and sharpness of highlights/reflections. * - ``_nrm`` - Normal - Surface Detail - Simulates small bumps/dents without changing geometry. * - ``_emi`` - Emission - Self-Illumination - Makes parts glow or emit light independently. ``.mic`` Media Image Container ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Standard ``.png`` (`Portable Network Graphics `_). | Has modified `file signature `_. | Previously used for game `GUI`_. ``.texarr`` TEXture ARRay (TEXARR.bt_) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Container for ``.dds`` (`DirectDraw Surface `_) textures. | Textures referenced as ``group:path`` (e.g., ``probuilder:general/generic``). ---------------------------------------- 🗂️ Other Formats ---------------------------------------- ``.xeon`` eXtended Encrypted Object Notation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Contains large `JSON`_ structure. `AES Encrypted `_. | Once encrypted individually ``.eon`` files combined into bundles. ---------------------------------------- 🛠️ Launcher Formats ---------------------------------------- ``.map`` MAPping hashes (HASHMAP.bt_) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Contains SHA-1 hash mappings for game files. | Used by launcher for integrity verification. ``.torrent.bin`` TORRENT BINary (TORRENT.bt_) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | Modified ``.torrent`` (`Torrent `_) file. | Used by game launcher for content delivery. | Trackers block unauthorized access (token required). ---------------------------------------- 🗃️ NBT Formats ---------------------------------------- Uncompressed **NBT** (`Named Binary Tag `_) format and can be viewed/edited with tools like `NBT Explorer `_. Can be raw, but in game uses ``GZIP`` or ``ZSTD`` compression. Assets ^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 * - Filename - Compression - Purpose * - ``stalker/itemnames.dat`` - ``GZIP`` - **Quests items descriptions**. Configs ^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 * - Filename - Compression - Purpose - Keys (examples) * - ``prefs`` - ``ZSTD`` - **UI read state cache**. Tracks seen articles, experiences, tutorial prompts, and ads. - ``seenArticleLinks[], seenExperiences[], hasSeen*`` Per-Character Configs ^^^^^^^^^^^^^^^^^^^^^^ | Located in ``/config/%CharacterName%/``. | Files prefixed with ``sd`` (**Synced Data**) contain synchronized player state cached locally. .. list-table:: :header-rows: 1 * - Filename - Compression - Purpose - Keys (examples) * - ``common`` - ``ZSTD`` - **General settings and UI states**. Loot filter ("trashed" items), Reports cooldown, Events UI toggles, Viewed tutorials and introductions. - ``trashedItems[], caseLastOpenCount[], complaintsData{reportedCharnames[], reportedHacks[], ...}, seenFrontlineIntros`` * - ``sd0`` - ``ZSTD`` - **Incoming friend requests**. Contains a list of pending requests for UI. - ``requests[]`` * - ``sd1`` - ``ZSTD`` - **Recent interactions** (last 200 players). Stores usernames, faction IDs, and interaction type for the "Recently Interacted" UI. - ``interacts[{allianceId, type, username}]`` * - ``sd2`` - ``ZSTD`` - **Notifications history** (last 100 popups). Stores message content, read status, and dynamic ``payload`` (varies by notification type). - ``notifications[{isRead, receivedMoment, notification{channel_id, payload}}]`` * - ``sd3`` - ``ZSTD`` - **Store (donate shop) view history**. Tracks observed shop offers. - ``observedOffers[]`` * - ``sd4`` - ``ZSTD`` - **Profile customization UI state**. Tracks last seen versions of backgrounds, patterns, stickers, and tags. - ``lastSeenBackgroundsVersion, lastSeenPatternsVersion, lastSeenStickersVersion, lastSeenTagsVersion`` ---------------------------------------- ⚙️ Config Formats ---------------------------------------- .. list-table:: :header-rows: 1 * - Filename - Format - Purpose * - ``display`` - Text - Selected display ID * - ``keybindings`` - JSON - Keyboard control mappings * - ``options.json`` - JSON - Game settings (graphics, audio, gameplay) * - ``quests.json`` - JSON - Quest visibility toggles * - ``waypoints.cfg`` - JSON - Custom map markers