角色模组
通知图标与语音
替换需要的声音和图标，其余通知继续使用默认素材。
准备 note 文件夹
在角色目录创建 note/，放入 note.json 和它引用的图片、音频。只填写需要定制的通知，不必复制全部系统默认配置。
角色名字/
└── note/
├── note.json
├── notice.png
├── morning.wav
└── chat.wav一个完整的通知文件
下面可以作为 note/note.json 的起点。准备好树状图列出的三个素材文件：
{
"system": {"image": "notice.png"},
"greeting_1": {"image": "notice.png", "sound": "morning.wav"},
"random_1": {"sound": "chat.wav", "sound_priority": 1}
}system 只换图标；greeting_1 换早安图标与声音；random_1 增加点击时可播放的随机语音。
可以替换哪些通知？
| 名称 | 对应事件 |
|---|---|
system |
系统相关通知 |
status_hp / status_fv / status_coin |
饱食度 / 好感度 / 金币变化 |
start_tomato / end_tomato / cancel_tomato |
番茄钟开始 / 完成 / 取消 |
start_focus / end_focus / cancel_focus |
专注时间开始 / 完成 / 取消 |
greeting_1 至 greeting_5 |
早晨、中午、下午、晚上、深夜的启动问候 |
feed_1 / feed_2 / feed_3 |
喜欢、普通、不喜欢食物的喂食声音 |
random_1、random_2… |
按顺序编号的点击随机语音 |
优先级与素材检查
sound_priority 越高，声音越能打断低优先级声音。底本中系统、数值、问候、随机语音默认优先级为 0，专注任务为 1，喂食为 2。只在确有需要时改变优先级。
音频名字要与文件逐字一致。随机语音可以不添加；大量音频会增加资源占用，先用少量素材验证触发效果。
想让声音伴随头顶的文字出现，继续阅读对话气泡。
Prepare the note folder
Create note/ inside the character folder. Add note.json and its referenced images and audio. Configure only the notifications you want to change; there is no need to copy every system default.
CharacterName/
└── note/
├── note.json
├── notice.png
├── morning.wav
└── chat.wavA complete notification file
Use this as a starting point for note/note.json, with the three assets listed above:
{
"system": {"image": "notice.png"},
"greeting_1": {"image": "notice.png", "sound": "morning.wav"},
"random_1": {"sound": "chat.wav", "sound_priority": 1}
}system changes only the icon. greeting_1 changes the morning greeting icon and sound. random_1 adds a voice line that can play on clicks.
Available notification events
| Name | Event |
|---|---|
system |
System notifications |
status_hp / status_fv / status_coin |
Satiety / affection / coin changes |
start_tomato / end_tomato / cancel_tomato |
Pomodoro start / completion / cancellation |
start_focus / end_focus / cancel_focus |
Focus-time start / completion / cancellation |
greeting_1 through greeting_5 |
Morning, noon, afternoon, evening and late-night startup greetings |
feed_1 / feed_2 / feed_3 |
Favorite, ordinary and disliked food sounds |
random_1, random_2… |
Consecutively numbered random click voice lines |
Priority and asset checks
Higher sound_priority values let sounds interrupt lower-priority ones. The source defaults are 0 for system, stat, greeting and random sounds, 1 for focus tasks, and 2 for feeding. Change priorities only when needed.
Match audio file names exactly. Random voice lines are optional; large audio collections increase resource usage, so test with a small set first.
To pair voice with overhead text, continue to speech bubbles.
文档持续完善中。 查看原始开发文档 ↗