@forgeax/game 0.3.7 → 0.3.8

package/assets/extensions/asset3d/extension.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": 1,
+  "id": "asset3d",
+  "version": "1.0.0",
+  "skills": ["skills/art-3d-asset-library"],
+  "cli": "cli.mjs"
+}

package/assets/extensions/asset3d/skills/art-3d-asset-library/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: art-3d-asset-library
+description: Search EA/AW for reusable 3D assets and import native Pack or GLB into a ForgeaX game. Use when the user wants assets from the library.
+---
+
+# Asset library
+
+Run the following commands from the game directory. The command is pinned to this
+installation; no global CLI or separate Asset3D MCP server is needed.
+
+1. If setup is uncertain, run `{{CLI}} doctor --json`.
+   If not enabled, ask the user to configure `{{CLI}} enable`.
+2. Search: `{{CLI}} candidates --query "<English description>" --json`.
+   Select a returned `assetId` by name and format. Refine the query if none fits.
+3. Import: `{{CLI}} import --query "<same description>" --asset-id "<selected ID>" --json`.
+   Read `ok`, per-item results, `deliveredFormat` and Engine identities.
+   A GLB import does not satisfy a request for native Pack.
+4. Use the returned GUIDs through the installed Engine authoring skills. Keep the
+   imported files and material/texture dependencies together. Build and open the
+   Engine-owned Preview; verify the assets are visible and the requested input works.
+
+The CLI owns API calls, authentication, downloads and Engine import. Do not invent
+IDs, handwrite HTTP requests, or substitute generated geometry for library results.
+Pack source may execute during Engine build: import only from a trusted service,
+and never directly execute downloaded helpers. Never read or display credentials.
+
+If a command fails, report the error and stop the dependent step. Search, import
+and playable Preview are separate conclusions; report only what was verified.

package/assets/licenses/fflate.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Arjun Barrett
+
+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/assets/skills/forgeax-game/SKILL.md

@@ -58,13 +58,10 @@ does not require a new gameplay quality review.
 
 ## Reuse 3D assets
 
-- When the user asks for an existing, reusable, library, stock, or licensed 3D asset,
-  require the project-local `asset3d-search` MCP server and its `search_asset` tool.
-- If that server or tool is absent, report `BLOCKED(asset-library-tools-missing)` and
-  run or recommend `forgeax-game asset3d doctor --json`. Do not describe procedural
-  primitives as the asset library, and do not silently substitute `forgeax_generate_3d`.
-- Use `forgeax_generate_3d` only for an explicitly bespoke/generated asset or after a
-  library search found no acceptable candidate and the user approves generation.
+Read the installed `art-3d-asset-library` Skill and use its pinned CLI to search
+candidates and import a selected asset. If not enabled, ask the user to enable it.
+No separate Asset3D MCP tool is required. Do not substitute procedural geometry or
+generation for a requested library asset without user approval.
 
 > [!CAUTION]
 > Any `forgeax_run_current_game` error means the current game is **not previewed**.