OLD-CasperLet/Detailed Setup

From CasperTech Wiki
Jump to navigation Jump to search

Introduction

The goal of this system is to provide you with a feature rich, stable, good looking rental network with very low resource usage. You'll be able to use this system to rent our stores, streams, anything you like! It's so fast and SO EASY you'll be up and running in no time. With only 1 SCRIPT per rental unit, by switching to CasperVend you're guaranteed to have a much less laggy sim!

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

Discounts for Renters

See the Discounts page for details.

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. Touch/click the unit again, and select "soft reset" on the popup menu. This will tell the rental box to switch to the "available" state, with corresponding location and appearance.

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. Touch/click the unit again, and select "soft reset" on the popup menu. This will tell the rental box to switch to the "available" state, with corresponding location and appearance.
  • 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.

Physically Moving Units

Sometimes your renters want to change parcels, or if you have multiple sims/regions, they want to move to a different sim/region in your estate. You can use the transfer rental option to move your renter, or if you want to move your actual rental unit (and thus your tenant) WITHOUT losing configuration just use the following steps:

1) Right-click on the rental unit
2) select "wear" (or, "More" then "wear" depending on your viewer)
3) Teleport to the new location
4) Right-click, then "DROP"
Do not use "detach" - that will detach it to your inventory, and rezzing it out will lose it's configuration
5) Right-click and then "edit" to move the unit once it is safely dropped
6) Touch/click the rental box and use the soft reset function from the pop-up menu. This will update the website with the rental unit's new location.
7) Make any changes to the rental unit's configuration that you need to for the new location and save them.
8) The next time the prim counter runs in the new sim the relocated rental unit's prim use will be updated.

Moving your rental unit in this fashion means:

  • It reports correct time remaining
  • It remembers the tenant
  • Website sees the new location almost immediately
  • Prim count will initially reflect the OLD location, but will update once the prim counter sees the unit's new location.

Moving your rental unit in ANY OTHER fashion beyond what is described here is NOT guaranteed to keep the configuration!

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@(text)" or "m@(text)" at the beginning of the description field on the unit. If you remove that, the textures will not change. Please note that the “(text)” in the description can be anything; but something MUST be in the description field after the @ or texture changing will not work correctly.

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.

Transporter Link

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.

Adding a Manager

Adding a manager can only be done in the following manner:

  1. Have your manager register for their own CasperDNS account
  2. It is *very* helpful if they sign up as their SL account name, rather than a random other name - however they should NEVER use a password that is in use for any other service, it should always be a unique password
    (see how to create an account on CasperDNS for details)
  3. Once they've done so, have them tell you the name they signed up under
  4. Log in to YOUR CasperLet account
  5. click the "Managers" icon
  6. On the "Managers" page, click "Add a Manager"
  7. Enter the CasperDNS user name your new manager gave you, and click OK
  8. You will then be taken to a permissions page - you'll see three blocks of items, color coded for risk level
  9. Tick the options you want THAT manager to have, and click "save permissions" at the bottom.

Be very certain you trust the manager if you are granting medium or high risk permissions!

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 on the mapper table manually with any changes you want to see reflected on the map.

Group Bots

See the group bots page for more information.

FAQ / Troubleshooting

See the complete FAQ page.

Additional Options

You can also....

...Read about the CasperLet API.
...Learn to always rez under the land group, depending on your viewer
Retrieved from "https://wiki.casperdns.com/index.php?title=OLD-CasperLet/Detailed_Setup&oldid=3175"