StraponPlus Plugin (FM69) - Summary for VaM Hub
==============================================

Overview
--------
StraponPlus is a fully upgraded and stabilized rewrite of the original vamtaco.Strapon plugin. 
It preserves the original functionality but fixes all major issues and introduces reliability, 
quality-of-life improvements, automatic clothing support, and safer scene behavior.

Key Improvements Over the Original Plugin
-----------------------------------------
1. **Single-Dildo System**
   - Prevents the multiple-dildo bug present in the original plugin.
   - Ensures that only ONE dildo atom exists at any time.
   - Automatically removes stray or duplicated dildo atoms.

2. **Reliable Enable / Disable Behavior**
   - Enabling always creates exactly one dildo and attaches it correctly.
   - Disabling completely removes the dildo from the scene.
   - Eliminates the issue of hidden leftover dildos causing duplicates.

3. **Automatic Loading of AmineKunai Belt Strapon**
   - Automatically activates the AmineKunai belt if it's installed (VAR or Custom folder).
   - Falls back to a default clothing item when not available.
   - No manual clothing prep needed.

4. **Stable and Accurate Attachment System**
   - Clean attachment to the pelvis with customizable offset sliders.
   - Fully compatible with character scaling.
   - Smooth, intuitive rotation controls (pitch, yaw, roll).

5. **Cleaner, Faster, More Reliable Code**
   - No compilation errors.
   - No ambiguous VaM API calls.
   - Better performance and scene stability.
   - Fully production ready.

How to Use the Plugin
---------------------
1. Add **StraponPlus.cs** to any Person atom:
   - Person → Plugins → Add Plugin → Choose StraponPlus.cs

2. Press **Enabled**.
   - A dildo atom will spawn and auto-attach to the pelvis.
   - The AmineKunai Belt Strapon clothing will auto-load if installed.

3. Adjust alignment if desired:
   - Offset Forward (Z)
   - Offset Up (Y)
   - Offset Side (X)
   - Pitch / Yaw / Roll

4. Use the quality-of-life tools:
   - Reset Offsets
   - Reset Rotation
   - Flip 180°
   - Rotate Yaw +90°

5. Disable the plugin to fully remove the dildo from the scene.
   - Safe to re-enable anytime without duplicates.

Compatibility
-------------
- Works with VaM 1.22.0.x.
- Supports both VAR and Custom/ installations of the AmineKunai belt.
- Stable in complex scenes.
- Works cleanly with save/load cycles and presets.

Author
------
FM69 — rewritten and improved for modern VaM usage.
