@gmvjs/unreal3 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Shibisty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,62 @@
-# Temporary Holding Version
+# @gmvjs/unreal3 — Unreal Engine 3, via PSK export
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![Patreon](https://c5.patreon.com/external/logo/become_a_patron_button.png)](https://www.patreon.com/cw/shibisty)
+
+Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…): a bridge for now; models and animations exported by UModel / FModel to ActorX PSK/PSKX/PSA. PSK parsing comes from [`@gmvjs/unreal2`](../unreal2/README.md).
+
+An engine plugin for [`@gmvjs/core`](../core/README.md): formats, archives and game presets. Heavy parsers are loaded on demand (`import()` inside `load`), so adding the package costs almost nothing until a file of this engine is opened.
+
+## Installation
+
+```sh
+npm i @gmvjs/core @gmvjs/unreal3 @gmvjs/unreal2
+```
+
+## Usage
+
+The whole engine (all games):
+
+```ts
+import { createRegistry, ViewerSession } from '@gmvjs/core';
+import { unreal3Engine } from '@gmvjs/unreal3';
+
+const session = new ViewerSession(createRegistry([unreal3Engine]));
+```
+
+One game: a package subpath (the game preset and an engine limited to that game):
+
+```ts
+import { createRegistry, ViewerSession } from '@gmvjs/core';
+import ue3 from '@gmvjs/unreal3/ue3';
+
+const session = new ViewerSession(createRegistry([ue3.engine]), ue3.preset.id);
+```
+
+## Games (subpaths)
+
+| Import | Preset | Game | Status | Notes |
+|---|---|---|---|---|
+| `@gmvjs/unreal3/ue3` | `ue3` | Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…) — PSK/PSA export | 🔌 bridge (via export) | — |
+
+## Formats
+
+| id | What | Files | Status |
+|---|---|---|---|
+| `unreal3-psk` | ActorX PSK/PSKX | `.psk`, `.pskx` + `.psa` animations | 🔌 bridge (via export) |
+
+## Dependencies
+
+- `@gmvjs/core` — plugin API, types, ZIP/folder archives, zlib, DDS/BC, geometry
+- `@gmvjs/unreal2` — PSK/PSA parsing
+
+## Not done yet
+
+- Native `.upk`, `.u`
+
+## License
+
+MIT
+
+[![Patreon](https://c5.patreon.com/external/logo/become_a_patron_button.png)](https://www.patreon.com/cw/shibisty)
+
+If this project helps you, consider supporting its development on Patreon ❤️

package/dist/games/ue3.d.ts

@@ -0,0 +1,7 @@
+export declare const engine: import("@gmvjs/core/plugin").EnginePlugin;
+export declare const preset: import("@gmvjs/core/plugin").GamePreset;
+declare const _default: {
+    engine: import("@gmvjs/core/plugin").EnginePlugin;
+    preset: import("@gmvjs/core/plugin").GamePreset;
+};
+export default _default;

package/dist/games/ue3.js

@@ -0,0 +1,11 @@
+import { pickGames } from "@gmvjs/core/plugin";
+import { unreal3Engine } from "../index.js";
+const engine = pickGames(unreal3Engine, "ue3");
+const preset = engine.games[0];
+const ue3 = { engine, preset };
+export {
+  ue3 as default,
+  engine,
+  preset
+};
+//# sourceMappingURL=ue3.js.map

package/dist/games/ue3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ue3.js","sources":["../../src/games/ue3.ts"],"sourcesContent":["// Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…) — PSK/PSA export — subpath `@gmvjs/unreal3/ue3`: the game preset and an engine limited to it.\nimport { pickGames } from '@gmvjs/core/plugin';\nimport { unreal3Engine } from '../index';\n\nexport const engine = pickGames(unreal3Engine, 'ue3');\nexport const preset = engine.games![0]!;\nexport default { engine, preset };\n"],"names":[],"mappings":";;AAIO,MAAM,SAAS,UAAU,eAAe,KAAK;AAC7C,MAAM,SAAS,OAAO,MAAO,CAAC;AACrC,MAAA,MAAe,EAAE,QAAQ,OAAA;"}

package/dist/i18n.d.ts

@@ -0,0 +1,2 @@
+import type { EngineTexts } from '@gmvjs/core/plugin';
+export declare const EN: EngineTexts;

package/dist/i18n.js

@@ -0,0 +1,13 @@
+const EN = {
+  "title": "Unreal Engine 3, via PSK export",
+  "presets": {
+    "ue3": {
+      "title": "Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…) — PSK/PSA export",
+      "hint": 'Export the model with UModel (UEViewer) to PSK/PSKX (+ PSA for animations, textures as TGA/PNG) and open the export folder with "Game folder". Native .upk/.u are not read yet.'
+    }
+  }
+};
+export {
+  EN
+};
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sources":["../src/i18n.ts"],"sourcesContent":["// English texts of the unreal3 engine (Russian ones live in the plugins themselves).\nimport type { EngineTexts } from '@gmvjs/core/plugin';\n\nexport const EN: EngineTexts = {\n  \"title\": \"Unreal Engine 3, via PSK export\",\n  \"presets\": {\n    \"ue3\": {\n      \"title\": \"Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…) — PSK/PSA export\",\n      \"hint\": \"Export the model with UModel (UEViewer) to PSK/PSKX (+ PSA for animations, textures as TGA/PNG) and open the export folder with \\\"Game folder\\\". Native .upk/.u are not read yet.\"\n    }\n  }\n};\n"],"names":[],"mappings":"AAGO,MAAM,KAAkB;AAAA,EAC7B,SAAS;AAAA,EACT,WAAW;AAAA,IACT,OAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,IAAA;AAAA,EACV;AAEJ;"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare const unreal3Engine: import("@gmvjs/core/plugin").EnginePlugin;

package/dist/index.js

@@ -0,0 +1,25 @@
+import { defineEngine } from "@gmvjs/core/plugin";
+import { pskUi, pskFormat } from "@gmvjs/unreal2";
+import { EN } from "./i18n.js";
+const unreal3Engine = defineEngine({
+  id: "unreal3",
+  title: "Unreal Engine 3, через экспорт PSK",
+  i18n: { en: EN },
+  formats: [pskFormat("unreal3")],
+  games: [
+    {
+      id: "ue3",
+      group: "Игры",
+      title: "Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…) — экспорт PSK/PSA",
+      engine: "unreal3",
+      formats: ["unreal3-psk"],
+      ui: pskUi,
+      status: "bridge",
+      hint: "Экспортируйте модель утилитой UModel (UEViewer) в PSK/PSKX (+ PSA для анимаций, текстуры в TGA/PNG) и выберите «Папку игры» с экспортом. Нативные .upk/.u пока не читаются."
+    }
+  ]
+});
+export {
+  unreal3Engine
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["// Unreal Engine 3: a bridge only for now; models and animations exported to ActorX PSK/PSKX/PSA. PSK parsing comes from @gmvjs/unreal2.\nimport { defineEngine } from '@gmvjs/core/plugin';\nimport { pskFormat, pskUi } from '@gmvjs/unreal2';\nimport { EN } from './i18n';\n\nexport const unreal3Engine = defineEngine({\n  id: 'unreal3',\n  title: 'Unreal Engine 3, через экспорт PSK',\n  i18n: { en: EN },\n  formats: [pskFormat('unreal3')],\n  games: [\n    { id: 'ue3', group: 'Игры', title: 'Unreal Engine 3 (Gears of War, Mass Effect, BioShock Infinite…) — экспорт PSK/PSA', engine: 'unreal3', formats: ['unreal3-psk'], ui: pskUi, status: 'bridge',\n      hint: 'Экспортируйте модель утилитой UModel (UEViewer) в PSK/PSKX (+ PSA для анимаций, текстуры в TGA/PNG) и выберите «Папку игры» с экспортом. Нативные .upk/.u пока не читаются.' },\n  ],\n});\n"],"names":[],"mappings":";;;AAKO,MAAM,gBAAgB,aAAa;AAAA,EACxC,IAAI;AAAA,EACJ,OAAO;AAAA,EACP,MAAM,EAAE,IAAI,GAAA;AAAA,EACZ,SAAS,CAAC,UAAU,SAAS,CAAC;AAAA,EAC9B,OAAO;AAAA,IACL;AAAA,MAAE,IAAI;AAAA,MAAO,OAAO;AAAA,MAAQ,OAAO;AAAA,MAAqF,QAAQ;AAAA,MAAW,SAAS,CAAC,aAAa;AAAA,MAAG,IAAI;AAAA,MAAO,QAAQ;AAAA,MACtL,MAAM;AAAA,IAAA;AAAA,EAA8K;AAE1L,CAAC;"}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@gmvjs/unreal3",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "gmv: Unreal Engine 3, via PSK export",
+  "keywords": [
+    "gmv",
+    "unreal-engine-3",
+    "ue3",
+    "psk",
+    "actorx"
+  ],
+  "license": "MIT",
+  "author": "Alexander Shibisty",
+  "homepage": "https://github.com/shibisty/gmv/tree/main/packages/unreal3#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shibisty/gmv.git",
+    "directory": "packages/unreal3"
+  },
+  "bugs": {
+    "url": "https://github.com/shibisty/gmv/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "gmv-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ue3": {
+      "gmv-source": "./src/games/ue3.ts",
+      "types": "./dist/games/ue3.d.ts",
+      "import": "./dist/games/ue3.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs"
+  },
+  "dependencies": {
+    "@gmvjs/core": "^0.1.1",
+    "@gmvjs/unreal2": "^0.1.1"
+  },
+  "devDependencies": {
+    "@gmvjs/test-utils": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}