饰品工匠

TrinketTinker - 星露谷物语饰品框架

这是一个用于创建饰品的框架，仅需使用 Content Patcher 即可实现高级能力。

该框架能做什么？

• 可设置多种移动模式的动画伙伴。
• 伙伴的皮肤系统（变体），以及设置/更改伙伴变体的相关功能。
• 基于动态事件的能力，通过伙伴而非玩家触发。
• 支持通过动作（actions）使用其他 C# 模组的自定义效果。
• 通过特殊触发动作，玩家无需解锁饰品槽即可获得饰品效果。

如果你想使用此框架制作模组，请参考 模组制作指南。

本模组采用 MPL-2.0 许可协议，欢迎贡献代码。

TrinketTinker 示例模组

• [[CP] 邪恶仆从](https://github.com/Mushymato/TrinketTinker/tree/main/%5BFullMod%5D/%5BCP%5D%20Sinister%20Servants)：TrinketTinker 的可用模组，添加了 6 种怪物饰品。
• [[CP] 袋负鼠与生物笼](https://github.com/Mushymato/TrinketTinker/tree/main/%5BFullMod%5D/%5BCP%5D%20Pack%20Possum%20and%20Critter%20Cages)：TrinketTinker 的可用模组，添加了 3 个可容纳更多饰品的“盒子”饰品，以及一只可雇用的负鼠。
• [[CP] 阿比盖尔的斧头冒险](https://github.com/Mushymato/TrinketTinker/tree/main/%5BExamples%5D/%5BCP%5D%20Abigail%20Axcellent%20Adventure)：NPC 风格饰品的示例模组，此类饰品在世界中独一无二，并会隐藏对应的 NPC。
• [[CP] 锁刀](https://github.com/Mushymato/TrinketTinker/tree/main/%5BExamples%5D/%5BCP%5D%20Lockmachete)：展示帧集重复动画工作原理的示例模组。
• [[CP] Trinket Tinker 示例](https://github.com/Mushymato/TrinketTinker/tree/main/%5BExamples%5D/%5BCP%5D%20Trinket%20Tinker%20Examples)：测试模组，内容略显杂乱。

翻译

• 英语 default.json
• 简体中文 zh.json
• 法语 fr.json（由 Caranud 翻译）

兼容性

• 兼容 Windows/Mac/Linux 上的星露谷物语 1.6.9+ 版本，具体构建所针对的游戏和 SMAPI 版本请参见 manifest.json。
• 在 Android 上部分可用，但 物品栏 相关功能除外。这个问题短期内不太可能解决。

多人游戏

极其重要的是，每位玩家都必须使用相同版本的 TrinketTinker 和相同的内容包，因为本模组大量使用网络字段来让其他人看到你的伙伴。

用户配置

这些按键绑定在该框架下的各模组间共享，供用户按喜好设置。

• Do Interact Key：当靠近伙伴时，按下此键可与其互动。用于与伙伴对话或为其戴上帽子。
• Open Tinker Inventory Key：按下此键可打开已装备饰品的物品栏。
• Tinker Inventory Next Key：当 Tinker 物品栏打开，且装备了多个带物品栏的饰品时，按下此键切换到下一个物品栏。
• Tinker Inventory Prev Key：当 Tinker 物品栏打开，且装备了多个带物品栏的饰品时，按下此键切换到上一个物品栏。

这些设置对所有使用此框架创建的饰品全局生效，但对其他饰品（原版游戏、通过其他 C# 模组添加的）无效。

• Hide During Events：在事件期间隐藏所有饰品伙伴。仅影响通过 TrinketTinker 添加的饰品。
• Draw Debug Mode：启用绘制调试模式，该模式会高亮显示伙伴的边界并显示其当前帧编号。如果你不是模组开发者，并且看到你的饰品周围有品红色背景，请关闭此选项。

故障排除

如果你的角色“卡住”了某个饰品或伙伴，请使用 tt.unequip_trinket 控制台命令移除所有饰品。

链接

模组制作指南

源代码