Script: (Bento) Faces PRO AVsitter Plugin

Documentation ยท (Bento) Faces PRO Plugin for AVsitter 2

[Black Tulip] Script - BENTO Faces PRO - AVsitter Plugin and [Black Tulip] Script - BENTO Faces PRO + Animations - AVsitter Plugin in Marketplace.

Follow these directions carefully. Complete the Step by Step Guide in the first place and then go to the Advanced Setup section for a detailed explanation of all the features. There's a Troubleshooting section at the end. Before asking for help, check that your problem isn't one of the problems described in there.

License of Use: Click here to read the License of use.

What's included in your purchase

Check that your box contains the following assets:

  • [Black Tulip] Script - BENTO Faces BASIC - AVsitter Plugin (this is the basic script, boxed)
  • [Black Tulip] Faces PRO v1.0 - AVsitter Plugin
  • [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~
  • [Black Tulip] Rest Head (P0)
  • [Black Tulip] Reset Facial Expressions (P6)
  • [Black Tulip] SAMPLE Fireplace w.AVsitter 2
  • [Black Tulip] Proof Of Purchase - Faces PRO Plugin
  • [Black Tulip] Faces PRO - AVsitter Plugin ~DOC~
  • [Black Tulip] SAMPLE Fireplace w.AVsitter 2 - COMPLETE

If any of these is missing, contact Auryn Beorn for a replacement.

Features list

  • Bento facial expressions for Bento mesh heads are now possible in your items
  • Turn the facial expressions on/off
  • Notecard configuration to define your expressions and add extra ANIM lines

Step by Step Guide

Our step by step example consists of a fireplace with three poses for couples. One of them is a repeat to show one of the extra features of this script versus the basic version. This teaches us how to use the script, and how to use it when more than one avatar is involved (which might be the usual).

Rez the included [Black Tulip] SAMPLE Fireplace w.AVsitter 2 sample object. It's prepared with AVsitter 2 and, important, including the [AV]faces script. You need [AV]faces if you want to trigger the facial expressions in default avatars and have access to the [DUMP] function that outputs all the ANIM lines.

Drop the included animation [Black Tulip] Rest Head (P0). This is perhaps the most important step.

Open the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ configuration notecard and change the number next to maxSitters = to the total number of sitters of your engine.

Now let's observe the two blocks of face elements that it contains. They're separated visually on purpose, and the script expects them in that order.

The first block contains the list of system facial expressions and the name of the Bento animation that will be used on a mesh head, separated by the pipe character | . You can replace the supplied names with your own animations, or leave them as-is if you're using our Black Tulip Bento facial expressions set.

It is very important to leave all the lines with all the SYSTEM facial expressions. The script may not work correctly otherwise. It is also very important NOT TO CHANGE THE ORDER of the lines in this first block. Otherwise we're making it incompatible with one of AVsitter's [AV]faces features.

The second block of face lines is simply a list of other animations that we'll be using in our ANIM lines that do not correspond to any of the default. We must define them first here, and then we can use them in our ANIM lines by that same name.

The script will read both the AVpos notecard and the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ notecard for ANIM lines. Although the majority of the ANIM lines are in the AVpos notecard, the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ notecard can be used to launch Bento animations that don't have a system equivalent. They can be on the AVpos notecard too and [AV]faces will launch them - they simply won't have an effect in the default system avatar, only in the Bento heads.

If we choose to include ANIM lines in the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ notecard, we must write first which SITTER is the corresponding one. The provided sample notecard shows this.

Now we check the ANIM lines in the AVpos notecard and make the list of animations that we have to use:

  • express_laugh_emote: [Black Tulip] Faces - express_laugh_emote
  • express_toothsmile: [Black Tulip] Faces - express_toothsmile
  • express_bored_emote: [Black Tulip] Faces - express_bored_emote
  • express_disdain: [Black Tulip] Faces - express_disdain

(These animations are part of our Bento animations kit, which is sold apart - no transfer versions are included in the final sample to see the effect.)

We then check the ANIM lines in the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ configuration notecard and make the list of the remaining animations that we use:

  • [Black Tulip] Faces - open_mouth_anim #1
  • [Black Tulip] Faces - tongue_animation

(These animations are part of a store group gift - no transfer versions are included in the final sample to see the effect.)

We change permissions for next owner of the animations to either no copy/transfer or copy/no transfer, and after that, we drop them in the engine.

Then we drop the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ configuration notecard with all the data we need.

Now we have to answer to this question: How many avatars is our engine for?

In our example case, the engine is for TWO avatars. This means that we have to drop TWO copies of the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin script inside the engine. (Change permissions for next owner in inventory before dropping the script or it will self delete).

This script reads first from the [Black Tulip] Faces PRO v1.0 - AVsitter Plugin ~CFG~ notecard and then directly from the AVpos notecard. It notifies when it's done.

And we're ready to go :-)

You can find the finished sample as the [Black Tulip] SAMPLE Fireplace w.AVsitter 2 - COMPLETE object.

NOTE: Not all animations of all creators are made the same. In some cases, you may find that after stopping the animation, you're still stuck in the pose. You can use the supplied [Black Tulip] Reset Facial Expressions (P6) animation by playing it directly from inventory, and if that doesn't work, then you need to undeform your avatar in the Avatar Health menu (at least in Firestorm). This [Black Tulip] Reset Facial Expressions (P6) animation is NOT used by the script, and you can give it away freely if you wish.

NOTE: If you want to include a FACES script to turn the Bento faces animations on/off, you have to write a line like this on top of your AVpos notecard:

ADJUST FACES|-31450010

Keep in mind that [FACES] is already used by [AV]faces.

The BENTO Faces BASIC script is included in this package. Read here for its documentation and remember that you can't mix the scripts. Your engine must have either all BASIC scripts, or all PRO scripts.

Troubleshooting

Q: I've added the ADJUST line in AVpos, but the button isn't showing under [ADJUST].

A: First, make sure that you have only one ADJUST line in your AVpos notecard. Use the Search feature for this. If you have one ADJUST line, for instance:

ADJUST COLOR|12345

then you need to modify the ADJUST line like, for example:

ADJUST COLOR|12345|FACES|-31450010

It is likely that you're using one of the first versions of AVsitter 2. Update to the latest version to have all of AVsitter's feature - including this one.

If after having followed the directions and checked the troubleshooting list, you have problems making the script work, please click here for the customer service form.