超级装饰

SuperDecor是《超市模拟器》的装饰框架，同时提供了为其制作装饰的工具。你可以在游戏内的SuperDecor商店购买物品，将它们摆放在商店各处，并借助屏幕上的操控组件精确调整位置。该框架支持静态与动画道具、可交互物品，以及你可以碰撞和滚动的物理道具。

这是早期版本，重点在于框架和创作工具，而非完整的装饰库。目前仅包含少量测试物件：几个立方体、一个镀铬环面、一条飘动的缎带和一个球。它们并非真正的装饰品，而是为了让您看到系统各部分的运作，并让创作者能立即基于API开始构建。正式的第一方装饰即将推出。

任何人都可以制作新装饰并分享。SuperDecor 扩展包生成器浏览器工具可将 3D 模型转换为即插即用的扩展包，无需任何代码；而对于需要自定义行为的物品，则提供了 C# API。

特性

游戏中的装饰品商店
浏览所有已安装的物品，按类别分组，每项均包含详情面板和价格。将所需物品加入购物车，并通过游戏正常流程完成结算。新安装的内容包会自动显示在此处。

放置与布置（装饰编辑模式）
按下 B 进入装饰编辑模式。对准已放置的物品并点击以拾取，然后移动它、调整高度、旋转它，并使用方向键沿表面微调。对准的物品会显示高亮轮廓，以便你始终知道即将抓取什么。

精准模式
按 G 编辑模式下实现精确控制：屏幕上的移动、旋转和缩放控件，外加数值面板，并支持撤销和重做。摄像机脱离视角，可自由飞行：使用WASD移动，按空格键和Z键上升与下降，按住鼠标中键环视四周。

动画装饰
装饰物可自行移动，无需任何设置。物品一旦放置，动画即自动播放。本次发布的动画测试物（呼吸方块、飘动彩带及数个旋转方块）展示了该功能的运作效果，同一系统可驱动创作者构建的任何物件，如滴答作响的时钟或旋转的风扇。

物理装饰
某些道具拥有真实物理效果。碰一下它们就会滚动。这个版本中，橙色测试球就是例子。框架能在你重新摆放物理道具时将其固定，并在重新加载时恢复其静止位置。

自己做，无需代码
扩展包生成器是一个GitHub Pages浏览器工具。放入一个3D模型，填写名称、价格和类别，即可导出一个扩展包。将扩展包放入你的游戏，它就会和所有其他物品一起出现在SuperDecor商店中。无需Unity，无需.NET，无需编译任何内容。带动画的模型同样适用。

打开发电机： leptoon.github.io/superdecor-release

要求

• 已在超市模拟器1.6.0中测试
• Tobey为《超市模拟器》制作的BepInEx整合包，IL2CPP版本（0.10.0或更新）。链接请参阅“需求”部分。
  

安装

• 为《超市模拟器》安装Tobey的BepInEx整合包。
• 请从“文件”标签页下载SuperDecor。
• 提取 超级装饰 文件夹至 BepInEx/plugins/ 文件夹.
• 启动游戏，打开游戏内电脑，然后开启超级装饰商店。
  

要添加资源包，请将其 .zip 文件拖放到此处 BepInEx/plugins/SuperDecor/Packs/.无需解压。

操作

• B 开启或关闭装饰编辑模式。
• 左键单击 (空手，处于编辑模式)拾取你瞄准的道具。
• 制表键 将持有的物品固定到位，或释放它以再次跟随你的瞄准。
• G 切换精确模式（包含操纵器和数值面板）。
• H 循环高亮：瞄准、全部、关闭。
• 方向键，Y，U 沿着表面轻推持有的物品。
• 滚动，Q，E 旋转手持物品。
• 右键单击 锚定一个后续物品，然后提交。在精淮模式下，第一次右键点击会退出精淮模式。
• Esc 一步一步退出：先是精准模式，然后是装饰编辑模式，最后是菜单。
• F4 显示或隐藏装饰编辑模式HUD。
  

制作并分享你自己的装饰
本次更新主要是关于框架的内容，因此我的目标是让建造装饰尽可能简单。有两种方式构建内容包，两种方式都会生成带有稳定ID的物品，这样玩家的摆放位置在更新后依然保留。

• 无代码 与 扩展包生成器。这是大多数创作者的道路。
• 使用C# 当物品需要自定义行为时，例如可切换的灯光、粒子效果，或对玩家的响应。
  

指南和完整API参考见GitHub： github.com/leptoon/superdecor-release

包含内容
目前SuperDecor仅包含一组测试对象，并非成品装饰。这些对象覆盖了基础功能，以便你能看到框架的运行效果：一个蓝色立方体和一个镀铬圆环、一条丝带、一个呼吸立方体和两个旋转立方体用于动画；以及一个橙色球体用于物理模拟。随时将资源包放入你的Packs文件夹即可添加真实装饰，也可使用生成器或API自行构建。第一方装饰资源包正在规划中。

计划中的更新
此列表可能会有所变动。我会尽量保持更新。

• 第一方装饰包
• 游戏中脚本化声音的播放（包中已可定义）
• 动画纹理（滚动与序列帧材质）
• 合作模式测试与支持。SuperDecor目前是为单人游戏设计的
• 吸附网格（游戏开发团队正在处理此功能，敬请期待）
• 选择并在跟随模式下移动多个物品
• 在精确模式下切换选中的对象
• UI打磨，更详细的属性统计，以及面向创作者的调试模式
• 为创作者提供更多选项，例如商店等级要求和自定义包图标/横幅
  

兼容性与注意事项

• 你放置的装饰会以稳定的ID保存，因此在重装游戏或更新后依然会保持不变。
• 缺失或损坏的模型不会导致游戏崩溃；该物品只会显示为占位符。
• 如果游戏更新导致SuperDecor出现问题，它会通过游戏内通知自行禁用，而不是破坏你的游戏。安装更新版本后，它就会恢复。
• SuperDecor已经过与数十个其他模组的兼容性测试，但按键绑定仍可能发生冲突。如需更改按键绑定，请编辑位于'Supermarket Simulator/BepInEx/config/com.leptoon.superdecor.cfg'的设置文件。
• SuperDecor 是专为单人游戏打造的。多人合作模式未经测试。
• 通过私信报告问题,或在“Bugs”标签页上。