@linxin666/dsh-pet 0.3.2 → 0.3.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: 02e682f7c14dee40461f177660a3c976fc4bb05d
-README.zh.md: d263d62d64cde1cd14a4e8656646166b944c4c0c
+README.md: 515f3af940b587c685e194b5467ca91020af36a2
+README.zh.md: f3dc4a805673d04289018dab31a9a4f0d16112fb

package/README.md

@@ -65,9 +65,9 @@ A pet is a directory holding one `pet.json` manifest and one atlas image. Nothin
 A pet directory's `pet.json` declares its renderer explicitly in v2:
 
 - `petManifestVersion: 2` (absent = v1, compat-read as `sprite2d` with a migration hint);
-- `renderer`: `"sprite2d"` (the atlas contract above) or `"live2d"`;
+- `renderer`: `"sprite2d"` (the atlas contract above), `"live2d"`, or `"frames2d"`;
 - `license` (required in v2): asset license identifier — community pets carry provenance;
-- a renderer block: `sprite2d` (spritesheetPath/cell/columns/atlasRows/frames/tracks) or `live2d` (model/motions/expressions/hitAreas/scale/translate).
+- a renderer block: `sprite2d` (spritesheetPath/cell/columns/atlasRows/frames/tracks), `live2d` (model/motions/expressions/hitAreas/scale/translate), or `frames2d` (dir/defaultFrameMs/tracks/phases — directory-style frame sequences).
 
 Validation is fail-closed on structure (unknown fields or renderer kinds reject the entry with a diagnostic) and warn-and-drop on sequence/remark content. The machine-readable schema lives at `contracts/pet-manifest-v2.schema.json`; the authoritative validator is `src/manifest-v2.ts`. Migrate v1 manifests with `node scripts/dsh-pet-migrate-v2.mjs <dir> --write` (dry-run by default; keeps `pet.json.v1.bak`).
 
@@ -157,6 +157,14 @@ A Live2D manifest maps the seven activity phases onto the model's motion groups:
 
 Model licensing: the official Live2D sample models (Hiyori, Haru, and friends) are evaluation-only and must not be redistributed — ship only models you have rights to (original creations or permissively licensed ones).
 
+## Frames2d pets and gameplay (renderer: frames2d)
+
+Frames2d pets ship directory-style frame sequences instead of an atlas: `thumb/<track>/<frame>.webp`, with per-frame durations from an optional `_<ms>` filename tail or the track's `frameMs` list (default 200 ms, bounds 16–5000). The manifest maps the activity phases onto tracks; a `drag` track follows the chrome's drag gesture, and non-looping tracks settle into their `fallback` (default the idle track), so intro/loop splits (sleep-intro → sleep) are plain manifest data.
+
+A frames2d pet may declare a `gameplay` block — an opt-in mini-game layer generalized from the miku desktop pet: decaying stat bars (`stats` with per-minute decay, a working variant and an idle variant), the unified treat (小鱼干) currency — gameplay income and shop spending ride the same panel treat stock (capped at 20): `work` success, `passiveIncome` and lottery prizes grant treats, and shop items are priced and paid in treats, with no separate wallet page — a weighted `idleDirector` (rolls an act every `intervalMs`, `maxMiss` forces one after consecutive idle rolls), `touch` zones inside a `hitBox` (roll branches with effects, a track hold and phrase bubbles), a `work` loop (host-adjudicated ticks with success/fail result tracks), a `sleep` loop (lazy stat restore), `passiveIncome`, and a `shop` whose items carry effects or tiered lotteries. All rolls and bookkeeping are host-authoritative (`POST /api/pet/gameplay/*`); state persists per pet in `pet.json` and settles lazily on the treats-economy discipline. The browser half renders the menu card (stat bars, work/sleep toggles, shop grid) automatically for any pet that declares the block.
+
+The **Miku pet** (contributed by stushansusu under MIT; Hatsune Miku character rights belong to Crypton Future Media under the Piapro Character License — see THIRD_PARTY_NOTICES.md) is the reference frames2d gameplay pet. It ships through the **Workshop** only (not the npm bundle): install it from the Workshop's pet list and it lands in `$DSH_HOME/pets/miku/`.
+
 ## Status decorations (decoration.json, pet-center M5, #567)
 
 A status bubble can carry a small ornament ahead of its text (built-in: the spouting whale), driven by the ActivityPhase stream. Decorations are independent of pets: own descriptor, own id, own directory — switching pets never switches decorations. Entry assets are PNG/WebP single-row sprite strips only (no SVG/CSS); the bubble always keeps its role=status/aria-live (or session-bubble button semantics), the ornament is aria-hidden; prefers-reduced-motion holds the segment first frame, and a broken asset only removes the ornament — the text stays.
@@ -189,14 +197,17 @@ A status bubble can carry a small ornament ahead of its text (built-in: the spou
 
 | Registry id | Selector label | Source |
 |---|---|---|
+| `ouo-neko` | OUO Neko | Pink-sakura cat-eared companion contributed by `Pessimist0906` under MIT |
 | `whale-girl` | 鲸鱼娘（原版） | The repository's original whale-girl atlas |
 | `whale-girl-refined` | 鲸鱼娘（精致版） | An AI-assisted derivative with repaired and refined details, based on the whale-girl design direction |
 
-The refined variant references DreamSkin's “DeepSeek-Whale” theme. The historical source record identifies `powerdog996` as the original theme author and marks the theme as MIT: [DreamSkin](https://dreamskin.cc), [repository source record](https://github.com/zhu1090093659/dsh-web-ui/commit/87edd7ff4800dffd40bc93fb76e4ae450390facd). This attribution records the source and derivative relationship; it does not present the refined variant as an official work of the original author or redefine the original artwork's licensing scope.
+The Miku pet is deliberately not bundled: it is a frames2d gameplay pet installed on demand from the Workshop (see the frames2d section above).
+
+The refined variant references DreamSkin's “DeepSeek-Whale” theme. The historical source record identifies `powerdog996` as the original theme author and marks the theme as MIT: [DreamSkin](https://dreamskin.cc), [repository source record](https://github.com/zhu1090093659/dsh-web/commit/87edd7ff4800dffd40bc93fb76e4ae450390facd). This attribution records the source and derivative relationship; it does not present the refined variant as an official work of the original author or redefine the original artwork's licensing scope.
 
 ## Animation preview
 
-The sprites are an 8-column × 9-row atlas (192×208 cells) generated by the [hatch-pet](https://github.com/dsh2026) pipeline; below are previews of each state:
+Sprite pets use 8-column atlases with 192×208 cells generated by the [hatch-pet](https://github.com/dsh2026) pipeline. Classic atlases carry 9 animation rows; v2 atlases add 2 rows for 16 look directions. Below are previews of the standard animation states:
 
 | idle | waiting | running | jumping |
 |---|---|---|---|
@@ -230,6 +241,7 @@ dsh-pet/
 |       `-- pet.module.css
 |-- assets/whale/            # built-in original whale-girl (manifest + atlas + previews)
 |-- assets/whale-refined/    # built-in refined whale-girl registry variant
+|-- assets/ouo-neko/         # built-in OUO Neko v2 pet (11-row atlas + previews)
 `-- cordis.patch.yml         # bundle patch: inserts the pet plugin row
 ```
 
@@ -255,15 +267,15 @@ global React root (createRoot → document.body) <-- polling 2s -- pet-client (b
 
 ## Install
 
-Install the family aggregate package `@linxin666/dsh-web-ui-all` (all plugins and skins in one) or this plugin alone:
+Install the family aggregate package `@linxin666/dsh-web-all` (all plugins and skins in one) or this plugin alone:
 
 ```sh
 ### From npm (recommended)
 dsh plugin --profile web add @linxin666/dsh-pet@latest
 
 ### From the repository (development)
-git clone https://github.com/zhu1090093659/dsh-web-ui.git
-cd dsh-web-ui
+git clone https://github.com/zhu1090093659/dsh-web.git
+cd dsh-web
 pnpm install && pnpm -r build
 dsh plugin --profile web add link:$(pwd)/packages/dsh-pet
 
@@ -286,6 +298,8 @@ The browser bundle rides the `window.__ModuleLoader__.load` contract; React/cord
 
 The two built-in whale-girl atlases use the same 9-state × 8-column contract: `assets/whale/` is the original and `assets/whale-refined/` is the refined variant. Each atlas is 1536×1872 (8 columns × 9 rows of 192×208 cells). Frame counts, rhythm, and scene rotation live in each directory's `pet.json`; pets without overrides follow the hatch-pet contract rhythm and canonical single-track scene mapping (row order: 0 idle / 1 running-right / 2 running-left / 3 waving / 4 jumping / 5 failed / 6 waiting / 7 running / 8 review).
 
+OUO Neko uses the extended v2 contract: a 1536×2288 atlas with the same 9 animation rows plus 2 eight-frame look-direction rows. Its manifest declares `sprite2d.atlasRows: 11`, and the renderer treats the last 16 cells as the clockwise look loop.
+
 ## Security model
 
 - Every `/api/pet/*` and `/pet/<id>/*` route is loopback-only by default (the shared plugin-family fence: loopback socket + Host header + browser same-origin markers): unpaired LAN clients get `403 forbidden: loopback-only` before any pet state or atlas is served. When `dsh-remote-web-ui` is also loaded, a live paired-device cookie is an additional allow path (the same cookie `api/gate` already checks); unpaired and revoked devices stay 403. The pet does not depend on the remote plugin.
@@ -294,6 +308,10 @@ The two built-in whale-girl atlases use the same 9-state × 8-column contract: `
 - The plugin never downloads executables and never bundles the Live2D Cubism Core.
 - Manifests are fail-closed on structure: unknown fields or renderers reject the entry with a diagnostic shown in settings.
 
+## Telemetry
+
+The browser half sends one anonymous install heartbeat per UTC day to dsh-market.com: a random localStorage id plus this package's name, nothing else. The server stores only a salted hash of that id, never IP addresses, and exposes aggregate counts only. See [docs/telemetry.md](../../docs/telemetry.md) for the full contract.
+
 ## License
 
 [BSD-3-Clause](LICENSE)

package/README.zh.md

@@ -65,9 +65,9 @@
 宠物目录的 `pet.json` 在 v2 中显式声明渲染器：
 
 - `petManifestVersion: 2`（缺省 = v1，按 `sprite2d` 兼容读并给出迁移提示）；
-- `renderer`：`"sprite2d"`（上文图集契约）或 `"live2d"`；
+- `renderer`：`"sprite2d"`（上文图集契约）、`"live2d"` 或 `"frames2d"`；
 - `license`（v2 必填）：资产授权标识——社区宠物必须携带来源声明；
-- 渲染器专属块：`sprite2d`（spritesheetPath/cell/columns/atlasRows/frames/tracks）或 `live2d`（model/motions/expressions/hitAreas/scale/translate）。
+- 渲染器专属块：`sprite2d`（spritesheetPath/cell/columns/atlasRows/frames/tracks）、`live2d`（model/motions/expressions/hitAreas/scale/translate）或 `frames2d`（dir/defaultFrameMs/tracks/phases——目录式帧序列）。
 
 校验纪律：结构 fail-closed（未知字段或未知渲染器直接拒载并给出诊断），sequences/remarks 内容维持 warn-and-drop。机器可读 schema 见 `contracts/pet-manifest-v2.schema.json`，权威校验器为 `src/manifest-v2.ts`。迁移 v1 清单：`node scripts/dsh-pet-migrate-v2.mjs <dir> --write`（默认 dry-run；保留 `pet.json.v1.bak`）。
 
@@ -157,6 +157,14 @@ Live2D 清单把七个活动相位映射到模型的动作组：
 
 模型授权：Live2D 官方示例模型（Hiyori、Haru 等）仅供评估、禁止再分发——只发布你有权的模型（原创作品或宽松授权的模型）。
 
+## Frames2d 宠物与玩法（renderer: frames2d）
+
+frames2d 宠物不用图集，直接交付目录式帧序列：`thumb/<track>/<frame>.webp`，帧时长取文件名 `_<ms>` 尾缀或轨道的 `frameMs` 列表（默认 200ms，范围 16–5000）。清单把七个活动相位映射到轨道；`drag` 轨道跟随外壳的拖拽手势；非循环轨道播完进入 `fallback`（默认 idle 轨道），入睡/睡熟这类"引子 + 循环"拆分（sleep-intro → sleep）就是纯清单数据。
+
+frames2d 宠物可声明 `gameplay` 块——从 miku 桌宠泛化而来的可选玩法层：属性条（`stats`，按分钟衰减，另有打工中与空闲变体）、统一的小鱼干货币（玩法收入与商店支出都走宠物面板那条小鱼干库存，上限 20 条：`work` 成功、`passiveIncome` 与彩票奖品发放小鱼干，商品也以小鱼干标价扣款，无独立钱包页）、加权 `idleDirector`（每 `intervalMs` 掷骰演出小动作，连续落空 `maxMiss` 次必演）、`hitBox` 内的 `touch` 触摸分区（分支掷骰：效果 + 轨道保持 + 台词气泡）、`work` 打工循环（宿主裁决 tick，成功/失败结果轨道）、`sleep` 睡觉循环（惰性恢复）、`passiveIncome` 被动收入，以及 `shop` 商店（商品可带效果或分档抽奖）。所有掷骰与记账由宿主权威裁决（`POST /api/pet/gameplay/*`），状态按宠物持久化在 `pet.json`，沿用小鱼干经济的惰性结算纪律。浏览器半侧为声明了该块的宠物自动渲染玩法菜单卡（属性条、打工/睡觉开关、商店网格）。
+
+**Miku 宠物**（stushansusu 涂山苏苏以 MIT 贡献；初音未来角色权利归 Crypton Future Media，受 Piapro 角色许可约束——见 THIRD_PARTY_NOTICES.md）是 frames2d 玩法的参考实现。它只经**创意工坊**分发（不打进 npm 包）：从工坊宠物列表安装后落在 `$DSH_HOME/pets/miku/`。
+
 ## 状态装饰（decoration.json，宠物中心 M5，#567）
 
 宠物状态气泡里的文字之前可以有一个小的状态装饰（内置：喷水鲸鱼），由 ActivityPhase 流驱动换帧。装饰与宠物相互独立：独立描述符、独立 id、独立目录，换宠物不换装饰。入口资产只收 PNG/WebP 单行精灵条带（不收 SVG/CSS）；气泡自身的 role=status/aria-live（或会话气泡按钮语义）永远保留，装饰 aria-hidden；prefers-reduced-motion 时停在帧段首帧，资产加载失败只消失装饰、文字照常。
@@ -189,14 +197,17 @@ Live2D 清单把七个活动相位映射到模型的动作组：
 
 | 注册表 id | 选择器名称 | 来源 |
 |---|---|---|
+| `ouo-neko` | OUO Neko | `Pessimist0906` 以 MIT 许可证贡献的粉色樱花猫耳伙伴 |
 | `whale-girl` | 鲸鱼娘（原版） | 仓库原有的鲸鱼娘图集 |
 | `whale-girl-refined` | 鲸鱼娘（精致版） | 以鲸鱼娘设计方向为基础，经 AI 辅助二次创作、修复和细节精修的衍生版本 |
 
-精致版参考了 DreamSkin 的「DeepSeek-鲸鱼娘」主题。历史来源记录标注原主题作者为 `powerdog996`，并标注主题为 MIT：[DreamSkin](https://dreamskin.cc)、[仓库来源记录](https://github.com/zhu1090093659/dsh-web-ui/commit/87edd7ff4800dffd40bc93fb76e4ae450390facd)。此处用于记录素材来源与衍生关系；精致版不表述为原作者的官方作品，也不重新定义原始美术作品的授权范围。
+Miku 宠物有意不随包内置：它是 frames2d 玩法宠物，经创意工坊按需安装（见上文 frames2d 一节）。
+
+精致版参考了 DreamSkin 的「DeepSeek-鲸鱼娘」主题。历史来源记录标注原主题作者为 `powerdog996`，并标注主题为 MIT：[DreamSkin](https://dreamskin.cc)、[仓库来源记录](https://github.com/zhu1090093659/dsh-web/commit/87edd7ff4800dffd40bc93fb76e4ae450390facd)。此处用于记录素材来源与衍生关系；精致版不表述为原作者的官方作品，也不重新定义原始美术作品的授权范围。
 
 ## 动画预览
 
-精灵图是由 [hatch-pet](https://github.com/dsh2026) 流水线生成的 8 列 × 9 行图集（192×208 单元格）；各状态预览：
+精灵宠物使用由 [hatch-pet](https://github.com/dsh2026) 流水线生成的 8 列图集，单元格为 192×208。经典图集包含 9 行动画；v2 图集额外增加 2 行，共提供 16 个观察方向。以下为标准动画状态预览：
 
 | idle | waiting | running | jumping |
 |---|---|---|---|
@@ -230,6 +241,7 @@ dsh-pet/
 |       `-- pet.module.css
 |-- assets/whale/            # 内置原版鲸鱼娘（manifest + 图集 + 预览）
 |-- assets/whale-refined/    # 内置精致版鲸鱼娘注册表变体
+|-- assets/ouo-neko/         # 内置 OUO Neko v2 宠物（11 行图集 + 预览）
 `-- cordis.patch.yml         # bundle 补丁：插入宠物插件行
 ```
 
@@ -255,15 +267,15 @@ dsh-pet/
 
 ## 安装
 
-安装聚合全家桶 `@linxin666/dsh-web-ui-all`（全部插件与皮肤一次到位），或单独安装本插件：
+安装聚合全家桶 `@linxin666/dsh-web-all`（全部插件与皮肤一次到位），或单独安装本插件：
 
 ```sh
 ### 从 npm 安装（推荐）
 dsh plugin --profile web add @linxin666/dsh-pet@latest
 
 ### 从仓库安装（开发调试）
-git clone https://github.com/zhu1090093659/dsh-web-ui.git
-cd dsh-web-ui
+git clone https://github.com/zhu1090093659/dsh-web.git
+cd dsh-web
 pnpm install && pnpm -r build
 dsh plugin --profile web add link:$(pwd)/packages/dsh-pet
 
@@ -286,6 +298,8 @@ pnpm typecheck    # 仅类型检查
 
 两套内置鲸鱼娘图集使用同一份 9 态 × 8 列契约：`assets/whale/` 是原版，`assets/whale-refined/` 是精致版。每张图集均为 1536×1872（8 列 × 9 行，192×208 单元格）。每行帧数、节奏与场景轮换写在各目录的 `pet.json` 中；未覆盖的宠物沿用 hatch-pet 契约节奏和标准单轨场景映射（行序：0 idle / 1 running-right / 2 running-left / 3 waving / 4 jumping / 5 failed / 6 waiting / 7 running / 8 review）。
 
+OUO Neko 使用扩展 v2 契约：图集为 1536×2288，在相同 9 行动画之后增加 2 行、共 16 帧观察方向。其清单声明 `sprite2d.atlasRows: 11`，渲染器把最后 16 个单元格作为顺时针观察方向循环。
+
 ## 安全模型
 
 - 全部 `/api/pet/*` 与 `/pet/<id>/*` 路由默认仅限 loopback（插件家族共享围栏：loopback 套接字 + Host 头 + 浏览器同源标记）：未配对的局域网客户端在任何宠物状态或图集下发前即收到 `403 forbidden: loopback-only`。同时装了 `dsh-remote-web-ui` 时，有效的已配对设备 cookie 是额外放行路径（与 `api/gate` 检查同一枚 cookie）；未配对与已撤销设备仍 403。宠物插件不硬依赖远程插件。
@@ -294,6 +308,10 @@ pnpm typecheck    # 仅类型检查
 - 插件从不下载可执行文件，也从不内置 Live2D Cubism Core。
 - 清单结构 fail-closed：未知字段或未知渲染器直接拒载，并在设置中给出诊断。
 
+## 数据遥测
+
+浏览器半区每个 UTC 日向 dsh-market.com 发送一次匿名安装心跳：仅含一个 localStorage 随机 ID 与本包名，无其他数据。服务端只存储该 ID 的加盐哈希，不存 IP，且只暴露聚合计数。完整契约见 [docs/telemetry.md](../../docs/telemetry.md)。
+
 ## 许可证
 
 [BSD-3-Clause](LICENSE)

package/assets/ouo-neko/pet.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://schemas.linxin666.org/dsh-pet/pet-manifest-v2.schema.json",
+  "petManifestVersion": 2,
+  "id": "ouo-neko",
+  "displayName": "OUO Neko",
+  "author": "Pessimist0906",
+  "version": "1.0.0",
+  "description": "A warm pink-sakura companion with cat ears and a lively chibi personality.",
+  "license": "MIT",
+  "renderer": "sprite2d",
+  "sprite2d": {
+    "spritesheetPath": "spritesheet.webp",
+    "cell": {
+      "width": 192,
+      "height": 208
+    },
+    "columns": 8,
+    "atlasRows": 11,
+    "frames": [
+      6,
+      8,
+      8,
+      4,
+      5,
+      8,
+      6,
+      6,
+      6
+    ]
+  }
+}

package/contracts/pet-manifest-v2.schema.json

@@ -55,7 +55,8 @@
     "renderer": {
       "enum": [
         "sprite2d",
-        "live2d"
+        "live2d",
+        "frames2d"
       ],
       "default": "sprite2d",
       "description": "Renderer kind; omitted means sprite2d (v1 compatibility). Unknown values are rejected."
@@ -239,6 +240,88 @@
         }
       }
     },
+    "frames2d": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "tracks",
+        "phases"
+      ],
+      "description": "Frame-sequence renderer block; required when renderer=frames2d. Free-form named tracks laid out as <dir>/<track>/<frame>.(webp|png|gif|jpg|jpeg); phase-direct state selection (the live2d motions precedent). Frame durations resolve frameMs[i] > filename-encoded <base>_<index>_<ms> suffix > defaultFrameMs.",
+      "properties": {
+        "dir": {
+          "type": "string",
+          "minLength": 1,
+          "default": ".",
+          "description": "Frame root directory relative to the manifest directory (safe segments only)."
+        },
+        "defaultFrameMs": {
+          "type": "integer",
+          "minimum": 16,
+          "maximum": 5000,
+          "default": 200
+        },
+        "tracks": {
+          "type": "object",
+          "minProperties": 1,
+          "maxProperties": 64,
+          "description": "Named tracks (lowercase kebab ids, at most 32 chars).",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "frames": {
+                "type": "array",
+                "minItems": 1,
+                "maxItems": 64,
+                "items": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Frame file name inside the track directory (no path segments)."
+                },
+                "description": "Explicit ordered frame list; omitted means list the track directory in filename order."
+              },
+              "frameMs": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "integer",
+                  "minimum": 16,
+                  "maximum": 5000
+                },
+                "description": "Per-frame durations; requires an explicit frames list of the same length."
+              },
+              "loop": {
+                "type": "boolean",
+                "default": true,
+                "description": "false stops on the last frame, then enters fallback."
+              },
+              "fallback": {
+                "type": "string",
+                "description": "Track entered when a non-loop track ends; defaults to the idle-mapped track."
+              }
+            }
+          }
+        },
+        "phases": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "idle"
+          ],
+          "description": "ActivityPhase -> track name; idle is required, unmapped phases fall back to it.",
+          "properties": {
+            "idle": { "type": "string", "minLength": 1 },
+            "waiting": { "type": "string", "minLength": 1 },
+            "thinking": { "type": "string", "minLength": 1 },
+            "tool": { "type": "string", "minLength": 1 },
+            "review": { "type": "string", "minLength": 1 },
+            "done": { "type": "string", "minLength": 1 },
+            "failed": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
     "sequences": {
       "type": "object",
       "description": "Renderer-agnostic ActivityPhase sequence table (v1 structure; every declared sequence has at least 5 items)."
@@ -246,6 +329,10 @@
     "remarks": {
       "type": "object",
       "description": "Per-slot witty-remark pools (v1 structure; a slot replaces the built-in pool for that slot only)."
+    },
+    "gameplay": {
+      "type": "object",
+      "description": "Optional gameplay layer (frames2d pets only): stat decay, currencies, touch zones, work/sleep loops, passive income and a shop with optional lotteries. State references name frames2d tracks; structure is fail-closed in the validator."
     }
   },
   "allOf": [
@@ -276,6 +363,20 @@
           "live2d"
         ]
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "renderer": {
+            "const": "frames2d"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "frames2d"
+        ]
+      }
     }
   ]
 }