@genex-ai/cli-demo 1.8.1-dev.497 → 1.8.1-dev.499

package/dist/index.js

@@ -20292,6 +20292,12 @@ ${c.bold("Usage")}
                                      refusal. "test <id>" gives you a free copy of
                                      your own item: you can't buy from your own game,
                                      so this is how you check the shop works.
+                                     --icon <url> is the item's square art, shown in
+                                     the shop and on the resale market \u2014 generate it
+                                     from the item's real in-game look with
+                                     "genex image ... --edit <reference>" and pass the
+                                     printed URL. An icon-less item renders as a
+                                     placeholder tile everywhere it is sold.
                                      --resellable lets players resell the item to each
                                      other on the market; durable items only, off by
                                      default, and --no-resellable turns it back off.
@@ -20545,8 +20551,9 @@ ${c.bold("Examples")}
   genex domain add play.mygame.com
   genex domain list
   genex shop list
-  genex shop add "Iron Key" --price 100 --type durable --resellable
+  genex shop add "Iron Key" --price 100 --type durable --resellable --icon https://assets.genex.technology/generations/abc123/image-main
   genex shop set sku_123 --price 200
+  genex shop set sku_123 --icon https://assets.genex.technology/generations/abc123/image-main
   genex shop test sku_123
   genex shop remove sku_123
   genex publish --no-push --title "My Game"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.8.1-dev.497",
+  "version": "1.8.1-dev.499",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-monetization/SKILL.md

@@ -135,6 +135,54 @@ to spend. Pick the nearest grid price rather than working around it.
 Record the ids in `DESIGN.md` next to what each item does. They are the one
 thing the game's code cannot regenerate for itself.
 
+## Item art
+
+**Every item ships with a picture.** `--icon` is optional to the command and not
+optional to the product: a SKU with no icon renders as a coloured plate with a
+generic box on it, in your shop and on the platform's resale market, where it
+sits next to other games' items that do have art.
+
+**It has to be the item.** Not "a fantasy key" — *this* key, the one the player
+just picked up, in this game's light and this game's palette. An icon that shows
+a different object than the world does is worse than the plate, because the
+plate at least does not claim anything.
+
+So if the item exists as an asset — a generated model, a sprite, a texture —
+generate the art FROM it. Point the camera at the model in the game, or use the
+asset image, and feed that frame in as the reference:
+
+```bash
+# 1. capture the real item -> ./iron-key-ref.png  (crop it SQUARE, see below)
+npx genex image "shop item art of the exact object in the reference image: an ornate iron key, centred, lit from above with a soft rim light, on a clean dark backdrop, no text, no watermark, no interface" \
+  --edit ./iron-key-ref.png --quality high
+#    -> https://assets.genex.technology/generations/<id>/image-main
+
+# 2. attach it
+npx genex shop add "Iron Key" --price 100 --type durable --icon <that url>
+npx genex shop set sku_a1b2c3 --icon <that url>     # or fix one later
+```
+
+`--edit` takes a **local file** (≤ 4 MB) as well as an asset URL, so a screenshot
+goes straight in. Two things about that lane:
+
+- **It keeps the reference's shape**, so `--aspect` does nothing here — crop the
+  reference square before you pass it, or you will get a wide icon in a square
+  cell.
+- It is a different model from the plain text lane, and a better one for this
+  job, because the reference is what makes the picture the item and not a
+  picture of the idea.
+
+No asset yet? Same prompt without `--edit`, anchored on the item's name and on
+**the game's own vibe words** — take them from `DESIGN.md` rather than inventing
+a style, and generate the whole shop in one sitting with the same style clause
+so the shelf reads as one set.
+
+Prompt shape, and every clause earns its place: one object, centred, on a clean
+simple backdrop, lit the way the game lights things, closing with *no text, no
+watermark, no interface*. Say what you want, never what you don't — an image
+model reads "no swords" as "swords", so a ban only works when the thing is
+absent from the prompt entirely.
+
 ## The API
 
 From `@genex-ai/embed-sdk`, already installed. `initEmbed()` must have run.

package/templates/skills/genex-threejs-multiplayer/SKILL.md

@@ -36,15 +36,18 @@ calling multiplayer done, run the mandatory
 ## Install
 
 ```bash
-npm i @genex-ai/multiplayer@^0.12.0
+npm i @genex-ai/multiplayer@^0.16.0
 ```
 
-> Pin `@^0.12.0` (not a bare `npm i`): cross-region invites can select the inviter's exact
-> relay with the optional `url` override; unowned object writes warn instead of failing silently;
-> live connected-player presence, supplier-form `connect()`
-> auth, regional relay selection (`getColyseusUrls()` + `urls`)
-> landed in 0.10; confirmed object controls, snaps, host-tick teardown, and reconnect rebasing
-> in 0.9. An older resolve does not have those.
+> Pin `@^0.16.0` (not a bare `npm i`, and not an older range): automatic TURN — the thing that
+> lets players behind symmetric NAT or carrier CGNAT be heard at all — landed in 0.16, mesh voice
+> in 0.15, room text chat in 0.14, host-only `setRoomOpen()` in 0.13; cross-region invites can
+> select the inviter's exact relay with the optional `url` override since 0.11; unowned object
+> writes warn instead of failing silently, live connected-player presence, supplier-form
+> `connect()` auth and regional relay selection (`getColyseusUrls()` + `urls`) landed in 0.10;
+> confirmed object controls, snaps, host-tick teardown, and reconnect rebasing in 0.9. An older
+> resolve does not have those — and because this package is still `0.x`, a caret range is
+> minor-locked, so `^0.12.0` would resolve to 0.12.x and give you no voice at all.
 
 This skill targets `@genex-ai/multiplayer` **≥ 0.16.0** (`objects`/`host` since 0.4; verified per-player `avatarUrl` since 0.12;
 room text chat via `room.chat` since 0.14; mesh voice via `room.voice` since 0.15;
@@ -1021,7 +1024,7 @@ host-driven saving works as long as ANY account is in the room.
 
 ## Checklist
 
-- [ ] `npm i @genex-ai/multiplayer@^0.12.0` (connected presence, supplier auth, confirmed controls, snap epochs, reconnect-safe host ticks, unowned-write warnings, cross-region exact-relay overrides); config wired into the build.
+- [ ] `npm i @genex-ai/multiplayer@^0.16.0` (automatic TURN, mesh voice, room text chat, connected presence, supplier auth, confirmed controls, snap epochs, reconnect-safe host ticks, unowned-write warnings, cross-region exact-relay overrides); config wired into the build.
 - [ ] The plan names one net model, the player-experience reason, start/quorum, late-join/backfill,
       and below-quorum/end behavior. The agent inferred it unless the experience was genuinely ambiguous.
 - [ ] `reconnecting`/`reconnected`/`disconnect` render an overlay (don't tear the scene down).