開始前：選擇三種主要分享方式

工作坊目前有三種主要封裝方式：姿勢包使用 "type": "pose"，適合分享一個右鍵呼叫姿勢與它的素材；完整桌寵包使用 "type": "pet"，以 pet_config.json 帶入基礎姿勢、提醒、快捷鍵與其他設定；養成內容則使用 "type": "care"，提供商城物品、工作與日常事件。

三種封裝方式不是內容上限。你可以在它們之中組合下方八個創作主題，從角色動畫、移動、對話、專注、實況反應、AI 素材提示，到養成規則與安全打包。

進階欄位與打包參考

讓入口 JSON 和所有圖片、音效留在同一個可攜資料夾內。其他玩家匯入時，程式會從 JSON 所在位置解析相對路徑。

MyWavePose/
  desktop_pet_studio_workshop.json
  assets/
    frame_01.png
    frame_02.png
    frame_03.png
    frame_04.png
    frame_05.png
    frame_06.png
    wave.wav

請使用 assets/frame_01.png 這類相對路徑，不要填入 C:\Users\... 等本機絕對路徑。素材建議使用透明背景 PNG；走動影格請面向右方，桌寵在往左移動時會自動鏡像。

單一姿勢 manifest

以下範例能建立一個揮手姿勢：使用六張獨立影格、播放音效、隨機氣泡，並以小跳躍方式移動。

{
  "schema_version": 1,
  "id": "my-wave-pose",
  "title": "揮手打招呼",
  "type": "pose",
  "content_kind": "single_pose",
  "assets_mode": "bundled",
  "pose": {
    "name": "揮手打招呼",
    "category": "custom",
    "animation_paths": [
      "assets/frame_01.png", "assets/frame_02.png", "assets/frame_03.png",
      "assets/frame_04.png", "assets/frame_05.png", "assets/frame_06.png"
    ],
    "playback_speed": 1.25,
    "sound_path": "assets/wave.wav",
    "bubble_texts": ["嗨，我在這裡！", "今天也一起加油"],
    "bubble_interval_sec": 20,
    "enabled": true,
    "movement": {
      "enabled": true,
      "mode": "hop",
      "speed": 1.2,
      "distance_px": 160,
      "vertical_px": 36,
      "duration_sec": 2.4,
      "loop": false,
      "gravity": false
    }
  }
}

移動參數補充

movement 只接受白名單資料，JSON 不會執行任意程式碼。可用模式為 none、wander、patrol、hop、shake、drift 與 sequence。其中 sequence 可用多段 dx、dy、duration_ms 與 easing 組成演出。

Twitch Bits 欄位補充

可在任一姿勢內加入 twitch_trigger，依觀眾 Bits 金額播放對應動畫、音效與氣泡。工作坊會分享這組玩法規則，但不會包含 Twitch 帳號、授權碼或權杖；每位玩家都必須連接自己的 Twitch。

"twitch_trigger": {
  "enabled": true,
  "min_bits": 100,
  "max_bits": 499,
  "bubble_texts": ["謝謝 {viewer_name} 的 {amount} {currency}！"]
}

AI 素材提示欄位補充

可選用 ai_asset_prompts，引導玩家延伸同一角色的姿勢。至少提供一個語系文案；介面會優先顯示目前語言，沒有時回退為中文或英文。單一姿勢包會直接顯示提示；完整桌寵包則以整包標題建立可展開群組。

"ai_asset_prompts": [{
  "id": "wave_ai_prompt",
  "name": "揮手姿勢 AI 說明",
  "pose_id": "wave",
  "zh": "請用我上傳的角色圖，製作揮手動畫。輸出 6 張獨立透明背景 PNG，檔名 frame_01.png 到 frame_06.png；不要六宮格、不要 sprite sheet、不要文字、不要浮水印。",
  "zh_cn": "请用我上传的角色图，制作挥手动画。输出 6 张独立透明背景 PNG；不要六宫格、不要 sprite sheet、不要文字、不要水印。",
  "en": "Use my character reference to create a waving animation. Output six separate transparent-background PNG frames; no grid, sprite sheet, text, or watermark."
}]

分享前檢查

开始前：选择三种主要分享方式

创意工坊目前有三种主要封装方式：姿势包使用 "type": "pose"，适合分享一个右键调用姿势与它的素材；完整桌宠包使用 "type": "pet"，以 pet_config.json 带入基础姿势、提醒、快捷键与其他设置；养成内容使用 "type": "care"，提供商城物品、工作与日常事件。

三种封装方式不是内容上限。你可以在它们之中组合下方八个创作主题，从角色动画、移动、对话、专注、直播反应、AI 素材提示，到养成规则与安全打包。

进阶字段与打包参考

让入口 JSON 和所有图片、音效留在同一个可携资料夹内。其他玩家导入时，程序会从 JSON 所在位置解析相对路径。

MyWavePose/
  desktop_pet_studio_workshop.json
  assets/
    frame_01.png ... frame_06.png
    wave.wav

请使用 assets/frame_01.png 这类相对路径，不要填入本机绝对路径。素材建议使用透明背景 PNG；走动帧请面向右方，桌宠在往左移动时会自动镜像。

单一姿势 manifest

使用 schema_version、id、title、type 与 pose 描述内容。pose.animation_paths 放入六张独立帧，sound_path 可指定 WAV，bubble_texts 可设置随机气泡。

{
  "schema_version": 1,
  "id": "my-wave-pose",
  "title": "挥手打招呼",
  "type": "pose",
  "content_kind": "single_pose",
  "assets_mode": "bundled",
  "pose": {
    "name": "挥手打招呼",
    "category": "custom",
    "animation_paths": ["assets/frame_01.png", "assets/frame_02.png", "assets/frame_03.png", "assets/frame_04.png", "assets/frame_05.png", "assets/frame_06.png"],
    "playback_speed": 1.25,
    "sound_path": "assets/wave.wav",
    "bubble_texts": ["嗨，我在这里！", "今天也一起加油"],
    "bubble_interval_sec": 20,
    "enabled": true
  }
}

移动参数补充

movement 只接受白名单数据，JSON 不会执行任意代码。可用模式为 none、wander、patrol、hop、shake、drift 与 sequence。可用 speed、distance_px、vertical_px、duration_sec、loop 与 gravity 调整演出。

Twitch Bits 字段补充

可在任一姿势内加入 twitch_trigger，依观众 Bits 金额播放对应动画、音效与气泡。创意工坊会分享这组玩法规则，但不会包含 Twitch 账号、授权码或令牌；每位玩家都必须连接自己的 Twitch。

"twitch_trigger": {
  "enabled": true,
  "min_bits": 100,
  "max_bits": 499,
  "bubble_texts": ["谢谢 {viewer_name} 的 {amount} {currency}！"]
}

AI 素材提示字段补充

可选用 ai_asset_prompts，引导玩家延伸同一角色的姿势。至少提供一个语言文案；单一姿势包会直接显示，完整桌宠包会以整包标题建立可展开群组。提示请明确要求 6 张独立透明背景 PNG，并说明不要六宫格或 sprite sheet。

分享前检查

Before you begin: choose one of three main sharing formats

Workshop content currently has three main package formats. Use "type": "pose" for one right-click pose and its assets. Use "type": "pet" with pet_config.json for a complete pet configuration. Use "type": "care" for shop items, jobs, and everyday events.

The three formats are not a limit on what you can create. You can combine the eight topics below: character animation, movement, dialogue, focus, stream reactions, AI asset prompts, care rules, and safe packaging.

Advanced fields and packaging reference

Keep the entry JSON, images, and sound together. The app resolves relative paths from the JSON file, so a player can import the same folder on a different computer.

MyWavePose/
  desktop_pet_studio_workshop.json
  assets/
    frame_01.png ... frame_06.png
    wave.wav

Use a relative path such as assets/frame_01.png, never an absolute local path. Transparent PNG is recommended. Make walking frames face right; the app mirrors them automatically when moving left.

Single-pose manifest

Describe the content with schema_version, id, title, type, and pose. Place independent frames in pose.animation_paths, optionally assign a WAV through sound_path, and use bubble_texts for random dialogue.

{
  "schema_version": 1,
  "id": "my-wave-pose",
  "title": "Wave hello",
  "type": "pose",
  "content_kind": "single_pose",
  "assets_mode": "bundled",
  "pose": {
    "name": "Wave hello",
    "category": "custom",
    "animation_paths": ["assets/frame_01.png", "assets/frame_02.png", "assets/frame_03.png", "assets/frame_04.png", "assets/frame_05.png", "assets/frame_06.png"],
    "playback_speed": 1.25,
    "sound_path": "assets/wave.wav",
    "bubble_texts": ["Hi, I'm here!", "Let's do our best today."],
    "bubble_interval_sec": 20,
    "enabled": true
  }
}

Movement field reference

movement accepts only allow-listed data; JSON never executes arbitrary code. The available modes are none, wander, patrol, hop, shake, drift, and sequence. Tune an action with speed, distance_px, vertical_px, duration_sec, loop, and gravity.

Twitch Bits field reference

Add twitch_trigger to any pose to play its animation, sound, and bubble for a viewer's Bits amount. Workshop packages share this gameplay rule, never a Twitch account, authorization code, or token; every player connects their own Twitch account.

"twitch_trigger": {
  "enabled": true,
  "min_bits": 100,
  "max_bits": 499,
  "bubble_texts": ["Thanks {viewer_name} for {amount} {currency}!"]
}

AI asset-prompt field reference

Use optional ai_asset_prompts to show players how to extend a character. Provide at least one language. A pose pack is shown directly in the AI Asset Helper; a full-pet pack appears in an expandable group. Clearly ask for six separate transparent PNG frames, not a grid or sprite sheet.

Pre-share checklist