桌面模组文档开始创作
模组开发文档

开始创作

素材准备与测试

先整理好素材,再让第一个小目标在软件里运行。

准备动画素材

动作由一组透明背景的 PNG 图片按顺序播放而成。同一个动作使用相同前缀,从 0 开始连续编号。

stand_0.png
stand_1.png
stand_2.png

保持角色在各帧中的实际大小一致。不同动作使用一致的画布和脚底基准,能减少切换动作时的跳动;需要调整位置时,参考 anchor 的说明。

整理文件

尽量使用英文文件名,避免不同系统或解压工具造成文件名编码问题。配置里的文件名应与实际文件完全一致,包括大小写与扩展名。

先保存一份原始素材,再在独立的模组文件夹中整理发布内容。不要覆盖软件自带的系统资源。

在软件中测试

通过软件「系统」中的模组添加功能导入你的作品。每次先检查一个小目标,再增加新的动作或配置。

  • 角色:检查待机、提起、下落,以及动作切换的位置。
  • 迷你宠物:检查召唤、显示和与角色的联动。
  • 物品:检查图片、描述、获取方式和使用效果。

分享前再检查一次

确认配置引用的图片和声音都在包内,补充模组介绍和作者信息。用准备分享的文件重新导入测试,避免只在自己的开发目录里能正常运行。

配置格式有疑问时先看 JSON 基础。发布前按作者资料补全介绍,再使用测试与排查清单。

Prepare animation frames

Animations play a sequence of transparent PNG images. Use one prefix per animation and number the frames consecutively, starting at 0.

stand_0.png
stand_1.png
stand_2.png

Keep the character’s apparent size consistent. A shared canvas and ground reference reduce jumps between animations. See anchor positioning when an offset is needed.

Organize files

Prefer English file names to reduce encoding problems across systems and archive tools. Every name in a configuration must match the actual file, including case and extension.

Keep your original assets separately, and assemble the release in its own mod folder. Do not overwrite the app’s system resources.

Test in the app

Import your work using the mod import feature under System. Test one small goal at a time before adding more animations or settings.

  • Characters: check idle, dragging, falling and position changes between animations.
  • Mini-pets: check summoning, appearance and character interactions.
  • Items: check images, descriptions, acquisition and effects.

Check before sharing

Include every referenced image and sound, and add mod and creator information. Import the files you actually intend to share to make sure the mod works outside your development folder.

For configuration syntax, see JSON basics. Before sharing, complete the creator information and follow the testing checklist.

文档持续完善中。 查看原始开发文档 ↗

使用指南

待后续补充

使用指南将在后续补充,介绍呆啵桌宠的设置与日常使用。

常见问题

待后续补充

常见问题将在后续补充,汇总使用过程中常遇到的问题与解答。

QQ 群

一起分享使用体验,抢先测试新版

群号557261268

QQ 群二维码

使用 QQ 扫码,或搜索群号加入。