How to get AVsitterPlus

AVsitterPlus can be freely obtained from GitHub and imported into Second Life by following our import guide.

Tip: If you would prefer a packaged version of the latest release, and to receive in-world updates of future releases, visit the SL Marketplace. Proceeds from marketplace sales are shared with open-source contributors and help support continued development.

Inside the AVsitterPlus Package

The main AVsitterPlus package contains:

• AVP_sitA & AVP_sitB scripts

  The main scripts that must always be used in a pair (A+B), one pair for each avatar to sit. Each pair will define a SITTER.

• AVP_adjuster script & AVP_helper object

  These are setup items that allow the default pose positions to be adjusted.

• AVP_Positions notecard

  AVsitterPlus data needs to be saved in an AVP_Positions notecard. The notecard provided is intentionally empty.

• Utilities [BOX]

  The Utilities [BOX] contains the Utilities.

• Plugins [BOX]

  The Plugins [BOX] contains scripts that provide special functionality, along with examples. Example items are provided for each script.

Note: AVsitterPlus Examples are in development. The AVsitter Examples, available on the AVsitter SL Marketplace, contains over 40 example items that demonstrate the use of the system. The AVsitter Examples are equally applicable to AVsitterPlus. However, the AVsitter marketplace item is priced at L$2,999.

Requirements

There are some basic requirements to use AVsitterPlus:

• You will need to have a beginner's knowledge of building in Second Life.
• You will need to purchase animation files from animation stores in SL or learn to create them yourself.

Setup

Basic Prim Setup

The most basic setup is a prim that seats one avatar.

1. Drop the following into an empty prim in your furniture:
   • AVP_sitA + AVP_sitB scripts
   • AVP_adjuster script
   • AVP_helper object
   • AVP_Positions notecard
   • The animation files you plan to use
   Note: One pair of AVP_sit (A+B) scripts will mean the prim has one SITTER.
2. Sit on your furniture, and the menu will appear (if you lose the menu just touch your furniture again to get the menu back).
3. Choose [ADJUST] then [HELPER] from the menu, and the AVP_helper stick will rez.
4. Choose [NEW] from the menu, then choose [POSE] to create a singles pose.
5. After creating a pose, adjust its position by moving the helper stick with the SL building tools until your avatar is in the correct position. Click [SAVE] for each pose you create before moving on to the next.
6. When you have finished saving all your poses, click [DUMP] to output your settings into chat.
   Note: If you use a translator, turn it off before pressing [DUMP].
7. Copy-paste the [DUMP] result into your AVP_Positions notecard, replacing the contents of the notecard.
   Note: A web link is now given as a link at the end of the settings [DUMP], which is more reliable than copying from SL chat.
8. If required, you can rez the [HELPER] again and add more poses.
9. To add poses to other prims in your object, simply repeat the process.

Important: When you [DUMP] you’ll see the diamond character (♦) on every line. All text on a notecard line before the diamond is ignored by the script. This allows you to copy-paste chat output directly into your notecard without having to remove the timestamp from every line. If you remove the timestamps from your notecard then you can safely remove the diamonds.

Tip: Once setup is complete, you can (optionally) remove the AVP_helper and AVP_adjuster from your furniture. Leaving them in will allow the next owner to modify and [SAVE] the default pose positions (although they will not have access to [DUMP] or [NEW] unless they are an AVsitterPlus owner).

Basic Setup Video

Tip: If English is not your language, the videos have captions for automatic translation.

Couples Prim Setup

Setup of a prim for multiple avatars is the same as for Basic Prim Setup, with a few additions:

1. Your object must have a prim count equal to or greater than the number of avatars you plan on sitting.
2. You will need to drop one pair of AVP_sit (A+B) scripts into the prim for each avatar you want to sit. i.e. For 2 sitters you'll need 2 pairs of AVP_sit (A+B) scripts.
   Note: SL should automatically name your scripts sequentially when you drop them in together. Please make sure it does this correctly, as the names must be sequential. i.e. AVP_sitA, AVP_sitA 1, AVP_sitB, AVP_sitB 1
3. In the [NEW] menu, choosing [POSE] will create a singles pose and choosing [SYNC] will create a couples pose.
   Note: Choosing [POSE] will add a singles POSE only to the menu of the SITTER you are on. Press [SWAP] first if you need to move to a different SITTER’s menu before adding the pose. The active SITTER # is listed in the menu.
   Note: Choosing [SYNC] will add a SYNC pose to the menu of multiple SITTERs (e.g. SITTER 0 and SITTER 1).
   Important: Singles poses should be positioned so that they do not overlap the positions set for other sitters. e.g. SITTER 0 poses on left-hand side of the furniture, and SITTER 1 on right-hand side.
   Important: The first pose in each SITTER is the default pose for the seat. Even in couples furniture, you should usually make the first pose in each SITTER’s menu a singles POSE.

Couples Setup Video

Tip: If English is not your language, the videos have captions for automatic translation.

Submenus

To create a submenu…

1. In the [NEW] menu, choose [SUBMENU]. This will create a submenu only in the menu of the SITTER you are on.
2. Navigate to your submenu and then create new [POSE], [SYNC], or [SUBMENU] inside the submenu.

Note: [SUBMENU] will only add to the menu of the SITTER you are on. If want to have the same submenu in another SITTER’s menu, you will need to press [SWAP] to move to the other SITTER and create the submenu there too.

Important: If adding a [SYNC] pose, the pose will be added to whichever submenu was last selected. This applies separately to each SITTER’s menu. You will need to press [SWAP] to move to the other SITTER and create/select the submenu there too.

Important: Adding poses to submenus via the [NEW] menu is for beginners. You can create, re-order, rename, delete submenus by learning the TOMENU and MENU commands covered in the Notecard Section.

Camera

To save a camera position…

1. In the [NEW] menu, choose [CAMERA] then [SAVE]. This will save your camera view for all sitters in the prim.
2. To remove all camera settings from the object, choose [CAMERA] then [CLEAR].
3. Changes to camera settings will take effect the next time you sit.

Note: The camera setting is a prim property and does not require anything to be placed in the AVP_Positions notecard.

Warning: For camera settings in multiple prims, be aware of JIRA BUG-5494.

Note: If you need a different camera position for each pose, see information for the AVP_camera script instead.

Chat Commands

The following chat commands can be typed into local chat while the AVP_adjuster and AVP_helper are in the furniture:

• /5 helper - rezzes the helpers (alternate to using menu).
• /5 cleanup - deletes the AVP_adjuster & AVP_helper from the prim.
• /5 <avatar uuid> - moves the helper into the exact position of another avatar. Useful for copying positions from poseballs.
• /5 targets - briefly shows the SitTargets in hovertext.

Making Corrections

If you do not get things right the first time, you can always make corrections or additions:

• To change the position of a pose, or to add new poses, you can always select [HELPER] again, position the pose, and [SAVE]. Remember to [DUMP] your settings again and save them to the AVP_Positions notecard after making any changes.
• If you want to rename or change the order of any menu items you can manually edit the AVP_Positions notecard.
• To delete a pose, you must manually remove the lines from the the AVP_Positions notecard.
• As with all building in SL, you should take a backup of your work regularly to avoid losing progress.

Advanced Setup

The [NEW] menu described on this page is a great way to start using AVsitterPlus, however you will have much more control when you learn to edit the notecard manually. After you can follow the tutorials on this page you should then learn the format of the AVP_Positions notecard and learn about the utility scripts. Advanced users can then consider custom scripting or one of the available plugins.

Multiple Setups

It is possible to have any mix of singles & couples setups in different prims of the same furniture, however you must follow the instructions given in the SitTargets section.

Setups for 3+ Avatars

Setups in one prim for 3+ avatars is the same as for couples setup but needs to include more pairs of AVP_sit (A+B) scripts. The [NEW] menu will allow you to add a SYNC pose for multiple SITTERs but you should also learn to add/edit poses manually in the notecard.

Note: If your furniture does not include SYNC poses you could instead set each avatar’s poses in separate prims. e.g. a table with 4 chairs around would usually be best with a singles setup in each chair, rather than 4 SITTERs in one.

Warning: There is no set limit but it’s not recommended to have more than 6 SITTERs in the same prim.

Animation Sequences

AVsitterPlus provides two ways to do sequences: the AVP_sequence™ script and the “built-in” sequence method. Read about both and use the method most appropriate for your situation.

Sounds and Songs

Playing sound files is achieved with the AVP_sequence™ script (includes playing a single sound with a pose, or a complete song).

Migration from AVsitter

An existing AVsitter deployment can easily migrate to AVsitterPlus by replacing the AVsitter scripts with the corresponding AVsitterPlus scripts and renaming the [AV]pos notecard to AVP_Positions. Each piece of furniture that has previously been configured with AVsitter must be edited, the scripts replaced, and the notecard(s) renamed. A migration tool is in development.

Script Replacement Mapping

In order to comply with the AVsitter trademark restrictions, AVsitterPlus has not only been renamed from AVsitter but all [AV]* scripts, plugins, objects, and utilities have been renamed. Renaming generally conforms to the pattern of replacement [AV] -> AVP_. For example, the AVsitter script [AV]sitA has been renamed to AVP_sitA in AVsitterPlus.

The mapping between AVsitter names and AVsitterPlus names is as follows:

AVsitter	AVsitterPlus
[AV]pos	AVP_Positions
[AV]adjuster	AVP_adjuster
[AV]helper	AVP_helper
[AV]sitA	AVP_sitA
[AV]sitB	AVP_sitB
[AV]select	AVP_select
[AV]root-security	AVP_root-security
[AV]camera	AVP_camera
[AV]faces	AVP_faces
[AV]menu	AVP_menu
[AV]object	AVP_object
[AV]prop	AVP_prop
[AV]sequence	AVP_sequence
[AV]sequence_settings	AVP_sequence_settings
[AV]LockGuard	AVP_LockGuard
[AV]LockGuard-object	AVP_LockGuard-object
[AV]root-control	AVP_root-control
[AV]root-RLV	AVP_root-RLV
[AV]root-RLV-extra	AVP_root-RLV-extra
[AV]Xcite!	AVP_Xcite
[AV]Xcite_settings	AVP_Xcite_settings
AVhipfix	AVP_hipfix
AVpos-generator	pos-generator
Not Included	AVP_LockMeister
Not Included	AVP_favs
Not Included	PMAC-Converter

If not listed in the mapping table the name remains the same. Existing preconfigured notecards can simply be renamed, preserving their contents. Existing AVsitter scripts must be replaced with their AVsitterPlus counterpart.