SimpleSit

From CasperTech Wiki
Jump to navigation Jump to search

Template:Menu

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 individual users to adjust their position for perfect sitting
  • Remembers the last 100 users' changes

Setting Up Your SimpleSit

Video Tutorials

VideoService "youtubehd" not recognized.
VideoService "youtubehd" not recognized.

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.

Do not attempt to set up multiple pieces of furniture at the same time. Work with only ONE furniture item, start to finish, before working on any other. If you don't, the script may associate to the wrong item.

Don't shift-drag a copy of your furniture item after you've loaded the SimpleSit script in it. 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.

Positioners will also tend to associate to the wrong item when you rez them out before putting the SimpleSit script in your furniture.


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!

Optional Features

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.

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".

Prim Primer Script

This script flushes out old sit script information that the prim might still have in its memory.

The way SimpleSit functions, it doesn't matter whether you use the Prim Primer script before or after the animations are set - it won't disturb SimpleSit's settings. If you're paranoid, use it before you begin setting up your furniture.

Limitations

No Couples, Sex Beds or Other Synced Furniture

Each individual must change their animations themselves.

Animation Names Limitation

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.

No Long Animation Names

The more characters in the name of the animation, the more script space it will take up, and the fewer animations you can use before the script crashes.

Animation names should not be any longer than 24 characters, NON-unicode.

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.

No More Than Six Animations Per Seat

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.)

Script Goes In Root Prim

SimpleSit MUST be in the root prim, or the script will self-delete!

Errors

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.

Multiple Copies of Script in Root Prim

Just delete the extras. The script left will record the positions associated by object number, so it doesn't matter which one you delete (but deleting the extras with numbers on the end will make the contents look at little neater.)

Common 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
Setup is not complete. 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.
  WARNING: Couldn't save current animation position because i'm not associated with a base unit
Make sure the base unit (i.e., your furniture item) 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.

FAQ / Troubleshooting

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 the entire sim/region.
Retrieved from "https://wiki.casperdns.com/index.php?title=SimpleSit&oldid=8676"