S4S Visual Slot Editor 1.0.0 - Quick Guide
===========================================

1. Purpose and Compatibility

Visually create, edit, and write The Sims 4 object slots in Blender.
Requires Blender 3.6 or newer. Tested with Blender 3.6, 4.5, and 5.2.
The interface follows Blender automatically: Simplified Chinese uses Chinese; English and untranslated languages use English. Restart Blender after changing its language.
S4S reference names such as SML, MED, LRG, Deco Medium, and Dress Hanger always remain in English.

Supported slots:
- deco_sml / deco_med / deco_lrg
- Dress Hanger
- Postcard Board Collect
- Curtain Interior / Curtain Exterior
- Wall Deco Large
- Magnet Board Collect

2. Installation

1. Open Edit > Preferences > Add-ons > Install.
2. Select S4S_Visual_Slot_Editor_1.0.0.zip without extracting it.
3. Enable S4S Visual Slot Editor.
4. Press N in the 3D View and open the “S4S Slots” tab.

3. Direct Package Project

1. Click “Open Package Project”.
2. If the scene contains objects, choose whether to clear or keep them.
3. The add-on loads LOD0 reference models. For a multi-Model object, switch between model groups in the panel.
4. Move, rotate, delete, or add slots. Shift+D on an existing slot creates a new slot. Use “Change Type” to change an existing slot's type/size without changing its position, rotation, or RIG usage; unsafe references block writing.
5. Click “Check and Write Current Package” at the bottom.
6. Review affected Models, additions, updates, deletions, existing slots retyped, final RIG counts, and output mode before confirming.

4. Regular Blend Workflow

1. Open the furniture Blend. If it has an Armature, scan supported slot bones.
2. Add and arrange slots with the slot library, presets, and array tools.
3. Choose the target Package and Model at the bottom of the panel.
4. Choose one mode:
   - Add Only: keep existing Package slots and skip exact duplicates.
   - Replace Supported Types: replace supported slots only. FX, transformBone, and unrecognized RIG entries remain unchanged.

5. Important Rules

- Same type and size: a new slot inherits the selected slot's position and rotation.
- Different type or size: it inherits position only and resets rotation.
- No valid selection: it reuses the last manually added slot of the same definition, or starts at the world origin.
- Unselected slots use 50% opacity; selected slots use 100%. A boundary is shown in exact Top View.
- Presets save supported slots, positions, and rotations only. Furniture and Package bindings are excluded.
- Each independent RIG has a limit of 180. Model groups sharing one RIG share the same limit.

6. Safe Output

- Overwrite mode creates a timestamped backup in S4S_Slot_Backups.
- Save As mode writes to S4S_Slot_Output without overwriting the original.
- If another program modifies the Package during editing, the add-on blocks writing from the outdated project state.

7. Common Issues

- Slot colors are not visible: switch the 3D View to Solid mode.
- Write is unavailable: check that slots exist, the Package is valid, and RIG usage does not exceed 180.
- Multi-Model preset cannot be applied: the target Package must have the same Model count as the preset.
- No slots were added: exact duplicates may have been skipped; open Latest Check Results.
