@gmvjs/dunia1 0.0.0-stage → 0.1.0

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 (Far Cry 2): архивы .fat/.dat (имена по хешу, из XML-списков ресурсов игры), модели .xbg, материалы .xbm,\n// текстуры .xbt, анимации .mab (скелет — *_ref.skeleton в папке модели или выше).\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;
+}
+/** Слои ландшафта и сетка мира из 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;
+}
+/** Ландшафт сектора (см. заголовок файла). */
+export declare function parseTerrainSector(u: Uint8Array): TerrainSector;
+/**
+ * Слой вершины: старший установленный бит младшей тетрады маски, чей слот занят (верхний нарисованный слой);
+ * пустой слот — 255; без бит (край сектора) — первый занятый слот.
+ */
+export declare function vertexLayer(mask: number, slots: readonly number[]): number;
+/**
+ * Углы объекта (градусы) -> кватернион [w, x, y, z]: R = Rz(z)·Ry(y)·Rx(x) (сначала X, затем Y, затем Z — рыскание).
+ * Проверено по объектам на склонах: ось «вверх» объекта совпадает с нормалью земли (см. тест уровней).
+ */
+export declare function anglesQuat(a: readonly number[]): number[];
+/** Объект уровня: модель, видимые части (пусто — все), поза. */
+export interface LevelEntity {
+    name: string;
+    model: string;
+    parts: string[];
+    pos: number[];
+    angles: number[];
+    layer: string;
+    archetype?: string;
+}
+/** Архетипы entitylibrary.fcb: hidName -> модель и части. */
+export declare function entityLibrary(root: FcbObject): Map<string, {
+    model: string;
+    parts: string[];
+}>;
+/** Объекты сектора (WorldSector) с моделями; архетипы — по библиотеке. */
+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[];
+};
+/**
+ * Коллекции сектора (CCollectionComponent у CSectorEntity — камни, мусор, растительность, расставленные кистью редактора):
+ * 0x114CFEE7 — набор (рамка 0x17E7C62E–0x2BEAF977), его данные 0xA18C8484: 0x89C8C095 — хеши путей моделей (как имена
+ * в .fat), 0x58AD43E2 — число групп каждой модели, 0x798C33D5 — группы (u8 число экземпляров, далее номер первого),
+ * 0xB0484974 — центры и радиусы групп; экземпляры: 0xD28100C0 — u16 x, u16 y (дециметры), 0x8E2752CA — f32 z,
+ * 0x98C678BD — u32 (младшие 16 бит — поворот вокруг Z, полный круг = 65536; старшие — не разобраны), 0x9D1CAE67 — цвета.
+ * Все массивы — u32 число, затем элементы.
+ */
+export declare function sectorCollections(root: FcbObject): Array<{
+    hash: number;
+    pos: number[];
+    yaw: number;
+}>;
+/** Шаг сетки ландшафта (м): степень двойки, чтобы вершин было не больше бюджета. */
+export declare const terrainStep: (w: number, h: number, budget?: number) => number;
+/** Меши ландшафта области: по мешу на слой (треугольник — по слою его угла), UV — плитка слоя (Tiling повторов на сектор). */
+export declare function terrainMeshes(spec: {
+    x0: number;
+    y0: number;
+    w: number;
+    h: number;
+}, sectors: Map<number, TerrainSector>, widthInSectors: number, layers: TerrainLayer[], step: number): Mesh[];
+/** Вода: по сектору с уровнем воды — клетки сетки, где земля ниже уровня, плоскостью на уровне; полупрозрачная. */
+export declare function waterMesh(spec: {
+    x0: number;
+    y0: number;
+    w: number;
+    h: number;
+}, sectors: Map<number, TerrainSector>, widthInSectors: number, step: number): Mesh | null;
+/** Указатель мира: файлы мира, ландшафт по номеру сектора, файлы объектов (WorldSector) по X, Y. Строится один раз на архив. */
+interface WorldIndex {
+    files: FatRef[];
+    terrain: Map<number, FatRef>;
+    terrainEnd: number;
+    objects?: Promise<Map<number, FatRef[]>>;
+    full?: boolean;
+}
+/**
+ * Указатель мира. Обычно файлы мира — участок .dat между .sectorsdep.fcb предыдущего мира и своим (worlds.dat). Если там
+ * нет ландшафта или номера секторов повторяются (dlc1.dat: сначала сектора всех миров, потом их именованные файлы), k-й блок ландшафта .dat — k-го мира
+ * по порядку .sectorsdep.fcb, а файлы мира — от начала его блока до начала следующего.
+ */
+export declare function worldIndex(api: DuniaArchiveApi, world: DuniaWorld): Promise<WorldIndex>;
+/**
+ * Файлы объектов мира: .fcb с корнем WorldSector. У больших миров — после блока ландшафта (объекты слоёв миссий; рядом
+ * с ландшафтом — только сектора-коллекции растительности), у малых — вперемешку с ландшафтом. X, Y — первые значения
+ * корня, читаются из начала файла.
+ */
+export declare function worldObjects(api: DuniaArchiveApi, world: DuniaWorld, idx: WorldIndex): Promise<Map<number, FatRef[]>>;
+/** X, Y из начала .fcb с корнем WorldSector (иначе null). */
+export declare function worldSectorXY(h: Uint8Array): [number, number] | null;
+export declare function loadDuniaLevel(text: string, main: VFile, ctx: LoadContext): Promise<Model>;
+export {};