SINGLE POSE PACKAGE
單一姿勢包
替角色新增揮手、跳躍、驚訝或右鍵呼叫動作，連同影格、移動、氣泡、音效與快捷鍵一起分享。
CREATE · COLLECT · SHARE
製作桌寵、
製作角色動作、照顧玩法或 DIY 特效，打包分享給其他玩家。v1.3.0 可用名稱與封面整理桌寵收藏，預覽後再確認使用。
CREATE · COLLECT · SHARE
制作桌宠、
制作角色动作、照顾玩法或 DIY 特效，打包分享给其他玩家。v1.3.0 可用名称与封面整理桌宠收藏，预览后再确认使用。
CREATE · COLLECT · SHARE
Create pets, effects and care gameplay
Make character poses, care gameplay or DIY effects and package them for other players. In v1.3.0, organize pet collections with names and covers, then preview before confirming use.
YOUR NEXT CREATION
四種可分享的作品
單一姿勢、完整桌寵、照顧玩法與獨立特效都能分開分享。下方說明各類型的用途與格式。
FULL PET PACKAGE
完整桌寵包
將角色素材、姿勢與可分享的設定存成桌寵收藏，並設定選單名稱與封面，方便切換或分享。
CARE GAMEPLAY PACKAGE
照顧玩法包
為角色設計工作、商城、道具、日常事件與心情回應。
STANDALONE EFFECT
獨立 PetFX 特效
製作星光、泡泡或其他動畫效果，設定觸發與跟隨位置。特效可獨立匯出，不必打包成完整桌寵。
PET COLLECTIONS
收藏名稱、封面與預覽
匯入完整套件後，素材會和桌寵一起保存。先預覽外觀與動作，確認使用後再切換目前的桌寵。
- 選單名稱用來辨識作品，與角色名稱分開設定。
- 封面使用一張 1:1 圖片，不必走姿勢六宮格裁切流程。
- 相同內容不重複收藏，匯入不會改動原始檔案。
DIY EFFECTS
DIY 特效與觸發設定
DIY 教學提供 HTML、CSS 與 JavaScript 範例，可搭配 PetFX 套件規則製作動畫，設定觸發事件與跟隨位置。
- 為指定姿勢或影格手動標記位置，讓效果跟隨標點；程式不會自動辨識頭、手等部位。
- 選取、預覽與啟用分開操作：點選卡片不會直接播放，預覽也不代表已啟用。
- 可為 Twitch Bits、追隨、訂閱與贈禮設定不同效果、事件後姿勢及輸出目標；追隨需要相應授權。
SUPPORTED SETTINGS
角色動作與互動設定
展開下列主題，可查看動畫、移動、氣泡、音效與照顧玩法的設定，以及對應 JSON 範例。
角色與動畫任何有授權的角色，都能成為桌寵。
可放入多張透明 PNG 或 GIF 動畫，設定播放速度，讓原創角色、兔子、機器人或其他形象都有自己的動作。
- 多幀動畫影格與相對素材路徑
- 動畫速度 0.25x 到 4x
- 走動素材面向右方，向左移動會自動鏡像
移動與動作演出讓角色走、跳、巡邏、漂浮，或演出一段專屬動作。
用安全的 JSON 參數設定移動距離、速度、重力與循環，不需要在工作坊內容裡執行程式。
- 隨機走動、巡邏、跳躍、抖動、漂浮
- 多段 sequence 與 easing 演出曲線
- 可決定姿勢期間是否受到自然下墜影響
氣泡、音效與快捷鍵替姿勢加入對話、音效與快捷鍵。
每個姿勢都能有隨機文字氣泡、WAV 音效、啟用狀態與建議快捷鍵，玩家仍能依自己的習慣調整。
- 多句隨機氣泡與出現間隔
- 右鍵呼叫姿勢的 WAV 音效
- 建議快捷鍵與預設啟用狀態
專注模式與按鍵反應專注時，讓桌寵停在你指定的位置。
完整桌寵包可設定固定專注姿勢。玩家能拖曳桌寵調整位置，也能選擇顯示按鍵反應速度，並自訂數值前後的文字。
- 固定位置，不觸發走動、攀附或下墜
- 按鍵時重新播放專注動畫
- 可自訂毫秒數前後文字，不記錄按鍵內容
Twitch 實況反應依 Bits、訂閱或贈送訂閱觸發指定姿勢。
為姿勢設定 Bits 金額範圍、一般訂閱或贈送訂閱觸發規則與持續秒數，氣泡可帶入觀眾暱稱、留言和 Bits 數量；觸發後會回到原本動作。
- 金額區間與播放持續時間
- 專屬動畫、音效與文字氣泡
- 不會打包任何 Twitch 帳號或授權資料
AI 素材提示與多語系附上 Prompt，讓玩家製作更多角色動作。
可為作品提供 AI 素材助手 Prompt，玩家能依自己的角色圖延伸新姿勢；提示可提供多種語言版本。
- 姿勢包直接顯示，完整桌寵可分組展開
- 支援繁中、簡中、英文、日文與更多語系文案
- 指定一張 3×2 六宮格，裁切後再匯入姿勢
工作、商城與日常事件設定角色的工作、商品與日常事件。
創作者能做出角色專屬的工作、商品和事件，改變飽食度、親合度、心情與遊戲內金幣，並安排刷新規則。
- 食物、禮物、收藏品與有限庫存
- 工作時長、獎勵、消耗與心情風險
- 依飽食度、親合度、心情觸發日常對話
安全打包與分享把素材和設定整理好，其他玩家就能直接匯入。
桌寵、姿勢與養成包使用相對路徑與允許的 JSON 欄位。程式不會執行 JSON 程式碼，也不需要把私人帳號資訊分享出去。
- 支援姿勢、完整桌寵與養成內容分開分享
- 素材與 WAV 音效可一併打包
- 不包含 Google、Twitch 權杖或玩家私密設定
FROM IDEA TO WORKSHOP
匯入、使用與分享流程
FOR PLAYERS
匯入與使用作品
- 選擇作品在 Steam 工作坊訂閱作品，或準備創作者分享的本機套件。
- 載入並預覽在程式中掃描工作坊內容或匯入本機套件，確認作品類型與素材。
- 確認使用完整桌寵先加入收藏並預覽，再確認切換；特效則先預覽，再依需要啟用。
FOR CREATORS
製作與分享作品
- 製作與測試整理角色影格、照顧規則或 DIY 特效，先在本機測試播放、觸發與素材路徑。
- 整理名稱與封面確認作品名稱、封面及要包含的素材；完整桌寵可依需要選擇是否附帶 PetFX。
- 匯出並確認發布獨立特效使用「匯出特效…」，再按「前往工作坊上傳」帶入表單。檢查內容後確認發布；匯出不會自動上傳，也不覆寫原作品。
JSON GUIDE
JSON 格式與指南下載
提供姿勢、完整桌寵與照顧內容的 JSON 範例，以及收藏、封面、PetFX 與匯出說明。v1.3.0 Markdown 指南有繁中、簡中、英文版本。
YOUR NEXT CREATION
四种可分享的作品
单一姿势、完整桌宠、照顾玩法与独立特效都能分开分享。下方说明各类型的用途与格式。
SINGLE POSE PACKAGE
单一姿势包
替角色新增挥手、跳跃、惊讶或右键调用动作，连同帧、移动、气泡、音效与快捷键一起分享。
FULL PET PACKAGE
完整桌宠包
将角色素材、姿势与可分享的设置存为桌宠收藏，并设置菜单名称与封面，方便切换或分享。
CARE GAMEPLAY PACKAGE
照顾玩法包
为角色设计工作、商城、道具、日常事件与心情回应。
STANDALONE EFFECT
独立 PetFX 特效
制作星光、泡泡或其他动画效果，设置触发与跟随位置。特效可独立导出，不必打包成完整桌宠。
PET COLLECTIONS
收藏名称、封面与预览
导入完整套件后，素材会和桌宠一起保存。先预览外观与动作，确认使用后再切换当前桌宠。
- 菜单名称用来辨识作品，与角色名称分开设置。
- 封面使用一张 1:1 图片，不必走姿势六宫格裁切流程。
- 相同内容不重复收藏，导入不会改动原始文件。
DIY EFFECTS
DIY 特效与触发设置
DIY 教程提供 HTML、CSS 与 JavaScript 示例，可搭配 PetFX 套件规则制作动画，设置触发事件与跟随位置。
- 为指定姿势或帧手动标记位置，让效果跟随标记；程序不会自动识别头、手等部位。
- 选取、预览与启用分开操作：点击卡片不会直接播放，预览也不代表已启用。
- 可为 Twitch Bits、关注、订阅与赠礼设置不同效果、事件后姿势及输出目标；关注需要相应授权。
SUPPORTED SETTINGS
角色动作与互动设置
展开下列主题，可查看动画、移动、气泡、音效与照顾玩法的设置，以及对应 JSON 示例。
角色与动画任何有授权的角色，都能成为桌宠。
可放入多张透明 PNG 或 GIF 动画，设置播放速度，让原创角色、兔子、机器人或其他形象都有自己的动作。
- 多帧动画与相对素材路径
- 动画速度 0.25x 到 4x
- 走动素材面向右方，向左移动会自动镜像
移动与动作演出让角色走、跳、巡逻、漂浮，或演出一段专属动作。
用安全的 JSON 参数设置移动距离、速度、重力与循环，不需要在创意工坊内容里执行程序。
- 随机走动、巡逻、跳跃、抖动、漂浮
- 多段 sequence 与 easing 演出曲线
- 可决定姿势期间是否受到自然下坠影响
气泡、音效与快捷键为姿势加入对话、音效与快捷键。
每个姿势都能有随机文字气泡、WAV 音效、启用状态与建议快捷键，玩家仍能依自己的习惯调整。
- 多句随机气泡与出现间隔
- 右键调用姿势的 WAV 音效
- 建议快捷键与默认启用状态
专注模式与按键反应专注时，让桌宠停在你指定的位置。
完整桌宠包可设置固定专注姿势。玩家能拖动桌宠调整位置，也能选择显示按键反应速度，并自定义数值前后的文字。
- 固定位置，不触发走动、攀附或下坠
- 按键时重新播放专注动画
- 可自定义毫秒数前后文字，不记录按键内容
Twitch 直播反应按 Bits、订阅或赠送订阅触发指定姿势。
为姿势设置 Bits 金额范围、一般订阅或赠送订阅触发规则与持续秒数，气泡可带入观众昵称、留言和 Bits 数量；触发后会回到原本动作。
- 金额区间与播放持续时间
- 专属动画、音效与文字气泡
- 不会打包任何 Twitch 账号或授权资料
AI 素材提示与多语言附上 Prompt，让玩家制作更多角色动作。
可为作品提供 AI 素材助手 Prompt，玩家能依自己的角色图延伸新姿势；提示可提供多种语言版本。
- 姿势包直接显示，完整桌宠可分组展开
- 支持繁中、简中、英文、日文与更多语言文案
- 指定一张 3×2 六宫格，裁切后再导入姿势
工作、商城与日常事件设置角色的工作、商品与日常事件。
创作者能做出角色专属的工作、商品和事件，改变饱食度、亲合度、心情与游戏内金币，并安排刷新规则。
- 食物、礼物、收藏品与有限库存
- 工作时长、奖励、消耗与心情风险
- 依饱食度、亲合度、心情触发日常对话
安全打包与分享把素材和设置整理好，其他玩家就能直接导入。
桌宠、姿势与养成包使用相对路径与允许的 JSON 字段。程序不会执行 JSON 代码，也不需要把私人账号信息分享出去。
- 支持姿势、完整桌宠与养成内容分开分享
- 素材与 WAV 音效可一并打包
- 不包含 Google、Twitch 令牌或玩家私密设置
FROM IDEA TO WORKSHOP
导入、使用与分享流程
FOR PLAYERS
导入与使用作品
- 选择作品在 Steam 创意工坊订阅作品，或准备创作者分享的本地套件。
- 加载并预览在程序中扫描创意工坊内容或导入本地套件，确认作品类型与素材。
- 确认使用完整桌宠先加入收藏并预览，再确认切换；特效则先预览，再按需启用。
FOR CREATORS
制作与分享作品
- 制作与测试整理角色帧、照顾规则或 DIY 特效，先在本地测试播放、触发与素材路径。
- 整理名称与封面确认作品名称、封面及要包含的素材；完整桌宠可按需选择是否附带 PetFX。
- 导出并确认发布独立特效使用“导出特效…”，再点击“前往创意工坊上传”带入表单。检查内容后确认发布；导出不会自动上传，也不覆盖原作品。
JSON GUIDE
JSON 格式与指南下载
提供姿势、完整桌宠与照顾内容的 JSON 示例，以及收藏、封面、PetFX 与导出说明。v1.3.0 Markdown 指南有繁中、简中、英文版本。
YOUR NEXT CREATION
Four types of content to share
Share a single pose, a full pet, care gameplay or a standalone effect. The sections below explain what each type includes and how to package it.
SINGLE POSE PACKAGE
Single pose pack
Add a wave, hop, surprise, or right-click action with its frames, movement, bubbles, sound, and hotkey.
FULL PET PACKAGE
Full pet pack
Save character assets, poses and shareable settings as a pet collection. Add a menu name and cover to identify pets when switching or sharing them.
CARE GAMEPLAY PACKAGE
Care gameplay pack
Design jobs, shop items, daily events, and mood responses for your character.
STANDALONE EFFECT
Standalone PetFX effect
Create stars, bubbles or other animated effects, then choose their triggers and follow positions. Export an effect on its own without bundling a full pet.
PET COLLECTIONS
Collection names, covers and previews
Import a complete package to keep its assets with the pet. Preview its appearance and actions, then confirm before switching your current pet.
- Set a menu name separately from the character name.
- Use one square 1:1 cover image; covers do not use the six-panel pose crop workflow.
- Identical content is not added twice, and imports leave the original files unchanged.
DIY EFFECTS
DIY effects and triggers
The DIY tutorial includes HTML, CSS and JavaScript examples. Use them with PetFX package rules to create animations and set their triggers and follow positions.
- Place anchors manually on a pose or frame for effects to follow. The app does not automatically detect heads, hands or other body parts.
- Selection, preview and enablement are separate. Selecting a card does not play it, and previewing does not enable it.
- Choose effects, post-event poses and output targets for Twitch Bits, follows, subscriptions and gifts. Follows require the relevant authorization.
SUPPORTED SETTINGS
Character actions and interaction settings
Expand a topic for animation, movement, bubble, audio and care settings, with links to the corresponding JSON examples.
Character and animationAny character you have rights to use can become a desktop pet.
Add multiple transparent PNG frames or a GIF, adjust playback speed, and give an original character, rabbit, robot, or another design its own movement.
- Multi-frame animation and relative asset paths
- Playback from 0.25x to 4x
- Right-facing walk art mirrors automatically when moving left
Movement and action stagingMake a character walk, hop, patrol, drift, or perform a signature sequence.
Use safe JSON values for distance, speed, gravity, and looping. Workshop content never needs to run executable code.
- Wander, patrol, hop, shake, and drift
- Multi-step sequences with easing curves
- Choose whether gravity applies during a pose
Bubbles, sound, and hotkeysAdd dialogue, sound, and a hotkey to a pose.
Each pose can include random bubble text, a WAV sound, an enabled state, and a suggested hotkey. Players can adjust these settings.
- Multiple random bubbles and intervals
- WAV sound for right-click poses
- Suggested hotkeys and default enabled state
Focus mode and key responseKeep your pet in a chosen spot while you focus.
A full pet pack can include a fixed focus pose. Players can drag the pet to a new position and optionally show key-response speed with custom text before and after the value.
- Stay put without walking, clinging, or falling
- Replay the focus animation on key input
- Customize the millisecond bubble without recording keys
Twitch live reactionsTrigger a pose with Bits, subscriptions or gift subscriptions.
Set a Bits range, regular or gift subscription triggers, and a duration for a pose. Bubbles can include a viewer name, message, and Bits amount; the pet returns to its earlier action afterward.
- Amount ranges and playback duration
- Dedicated animation, sound, and bubbles
- No Twitch account or authorization data is packaged
AI asset prompts and languagesInclude prompts to help players create more character actions.
Add AI Asset Helper prompts so a player can create more poses from their own reference art. Prompts may include multiple languages.
- Pose packs display directly; full pets group prompts
- Traditional Chinese, Simplified Chinese, English, Japanese, and more
- Ask for one 3×2 six-panel PNG; crop it into frames before import
Jobs, shop items, and daily eventsSet up jobs, shop items, and daily events for your character.
Creators can make character-specific jobs, items, and events that affect hunger, affinity, mood, and in-game coins, and set rules for when they refresh.
- Food, gifts, collectibles, and limited stock
- Job duration, rewards, costs, and mood risk
- Daily dialogue triggered by hunger, affinity, and mood
Safe packaging and sharingOrganize assets and settings so other players can import them directly.
Pet, pose and care packs use relative paths and allow-listed JSON data. The app never runs JSON as code, and private account information stays out of a shared pack.
- Share poses, full pets, and care content separately
- Bundle art and WAV sound together
- No Google or Twitch tokens, or private player settings
FROM IDEA TO WORKSHOP
Importing, using and sharing content
FOR PLAYERS
Import and use content
- Find a creationSubscribe on Steam Workshop or get a local package shared by its creator.
- Load and previewScan Workshop content in the app or import a local package, then check the content type and assets.
- Confirm useAdd a full pet to your collection and preview it before confirming the switch. Preview effects separately, then enable the ones you want.
FOR CREATORS
Create and share content
- Create and testPrepare character frames, care rules or DIY effects. Test playback, triggers and asset paths locally.
- Add a name and coverCheck the name, cover and included assets. When exporting a full pet, choose whether to include PetFX.
- Export and confirm publicationFor a standalone effect, choose “Export effect…”, then open the Workshop upload form with its details filled in. Review before publishing. Exporting neither uploads automatically nor overwrites the original.
JSON GUIDE
JSON formats and guide downloads
Find JSON examples for poses, full pets and care content, plus collection, cover, PetFX and export instructions. The v1.3.0 Markdown guide is available in Traditional Chinese, Simplified Chinese and English.
開始前：從三種主要分享方式中選擇
桌寵 JSON 有三種封裝方式；PetFX 特效使用另列的獨立格式：姿勢包使用 "type": "pose"，適合分享一個右鍵呼叫姿勢與它的素材；完整桌寵包使用 "type": "pet"，以 pet_config.json 帶入基礎姿勢、提醒、快捷鍵與其他設定；養成內容則使用 "type": "care"，提供商城物品、工作與日常事件。
你可以在這三種封裝方式中，組合下方八個創作主題：角色動畫、移動、對話、專注、實況反應、AI 素材提示、養成規則與安全打包。
本指南涵蓋的 8 個創作主題
- 角色與動畫
- 移動與動作演出
- 氣泡、音效與快捷鍵
- 專注模式與按鍵反應
- Twitch 直播姿勢
- 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 組成演出。
playback_speed動畫倍率，支援 0.25 到 4.0；多數姿勢建議 0.75 到 1.5。
distance_px水平距離或抖動幅度，範圍 0 到 2400。
vertical_px垂直距離或跳躍高度；負數可用於向上漂移。
gravity設為 false 時，姿勢期間不會進入自然下墜流程。
Twitch 直播欄位補充
可在任一姿勢內加入 twitch_trigger，依觀眾 Bits 金額、一般訂閱或贈送訂閱播放對應動畫、音效與氣泡。訂閱事件需要玩家授予相應 Twitch 權限。工作坊會分享這組玩法規則，但不會包含 Twitch 帳號、授權碼或權杖；每位玩家都必須連接自己的 Twitch。
"twitch_trigger": {
"enabled": true,
"subscription_enabled": true,
"gift_subscription_enabled": true,
"duration_sec": 8,
"min_bits": 100,
"max_bits": 499,
"bubble_texts": ["謝謝 {viewer_name} 的 {amount} {currency}！"]
}AI 素材提示欄位補充
ai_asset_prompts 至少提供一個語系。姿勢包直接顯示提示，完整桌寵包以標題分組。請 AI 先輸出一張 3×2 六宮格 PNG，再用「宮格圖片裁切」拆成六張影格，最後加入 animation_paths；不要直接把整張宮格當作單一影格。
"ai_asset_prompts": [
{
"id": "wave_ai_prompt",
"name": "揮手姿勢",
"pose_id": "wave",
"zh": "使用我的角色參考圖製作揮手動畫，保留原有特徵與配件。輸出 1 張 3 x 2 六宮格透明 PNG，不拆成獨立檔案；每格 256 x 256 px，角色大小、中心點與底部定位一致，格間正好 5px。只在外側留白放 #0CB8EC 細虛線與 90 度直角裁切標記，不壓到角色；不要文字、格號或浮水印。"
}
]v1.3.0：桌寵收藏、名稱與封面
完整桌寵包的 title 是收藏與工作坊選單名稱，不會改寫 pet_config.json 的 pet_name。可用 cover_path 指定包內封面；沒有有效封面時顯示占位圖，舊包仍可使用。
{
"schema_version": 1,
"id": "my-complete-pet",
"title": "小露娜桌寵",
"type": "pet",
"content_kind": "full_pet",
"config_path": "pet_config.json",
"cover_path": "cover.png",
"assets_mode": "bundled"
}匯入收藏會複製設定、封面與必要素材，保留原始檔案；先預覽，確認使用後才替換目前桌寵。同內容不重複收藏。跨電腦使用前，請先退出程式並在 Steam 確認同步完成。
DIY 網頁特效與工作坊分享
PetFX 是獨立的特效套件，使用 petfx.json 的 displayName 與 cover，不可替換成桌寵包的 title／cover_path。套件包含網頁程式與素材；封面用 1:1 單張圖片，不走姿勢六宮格裁切流程。完整範例、事件綁定與標點跟隨請參考程式內的 DIY 網頁特效教學。
- 選取作品，按「匯出特效…」並選擇存放位置。
- 匯出完成後，按「前往工作坊上傳」。
- 檢查內容資料夾、標題與封面，再確認發布。
匯出保留素材、封面、名稱、觸發規則與標點，不含登入資料、OBS 連線或個人啟停偏好；不覆寫原作品，也不會自動上傳。
分享前檢查
- 每張影格的角色中心點盡量一致，避免播放時晃動。
- 完整桌寵包以
config_path指向pet_config.json；不要包含 Google token、OAuth 設定、本機訂閱清單或其他私密資料。 - 只放入你擁有或已取得授權的圖片、音效與文字；為素材來源與使用條件做清楚標記。
- 先以工作坊頁的掃描與匯入流程在乾淨資料夾測試，再分享給其他玩家。
开始前：从三种主要分享方式中选择
桌宠 JSON 有三种封装方式；PetFX 特效使用下文说明的独立格式：姿势包使用 "type": "pose"，适合分享一个右键调用姿势与它的素材；完整桌宠包使用 "type": "pet"，以 pet_config.json 带入基础姿势、提醒、快捷键与其他设置；养成内容使用 "type": "care"，提供商城物品、工作与日常事件。
你可以在这三种封装方式中，组合下方八个创作主题：角色动画、移动、对话、专注、直播反应、AI 素材提示、养成规则与安全打包。
本指南涵盖的 8 个创作主题
- 角色与动画
- 移动与动作演出
- 气泡、音效与快捷键
- 专注模式与按键反应
- Twitch 直播姿势
- 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 直播字段补充
可在任一姿势内加入 twitch_trigger，依观众 Bits 金额、一般订阅或赠送订阅播放对应动画、音效与气泡。订阅事件需要玩家授予相应 Twitch 权限。创意工坊会分享这组玩法规则，但不会包含 Twitch 账号、授权码或令牌；每位玩家都必须连接自己的 Twitch。
"twitch_trigger": {
"enabled": true,
"subscription_enabled": true,
"gift_subscription_enabled": true,
"duration_sec": 8,
"min_bits": 100,
"max_bits": 499,
"bubble_texts": ["谢谢 {viewer_name} 的 {amount} {currency}！"]
}AI 素材提示字段补充
ai_asset_prompts 至少提供一种语言。姿势包直接显示提示，完整桌宠包按标题分组。请 AI 先输出一张 3×2 六宫格 PNG，再用“宫格图片裁切”拆成六张帧，最后加入 animation_paths；不要直接把整张宫格作为单帧。
"ai_asset_prompts": [
{
"id": "wave_ai_prompt",
"name": "挥手姿势",
"pose_id": "wave",
"zh_cn": "使用我的角色参考图制作挥手动画，保留原有特征与配件。输出 1 张 3 x 2 六宫格透明 PNG，不拆成独立文件；每格 256 x 256 px，角色大小、中心点与底部定位一致，格间正好 5px。只在外侧留白放 #0CB8EC 细虚线与 90 度直角裁切标记，不压到角色；不要文字、格号或水印。"
}
]v1.3.0：桌宠收藏、名称与封面
完整桌宠包的 title 是收藏与创意工坊菜单名称，不会改写 pet_config.json 的 pet_name。可用 cover_path 指定包内封面；没有有效封面时显示占位图，旧包仍可使用。
{
"schema_version": 1,
"id": "my-complete-pet",
"title": "小露娜桌宠",
"type": "pet",
"content_kind": "full_pet",
"config_path": "pet_config.json",
"cover_path": "cover.png",
"assets_mode": "bundled"
}导入收藏会复制设置、封面与必要素材，保留原始文件；先预览，确认使用后才替换当前桌宠。相同内容不重复收藏。跨电脑使用前，请先退出程序并在 Steam 确认同步完成。
DIY 网页特效与创意工坊分享
PetFX 是独立的特效套件，使用 petfx.json 的 displayName 与 cover，不可替换为桌宠包的 title／cover_path。套件包含网页代码与素材；封面使用 1:1 单张图片，不走姿势六宫格裁切流程。完整示例、事件绑定与标点跟随请参考程序内的 DIY 网页特效教学。
- 选择作品，点击“导出特效…”并选择保存位置。
- 导出完成后，点击“前往创意工坊上传”。
- 检查内容文件夹、标题与封面，再确认发布。
导出保留素材、封面、名称、触发规则与标点，不包含登录资料、OBS 连接或个人启停偏好；不覆盖原作品，也不会自动上传。
分享前检查
- 每张帧的角色中心点尽量一致，避免播放时晃动。
- 完整桌宠包以
config_path指向pet_config.json，不要包含 Google token、OAuth 设置或其他私密资料。 - 只放入你拥有或已取得授权的图片、音效与文字，并先在干净资料夹测试导入。
Before you begin: choose one of three main sharing formats
Pet JSON content has three package formats; PetFX effects use the separate format described below. 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.
Within these three formats, you can combine the eight topics below: character animation, movement, dialogue, focus, stream reactions, AI asset prompts, care rules, and safe packaging.
This guide covers 8 creation topics
- Character and animation
- Movement and action staging
- Bubbles, sound, and hotkeys
- Focus mode and key response
- Twitch live poses
- AI asset prompts and languages
- Jobs, shop items, and daily events
- Safe packaging and sharing
Advanced fields and packaging reference
Keep the entry JSON, images, and sound files in one folder. The app resolves relative paths from the JSON file, so a player can import that folder on another computer.
MyWavePose/
desktop_pet_studio_workshop.json
assets/
frame_01.png ... frame_06.png
wave.wavUse 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 live field reference
Add twitch_trigger to any pose to play its animation, sound, and bubble for Bits, regular subscriptions or gift subscriptions. Subscription events require the player's relevant Twitch permissions. 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,
"subscription_enabled": true,
"gift_subscription_enabled": true,
"duration_sec": 8,
"min_bits": 100,
"max_bits": 499,
"bubble_texts": ["Thanks {viewer_name} for {amount} {currency}!"]
}AI asset-prompt field reference
Provide at least one language in ai_asset_prompts. Pose prompts appear directly; full-pet prompts are grouped by title. Generate one 3×2 six-panel PNG, use “Crop grid image” to split it into six frames, then add those frames to animation_paths. Do not import the whole grid as one frame.
"ai_asset_prompts": [
{
"id": "wave_ai_prompt",
"name": "Wave pose",
"pose_id": "wave",
"en": "Create a waving animation from my character reference; preserve its features and accessories. Output one transparent 3 x 2 six-panel PNG, not separate files. Use 256 x 256 px panels, identical scale, centers and bottom anchors, and exactly 5px gaps. Place thin #0CB8EC dashed guides and sharp 90-degree crop marks only in outer margins, never over the character. No text, panel numbers or watermark."
}
]v1.3.0: pet collections, names and covers
A full-pet package uses title for its collection and Workshop menu name without changing pet_name in pet_config.json. Use cover_path for a cover inside the package. A missing or invalid cover shows a placeholder; older packages still work.
{
"schema_version": 1,
"id": "my-complete-pet",
"title": "Luna pet",
"type": "pet",
"content_kind": "full_pet",
"config_path": "pet_config.json",
"cover_path": "cover.png",
"assets_mode": "bundled"
}Collection import copies settings, the cover and required assets while preserving the source files. Preview first; the current pet changes only after you confirm use. Identical content is not added twice. Before switching computers, exit the app and confirm that Steam has finished syncing.
DIY web effects and Workshop sharing
PetFX is a separate effect package format. It uses displayName and cover in petfx.json, not the pet-package fields title and cover_path. Packages contain web code and assets. Use one 1:1 cover image, not a pose grid. See the in-app DIY web effects tutorial for complete examples, event bindings and anchor following.
- Select your work, click “Export effect…” and choose a save location.
- After exporting, click “Go to Workshop upload”.
- Check the content folder, title and cover, then confirm publication.
Export preserves assets, the cover, name, trigger rules and anchors. It excludes login data, OBS connections and personal enabled preferences. It neither overwrites the original work nor uploads automatically.
Before you share
- Keep the character center consistent across frames to prevent visual jitter.
- For a full-pet pack, point
config_pathtopet_config.json; never include Google tokens, OAuth settings, or other private data. - Share only art, sound, and text you own or are licensed to distribute, then test importing from a clean folder.