What for?
Below are a few usage scenarios for this package, but of course they are just suggestions and I'd be happy to hear about the usage you are making of the AutoAttach system!
Quick set up for a live performance
The initial request for this system came from a musician friend who does live performances in SL and needed a quick and reliable way of getting prepared for the show by attaching a guitar (with a choice), mediator and other accessories when "sitting" at the microphone.
Demonstrator for a shop owner
No need to package a specific "demo" version of your mesh clothes or accessories that will clutter the customer's inventory. With AutoAttach the customer can be prompted for one or several objects - clothes, jewelry, shoes... It does not matter if it's mesh, rigged mesh or ordinary prims!
When they confirm the permission they get to try the real thing without actually getting it. And with the "experience" version of the attachment script, they need confirm the permissions only once! (read about experiences in Second Life® here).
Custom HUD to organize your outfit elements
Sometimes you would like a quick way of selecting outfit elements (accessories, jewelry, whatever) to wear without having to search your inventory or navigate an overcrowded "outfits" menu in your viewer.
With the AutoAttach system, as long as your accessories are modifiable and copiable, you can just put them in the inventory of a button on your favourite HUD, maybe custom-made, put in the AutoAttach scripts, adjust the configuration and you're all set!
Feature list
Configuration
The AutoAttach system was designed to be very versatile to allow a variety of use cases. Thanks to a comprehensive solid configuration, you can define:
- the list of objects to attach, which require a choice through a menu and which don't ;
- who is allowed to use: owner only, group members or everyone ;
- the condition that triggers the attachments: an allowed user touching the prim, sitting on it, the prim being rezzed on the ground, or attached to its owner, or maybe a combination of these conditions ;
- optionally the condition that cases the attachments to detach : touching the prim, standing from it, the prim being rezzed again or detached from its owner, or just no condition at all !
- whether the attachments will detach when this condition is met, or just remain attached until the user manually detaches them or maybe teleports to another sim ;
- if there will be a "stop timer" that makes the attachments detach after a given period of time ;
- menu customization : define the prompt and rename the "Cancel" button if you need to ;
- customize messages said in the chat, or just disable them
Attachment script(s)
You can also fine tune the behavior of attachments by customizing the full perm script that goes into them. A few parameters exist in there:
- messages that you can alter or just disable
- forcing a different attachment point
- whether to detach when the user teleports to another sim or not
The attachment script comes in two versions: a regular one and an "experience" one, as described above. Experiences enables to only ask permissions once and for all, but require that you have access to an experience with the "contributor" (or owner) role. You can read about experiences in Second Life here.
And of course, since the attachment scripts are full perm, you can just modify them if you have the required scripting knowledge. Information about this is given in the documentation.
Plugins
The AutoAttach scripts send messages to other scripts so that they can interface and do something useful at this point (play sound? display a specific texture? prompt the user with something else?).An example plugin script is provided, that displays hovertext (like "This demonstrator is in use by [avatar]") with a number of nice easy-to-use features (to set color, alpha, fade in & out times, automatic erasing after some time). The display of this hovertext itself is managed by my HoverTextMgr script, freely available in my MarketPlace store.
Do you need something specific ? More features available to plugins? Feel free to contact me!
Full documentation
A full documentation notecard, suitable for new users and beginners as well as advanced users and scripters, is provided:
- usage scenarios
- step by step setup
- configuration reference
- configuration examples
- permissions considerations
- details about the attachment script versions
- scripting information to create plugins
Do you need something more? Just contact me!
