Quick Start

AVsitter Plugin Toolkit

Check out the Changelog for the latest updates.

This guide focuses on the usage of the DevKit | AVsitter Plugin which, in addition to the Obsidian AVsitter Plugin that the Obsidian box contains, also comes with the reverse engineered Aeros LEGACY AVsitter Plugin scripts.

If you have no access to the DevKit or not interested in using the LEGACY scripts, you can switch to the Obsidian AVsitter Plugin Reference page.

Aeros LEGACY products are Aeros products created before 2025.

DO NOT BE OVERWHELMED - You have ONE path out of 4 to choose from. Instructions are comprehensive for each path.

■ PATH 1 — Aeros LEGACY way with Obsidian fallback compatibility

If you want to support the Aeros LEGACY products and let the Obsidian pick up those commands.

• This makes sense if you are familiar with the pre-2025 Aeros AVsitter plugin (LEGACY way).
• This also makes sense if you do not own the Obsidian.

The Obsidian reacts to commands coming from the pre-2025 Aeros AVsitter plugin. If your product works with the previous models, you may choose to leave things as is and focus on using the DevKit in your new products going forward.

• REMOVE any previous versions of Aeros LEGACY scripts from the furniture.

• DROP IN (REQUIRED):

  • */ aeros LEGACY / API / [VERSION]
  • */ aeros LEGACY / AVsitter / [VERSION]

• NOTECARD to enable editing:

  • */ aeros LEGACY / AVsitter / EditMode [ON]

• Follow the LEGACY instructions

  (we renamed the scripts and notecards, but the rest is the same)

The script will say when to add one or more of these:

*/ aeros LEGACY / AVsitter / Extra DB / [VERSION]

■ PATH 2 — Obsidian only (with or without .OBS animations)

If you want to support Obsidian, WITHOUT compatibility with Aeros LEGACY models:

• This makes sense for cases in which you specifically make stuff for Obsidian, for example if your animations contain Obsidian Bento bones keyframes. This path should also be used if you have split animations targeting the Obsidian bones, with the files saved as .OBS suffix, and you wish Aeros script to take care of the syncing between the body and the Obsidian animations.

• DROP IN (REQUIRED):
  • */ aeros / AVsitter v[VERSION] / sitter — this is REQUIRED and works for sitter 0

    If your furniture’s Aeros wearer can be sitter 1, etc., drop the same script again so it auto-renames to ... / sitter 1. Keep dropping in the original script for as more sitters as needed and then remove those with unnecessary sitter indexes, but DO NOT REMOVE the original / sitter script.

1. Sit on the furniture. Switch to the appropriate sitter.
2. Using the Obsidian PLAY HUD, tap STOP liquids button several times in succession UNTIL you see a menu.
3. Enable RECORDING.
4. Switch to a desired animation using AVsitter menu.
5. Adjust the angles and stage of hardness using the Obsidian PLAY HUD. Make sure to tap the Play HUD Arrow even if no change needs to be made to ensure consistent record to all the menu items, and observe notification in local chat. (Menu allows deletion, if needed).

After you are done and happy:

• OPTIONAL STEPS:
  1. Choose [DUMP ALL] from the menu (or drop in the / dump script, since v110).
  2. Create a new notecard named */ aeros / AVsitter and copy the output into it.
  3. Drop this notecard into the furniture.
  4. Make a backup copy of your notecard (it can be imported back into the prim’s memory using / import script later on). The import script recognizes the following notecard names:
     • ** Aeros AVsitter Plugin ** Data
     • */ aeros / AVsitter
     • */ aeros LEGACY / AVsitter / Data

■ PATH 3 — Obsidian + Aeros LEGACY (no .OBS animations or another sync script)

If you want to support Obsidian first and Aeros LEGACY products second and record angles and stages of hardness. You DO NOT wish to include separate animations, with .OBS suffix, that are specific to Obsidian Bento bones. (Same applies if you use another script to sync split animations; they require different animation naming)

• This makes sense if you own the Obsidian, you will have an option to record angles using Obsidian.

• REMOVE any previous versions of Aeros LEGACY scripts from the furniture.

• DROP IN (REQUIRED):

  • */ aeros LEGACY / API / [VERSION]
  • */ aeros LEGACY / AVsitter / [VERSION]

• NEXT - choose ONE of the two options below:

  This Path offers two options - you must choose either OPTION A or OPTION B

• — OPTION A — To record angles using Obsidian:

  • DROP IN (required for the duration of the recording):
    • */ aeros / AVsitter v[VERSION] / sitter — this is REQUIRED and works for sitter 0

      If your furniture’s Aeros wearer can be sitter 1, etc., drop the same script again so it auto-renames to ... / sitter 1. Keep dropping in the original script for as more sitters as needed and then remove those with unnecessary sitter indexes, but DO NOT REMOVE the original / sitter script.

  1. Sit on the furniture. Switch to the appropriate sitter.
  2. Using the Obsidian PLAY HUD, tap STOP liquids button several times in succession UNTIL you see a menu.
  3. Enable RECORDING.
  4. Switch to a desired animation using AVsitter menu.
  5. Adjust the angles and stage of hardness using the Obsidian PLAY HUD. Make sure to tap the Play HUD Arrow even if no change needs to be made to ensure consistent record to all the menu items, and observe notification in local chat. (Menu allows deletion, if needed).

  After you are done and happy:

  1. Choose [DUMP ALL] from the menu (or drop in the / dump script, since v110).
  2. Copy-paste the output into the notecard named */ aeros LEGACY / AVsitter / Data.
  3. Drop this notecard into the furniture.
  4. Observe that Aeros LEGACY script is importing data.

  If the script requests additional Extra DB script, add: */ aeros LEGACY / AVsitter / Extra DB / [VERSION]

  5. DELETE ALL scripts starting with */ aeros / AVsitter v[VERSION] / sitter.

• — OPTION B — To record angles using Aeros LEGACY:

  • Follow the LEGACY instructions

    (we renamed the scripts and notecards, but the rest is the same)

Outcome: Both Obsidian and Aeros LEGACY should now automatically replay angles and stages of hardness.

■ PATH 4 — Full support of Obsidian (with separate .OBS animations) + Aeros LEGACY

You want to support BOTH Obsidian and Aeros LEGACY products, and you HAVE animations that are specific to Obsidian Bento bones animations, and have separate animation files, with .OBS suffix. You want Aeros script to play them in sync and you are NOT using any other script that does the syncing.

• REMOVE any previous versions of Aeros LEGACY scripts from the furniture.

• DROP IN (REQUIRED):

  • */ aeros LEGACY / API / [VERSION]
  • */ aeros LEGACY / AVsitter / [VERSION]

• DROP IN (REQUIRED):

  • */ aeros / AVsitter v[VERSION] / sitter — this is REQUIRED and works for sitter 0

    If your furniture’s Aeros wearer can be sitter 1, etc., drop the same script again so it auto-renames to ... / sitter 1. Keep dropping in the original script for as more sitters as needed and then remove those with unnecessary sitter indexes, but DO NOT REMOVE the original / sitter script.

1. Sit on the furniture. Switch to the appropriate sitter.
2. Using the Obsidian PLAY HUD, tap STOP liquids button several times in succession UNTIL you see a menu.
3. Enable RECORDING.
4. Switch to a desired animation using AVsitter menu.
5. Adjust the angles and stage of hardness using the Obsidian PLAY HUD. Make sure to tap the Play HUD Arrow even if no change needs to be made to ensure consistent record to all the menu items, and observe notification in local chat. (Menu allows deletion, if needed).

After you are done and happy:

1. Choose [DUMP ALL] from the menu (or drop in the / dump script, since v110).
2. Copy-paste the content into the notecard named */ aeros LEGACY / AVsitter / Data.
3. Drop this notecard into the furniture.
4. Observe that Aeros LEGACY script is importing data.

If the script requests additional Extra DB script, add:

*/ aeros LEGACY / AVsitter / Extra DB / [VERSION]