Little LUMI Model 制作模块， 发送到 Workshop
Mods 标签、 文件结构、 行为添加、 上传路径——补丁 1.2.0 之后。
补丁 1.2.0（ 2026 年 9 月 6 日）将 Little LUMI Model 变成了可模组的桌面伙伴。 模组现在可以添加新的行为和功能， 不仅仅是替换角色图片和语音。 本指南涵盖 Settings 中的 Mods 标签、 基于文件的模组化结构， 以及如何将模块上传到 app 5075020 的 Steam Workshop。
本指南面向想要制作内容的人。 要使用社区模块， 请从 模块中心 开始。 要在不进行模组化的情况下添加 Workshop 角色， 请使用 Workshop 指南。
Mods 标签
更新到 1.2.0 后， 打开 Settings， 找到 Screen 和 About 之间的 Mods 标签。 该标签显示你运行的所有模组——包括 Steam Workshop 订阅和手动添加的文件——在单个统一列表中。
从 Mods 标签你可以启用或禁用单个模组， 无需取消订阅 Workshop， 拖动项目以更改加载顺序（ 当多个模组影响同一行为时， 较高的项目优先）， 并查看哪些模组处于活动、 暂停或冲突状态。 如果某个模组导致意外的动画或冻结， 将其在列表中向下拖动或禁用它。 当两个模块对同一行为定义不同时， 加载顺序很重要。
基于文件的模组化结构
1.2.0 在发布时已存在的图片和语音支持之上引入了基于文件的模组化。 模组位于应用模组目录内的文件夹中。 确切路径是 Studio LUMI 在 Workshop 和官方沟通中记录的内容的一部分； 本 Wiki 不会编造 Steam 未发布的路径。
一个典型的模组文件夹包含 manifest.json， 声明模组名称、 版本、 作者以及它添加或覆盖的行为或功能。 images/ 文件夹包含替换或扩充 Lumi 默认艺术的精灵图或角色图片文件。 voices/ 文件夹包含自言自语、 相遇聊天或自定义声音的音频文件。 behaviours/ 文件夹包含添加新动作模式或交互响应的行为定义文件。 manifest 是必需的部分； 只有图片和语音的模组可以工作（ 这在 1.2.0 之前是可能的）， 但带有行为的模组需要 1.2.0 架构。
制作角色模块
角色模块是精灵图替换： 你提供 Lumi 动画系统作为新角色读取的图片， 还可以选择添加语音文件。 创建一个包含 manifest.json 的文件夹， 将其声明为角色模块， 将图片文件添加到 images/ 文件夹（ 按 Lumi 系统期望的动画槽命名）， 可选择添加自言自语和相遇聊天的语音文件， 通过将文件夹放入手动模组目录并检查它是否出现在 Settings → Mods 中来进行测试， 然后调整加载顺序， 让你的角色在任何它依赖的基础精灵图之后加载。
现有角色模块的 Workshop 页面是命名约定和文件夹结构的最佳参考——订阅一个， 在 Mods 标签中找到它， 并研究 Workshop 页面关于文件布局的说明。
制作行为模块
行为模块添加或覆盖动作模式。 这需要 1.2.0 行为架构。 manifest 声明模组填充哪些行为槽； behaviours/ 文件夹包含定义文件。 不要假设每个行为槽都是开放的。 如果两个模组声明同一个槽， Mods 标签中的加载顺序决定哪个获胜。 将你的模组放在列表顶部进行测试， 如果出现冲突， 将其向下移动。
上传到 Steam Workshop
将你的模组文件夹打包为可以共享的单个单元（ zip 或文件夹本身）。 转到 app 5075020 的 Steam Workshop， 点击 Submit an Item， 选择 LUMI Module， 然后按照 Workshop 提交步骤操作。 描述模组的作用、 需求（ 行为模组需要 1.2.0） 以及它填充的行为槽。 上传你打包的模组。 Workshop 页面成为想要你的角色或行为的订阅者的订阅端点。 批准后， 订阅者在 Settings → Mods 中以与 Workshop 角色订阅相同的方式看到你的模块。
模组安全
始终在 Mods 标签可见的情况下测试模组， 以便你可以快速禁用它。 覆盖核心动画的行为模组（ 如果格式不正确） 可能导致剪辑或冻结 Settings 窗口。 测试时保持干净的 Settings 基线打开。 不要分享复制或重新打包 Studio LUMI 专有资产的模组——角色模块应使用原创艺术。 如果模组破坏了 Lumi， 先从 Mods 标签禁用它， 然后确认基础宠物仍能运行， 然后再发布错误报告。
相关页面
在 模块中心 订阅社区模块。 使用 Workshop 指南 添加 Workshop 角色。 通过 多只 Lumi 调用额外的 Lumi 副本。 角色详情在 Lumi 中心。 模组化是 1.2.0 之后的新功能； 本指南将随着 Studio LUMI 发布行为架构和 Workshop 发布示例模块而增长。
常見問題
給剛裝好 Little LUMI Model 的人的短答。
补丁 1.2.0 为模组制作者带来了什么？
基于文件的模组化、 Settings 中的 Mods 标签， 以及模组添加新的行为和功能（ 不仅仅是图片和语音） 的能力。 行为模组需要 1.2.0 架构。
如何手动安装模组（ 不通过 Workshop）？
1.2.0 之后， 将模组文件夹放入应用的模组目录。 打开 Settings → Mods 在统一列表中查看。 完全重启 Lumi 以便读取文件夹。
模组文件夹结构是什么？
manifest.json 是必需的。 然后是 images/、 voices/ 和 behaviours/ 文件夹， 取决于模组添加的内容。 确切目录路径在 Studio LUMI 的官方 Workshop 文档中。
两个模组可以更改同一行为吗？
可以。 Settings → Mods 中的加载顺序决定哪个优先。 在列表中向上拖动以给予模组优先权。 当行为槽重叠时仔细测试。
我制作的模组应该上传到哪里？
app 5075020 的 Steam Workshop。 选择 LUMI Module 作为项目类型， 描述其功能， 然后上传你打包的模组文件夹。