OLD-CasperLet/Detailed Setup: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
Line 127: Line 127:
= '''<span style="color:#00528c">CasperLet + Transporter</span>''' =
= '''<span style="color:#00528c">CasperLet + Transporter</span>''' =


<span style="color:#F00;">'''NOTE: YOU NEED CASPERLET 1.15 OR HIGHER TO USE THIS FUNCTIONALITY.'''</span>
<span style="color:#F00;"> '''''NOTE: YOU NEED CASPERLET 1.15 OR HIGHER TO USE THIS FUNCTIONALITY.'''''</span>


# Set the "casperlet" value in the notecard to YES, and save.
# Set the "casperlet" value in the notecard to YES, and save.

Revision as of 06:28, 8 July 2013

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:

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

Configuring the states of your 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.
  • You cannot automatically change the transparency or size on a flat meter - they're designed to be left where people can easily see them.
  • If the renter gets evicted, the unit should automatically pick up and use the "available" state setting.
  • July 2013: There is a ticket is in the suggestion queue to increase the distance limit.

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. Are they going to the right unit? Click "yes" or "no". If they're not, start again from step #3.
  6. 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.

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.