@gmvjs/dunia1 0.0.0-stage → 0.1.1

package/dist/index.js

@@ -0,0 +1,68 @@
+import { defineEngine } from "@gmvjs/core/plugin";
+import { EN } from "./i18n.js";
+const ui = { archives: true, archiveExts: ["fat", "dat"], archiveLabel: "Открыть *.fat + *.dat…" };
+const dunia1Engine = defineEngine({
+  id: "dunia1",
+  title: "Dunia Engine 1 (Far Cry 2)",
+  i18n: { en: EN },
+  codecs: [{ id: "xbt", extensions: ["xbt"], decode: async (buf) => (await import("./xbt.js")).decodeXbt(buf) }],
+  formats: [
+    {
+      id: "dunia-xbg",
+      title: "Far Cry 2: модель .xbg",
+      engine: "dunia1",
+      extensions: ["xbg"],
+      motionExtensions: ["mab"],
+      status: "beta",
+      sniff: (h) => String.fromCharCode(...h.subarray(0, 4)) === "HSEM" ? 1 : 0,
+      load: async (main, ctx) => (await import("./xbg.js")).loadXbg(main, ctx),
+      afterLoad: async (ctx) => {
+        const arc = ctx.main.archive;
+        if (!arc || !ctx.model.loadMotions) return;
+        const list = (await import("./xbg.js")).listMabMotions(ctx.model, arc);
+        if (list.length) ctx.addMotions(list, "animations");
+      }
+    },
+    {
+      id: "dunia-level",
+      title: "Far Cry 2: уровень (worlds/<мир>/maps/*.fc2level — карта 1×1 км с объектами; <мир>.fc2level — весь мир)",
+      engine: "dunia1",
+      extensions: ["fc2level"],
+      status: "beta",
+      sniff: (h) => String.fromCharCode(...h.subarray(0, 12)) === "DUNIA-LEVEL\n" ? 1 : 0,
+      load: async (main, ctx) => {
+        const text = new TextDecoder().decode(await main.arrayBuffer());
+        return (await import("./level.js")).loadDuniaLevel(text, main, ctx);
+      }
+    }
+  ],
+  archives: [
+    {
+      id: "dunia-fat",
+      title: "Far Cry 2: архивы .fat + .dat",
+      engine: "dunia1",
+      extensions: ["fat"],
+      companionExtensions: ["dat"],
+      openFromFolder: true,
+      sniff: (h) => String.fromCharCode(...h.subarray(0, 4)) === "2TAF" ? 1 : 0,
+      open: async (file, siblings) => (await import("./fat.js")).openDuniaArchive(file, siblings)
+    }
+  ],
+  games: [
+    {
+      id: "farcry2",
+      group: "Игры",
+      title: "Far Cry 2 (2008)",
+      engine: "dunia1",
+      formats: ["dunia-xbg", "dunia-level"],
+      hint: "Откройте папку игры (или Data_Win32): архивы .fat/.dat подключатся сами, имена файлов берутся из списков ресурсов игры. Модели — graphics/…/*.xbg, уровни — worlds/<мир>/maps/*.fc2level (карта 1×1 км: ландшафт и объекты) и worlds/<мир>/<мир>.fc2level (весь мир — ландшафт).",
+      ui,
+      status: "beta",
+      markers: ["common.fat", "worlds.fat"]
+    }
+  ]
+});
+export {
+  dunia1Engine
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["// Dunia Engine 1 (Far Cry 2): .fat/.dat archives (names by hash, from the game's XML resource lists), .xbg models, .xbm materials,\n// .xbt textures, .mab animations (skeleton: *_ref.skeleton in the model folder or above).\nimport { defineEngine, type GamePreset } from '@gmvjs/core/plugin';\nimport { EN } from './i18n';\n\nconst ui: GamePreset['ui'] = { archives: true, archiveExts: ['fat', 'dat'], archiveLabel: 'Открыть *.fat + *.dat…' };\n\nexport const dunia1Engine = defineEngine({\n  id: 'dunia1',\n  title: 'Dunia Engine 1 (Far Cry 2)',\n  i18n: { en: EN },\n  codecs: [{ id: 'xbt', extensions: ['xbt'], decode: async (buf) => (await import('./xbt')).decodeXbt(buf) }],\n  formats: [\n    {\n      id: 'dunia-xbg',\n      title: 'Far Cry 2: модель .xbg',\n      engine: 'dunia1',\n      extensions: ['xbg'],\n      motionExtensions: ['mab'],\n      status: 'beta',\n      sniff: (h) => (String.fromCharCode(...h.subarray(0, 4)) === 'HSEM' ? 1 : 0),\n      load: async (main, ctx) => (await import('./xbg')).loadXbg(main, ctx),\n      afterLoad: async (ctx) => {\n        const arc = ctx.main.archive;\n        if (!arc || !ctx.model.loadMotions) return;\n        const list = (await import('./xbg')).listMabMotions(ctx.model, arc);\n        if (list.length) ctx.addMotions(list, 'animations');\n      },\n    },\n    {\n      id: 'dunia-level',\n      title: 'Far Cry 2: уровень (worlds/<мир>/maps/*.fc2level — карта 1×1 км с объектами; <мир>.fc2level — весь мир)',\n      engine: 'dunia1',\n      extensions: ['fc2level'],\n      status: 'beta',\n      sniff: (h) => (String.fromCharCode(...h.subarray(0, 12)) === 'DUNIA-LEVEL\\n' ? 1 : 0),\n      load: async (main, ctx) => {\n        const text = new TextDecoder().decode(await main.arrayBuffer());\n        return (await import('./level')).loadDuniaLevel(text, main, ctx);\n      },\n    },\n  ],\n  archives: [\n    {\n      id: 'dunia-fat',\n      title: 'Far Cry 2: архивы .fat + .dat',\n      engine: 'dunia1',\n      extensions: ['fat'],\n      companionExtensions: ['dat'],\n      openFromFolder: true,\n      sniff: (h) => (String.fromCharCode(...h.subarray(0, 4)) === '2TAF' ? 1 : 0),\n      open: async (file, siblings) => (await import('./fat')).openDuniaArchive(file, siblings),\n    },\n  ],\n  games: [\n    {\n      id: 'farcry2',\n      group: 'Игры',\n      title: 'Far Cry 2 (2008)',\n      engine: 'dunia1',\n      formats: ['dunia-xbg', 'dunia-level'],\n      hint: 'Откройте папку игры (или Data_Win32): архивы .fat/.dat подключатся сами, имена файлов берутся из списков ресурсов игры. Модели — graphics/…/*.xbg, уровни — worlds/<мир>/maps/*.fc2level (карта 1×1 км: ландшафт и объекты) и worlds/<мир>/<мир>.fc2level (весь мир — ландшафт).',\n      ui,\n      status: 'beta',\n      markers: ['common.fat', 'worlds.fat'],\n    },\n  ],\n});\n"],"names":[],"mappings":";;AAKA,MAAM,KAAuB,EAAE,UAAU,MAAM,aAAa,CAAC,OAAO,KAAK,GAAG,cAAc,yBAAA;AAEnF,MAAM,eAAe,aAAa;AAAA,EACvC,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,MAAM,EAAE,IAAI,GAAA;AAAA,EACZ,QAAQ,CAAC,EAAE,IAAI,OAAO,YAAY,CAAC,KAAK,GAAG,QAAQ,OAAO,SAAS,MAAM,OAAO,UAAO,GAAG,UAAU,GAAG,GAAG;AAAA,EAC1G,SAAS;AAAA,IACP;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY,CAAC,KAAK;AAAA,MAClB,kBAAkB,CAAC,KAAK;AAAA,MACxB,QAAQ;AAAA,MACR,OAAO,CAAC,MAAO,OAAO,aAAa,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC,MAAM,SAAS,IAAI;AAAA,MACzE,MAAM,OAAO,MAAM,SAAS,MAAM,OAAO,UAAO,GAAG,QAAQ,MAAM,GAAG;AAAA,MACpE,WAAW,OAAO,QAAQ;AACxB,cAAM,MAAM,IAAI,KAAK;AACrB,YAAI,CAAC,OAAO,CAAC,IAAI,MAAM,YAAa;AACpC,cAAM,QAAQ,MAAM,OAAO,UAAO,GAAG,eAAe,IAAI,OAAO,GAAG;AAClE,YAAI,KAAK,OAAQ,KAAI,WAAW,MAAM,YAAY;AAAA,MACpD;AAAA,IAAA;AAAA,IAEF;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY,CAAC,UAAU;AAAA,MACvB,QAAQ;AAAA,MACR,OAAO,CAAC,MAAO,OAAO,aAAa,GAAG,EAAE,SAAS,GAAG,EAAE,CAAC,MAAM,kBAAkB,IAAI;AAAA,MACnF,MAAM,OAAO,MAAM,QAAQ;AACzB,cAAM,OAAO,IAAI,YAAA,EAAc,OAAO,MAAM,KAAK,aAAa;AAC9D,gBAAQ,MAAM,OAAO,YAAS,GAAG,eAAe,MAAM,MAAM,GAAG;AAAA,MACjE;AAAA,IAAA;AAAA,EACF;AAAA,EAEF,UAAU;AAAA,IACR;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,YAAY,CAAC,KAAK;AAAA,MAClB,qBAAqB,CAAC,KAAK;AAAA,MAC3B,gBAAgB;AAAA,MAChB,OAAO,CAAC,MAAO,OAAO,aAAa,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC,MAAM,SAAS,IAAI;AAAA,MACzE,MAAM,OAAO,MAAM,cAAc,MAAM,OAAO,UAAO,GAAG,iBAAiB,MAAM,QAAQ;AAAA,IAAA;AAAA,EACzF;AAAA,EAEF,OAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,SAAS,CAAC,aAAa,aAAa;AAAA,MACpC,MAAM;AAAA,MACN;AAAA,MACA,QAAQ;AAAA,MACR,SAAS,CAAC,cAAc,YAAY;AAAA,IAAA;AAAA,EACtC;AAEJ,CAAC;"}

package/dist/level.d.ts

@@ -0,0 +1,120 @@
+import type { LoadContext } from '@gmvjs/core/plugin';
+import type { Mesh, Model, VFile } from '@gmvjs/core/types';
+import { type DuniaArchiveApi, type DuniaWorld, type FatRef } from './fat';
+import { type FcbObject } from './fcb';
+export interface TerrainLayer {
+    name: string;
+    texture: string;
+    normal: string;
+    tiling: number;
+}
+/** Terrain layers and the world grid from game.xml. */
+export declare function worldDescriptor(u: Uint8Array): {
+    layers: TerrainLayer[];
+    countX: number;
+    countY: number;
+};
+export interface TerrainSector {
+    id: number;
+    min: number;
+    max: number;
+    layers: number[];
+    height: Float32Array;
+    mask: Uint8Array;
+    water: number;
+}
+/** Sector terrain (see the file header). */
+export declare function parseTerrainSector(u: Uint8Array): TerrainSector;
+/**
+ * Vertex layer: the highest set bit of the mask's low nibble whose slot is used (the top painted layer);
+ * an empty slot is 255; with no bits (sector edge), the first used slot.
+ */
+export declare function vertexLayer(mask: number, slots: readonly number[]): number;
+/**
+ * Object angles (degrees) -> quaternion [w, x, y, z]: R = Rz(z)·Ry(y)·Rx(x) (X first, then Y, then Z, the yaw).
+ * Verified on objects on slopes: the object's "up" axis matches the ground normal (see the level test).
+ */
+export declare function anglesQuat(a: readonly number[]): number[];
+/** Level object: model, visible parts (empty = all), pose. */
+export interface LevelEntity {
+    name: string;
+    model: string;
+    parts: string[];
+    pos: number[];
+    angles: number[];
+    layer: string;
+    archetype?: string;
+}
+/** entitylibrary.fcb archetypes: hidName -> model and parts. */
+export declare function entityLibrary(root: FcbObject): Map<string, {
+    model: string;
+    parts: string[];
+}>;
+/** Sector objects (WorldSector) with models; archetypes from the library. */
+export interface LevelMarker {
+    kind: 'particle' | 'light';
+    name: string;
+    pos: number[];
+}
+export declare function sectorEntities(root: FcbObject, lib: Map<string, {
+    model: string;
+    parts: string[];
+}>): {
+    list: LevelEntity[];
+    noModel: number;
+    unknownArchetype: Set<string>;
+    markers: LevelMarker[];
+};
+/**
+ * Sector collections (CCollectionComponent of CSectorEntity: rocks, debris, vegetation placed with the editor brush):
+ * 0x114CFEE7 is a set (frame 0x17E7C62E–0x2BEAF977), its data 0xA18C8484: 0x89C8C095 = model path hashes (like the names
+ * in .fat), 0x58AD43E2 = group count per model, 0x798C33D5 = groups (u8 instance count, then the first index),
+ * 0xB0484974 = group centers and radii; instances: 0xD28100C0 = u16 x, u16 y (decimetres), 0x8E2752CA = f32 z,
+ * 0x98C678BD = u32 (low 16 bits: rotation about Z, full circle = 65536; high bits not decoded), 0x9D1CAE67 = colors.
+ * Every array is a u32 count followed by the elements.
+ */
+export declare function sectorCollections(root: FcbObject): Array<{
+    hash: number;
+    pos: number[];
+    yaw: number;
+}>;
+/** Terrain grid step (m): a power of two so that the vertex count stays within the budget. */
+export declare const terrainStep: (w: number, h: number, budget?: number) => number;
+/** Terrain meshes of an area: one mesh per layer (a triangle goes by the layer of its corner), UVs tile the layer (Tiling repeats per sector). */
+export declare function terrainMeshes(spec: {
+    x0: number;
+    y0: number;
+    w: number;
+    h: number;
+}, sectors: Map<number, TerrainSector>, widthInSectors: number, layers: TerrainLayer[], step: number): Mesh[];
+/** Water: for each sector with a water level, grid cells where the ground is below it, as a plane at that level; translucent. */
+export declare function waterMesh(spec: {
+    x0: number;
+    y0: number;
+    w: number;
+    h: number;
+}, sectors: Map<number, TerrainSector>, widthInSectors: number, step: number): Mesh | null;
+/** World index: world files, terrain by sector number, object files (WorldSector) by X, Y. Built once per archive. */
+interface WorldIndex {
+    files: FatRef[];
+    terrain: Map<number, FatRef>;
+    terrainEnd: number;
+    objects?: Promise<Map<number, FatRef[]>>;
+    full?: boolean;
+}
+/**
+ * World index. Normally a world's files are the .dat range between the previous world's .sectorsdep.fcb and its own (worlds.dat). If
+ * that range has no terrain or sector numbers repeat (dlc1.dat: first the sectors of all worlds, then their named files), the k-th .dat terrain block belongs to the k-th world
+ * in .sectorsdep.fcb order, and the world's files run from the start of its block to the start of the next.
+ */
+export declare function worldIndex(api: DuniaArchiveApi, world: DuniaWorld): Promise<WorldIndex>;
+/**
+ * World object files: .fcb with a WorldSector root. In large worlds they follow the terrain block (mission layer objects; next to
+ * the terrain are only vegetation collection sectors), in small worlds they are mixed with the terrain. X, Y are the root's first
+ * values, read from the start of the file.
+ */
+export declare function worldObjects(api: DuniaArchiveApi, world: DuniaWorld, idx: WorldIndex): Promise<Map<number, FatRef[]>>;
+/** X, Y from the start of an .fcb with a WorldSector root (otherwise null). */
+export declare function worldSectorXY(h: Uint8Array): [number, number] | null;
+export declare function loadDuniaLevel(text: string, main: VFile, ctx: LoadContext): Promise<Model>;
+export {};