PonyHUD

Description

When attached, the PonyHUD will appear as a small square with a floating text that looks like this:

The "READY" text means the PonyHUD has finished reading its configuration, and ready to receive commands from the GroomHUD. The text will change when a GroomHUD successfully connects to the PonyHUD.

The PonyHUD is resizable via the Edit menu, so ponies & mares can set the size to their liking.

Setting Up

Access List

Inside the PonyHUD, there are two Notecards:

• PonyHUDConfig -- general configuration of the PonyHUD. This notecard is NOT editable.

• BlockList -- may contain a list of Avatar/Group UUIDs, one per line. This notecard IS editable.

If a person's Avatar UUID or Active Group UUID is found in BlockList, then they will not be able to connect to the Pony HUD, even if their Avatar / Active Group UUID is expressly allowed in PonyHUDConfig!

You might want to edit the BlockList if you think there's a griefer, but please do it sparingly. Remember the main rule of BOS: No Drama.

DO NOT DELETE THE NOTECARDS! DOING SO WILL BREAK THE PONY HUD!

"Outfits Folder"

After setting up the Access List, you need to set up the Outfits Folders. Follow the steps below, and please note that all folder names are case-sensitive!

1. Under the #RLV folder, create a folder named ~BOS

2. Under the ~BOS folder, create a folder named outfits_v1

3. Under the outfits_v1 folder, create three folders named !MCC, !MCN and !MCW, and optionally create other outfit folders

The folders !MCC, !MCN and !MCW are mandatory. They have to exist, with those exact names. Other folders are optional.

!MCC contains the outfit for Mainland Carting Cold-weather,
!MCW contains the outfit for Mainland Carting Warm-weather
!MCN contains the outfit for Mainland Carting Naked,

If you create other (optional) folders beside the mandatory ones, make sure that The folder name (1) is short, 10 characters or less; and (2) does NOT contain any spaces, commas, colons, semicolons, or pipe sign | (emojis are okay)

The recommended outfit folders to create (aside the mandatory ones) are:

• ColdWear -- contains pieces of clothing items suitable for roleplaying in cold weather

• WarmWear -- contains pieces of clothing items suitable for roleplaying in warm weather

• NoTail -- removes the pony tail assembly

• NoBoots -- removes the pony hoof boot assembly

• Cloak -- covers pony in a cloak that hides the restraints

• GTFO!Hud -- containing the link to the GTFO! HUD (so, usually no visible change on the pony itself)

(You can prefix numbers in front of the outfit folders' names so they will sort nicely. For example: 1ColdWear, 2WarmWear, 3Cloak, and so on.)

For each outfit folder, create the following two subfolders:

• yes -- this will contain links to items

• no -- this will contain links to items

The subfolders yes and no must be in all lowercase! Do NOT use any uppercase letters!

When all folders have been set up, they will look something like this:

Note that not all folders have both the /yes and /no subfolders, as will be explained in the next section.

How it works

When the Groom HUD tells the Pony HUD to "don" an outfit, the Pony HUD will:

1. Detach all linked items from the no folder of an outfit folder

2. Attach all linked items from the yes folder of an outfit folder

When the Groom HUD tells the Pony HUD to "doff" an outfit, the reverse will happen:

1. Detach all linked items from the yes folder

2. Attach all linked items from the no folder

If any of the /no or /yes subfolders are missing or empty, then the step for that subfolder will be skipped.

Note the order of operation! The Outfit System always do detaches first, then attaches. This might affect scripted items that trigger things to happen when it gets attached/detached.

The Outfit System does NOT lock the newly-attached items. If the pony is unlocked, the pony can detach items individually without needing to
use the Outfit System.
Also, the Outfit System does NOT perform a periodic 'enforcement' of the outfit; if something other than the Outfit System changes the pony's
outfit, the groom will need to manually don/doff the correct outfit using the Groom HUD.

Example

Let's say I am going to configure my "Mainland Carting Cold" (!MCC) outfit.

This means that when I 'don' an outfit, I will have to wear a 'thermal suit'. I go find my thermal suit in my inventory, in my case it is a "Maitreya Underwear Layer" with ABV Body Suit pre-applied. I right click on the item and choose Copy

then I go to the ~BOS/outfits_v1/!MCC/yes folder, right-click on the folder, and choose Paste as link

When carting, I also usually wear my "Border Detector HUD", so I do the same thing:

Those done, next I want to minimize my script load by detaching unnecessary items. The "Deciduan HUD" is a heavy attachment, but since I'm wearing it at the moment, I cannot copy it:

So I have to detach it first, and then do the "Copy + Paste as Link" as before.

Then I do the same with my other things unnecessary for carting:

• Sensual Dance HUD

• Petter attachments

• The V vagina

• Nipple piercing (because it clips with the body suit)

Now the !MCC folder looks like this:

Aaaand done! For the !MCC outfit folder, that is. Still some other folders to go...

• For the !MCW folder, I just copy the yes and no folders of !MCC then delete the body suit, pasting a link to a bikini instead.

• For the !MCN folder, I again copy the yes and no folders of !MCC and delete the body suit, but I don't paste a link to any body covering.

Then I set up the NoTails folder. Since it is meant to remove my buttplug tail assembly and not adding anything, I only create the no folder, so it looks like this:

I do the same for NoBoots folder:

I also created the GTFO!HUD folder so if the groom/trainer desires, I can participate in GTFO! runs:

And so on ...

Yes, it's a chore, but you only need to do this once. And as long as you're not changing how you look, you don't need to touch them again 😉

Interactions

If you click on the HUD, the HUD will tell you its version.

Pony AutoLock

One thing to note: As soon as a groom/trainer controls your Pony HUD, you will immediately be locked: The HUD becomes non-detachable, and you will lose access to Inventory. The only way to unlock yourself is by having a groom/trainer unlock the Pony HUD using their Groom HUD. (Or, of course, using a non-RLV viewer, but that's cheating 😛)

.

.

GroomHUD

Do NOT use the Ignore or X/Close Buttons!

When the GroomHUD shows a menu, do NOT use the Ignore or X (Close) button, at all!
If you need to exit the menu, use the provided [Exit] button!
This is due to limitation of LSL script: It cannot detect if you use the Ignore or X buttons.
If you used either of those two buttons, you will have to wait until the GroomHUD times out before functionality gets restored. Usually within 1 minute.

Description

The GroomHUD is a 4-button HUD used by grooms/trainers to control a pony's outfit.

When a button looks faded, that means the button is disabled for the moment.

Interactions

Button 1: Scan/Choose Pony

Before the groom/trainer can use the features of the GroomHUD, the groom/trainer needs to choose a pony.

The target pony needs to be in the same region AND within whispering distance

Click the button, and after 3 seconds a menu will pop up showing ponies that can be controlled.

After the groom/trainer choose a pony, the other buttons will be enabled, and the Choose Pony button will change (acquire a red targeting reticle) to indicate that the GroomHUD is connected to one PonyHUD.

Clicking the Choose Pony button while the PonyHUD is connected (the button has a red targeting reticle) will disconnect the GroomHUD from the Pony HUD, allowing the groom/trainer to control a different pony/mare, and at the same time allow the pony/mare to be controlled by a different groom/trainer.

If you idle for more than 10 minutes after connecting to a Pony HUD (that is, not issuing any commands such as Choose Outfit or Lock/Unlock), the GroomHUD will automatically disconnect from the PonyHUD to allow others to control the pony's outfit.

Button 2: Choose Outfit

When clicked, the GroomHUD will inquire to the PonyHUD on outfits that have been set up. After several seconds, a menu will pop up showing all available outfits, and their state. This button can only be used when a pony has been selected.

• A checkmark means the pony is fully donning that outfit

• A cross means the pony is not wearing any parts of that outfit

• A tilde means the pony is wearing some parts of that outfit

Clicking on an outfit without a checkmark will instruct the Pony HUD to 'don' that outfit; clicking on an outfit with a checkmark will instruct the PonyHUD to 'doff' that oufit (see "How it works" section earlier)

Button 3: Lock/Unlock

When the groom/trainer connects to a PonyHUD, the pony/mare will become locked (see the "AutoLock" section earlier). The button will glow red to indicate that the pony/mare is locked.

Clicking while it's red will tell the PonyHUD to become unlocked. Conversely, clicking while it's black will tell the PonyHUD to become locked again.

Unlocking is needed for instance:

• The pony/mare is going to get untacked, and thus should regain Inventory access

• The pony/mare needs to set up / modify her outfits folders (see the relevant sections earlier)

Any groom with GroomHUD can unlock a pony locked by other grooms, or conversely re-lock a pony unlocked by other grooms. Provided, of course, the groom connect to the pony's PonyHUD first.

Button 4: Others

When you click this button, you will see a menu pops up:

Force menu

This button is used to Force the pony to perform an action. Currently available actions:

• Stand -- forces pony to stand from wherever it has been sitting on

• Sit on Ground -- forces pony to sit on the ground

• Sit on Item -- forces pony to sit on a nearby object (within 2m from the pony)

Sit on Item may fail if the object does not have a "sit location" defined on the object.

Pose menu

This button is used to make the pony adopts a pose. When the pony enters the pose, the pony is also immobilized, so please remember to disable the pose afterwards!

Restrict menu

This button can add additional restrictions over the restrictions enforced by the "BOS Protocol for Animals", such as:

• MouseLook -- forces pony to enter MouseLook mode, which they cannot Esc out

.

.

Advanced Usage Examples

These serve as examples on what you can do. Let your imaginations be wild! 😁

Carting in the Nude

Have the pony set up the !MCN, ColdWear and WarmWear outfit folders.

In !MCN:

• yes contains links to items the pony wish to wear for carting (e.g., the "border detector" HUD). Do NOT add any link to clothing items!

• no contains links to items the pony wish to detach while carting (e.g., Deciduan HUD, or other 'heavy' scripts)

In ColdWear:

• yes contains links to, say, a "thermal suit".

• no contains links to, say, piercings that will clip through the "thermal suit", but no other

In WarmWear:

• yes contains links to, say, a bikini.

• no contains links to, say, piercings that will clip through the bikini, but no other

The procedure:

1. As you start carting from BOS (which will always be in an "M" region), don !MCN

2. When you enter a "G" region, don the ColdWear/WarmWear outfit accordingly

3. When you've left the "G" region, doff the ColdWear/WarmWear outfit accordingly

4. When the carting is finished and you're back at BOS, after unhitching the pony, doff the !MCN outfit

Of course, this requires constant vigilance on what region you & the pony(-ies) are entering, which may become quite exhausting. If you want to a more relaxed carting, just use either !MCC or !MCW outfits at start, and be done with it (don't forget to doff at end of carting!)

Bathing a Pony

The pony needs to set up the NoTail and NoBoots outfit folders.

In NoTail:

• yes should be empty

• no should contain the links to the pony's tail, pelvic harness, and other items that make up the "pony tail assembly" of the pony

In NoBoots:

• yes probably should be empty

• no should contain the links to the pony's boots, shin guard, and other items that make up the "pony hoof boots assembly" of the pony

Depending on the body / boots being used, you might need to put in something like an auto-alpha either in the yes or no subfolders of NoBoots.

For example, inside my shin guard, I have a Maitreya script that will perform auto-alpha: Hide the legs when worn, reshow the legs when taken off. So in my case, I don't have to put anything in the NoBoots/yes subfolder, and just put my boots + my shin guards in the NoBoots/no subfolder. YMMV, of course.

When you start bathing the pony you can then 'don' the NoBoots outfit (which will cause the pony to remove their boots), then when it's time to clean the pony's nether regions, 'don' the NoTail outfit. When these two are donned, the pony should be totally bottomless.