# HappyBumsPlus — Wearable Diaper System for OpenSim (Wetting + Messing)
## Version 4.3

---

## What is HappyBumsPlus?

HappyBumsPlus is a wearable attachment for OpenSim that simulates diaper/incontinence
behaviour including both wetting and messing. It tracks separate wetness and mess states,
supports automatic wetting and messing on independent timers, provides access control
for caregivers and owners, and optionally integrates with a web-based remote control panel.

HappyBumsPlus is an extended version of HappyBums. It is designed to serve a wide range
of roleplay communities — including adult daycare, age regression, caregiver/dependent,
and medical roleplay. It is not inherently a sexual product; its appropriateness depends
entirely on how individual users and communities choose to use it.

**Note:** Messing content can be a sensitive topic for some people. HappyBumsPlus is
provided as a separate product from HappyBums precisely so that users can choose which
version suits their community and comfort level.

---

## What's in the box

The HappyBumsPlus attachment contains three scripts:

- **[HappyBumsPlus] Core** — menus, state management, timers, RLV
- **[HappyBumsPlus] Persistence** — saves all state to prim descriptions (hypergrid-safe)
- **[HappyBumsPlus] WebRelay** — optional web panel integration

There is also a separate optional wearable:

- **[HappyBums] HoverText** — displays floating text above the wearer showing their
  current wetness and mess state. Wear on the skull attachment point.
  (This is the same HoverText script as the standard version — it auto-detects Plus.)

---

## Getting started

1. Attach the HappyBumsPlus HUD to any attachment point.
2. Touch the HUD to open the main menu.
3. Use **Settings → RLV** to add owners/caregivers if desired.
4. Use **Settings → General → Website URL** to connect to the web panel if desired.

---

## Wetness states

| Level | Default name |
|-------|--------------|
| 0     | Dry          |
| 1     | Damp         |
| 2     | Wet          |
| 3     | Soaking      |
| 4     | Leaking      |

---

## Mess states

| Level | Default name |
|-------|--------------|
| 0     | Clean        |
| 1     | Soiled       |
| 2     | Messy        |
| 3     | Blowout      |

A **Blowout** triggers a special announce (mirroring the Leaking announce for wetness).

Both sets of state names are fully customisable via **Settings → Identity**.

---

## Main menu

The main menu adapts based on who is touching:

- **Check Status** — shows current wetness and mess state
- **Change Diaper** — change (subject to change lock settings)
- **Wet** — manually apply one wetness increment (owner/RLV owner)
- **Mess** — manually apply one mess increment (owner/RLV owner)
- **Lock / Unlock Changes** — control whether changes are permitted
- **Lock / Unlock HUD** — RLV lock the attachment on the wearer (RLV owners)
- **SAFEWORD** — immediately releases all RLV locks and resets both wetness and mess to 0
- **Settings** — access all configuration submenus

---

## Settings overview

### Announce
Controls how and where state-change messages are broadcast:
- **Full Announce** — triggered at Soaking/Leaking (wet) or Blowout (mess)
- **Leak Announce** — triggered specifically at Leaking/Blowout
- **Change Announce** — triggered when the diaper is changed
- **Notify Wearer** — whether the wearer receives IMs on state changes
- **Min Maturity** — suppresses public announces below a region's maturity rating

Each announce target: Private IM only, Local Chat, or Everyone.

### Access
- Enable/disable touch-to-open-menu
- Open or Owner-Only access mode
- Whitelist and blacklist management (up to 12 UUIDs each)
- Custom command channel and command prefix for text commands

### Identity
- **Owner Title** — what the wearer calls their caregiver (e.g. Mummy, Daddy, Nurse)
- **State Names** — customise the five wetness level labels
- **Mess Names** — customise the four mess state labels

### General
- **Auto-wet** — interval (in minutes) for automatic wetting; 0 = disabled
- **Auto-mess** — interval (in minutes) for automatic messing; 0 = disabled
- **Web Interval** — how often to send a heartbeat to the web panel
- **Website URL** — the URL of your HappyBums web panel installation
- **New UUID** — regenerate the HUD's unique ID
- **Reset Defaults** — restore all settings to defaults

### RLV
Manages RLV (Restrained Love Viewer) integration:
- Add/remove RLV owners (up to 6) — these people can lock the HUD on the wearer
- Set safeword and safeword channel
- Set change limits, minimum wetness before a change is allowed, and minimum mess before a change is allowed
- Either the wet threshold OR the mess threshold being met is sufficient to allow a change
- Notify owners when the wearer logs in or attaches
- Hover Text submenu — control the optional floating text display
- Reset website password for an owner

---

## Change lock and thresholds

Change permission uses an **either/or** rule for the two thresholds:

- If wetness >= Min Change State **OR** mess >= Min Mess State → change is allowed
- RLV owners can always change regardless of thresholds

---

## Access control

By default, anyone can touch the HUD and offer a change. You can restrict this:

- **Owner Only mode** — only the wearer's owner and RLV owners can interact
- **Whitelist** — only listed UUIDs can interact (plus owner/RLV owners)
- **Blacklist** — listed UUIDs are always blocked regardless of other settings
- **Change Lock** — allow only wearer+owner, or owner only

---

## RLV integration

If you use an RLV-capable viewer (such as Firestorm with RLV enabled):

- RLV owners can lock the attachment so the wearer cannot remove it
- The SAFEWORD button always releases all locks and resets wetness + mess to 0
- RLV owners can set change limits and minimum state thresholds

RLV is completely optional. HappyBumsPlus works fully without RLV — lock features simply have no effect.

---

## Web panel

HappyBumsPlus works with the same `happybums.php` web panel as the standard version.
The panel automatically detects that HappyBumsPlus is in use and shows the additional
Mess Status display and controls (Mess button, Auto-mess interval, Mess Names setting).

Features:
- View current wetness and mess state, region, and last-seen time
- Remotely wet, mess, change, lock/unlock
- Set auto-wet and auto-mess intervals
- Set announce settings, owner title, state names, and mess names
- Send an in-world IM to the wearer from the browser

---

## HoverText wearable

The HoverText attachment works with both HappyBums and HappyBumsPlus. When worn with
HappyBumsPlus, it automatically shows both the wetness and mess state:

- **Both clean and dry:** `[Name]'s diaper is clean and dry`
- **One or both soiled:** `[Name]'s diaper is [wet state] and [mess state]`

The text colour reflects whichever state is worse.

Wear on the **skull** attachment point. Adjust height via **Settings → RLV → Hover Text**.

---

## Status display format

When checking status, the HUD shows combined wording:

- `[Name]'s diaper is clean and dry` — immediately after a fresh change
- `[Name]'s diaper is Wet and Soiled` — combined wet + mess description

---

## Hypergrid compatibility

HappyBumsPlus stores all state in prim descriptions, making it fully hypergrid-safe.
State (including mess) is preserved when travelling between grids.

---

## Lockout recovery

If the HUD becomes locked and you cannot access the menu:

1. Edit the root prim of the attachment.
2. Find the Description field — it will contain something like `w=2,cl=1,rl=1,m=1,...,t=0`
3. Change `t=0` to `t=1`
4. Save and reset the scripts.

---

## Credits

HappyBumsPlus was developed for OpenSim. Scripts are LSL (Linden Scripting Language).