====== Successor to ForceUndress ======

{{:wiki:undressify.png?400|}}

This is the successor to ''ForceUndress''.

After a very unfortunate event, the system had to be rewritten from scratch. As a result, the creator has changed.

The code is entirely new and much leaner. Some functions were deliberately left out, while better ones were added.

**Key Changes:**
  * ❌A separate database is no longer required – no database.
  * ❌All old data, objects, and scripts are lost forever.

**Advantages:**
  * ✅ Keep your complexity low by avoiding transparent body parts.
  * 🎯 No need to search through your inventory to change clothing layers.
  * 🚀 Faster, cleaner, and more intuitive experience overall.

**Feedback & Support:**
If you discover a bug or encounter a problem, please report it via Discord (online).  
Feature requests are also welcome through the same channel.

**Conclusion:**  
A fresh start was necessary – and it comes with smarter design and improved usability.

===== How to Create the Avatar Folder =====

**!! NEVER KEEP THE TOOL WITHIN YOUR `~undressify` FOLDER !!**

Doing so will cause the tool to be detached when you change avatars.  
⚠️ I take no responsibility if the HUD fails to work with other RLV tools.

You must create a basic folder structure as explained below.  
This structure is essential for Undressify to function properly.

**Required Folder Structure:**

📁 Avatar Folder:
  * `#RLV/~undressify/av/youravatarname`

Place your naked avatar into this folder.  
🚫 **WITHOUT TESTICLES!** Unless you *really* want to carry scriptbombs.  
You can have multiple avatar folders.  
Load an avatar using the **Avatar** button!

---

===== 🧥 Version 1 – One outfit folder for all avatars =====
Create the following structure:
<code>
#RLV/~undressify/of/
└── nameofyouroutfit/
    ├── top_1
    ├── pants_1
    ├── top_2
    ├── pants_2
    ├── top_3
    ├── pants_3
    └── top_0 / pants_0 (optional)
 </code>



===== 🧥 Version 2 – One Outfit Folder per Avatar =====

🧥 Optional Setup:  
You can organize outfits per avatar by enabling **avatar-specific mode** (`avspecific`).

**Folder Structure Example:**

<code>
#RLV/~undressify/of_avatarname/
└── nameofyouroutfit/
    ├── top_1
    ├── pants_1
    ├── top_2
    ├── pants_2
    ├── top_3
    ├── pants_3
    └── top_0 / pants_0 (optional)
</code>

===== Folder Layer Meanings =====

📌 Each folder suffix defines how the clothing behaves during undressing.  
Refer to the table below for clarity:

^ Folder Suffix ^ Meaning ^ Notes ^
| `_1` | Top layer | Visible clothing |
| `_2` | Underwear or secondary layer | Optional |
| `_3` | Naked layer or extras | Optional, requires `_2` to be present |
| `_0` | Hidden layer | Inaccessible to others (e.g. tattoos or outfit-specific details) |

You can create multiple outfit folders to suit different styles or avatars.

**How to Use:**
  * Load an outfit using the **Outfits** button.
  * The **Clothing** button will appear next.
  * 👆 Click the **Clothing** button to preview how your clothing will be undressed.
  * You can now click your **belly** or **lower back** to open the menu and load your avatar, outfit, etc.
  * 🎛 Go to the main menu and click on **"outfit"** to begin.

===== Addons & AvAddons =====

🎯 **Addons**  
Addons are items you'd like to load with **every avatar and outfit** — such as HUDs, toys, or utility tools.

📁 Folder Structure:  
<code>#RLV/~undressify/addon/category/item</code>

Use categories to organize your items (e.g. <code>HUDs</code>, <code>Accessories</code>, <code>Scripts</code>).  
These items are loaded globally, no matter which avatar or outfit is selected.

❗ **Important:**  
None of these folders are created automatically. You must **create them manually** before placing items inside.

---

🧬 **AvAddons**  
AvAddons are items you'd like to load with your **current avatar and outfit only** — perfect for avatar-specific HUDs, toys, or gear.

📁 Folder Structure:  
<code>#RLV/~undressify/av_addons/avatarname/category/item</code>

🔄 **Starting with version 1.63:**
  * If you select a different subfolder within the same category, other items in that category will be automatically removed.
  * To **hide** any addon folder from the menu, simply add a <code>*</code> at the end of the folder name.

🛠 **Managing Addons:**
Use the **Options** menu to activate or deactivate Addons and AvAddons for other users.

✅ Example:
  * Global HUD: <code>#RLV/~undressify/addon/HUDs/gestureHUD</code>  
  * Avatar-specific toy: <code>#RLV/~undressify/av_addons/avatarname/Toys/bubblewand</code>

🔧 **Note:**  
AvAddon folders are **not created automatically** either. You need to create them manually to use them.

===== Example Folder Layout =====

This is a complete example of how to structure your Undressify outfit folders.

<code>
#RLV/
└── ~undressify/
    ├── addon/
    │   ├── HUDs/
    │   │   ├── gestureHUD
    │   │   └── AOcontroller
    │   ├── Accessories/
    │   │   ├── smartGlasses
    │   │   └── wristwatch
    │   └── Scripts/
    │       └── autoSit
    │
    ├── av_addons/
    │   ├── Luna/
    │   │   ├── Toys/
    │   │   │   ├── bubblewand
    │   │   │   └── leash
    │   │   ├── HUDs/
    │   │   │   └── lunaHUD
    │   │   └── Accessories/
    │   │       └── collar
    │   ├── Rex/
    │   │   ├── Gear/
    │   │   │   ├── combatVest
    │   │   │   └── scanner
    │   │   └── HUDs/
    │   │       └── rexHUD
    │
    ├── av/
    │   ├── Luna
    │   └── Rex
    │
    └── of/
        └── CasualLook/
            ├── top_1
            ├── pants_1
            ├── top_2
            ├── pants_2
            ├── top_3
            ├── pants_3
            ├── base_0
            └── stuff_0_0.100   ← optional item with hover height control
</code>

❗ **Note:** None of these folders are created automatically. You must create them manually before placing items inside.

🧩 **Tips:**
- The folder under `of/` is your outfit name (e.g. `CasualLook`)
- Items use suffixes like `_1`, `_2`, `_3` to define layer priority
- Items with `_0` are optional base layers
- You can append `_0.100`, `_0.050`, etc. to an item name to control avatar hover height

===== Sounds & Animations =====

🎵 **Sounds**  
Sounds correspond to the folder names.  
If you have a folder named <code>top_1</code>, the sound played will be <code>top</code>.  
You can place your own sound files inside the object to customize the experience.

🎬 **Animations**  
Animations follow the same logic:  
A folder named <code>pants_2</code> will trigger the animation named <code>pants</code>.

---

===== Hoverheight Control =====

📏 To automatically adjust your avatar's hover height, include a folder like:

<code>stuff_0_0.100</code>

- <code>_0</code> means the item won't appear in the dialog.
- <code>_0.100</code> sets your hover height to **100mm above ground**.
- Activate it via: <code>Options > Hoverheight</code>

🪑 If you sit on an object or the ground, your hover height will reset to 0.  
This helps avoid manually adjusting poses or animations.

---

===== Plugins =====

🕒 **Redress Timer**  
Automatically redresses you once no one is within a specified range, after a variable delay.

🎲 **Randomizer**  
Selects a random outfit every xx seconds.

🚶 **Follow**  
Lets you pick an avatar to follow automatically.

---

===== Tips & Tricks =====

🧵 If you change textures via a HUD (e.g. color or material changes),  
detach the item manually and reattach it after the change.  
Second Life may ignore HUD-based changes if the item is removed via RLV.

🔊 You can place your own sounds inside the object to override default ones.  
Just match the sound name to the folder prefix (e.g. <code>top</code> for <code>top_1</code>).

===== Undressify Changelog =====

🛠️ **Latest Updates & Changes**

==== Version 1.84 – 24. AUG 2025 ====

**🔄 New Functions**

  * ✅ New option  undress for sitters only

**🧩 Menu Adjustments**

  * ✅ The **Redress** function has been removed from the external menu.
  * ✅ All **Access** functions have been moved to the correct internal menu for better usability.

**✨ New Plugin: Create**
  * Create got a new menu text for the smurfs
---

''This changelog reflects the most recent updates to Undressify. Older versions and legacy features may no longer be supported.''