开始创作
测试、排查与分享
让模组在自己的目录之外，也能被顺利导入和使用。
先测试最小目标
先让一个动作或一件物品正常显示，再添加其他功能。保存一份可用配置；出现问题时，比较最近的一次修改。
通过软件「系统」中对应的模组添加功能导入。导入检查有助于发现缺失文件等问题，但成功导入不等于所有交互都已经正确。
按模组类型检查
| 模组 | 建议检查 |
|---|---|
| 角色 | 待机、点击、拖拽、下落、落地、随机动作、不同饱食度状态 |
| 迷你宠物 | 物品是否可获得、能否召唤、图片和动作、跟随位置、收回 |
| 物品 | 商店与解锁、图片、描述、使用效果、奖励和角色限制 |
| 昼夜作息 | 功能开启、白天 / 夜间动作池、过渡动画、夜间反应 |
| Equip | 多种姿势下的位置、重复使用收回、重新启动恢复 |
只测试自己实际配置的功能。切换系统和软件版本测试时，记录测试环境，不把“在我的电脑上可用”写成所有环境都兼容。
常见问题从哪里查？
| 现象 | 优先检查 |
|---|---|
| 配置无法读取 | JSON 双引号、逗号、括号、文件编码与后缀 |
| 动画缺失 | images 前缀、从 0 开始的连续帧、action/ 位置 |
| 特定动作不播放 | 动作名引用、解锁条件、饱食度、phase |
| 切换动作时跳动 | 画布尺寸、角色大小、底部中心与 anchor |
| 声音不播放 | note.json 注册名、音频文件名、大小写与优先级 |
| 物品或作者图片缺失 | 资料文件所在目录与相对路径 |
修改一个原因后重新测试，避免同时改动太多设置而无法判断哪一处生效。
整理并分享
- 保留模组配置和实际引用的素材，去掉开发草稿与临时文件。
- 填写模组介绍与作者资料。
- 检查压缩后的文件夹结构，确保没有遗漏图片和声音。
- 解压一份准备分享的包，重新导入测试。
- 附上实际测试的软件版本、使用说明与必要的关联模组说明。
独立模组和合集都应保持每个模组自身结构完整。多个模组放在一起，并不意味着可以省略某个成员的配置文件。
Test the smallest useful goal
Start with one visible animation or one working item. Keep a known-good configuration and compare the latest change when something breaks.
Import through the relevant mod feature under System. Import checks help catch missing files, but a successful import does not verify every interaction.
Check by mod type
| Mod | Suggested checks |
|---|---|
| Character | Idle, clicks, dragging, falling, landing, random actions, different satiety states |
| Mini-pet | Item availability, summoning, images and animations, following position, retraction |
| Items | Shop and unlocks, images, descriptions, effects, rewards and character restrictions |
| Day/night routines | Feature enabled, daytime / nighttime pools, transitions and nighttime reactions |
| Equip | Position in different poses, use again to retract, restoration after restart |
Test the features you actually configured. Record the system and app versions you test; working on your own computer is not proof of universal compatibility.
Where to look first
| Symptom | First checks |
|---|---|
| Configuration cannot be read | JSON quotes, commas, brackets, encoding and extension |
| Missing animation | images prefix, consecutive frames from 0, action/ location |
| An action never plays | Animation references, unlocks, satiety and phase |
| Position jumps between animations | Canvas dimensions, character size, bottom center and anchor |
| No sound | Registered name in note.json, file name, case and priority |
| Missing item or creator image | Information file location and relative paths |
Change one possible cause at a time so you can tell which adjustment helped.
Prepare to share
- Keep configurations and referenced assets; remove drafts and temporary files.
- Fill in mod and creator information.
- Check the archived folder structure for missing images and sounds.
- Extract the package you intend to share and import it again.
- Include the tested app version, instructions and required companion mods.
Standalone mods and collections should preserve each mod’s own complete structure. Putting several mods together does not remove the need for each member’s configuration files.
文档持续完善中。 查看原始开发文档 ↗