SimpleSit

SimpleSit Introduction

Hey, and thanks for your interest in Simple Sit by CasperTech! SimpleSit allows you to add multiple sit poses to your regular furniture with ease.

Please note: This is only the system to use animations in items. There are no animations included in the shipping package - you have to provide your own animations.

Features

• Create and sell furniture with perfect sit poses.
• Seat up to 50 avatars
• In case the script gets reset, positions are restored from a backup on the web server (up to 50 seats total, up to 6 per position!)
• Each seat can have its own set of animations, each animation with its own sit offset
• The user can choose an animation from the menu
• The user can swap seats
• There's no notecards to configure
• Only one script (really low lag!)
• Allows you to set the camera position easily (no silly prim adjustments needed!)
• Allows users to adjust their position for perfect sitting
• Remembers the last 100 users' changes

Setting Up Your SimpleSit

  1. Rez your furniture item.

  2. Drop a copy of the CasperTech SimpleSit script into the root prim of the furniture item.

  3. Rez as many SimpleSit Positioner balls as you need - 1 per (planned) seated avatar.

If you're planning your furniture item to seat up to 3 avatars, you need 3 positioners. If your furniture item will only seat 1 avatar, then you only need 1 positioner.

  4. The positioner(s) turn yellow when rezzed and will show in hovertext:

   Associated to OBJECTNAME (UUID of object)

  5. Insert up to 6 animations in each positioner, max name length of 24 characters (11 if unicode.)

  6. As each animation is dropped in, you will get the following message - this is normal!

  SimpleSit Positioner: Inventory changed! You must configure the positions again!

  7. Sit on the positioner, select the animation you wish to work with first, and move the ball so that the animation is in the proper position.

  8. Click the positioner ball and select "ANIM" to move to the next animation

  9. Positioner will automatically change to the next - you don't get an option to choose which one.

10. Move the ball to the proper position for the next animation

11. Repeat for each additional animation in the positioner

12. If you have additional positioners, repeat the process for each of those as well.

13. Once you are done setting up animation positions, click any positioner, and select SAVE! from the popup menu.

14. The balls will turn green, and you'll get a series of messages in local chat

15. WAIT for the message indicating that the furniture is all set before deleting positioners!

16. You should see ALL three messages when everything is successful:

  ((Object name)): Now backing up positions in case of reset or data loss...
  ((Object name)): Positions have been saved and backed up.
  ((Object name)): All done. Ready to rock! ((# of seats)) positions saved.

Associated to wrong item?

---

The script called "CasperTech SimpleSit" must go in the object FIRST, only then you can rez positioner(s).

If you don't follow this order, the positioners will associate to the wrong item, or not associate at all.

About the Ball Colors

---

The positioner balls associate to a piece of furniture by (1) the SimpleSit script contained within it and (2) the UUID of the furniture item.

Yellow: Positioner is associated with a furniture item (and indicates the UUID in the hovertext)
Red: Positioner is NOT associated - either the furniture is lacking the SimpleSit script, or the furniture was picked up and re-rezzed.

If lacking the SimpleSit script, you'll need to rerez the positioners once the SimpleSit script is added to the furniture.

Green: Positions are in the process of saving. WAIT for the message in local chat giving the all-clear before deleting!

Video Tutorials

VideoService "youtubehd" not recognized.

VideoService "youtubehd" not recognized.

Optional Feature: Camera Position

1. Follow steps 1-9 above

2. Click the positioner ball

3. Select Camera from the popup menu

4. Move your SL Viewer point of view to the proper position for the animation

5. Click Save Cam

6. You will get an additional popup that indicates the camera position will be sent to the object when you save.

7. Repeat for each additional positioner.

Optional Feature: Sequential Seat Order

This controls the SEAT order, not the order of animations within each seat. If you are going to number the seats, do NOT leave any as "0" in the description field, or the sit configuration will be broken.

1. Choose a positioner ball corresponding to the seat you want to be used first

2. Change the description field of the positioner - type in "1" and hit enter

3. Go to the next seat's positioner and replace the description field with the number "2"

4. Repeat for each additional positioner.

If you do not want to present the seats in any particular order, simply leave all the description fields as their default of "0".

Fixing Broken Animations

1. Delete the animations from the furniture

2. Drop in the Prim Primer script

3. Wipe out the description field (select/highlight all in the description field, hit the space bar a couple times, hit "enter")

4. Pick up and re-rez the furniture (this gives it a new UUID.)

5. Redo the complete setup all over again from scratch.

Limitations: Animation Names

Please do NOT name any of your animations the same name as any of the Second Life client's default internal animations.

The animation will still work, HOWEVER, what you'll actually get will be a blend of both your animation and the default animation.

Limitations: General

1. SimpleSit is not designed to hold more than six (6) animations per positioner/seat. (If you choose to add more, you do so at your own risk.)
2. SimpleSit is not designed to be used for a sex bed or any other automatically-synced furniture. Each person seated has to change their animation themselves.
3. Animation names must be less than 24 characters long (or less than 12 if using unicode.)
4. SimpleSit MUST be in the root prim, or the script will self-delete!
5. Under normal circumstances, a menu button should show up to 11-12 regular alphanumeric characters. If you are using Unicode, it may only show up to 6.

Error Messages

   Unable to give inventory. Blocked by permissions.

This comes from an additional rezzing or giver script - not SimpleSit. SimpleSit doesn't have this capability. Check your objects for a stray rezzing or giving script.

  Sorry, I'm Full

Be sure you are sitting on the actual positioner, rather than the furniture object, during setup.

  No room to sit here, try another spot. / There is no suitable surface to sit on, try another spot.

Often caused by being in the middle of the bounding box of a megaprim, such as many "off-sim" sculpties. If you get this message, you can try dropping the Prim Primer script into each prim in the linkset.

If your linkset has fewer prims than the expected maximum number of avatars, then you may need to add one prim per expected avatar. (The problem doesn't always come up, so sometimes it will work just fine, and other times you'll get the error.) So if you want to seat 4 avatars, your object may need to have at least 4 prims in total. (won't matter what shape they are or where they are located.) Once you do this, you can use the Prim Primer script in each additional prims and the problem should be gone.

When Should Prim Primer Script Be Used?

---

It doesn't matter whether you use the prim primer script before or after the animations are set. It won't disturb the settings either way.

FAQ / Troubleshooting

Q. I'm getting this error: WARNING: Couldn't save current animation position because i'm not associated with a base unit

A. Make sure the base unit has the SimpleSit script - If necessary, right-click, then "Edit", then in the contents tab, right click on the script and see who created it - you should see Casper Warden. If you see any other name, it's not a SimpleSit script.

Q. I've set up positions and hit save, but the balls aren't turning green.

A. If the balls aren't turning green, then you've overfilled the positioners. Remember that SimpleSit only supports up to 6 animations per positioner.

Q. If I've overfilled the positioners, do I have to reposition everything once I pull out the extra animations?

A. Unfortunately, yes, you'll need to set them up again. If they don't turn green, it means that the function that saves the positions has failed, and no data was kept.

Q. I already set the positions and was using the prim, but when I relocated the prim that I configured the sits for, the positions did not move with the prim - they're acting as if they're relative to the world...

A1. The positioners won't move with the prim. Once you've saved, you need to delete the positioners and then you can move the object.

A2. Make sure you haven't accidently resized the prim instead of moving it.

Q. How far away can the positioners be from the base?

A. The distance is unlimited. [Sim/region-wide]

Q. My SimpleSit is associating to the wrong furniture!

A. There are a few things to check:

1. Are you trying to set up multiple pieces of furniture simultaneously? If so don't - work on ONE piece from beginning to end, before starting the next.
2. Did you shift-drag a copy of the new piece of furniture you're working with? If so, don't - part of the SimpleSit setup includes adding a UUID to the description field that tells the website what to use and in what order. It's best to rez a new copy from inventory to work on the next piece.
3. Did you put the scripts in out of order? The SimpleSit script must go in the furniture first, or else the positioners will associate to the WRONG item.