ACS Wardrobe

The ACS Wardrobe HUD and ACS Wardrobe Handle are RLV-based tools for helping wear and remove different outfits, shapes, wigs, and so on. Advantages include:

  • Avoid messing with the inventory panel
  • Define different types of things that can be replaced independently – for example, replacing your hair or purse shouldn’t take off your outfit; replacing your outfit shouldn’t take off your body parts or HUD items, and so on
  • Prevent accidentally attaching an entire folder of outfits
  • Allow adding or removing entire outfits, or piece by piece

The ACS Wardrobe HUD can be used only by you.

The ACS Wardrobe Handle is visible to others and can be used by them unless you disable it. You can also take the scripts from the ACS Wardrobe Handle and put them in another object attached anywhere on your body for a custom look.

Unlike most ACS products, the Wardrobe has nothing specifically to do with androids, dolls, or other constructs (though of course they may use it). If you use an ACS CCU or ArtCore, you do not need the Wardrobe, as the features of the Wardrobe come built into the CCU and ArtCore.

You can wear both the HUD and Handle simultaneously. However, there is usually no need, since you can use your own Handle unless RLV restrictons prevent your from touching your own attachments (in which case you probably shouldn’t be changing your clothes anyway).

Basic Setup

  • Be sure you are using an RLV-enabled viewer with RLV enabled. You do not need an RLV relay. (The ACS Wardrobe does not act as an RLV relay, but you are welcome to use any relay you like simultaneously.)
  • HUD ONLY: Attach the ACS Wardrobe HUD to your HUD. By default, it attaches to the lower left corner, but you can move it to wherever you like it.
  • HANDLE ONLY: Attach the ACS Wardrobe Handle to your body. By default, it attaches to your Avatar Center and hovers a little bit over your head, but you can attach it elsewhere if you like. You can also use the Edit tool to adjust the handle’s position if its default position is inconvenient (for example, if you are unusually tall or short).
  • The ACS Wardrobe HUD or Handle automatically RLV-locks itself to prevent accidental detachment. To detach it, click and hold on the Wardrobe icon until the Configuration menu appears, then choose “Detach.”
  • No additional configuration is necessary (though many options are available).

Usage

  • HUD: Click the ACS Wardrobe icon on your HUD.
  • HANDLE: Click the ACS Wardrobe Handle above your (or someone else’s) head. You must be within 4 meters of someone to use their Handle.
  • After a short pause, a list of folders appears. Some folder names may have “(partly worn)” orĀ  “(fully worn)” next to them, helping you identify the items the Wardrobe’s owner is currently wearing.
  • To enter a folder (so you can put on or remove its contents), click the numbered button corresponding to the folder name.
  • If there are << and >> buttons, you can use them to see more available folders. The [Put on], [Take off], and [Change to] buttons are always at the end of the list of subfolders.
  • Click the [Put on] button to attach and wear all contents of the folder and any subfolders it may contain (without removing any other items). If the [Put on] button does not appear, either everything in the folder is already being worn, or the whole folder cannot be put on. Try choosing a subfolder to put on.
  • Click the [Take off] button to detach and remove all contents of the folder and any subfolders it may contain (without affecting any other items). If the [Take off] button does not appear, nothing in the folder is being worn, or the whole folder cannot be taken off. Try choosing a subfolder to take off.
  • Click the [Change to] button to attach and wear all contents of the folder and any subfolders it may contain, removing any other items of the same type already being worn. If the [Change to] button does not appear, either everything in the folder is already being worn, or the whole folder cannot be put on. Try choosing a subfolder to put on.
  • Click the [Rescan] button if the menu you’re seeing has gotten out of sync with your actual outfit – for example, if items have been renamed, added, or deleted, or if lag caused something not to be fully attached or detached before the menu appeared.
  • HUD: The sound effects you hear as you move through the folders and change clothes are heard only by you, not those near you.
  • HANDLE: The sound effects are audible to the avatar being dressed and anyone nearby. If you change the clothing of someone other than yourself, anyone nearby will be able to see that you are doing it.

Configuration

To access configuration menu of your own ACS Wardrobe HUD or Handle, click and hold on it until the configuration menu appears (after about 3 seconds).

  • To prevent others from using your Wardrobe Handle: Click “Availability.” The Handle will shrink and darken. You can still use it to dress yourself, and you can still click-and-hold to return to the Configuration menu, but no one else will be able to use it.Depending on your play style, you may want to leave your handle disabled (or detached) most of the time, but enable (or attach) it when you are restrained, unconscious, or otherwise unable to prevent people from dressing or undressing you.
  • To turn sound effects off or back on: Click “Sound FX.” (On the HUD, only you hear the sound effects. On the Handle, everyone near you can hear them.)
  • To limit the Wardrobe to specific folders: Click Add Root. You’ll get a menu similar to the dressing menu, but instead of options like [Put On] and [Take Off], you’ll have a [Select] option. Navigate to a folder you want to appear when your wardrobe menu is first clicked, and click Select. Repeat to add additional root folders.
  • To remove a root folder: Click Remove Root. You’ll get a list of all of your current root folders. Choose the one you want to remove.
  • To turn the sound effects on and off: Click “Sound FX.”
  • To unlock your Wardrobe so it can be removed or edited, or lock it to prevent accidental detaching: Click “Lock/Unlock.” The Wardrobe automatically locks itself when you attach it.
  • To detach your Wardrobe: Click “Detach”
  • To turn off the “Dress me” text above your Wardrobe Handle: Click “Text on/off.” Hovertext will still be displayed briefly when someone dresses or undresses you.
  • To turn off the wardrobe image on your Wardrobe Handle: Click “Image on/off.” This is primarily of use if you are using a custom handle (see below).
  • To view debugging information, click Debug. You will have no need to do this unless JulieDoll asks you to do it to help her troubleshoot a problem.

Advanced Setup

  • To hide a folder completely: Make its name start with a period (“.”)
    • Example: #RLV/.UglyStuff cannot be attached, entered, or even seen.
  • To prevent adding a folder: Make its name end in one or more periods (“.” or “…”).
    • Example:
      • #RLV/Outfits… cannot be attached.
      • #RLV/Outfits…/Fancy… cannot be attached.
      • #RLV/Outfits…/Fancy…/Blue Dress can be attached.
  • To set up types of items so that “Change to” only removes some items, not everything you’re wearing (for example, when someone replaces your wig, your outfits aren’t removed):
    • Put all of the items of each type in subfolders of a folder whose name ends with a right angle bracket (“>”).
    • Example:
      • If you “Change to” #RLV/Outfits>/Fancy…/Blue Dress, everything inside #RLV/Outfits> is removed, then the Blue Dress is added. Everything outside
      • #RLV/Outfits> is left untouched.
      • If you replace #RLV/Wigs>/Ponytail, everything inside #RLV/Wigs> is removed, then the Ponytail is added. Nothing outside #RLV/Wigs> is touched.
  • To make your type names a little friendlier, give the type folder a name consisting of two parts separated by a colon. Before the colon should be the name of the folder (like Outfits or Wristwatches), and after the colon should be the name of what an individual item inside the folder is (like outfit or wristwatch), as follows:
    • #RLV/Outfits:outfit>
    • #RLV/Wristwatches:wristwatch>

Customizing the Wardrobe Handle

If you want to make a Wardrobe Handle that looks different from the one sold by ACS but works the same way, you can copy the scripts from the ACS Wardrobe Handle and put them in another attachment of your choosing. Doing do will disable the image used by the ACS Handle, but you can turn it back on if you want to.

Custom Effects (Advanced)

The ACS Wardrobe devices include a simple API that allows someone with a little scripting expertise to add custom effects when items are put on or removed. The Wardrobe sends link messages when attaching or removing a folder, as follows:

  • Attaching: llMessageLinked(LINK_THIS, 3084, folderName, avatarKey);
  • Detaching: llMessageLinked(LINK_THIS, 3085, folderName, avatarKey);

Where folderName is the name of the folder being attached or detached, and avatarKey is the UUID of the avatar who requested the change. So you can freely add a script that includes a link_message event that tests for the numbers 3084 and 3085, and does whatever you want – play particle effects, run animations, or whatever else you like.

ACS Wardrobe and Other ACS Products

We do not recommend the use of the ACS Wardrobe Handle with the ACS CCU or ACS ArtCore. The CCU and ArtCore come with their own handles that will tend to overlap with the ACS Wardrobe Handle. It will still work, but it probably won’t look good. We do plan to incorporate all the functionality of the Wardrobe Handle into the CCU and ArtCore Handles at some point.

We anticipate no difficulties in using the ACS Wardrobe HUD with a CCU or ArtCore.