SphynxDraft/RenoSix: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
= '''<span style="color:#00528c">Prerequisites </span>''' =
= '''<span style="color:#00528c">Prerequisites </span>''' =
This version of the manual assumes you are a very experienced SL user that knows when to unpack items and how to put items in the contents of other items.
If this version is too complicated, please try the '''[[CasperLet/Quick_Start | new user quck start]]''' instead.
=== Terminology ===
=== Terminology ===
----
----
Line 59: Line 63:
= '''<span style="color:#00528c">Customising Your Rental Units</span>''' =  
= '''<span style="color:#00528c">Customising Your Rental Units</span>''' =  
To create your custom rental units AND to make sure rental state changes are reflected (or not, as you choose) between rented and available states, see the '''[[CasperLet/Customisation | Rental customisation]]''' page.  
To create your custom rental units AND to make sure rental state changes are reflected (or not, as you choose) between rented and available states, see the '''[[CasperLet/Customisation | Rental customisation]]''' page.  
='''<span style="color:#00528c">Shared Land or Tenant Takes Ownership?</span>'''=
=== Tenant Takes Ownership ===
----
:# Rez the rental unit ON the parcel - this tells the unit which parcel UUID to track.
:# Move the rental unit off the tenant's parcel and onto land that you control
:# No need for prim counter (they can't use more prims than their parcel allows)
=== Shared/Communal Land (Malls, etc.) ===
----
:# Rez the rental unit on the parcel
:# Make sure the tenant's role in land group does NOT allow object return for anyone '''else's''' objects
:# Use a '''[[CasperLet/Prim_Counter | prim counter]]''' to keep track of everyone's prim/impact usage


= '''<span style="color:#00528c">Configuring Your Units</span>''' =  
= '''<span style="color:#00528c">Configuring Your Units</span>''' =  
Line 253: Line 272:
'''Remember:''' Scripted objects in general will not function if you do not rez them under the proper land group. DropBoxes are no exception.  
'''Remember:''' Scripted objects in general will not function if you do not rez them under the proper land group. DropBoxes are no exception.  


(If you have both CasperVend and CasperLet, it '''is''' normal to see '''all''' of your notecards, from both CasperVend and CasperLet, in the notecard selector box, regardless of whether the DropBox originally came from a CasperVend or CasperLet pack.)
(If you have both CasperVend and CasperLet, it '''is''' normal to see '''all''' of your notecards, from both CasperVend and CasperLet, in the notecard selector box; it doesn't matter whether the DropBox originally came from a CasperVend or CasperLet pack.)




Line 259: Line 278:
For information on when and how to use the prim counter, and about scripted prim autoreturn, see the '''[[CasperLet/Prim_Counter | Prim Counter]]''' page.  
For information on when and how to use the prim counter, and about scripted prim autoreturn, see the '''[[CasperLet/Prim_Counter | Prim Counter]]''' page.  


Scanning Rental Units
= '''<span style="color:#00528c">Scanning For Rental Units</span>''' =
    (( --> webscan page ))
Learn how to do a rental unit scan - and its limitations - on the ''[[Website_Scans#Scanning_for_Rental_Units | scanning for rental units]]''' page.
 
Payments
Payments
   -- Transaction Logs
   -- Transaction Logs
Line 282: Line 302:
   -- Profit sharing
   -- Profit sharing
       -- Known Limitations
       -- Known Limitations
Rental Office Setup  
= '''<span style="color:#00528c">Rental Office Setup</span>''' =
    (( --> Rental office page ))
If you wish to set up a central rental office for your rental estate, see the ''[[CasperLet/Rental_Office | rental office page.]]'''
Group Bots For Invites & Ejects
= '''<span style="color:#00528c">Group Bots</span>''' =
    (( --> Bot Setup page ))
For information on setting up bots for your rental estate, see the '''[[GroupBots | group bots page.]]'''
 
 
Tenant Management  (( new page? ))  
Tenant Management  (( new page? ))  
   -- Maximum Tenants
   -- Maximum Tenants

Revision as of 18:56, 21 May 2016

Prerequisites

This version of the manual assumes you are a very experienced SL user that knows when to unpack items and how to put items in the contents of other items.

If this version is too complicated, please try the new user quck start instead.

Terminology


Parcel
A distinct, continuous (undivided) portion or tract of land.
Tenant
a person or group that rents and occupies land, a house, an office, or the like, from another for a period of time. The tenant is the customer of the landlord.
Landlord
You, the CasperLet account holder and land owner.
Manager
The people that help the landlord manage rentals.

Your Account

No, you cannot (currently) use your CasperVend account username/password if you have one - CasperVend and CasperLet are using two different logins.

See how to create (or reset) your CasperDNS Account.

About The Units

Note on New Units


Click to see larger image







As you can see in this image, when you click "change" to change the rental price, you will also get an additional option:

 Adjust time remaining on unit appropriately

Most landlords will want to leave this UNchecked/UNticked when setting out a brand new rental unit.

Debit Permissions


See the page on Debit Permissions to understand why these are necessary.

Placing Units


If you are an estate manager on the sim/region or the owner of the group that owns the mainland parcels you will be able to rez objects on the land even if the rights are otherwise turned off. When placing rental units, it's always a good idea to turn on "view land owners" and/or "view property lines" to make sure you are placing the unit in an area where scripts will always work, and the renter will not be able to return it. Most residents will behave in this regard, but there's always going to be someone who will want to test the estate staff.

How does a unit know which parcel to track?


When you are renting parcels on a sim, simply rez the rental unit ON the parcel you want it connected to.

Then you can move it off the parcel onto land where the renter can't return the rental unit, or move it to your sim's rental HQ.

Difference Between Meters and Boxes?


Both types allow rental state changes - showing whether a unit is available, rented, etc. - but where the box includes transparency functions, the meter does not because it's designed to be left out and visible at all times. As far as tenants are concerned, there are no functional differences between the boxes and the meters. Both will accept payments, both will show state changes.

Each type comes in a primary/master version, and a secondary/slave version that acts as a relay. You cannot use a "slave" unit in place of a primary unit - the "slave" units have no "brains" of their own, and exist solely to pass commands and responses back and forth from the primary unit it is linked to.

The primary/master unit names are as follows:

  CasperLet Rental Box 
  CasperLet Rental Meter
  CasperLet Mesh Rental Meter

The secondary/slave unit names are as follows:

  CasperLet SLAVE Box
  CasperLet SLAVE Meter

Customising Your Rental Units

To create your custom rental units AND to make sure rental state changes are reflected (or not, as you choose) between rented and available states, see the Rental customisation page.

Shared Land or Tenant Takes Ownership?

Tenant Takes Ownership


  1. Rez the rental unit ON the parcel - this tells the unit which parcel UUID to track.
  2. Move the rental unit off the tenant's parcel and onto land that you control
  3. No need for prim counter (they can't use more prims than their parcel allows)

Shared/Communal Land (Malls, etc.)


  1. Rez the rental unit on the parcel
  2. Make sure the tenant's role in land group does NOT allow object return for anyone else's objects
  3. Use a prim counter to keep track of everyone's prim/impact usage


Configuring Your Units

  • If all of your rental units will use the same base configuration, follow the instructions in "bulk setup" section.
  • If SOME of your rental units will use the same base config, but you will have SOME units with different settings, use the "Bulk + individual setup" section.
  • If all of your rental units will use different configurations, use the "individual setup" section below.

Setup Limitation


Currently CasperLet does not support rental profiles. If you have two or more "base configuration sets" (that are dependent on the rental), you will still need to choose one as the default, and change the rest individually - this will be using the bulk + individual section below.

A suggestion ticket is in the queue to add rental profile functionality.

Pay Buttons


To understand what goes in the pay buttons in the different unit configurations, see the Pay Buttons page.

Bulk Setup

1) Unpack your CasperLet shipping crate


If you're curious, you can see a list of what's in the box with links to explain some of the included tools.

2) Rez one (non-"slave") rental unit PER RENTAL


If the tenant will be taking OWNERSHIP of the parcel (such as with land sales on an island estate), the rental unit must NOT be rezzed on the parcel to which they take ownership. As a side-effect, this means the prim-counting feature will not function.
If the landlord is retaining ownership of the parcel that the tenant is renting (such as with vending events or shopping malls), the rental unit should be ON the parcel.
The object names of the primary/master units to use are as follows:
  CasperLet Rental Box 
  CasperLet Rental Meter
  CasperLet Mesh Rental Meter
Units with "slave" in the name are strictly a command relay object. They do not store settings at all, and you cannot use them in place of a primary/master unit.

Rez the unit ON the parcel to be tracked'


This is how CasperLet picks up the UUID of the parcel in order to keep tabs on it. It doesn't have to stay there, once it registers the parcel, it can be moved off to a sidewalk or rental office.

Manager handling your setup?


Rez out all the units that are needed - or drag-copy as many as you need - NOW before the configuration process begins!

3) Grant debit permissions


See the debit permissions page to details of what these are and why they should be granted.
NOTE: If you are re-rezzing a copy of a unit you've already granted permissions for, you won't see another debit perms popup. This is normal.

4) Recognize rented state changes?


Follow the instructions on the CasperLet customisation page to make sure they STILL change once you're done with configuration. If you make changes without following these instructions, rental units will not change between rented and available states.

5) Go to CasperLet website and log in


Click one of your rental units, select "config" from the popup menu, use that link to go to the website, and log in.

6) Set your bulk settings


Go to the Units page when logged in, and set your options. Remember to click "SAVE" anytime you have a "save" option on a setting, and then use the "save" button at the BOTTOM of the bulk page as well.
This means change only ONE option at a time, and when you have a "save" button for that option, click "save" once it's set!

Bulk + Individual Setup

1) Unpack your CasperLet shipping crate


If you're curious, you can see a list of what's in the box with links to explain some of the included tools.

2) Rez one (non-"slave") rental unit PER RENTAL


If the tenant will be taking OWNERSHIP of the parcel (such as with land sales on an island estate), the rental unit must NOT be rezzed on the parcel to which they take ownership. As a side-effect, this means the prim-counting feature will not function.
If the landlord is retaining ownership of the parcel that the tenant is renting (such as with vending events or shopping malls), the rental unit should be ON the parcel.
The object names of the primary/master units to use are as follows:
  CasperLet Rental Box 
  CasperLet Rental Meter
  CasperLet Mesh Rental Meter
Units with "slave" in the name are strictly a command relay object. They do not store settings at all, and you cannot use them in place of a primary/master unit.

Rez the unit ON the parcel to be tracked'


This is how CasperLet picks up the UUID of the parcel in order to keep tabs on it. It doesn't have to stay there, once it registers the parcel, it can be moved off to a sidewalk or rental office.

Manager handling your setup?


Rez out all the units that are needed - or drag-copy as many as you need - NOW before the configuration process begins!

3) Grant debit permissions


See the debit permissions page to details of what these are and why they should be granted.
NOTE: If you are re-rezzing a copy of a unit you've already granted permissions for, you won't see another debit perms popup. This is normal.

4) Recognize rented state changes?


Follow the instructions on the CasperLet customisation page to make sure they STILL change once you're done with configuration. If you make changes without following these instructions, rental units will not change between rented and available states.

5) Go to CasperLet website and log in


Click one of your rental units, select "config" from the popup menu, use that link to go to the website, and log in.

6) Set your bulk settings


Go to the Units page when logged in, and set your options. Remember to click "SAVE" anytime you have a "save" option on a setting, and then use the "save" button at the BOTTOM of the bulk page as well.
This means change only ONE option at a time, and when you have a "save" button for that option, click "save" once it's set!

7) Set your different individual settings


For each unit you want different from your base defaults, you will need to:
  1. Click that specific unit
  2. Select "config" from the popup menu
  3. Arrive at the individual unit's configuration page
  4. Make your changes
  5. Remember to click "save" for each option with a "save" button
  6. Remember to click "save" at the bottom when done

Individual Unit Setup

1) Unpack your CasperLet shipping crate


If you're curious, you can see a list of what's in the box with links to explain some of the included tools.

2) Rez one (non-"slave") rental unit PER RENTAL


If the tenant will be taking OWNERSHIP of the parcel (such as with land sales on an island estate), the rental unit must NOT be rezzed on the parcel to which they take ownership. As a side-effect, this means the prim-counting feature will not function.
If the landlord is retaining ownership of the parcel that the tenant is renting (such as with vending events or shopping malls), the rental unit should be ON the parcel.
The object names of the primary/master units to use are as follows:
  CasperLet Rental Box 
  CasperLet Rental Meter
  CasperLet Mesh Rental Meter
Units with "slave" in the name are strictly a command relay object. They do not store settings at all, and you cannot use them in place of a primary/master unit.

Rez the unit ON the parcel to be tracked'


This is how CasperLet picks up the UUID of the parcel in order to keep tabs on it. It doesn't have to stay there, once it registers the parcel, it can be moved off to a sidewalk or rental office.

Manager handling your setup?


Rez out all the units that are needed - or drag-copy as many as you need - NOW before the configuration process begins!

3) Grant debit permissions


See the debit permissions page to details of what these are and why they should be granted.
NOTE: If you are re-rezzing a copy of a unit you've already granted permissions for, you won't see another debit perms popup. This is normal.

4) Recognize rented state changes?


Follow the instructions on the CasperLet customisation page to make sure they STILL change once you're done with configuration. If you make changes without following these instructions, rental units will not change between rented and available states.

5) Go to CasperLet website and log in


Click one of your rental units, select "config" from the popup menu, use that link to go to the website, and log in.

6) Set your different individual settings


For each unit you want different from your base defaults, you will need to:
  1. Click that specific unit
  2. Select "config" from the popup menu
  3. Arrive at the individual unit's configuration page
  4. Make your changes
  5. Remember to click "save" for each option with a "save" button
  6. Remember to click "save" at the bottom when done


Notecard Delivery

Only you - the system owner - can edit and replace the notecards. Managers are not able to do this.

Managers may select different notecards from the supply that is already in the DropBox.

You are free to name your notecards whatever you like - "information" is used here to refer to the notecard sent to prospective tenants, and "rented" to refer to the notecard that gets sent to the tenant after they rent the unit.

Selecting Notecards


  1. Place your "information" and "rented" notecards in your DropBox.
  2. Log in to the CasperLet website
  3. If you have one notecard for all rentals, then select the notecard via the bulk Units page.
  4. If you have multiple notecards for different rentals, one may be set on the bulk Units page, but the rest will have to be set via the individual unit configuration pages.

Selecting Landmarks


  1. Place your landmark(s) in the Dropbox
  2. Log in to the CasperLet website
  3. If you have one landmark to use with all of your rentals (such as a rental HQ area), then select that landmark via the bulk Units page.
  4. If you have multiple landmarks for different rentals (for example, if you have one landmark per rental), they will need to be set via the individual unit configuration pages.

For more information about DropBoxes, and why they need to stay rezzed out, see the DropBoxes page.

Remember: Scripted objects in general will not function if you do not rez them under the proper land group. DropBoxes are no exception.

(If you have both CasperVend and CasperLet, it is normal to see all of your notecards, from both CasperVend and CasperLet, in the notecard selector box; it doesn't matter whether the DropBox originally came from a CasperVend or CasperLet pack.)


Prim Counting

For information on when and how to use the prim counter, and about scripted prim autoreturn, see the Prim Counter page.

Scanning For Rental Units

Learn how to do a rental unit scan - and its limitations - on the scanning for rental units' page.

Payments

 -- Transaction Logs
 -- Proxy Payments
    -- Cannot Restrict By Avatar/Group
    -- Will Accept Payments Even When Set "Won't Renew"

Rental Management (( new page? ))

 -- Quickly Finding Tenants
 -- Seeing Rentals-Per-Region
 -- Auto-Evict Note
 -- Rental Rates Note
 -- Floating Text On or Off
 -- Adding a manager
 -- Rent Paid, But Not Updated
 -- Rent Paid, But Some/All Money Refunded/Never Arrived
 -- See Time Remaining?
 -- Viewing Rental Logs
      -- Via Inworld Interaction
      -- Via Website Only
 -- Sales, discounts, etc.
 -- Profit sharing
      -- Known Limitations

Rental Office Setup

If you wish to set up a central rental office for your rental estate, see the rental office page.'

Group Bots

For information on setting up bots for your rental estate, see the group bots page.


Tenant Management (( new page? ))

 -- Maximum Tenants
 -- Transferring / Copying configuration
 -- Swapping Renters
 -- Physically moving units
 -- Why You Shouldn't Re-Rezz A Unit
 -- Customer Wants Higher Prim/Impact Limit
 -- Locking Rental Units
    -- By Individual Units
    -- By Bulk Options
 -- Reserving Rental Units
    -- Cancelling a reservation
 -- Group Restrictions Workaround

Notification Messages to Tenants

 -- Notifications via SmartBots
 -- Who gets reminders?
    -- Reminders sent before the tenancy ends
    -- Reminders sent after the tenancy has ended
    -- Why aren't notifications received?
    -- Testing notifications

Mapper / Map Table Touch/Popup Menu Options Hippo Migration Toolkit

         (( --> Hippo toolkit ))

Script Components

 -- Door & Sign Samples
    -- Changing Sign Texture
 -- CasperLet API

FAQ / Troubleshooting