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.

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 easiliy (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.
  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.

Script Order


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.

FAQ / Troubleshooting

Q. I'm getting "Sorry, I'm Full" messages.
A. Be sure you are sitting on the actual positioner rather than the furniture during setup.
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. Getting "No room to sit here, try another spot." or "There is no suitable surface to sit on, try another spot." messages?
A1. It's often caused by being in the middle of a giant megaprim (like those huge "off-sim" sculpties surrounding sims). But don't worry, you can fix it! IF you get this issue (and not everyone does), first try to drop the "Prim Primer" script into every other prim in the linkset. Obviously if you only have one prim, you can't do this.
A2. If this still doesn't work, then you will need to add some prims to your linkset. In this circumstance, you will need at least the same number of prims as you have seats. So, if you want to sit 4 avatars, your object must have AT LEAST 4 prims IN TOTAL. It doesn't matter what shape they are or where they are. Now, use the Prim Primer again in the empty prims and your problem should be gone.
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.