OLD-CasperLet/Detailed Setup

From CasperTech Wiki
Jump to navigation Jump to search

Introduction

Prerequisites

This manual assumes the following:

  • That you already have land you want to rent out
  • That you have purchased the paid version of CasperLet

Getting Started: Overview

  • Rez a rental unit.
  • If it's a box, click it. If it's a flat meter, click the (C)asperLet logo.
  • Select Config from the popup menu.
  • Go to the website. Create an account, if necessary. Log in.
  • Set the various configuration options such as rate, prim/impact limits, etc. on the bulk page.
  • Click "save" after each change.
  • If necessary, with each rental unit rezzed, change its individual options as well. Click save after each change.
  • If you want to count prims, then rez one prim counter for each land owner.

Terminology / Glossary

What's In The Crate?

For details on what comes in the shipping crate, see the Introduction page.

Creating An Account

See how to create an account on CasperDNS as well as reset your password.

Configuring Your Units

Configuring your primary rental unit

  • Rez a rental unit.
  • If it's a box, click it. If it's a flat meter, click the (C)asperLet logo.
  • Select Config from the popup menu.
  • Go to the website. Create an account, if necessary. Log in.
  • Set the various configuration options such as rate, prim/impact limits, etc. on the bulk page.
  • Click "save" after each change.
  • If necessary, with each rental unit rezzed, change its individual options as well. Click save after each change.
  • If you want to count prims, then rez one prim counter for each land owner.

When selecting the "count prims" option, the units will now - if there are additional tenants, or "count ALL prims" is enabled - give a breakdown of each user included in the prim count so you can see which users are using which amount of prims.

Configuring your "slave" rental unit

The "slave" units can be linked to the actual CasperLet rental units, and will copy whatever the main units do. This is really useful if you want a "central" rental area on the sim/region, as well as payment boxes on each of your rental locations.

  1. Rez a "slave" unit near the actual rental unit you want it linked to.
  2. Click "yes" when prompted.
  3. It's now assigned to that rental unit, and will copy that unit's settings and updates.
  4. Simply move (do not pick up!) the "slave" unit OR the main rental unit to where you want it to be

Transfer a rental/configuration

To learn how to copy or transfer a renter or unit configuration see the Transfer Rental page.

Website Configuration Options

See the page on unit configuration or the page on bulk configuration for details of what you can do.

Configuring States

Configuring the states of your rental BOX and MESH METER:

  1. Make sure the unit is available (not rented)
  2. Move the unit to where it should appear when available
  3. Resize and set the transparency as desired for the available state.
  4. Touch/click the unit, select "States" from the popup menu, then "Set Available"
  5. Move the unit to where it should appear when rented (max 10m distance away)
  6. Resize and set the transparency as desired for the rented state.
  7. Touch/click the unit, select "States" from the popup menu, then "Set Rented"
  8. Pay the unit to start a rental. This will store the settings.

Configuring the states of your 4 PRIM/2 IMPACT, RENTAL METER:

  1. Make sure the unit is available (not rented).
  2. Move the prim where it should appear when available (10m max distance)
  3. Touch/click the unit, select "States" from the popup menu, then "Set Available"
  4. Move the prim where you want it to appear when it is rented.
  5. Touch/click the unit, select "States" from the popup menu, then "Set Rented"
  6. Pay the unit to start a rental. This will store the settings.
  • If the renter gets evicted, the unit should automatically pick up and use the "available" state setting.

Limitations

  • ALL rental units: The maximum distance a unit can move, between "available" and "rented" states is 10 meters. A ticket is in the queue to increase the limit.
  • PRIM rental meter: Unless you edit linked parts, the prim meter is already the smallest you can go. Grabbing a corner and shrinking won't work since one of the prims is already at the 0.010 smallest size.
  • PRIM rental meter: Alpha setting persists across states, and will NOT automatically change.
  • PRIM rental meter: Do not "fold down" the popup AVAILABLE sign, the meter takes care of that automatically.

Configuring Textures

Customising your rental unit textures is easy! Simply:

  1. Take a copy of the textures out of the unit
  2. Save them to your hard drive
  3. Edit them (or use them as templates) to your liking
  4. Upload the new versions to SL
  5. Replace the textures in the rental units. That's it!

Remember that each respective texture needs to use the appropriate name:

  • "TEX-available"
  • "TEX-overdue"
  • "TEX-rented"
  • "TEX-overlimit"
  • "TEX-locked"
  • "TEX-reserved"

If you are using the flat meter, there will also be these additional textures (and your replacements also need to match these names):

  • METER-days
  • METER-hours
  • METER-minutes
  • METER-months
  • METER-weeks
  • METER-years

Textures must also be full perm (to YOU, the system owner) in order for the unit to display them, and the rental unit itself must retain either the "box@" or "m@" at the beginning of the description field on the unit. If you remove that, the textures will not change.

Configuring the Door & Sign

This applies to the sample door and sign that is included within the CasperLet shipping crate.

BOTH THE SIGN AND DOOR (AND THEIR SCRIPTS) ARE PROVIDED "AS-IS", WITHOUT WARRENTY OR SUPPORT. You may informally ask in the CasperTech support group if you get stuck, of course. Chances are there's a scripter who might be willing to help. Naturally, you're welcome to use them without restriction.

To use them as-is:

  1. Rez a door or sign near a CasperLet unit
  2. Touch/click it
  3. Click the CasperLet unit you want to link the door and/or sign to
  4. Click "Yes" on the popup menu
  5. Now click the CasperLet unit once more to send the most recent data
  6. The door and/or sign should now function as any door and/or sign would, save that it will automatically restrict itself to the current CasperLet tenant when rented.

The door will still work from within a linkset.

Casper Warden requests that if you use these scripts in a more advanced product and set it up for sale that you let him know, and he'll help promote it.

CasperLet + Transporter

NOTE: YOU NEED CASPERLET 1.15 OR HIGHER TO USE THIS FUNCTIONALITY.

  1. Set the "casperlet" value in the notecard to YES, and save.
  2. Wait a few seconds until the notecard has finished reading.
  3. Touch the transporter.
  4. Touch the rental unit you want to link the transporter to
  5. Watch the stream of particles which should now be emitting from your transporter.
  6. Are they going to the right unit? If so, click "Yes"
  7. If not, click "No" and start again.
  8. That's it! The transporter pad will now work in conjunction with your rental meter.

The CasperLet functionality will let ANYONE use the transporter when the unit is "available" - but ONLY the tenant(s) when it's rented.

By default, the transporter will ONLY take them to the location of the rental meter, however you can change this by setting "ACCESSCONTROLONLY" to YES. This will make the transporter behave as normal, except it will use the CasperLet unit to determine who can TP and who cannot.

If you like, you can set "acceptpayments" to YES which will allow people to pay the transporter pad to rent the rental unit it's linked to (if it's available). If this mode is enabled, the transporter will also duplicate any floating text which appears on the unit.

Notecard Delivery

Version 1.19 and prior

By default, these older versions ship with example notecards within the rental units. If you don't change the contents, your prospective renter will get a notecard that just says "this is an example notecard" - which is not exactly something that encourages renting, so PLEASE take the time to put some informational content in them.

  1. Place two notecards into the contents of EACH rental unit; the names must end with "-Info" and "-Rented".
  2. The "-Info" notecard is given when a user clicks Info in the menu.
  3. The "-Rented" notecard is given when a user rents. The user can also click the unit at any time and select "Notecard" from the popup menu to get the "-Rented" notecard again.

It is recommended that you include some basic information about your rental, such as:

  • How much per week
  • How many prims / land impact are allowed
  • Any rules you have on rentals, what tenants can and cannot rez out, any overall business theme, etc.
  • Anything else you want to add

Version 1.20 and forward

  • Place your "info" and "rented" notecards in the DropBox. Under 1.20 and forward, they do NOT need to have "-Info" or "-Rented" after the name (but you still can, if it makes them easier to find in the notecard list.)
  • If you want the manager to be able to change the notecard contents, they need:
  1. Their own DropBox
  2. A copy of your "Info" and "Rented" notecards that they can put in their DropBox

They will be unable to modify notecards within YOUR dropbox, even WITH modify permissions granted - this is why you have to give them a copy. This is an SL limitation, not something CasperLet can work around.

Mapper

The mapper will display a "mini map" of your sim/region, pulling the picture from whatever is current on LindenLab servers.

The mapper table surface is water level - the units will show a 3D space

You can change the "height modifier" by changing the description of the mapper table - If you set it to 0.00, all units will appear flat on the table. The scale is 1% of actual height.

For example:
A scale of 1.0 would mean that a unit at 4000m would show 40m above the table
A scale of 0.1 would mean that a unit at 4000m would show 4m above the table
A scale of 0.0 would mean that a unit at 4000m would show 0m above the table

You can resize the table, rotate it or move it, and the indicators will move into place within 60 seconds.

Indicators can be resized by touching the table and using +Scale or -Scale.

Indicators can be touched, and paid, just like the actual CasperLet unit, however the pay buttons CANNOT be customised.

To change the textures on the indicators:

  1. Rez the "MapBeacon" object from the mapper contents
  2. Put texture in its inventory just like you would for CasperLet boxes
  3. Delete the OLD "MapBeacon" out of the mapper's physical contents under "edit" mode.
  4. "Take" the new MapBeacon with your modified textures
  5. Put the new MapBeacon into the mapper's contents.

Limitations

Map tiles will not update automatically - Linden Lab removed that feature. You will need to update your sim/region map manually with any changes you want to see reflected on the map.

Group Bots

  1. Log in to the CasperLet website
  2. Click the "Group Bots" icon
  3. You will be presented with a "Robot Army" page.
  4. This page has sections for SmartBots, PikkuBots, METAbolt, and the now-discontinued CasperBot.
  5. Enter the appropriate information in for the bot system you are currently using
  6. Hit save

If the renter accidentally ignores/declines the group invite, just have them click the rental unit and choose "GRP INVITE" from the popup menu. The rental units will only invite people who are current renters.

Limitations

Bot ejects cannot remove a tentant from the group if they have been MANUALLY given any role other than the one they were invited to. The reason is the bot has no way of knowing what role(s) they were granted, so thus no way for the bot to know that it needs to remove them from the extra role(s).

Suggestion

If the land you're renting is individual parcels for each renter, be aware most people will want to be able to change their parcel media. Including permission to do that in the role you invite renters to will save you some time later.

FAQ / Troubleshooting

See the complete FAQ page.

Additional Options

You can also....

...Read about the CasperLet API.
...Get the details about setting up bots for group invites / ejects.
...Learn to always rez under the land group, depending on your viewer