S4S Visual Slot Editor 1.0.0 简明使用说明
==========================================

一、用途与版本

在 Blender 中可视化创建、编辑并写入《模拟人生4》物品插槽。
最低支持 Blender 3.6；已验证 Blender 3.6、4.5、5.2。
插件自动跟随 Blender 界面语言：简体中文显示中文，英文及其他未翻译语言显示英文。修改 Blender 语言后建议重新启动 Blender。
SML、MED、LRG、Deco Medium、Dress Hanger 等与 S4S 对照用的名称始终保留英文。

当前支持：
- deco_sml / deco_med / deco_lrg
- Dress Hanger
- Postcard Board Collect
- Curtain Interior / Curtain Exterior
- Wall Deco Large
- Magnet Board Collect

二、安装

1. 打开“编辑 > 偏好设置 > 插件 > 安装”。
2. 选择 S4S_Visual_Slot_Editor_1.0.0.zip，不要提前解压。
3. 启用 S4S Visual Slot Editor。
4. 在 3D 视图按 N，打开“S4S Slots”标签。

三、直接编辑 Package

1. 点击“直接打开 Package 工程”。
2. 场景有对象时，选择清空后载入或保留后载入。
3. 插件只载入各 Model 的 LOD0 作为只读参考；多 Model 可逐组切换。
4. 移动、旋转或删除已有插槽，也可从插槽库新增。选中后通过“更换类型”调整类型/尺寸，保留位置旋转，不额外占用 RIG；有不安全关联时会阻止写入。
5. Shift+D 复制已有插槽时，副本自动视为新增插槽。
6. 在面板底部点击“检查并写入当前 Package”。
7. 查看受影响 Model、新增、修改、删除、已有插槽类型替换和最终 RIG 数量，确认后写入。

四、普通 Blend 编辑

1. 打开家具 Blend；如带骨架，可扫描并载入已支持的骨骼插槽。
2. 使用插槽库、预设和阵列工具完成布局。
3. 点击面板底部的写入按钮并选择目标 Package 与 Model。
4. 选择：
   - 只新增：保留 Package 原插槽，完全重合项自动跳过。
   - 替换已录入类型：替换插件支持的插槽；FX、transformBone 和未识别 RIG 保持不动。

五、常用规则

- 同类型、同尺寸插槽：新增时继承所选插槽的位置和旋转。
- 不同类型或尺寸：只继承位置，旋转归零。
- 未选择有效插槽：复用上一个同类手动新增插槽；否则生成在世界原点。
- 插槽未选中时为 50% 透明，选中时为 100%。正顶视图显示边界厚度。
- 场景保护只锁定家具；摄像机和灯光不锁定，可使用快捷清理。
- 预设只保存支持的插槽、位置和旋转，不保存家具、Package 绑定或原件身份。

六、容量与写入安全

- 游戏中每个独立 RIG 上限为 180；共享 RIG 的 Model 共用容量。
- 自动模式使用检测到的 RIG；普通 Blend 无可靠骨架时可使用手动预留。
- 超过上限时禁止写入。
- 覆盖模式会在 S4S_Slot_Backups 中生成带时间的备份。
- 另存模式输出到 S4S_Slot_Output，不覆盖原文件。
- Package 在编辑期间被外部修改时，插件会拒绝使用旧工程状态写入。

七、常见问题

- 看不到颜色：切换到实体视图；插件会在其他着色模式下提示。
- 写入按钮不可用：检查是否存在插槽、Package 是否有效、RIG 是否超过上限。
- 多 Model 预设无法应用：目标 Package 的 Model 数量必须与预设一致。
- 写入后没有新增：完全重合的插槽可能已被安全跳过，请查看最近检查结果。
