CasperLet/Prim Counter

From CasperTech Wiki
Jump to navigation Jump to search

Prim Counter Basics

CasperLet units cannot - by themselves - count prims. For that, you need the prim counter. You need to rez one prim counter region PER LAND OWNER (because a prim counter can only count prims on parcels owned by the same entity that owns the prim counter).

It doesn't matter whether there's 1 skybox or 20, what matters is how the *land* itself is divided or not divided - the prim counter only sees the land, not the number of rentals you have on it.

If all land on the region is owned by YOU

  • Then rez out ONE prim counter on land owned by you
  • Do NOT deed it.
  • If you have multiple rental parcels owned by you, then tick the "Use prim consolidation" option box on the website.

If all land on the regions is owned by A LAND GROUP

  • Then rez out ONE prim counter on the group-owned parcel
  • Deed it to the land group
  • Tick the "Use prim consolidation" option box on the website.

If SOME land on the region is owned by you and SOME by a land group

  • Then rez out TWO prim counters, one of them ON the group owned land, and one ON land owned by you
  • Deed ONE of them to the land group, and leave the other alone
  • Tick the "Use prim consolidation" option box on the website.

If all land on the region is owned by MULTIPLE land groups

  • Then rez out one prim counter PER land group, each on the appropriate group-owned parcel
  • Deed ONE counter to EACH group
  • Tick the "Use prim consolidation" option box on the website.

Group Land & Deeding

Prim counter MUST be both rezzed and deeded on group owned land - if it's not deeded, it will fail, and display hovertext notifying you that it must be deeded. Once the prim counter is actually deeded, the prim counter automatically starts counting prims automatically, and then every six hours thereafter (three hours with the v2 prim counter).

How Often Does It Count Prims?

2.x prim counters count prims every 3 hours.

1.x prim counter count prims every 6 hours.

This is NOT configurable. However, you (landlord / system owner) can trigger a re-count and full system update (aka a "global" re-count) by touching the prim counter.

Tenants CANNOT trigger a global re-count, however they can trigger a "personal" re-count from the rental unit which will tell them how many prims they are using. It is only informative for them, and will not update the global count within the system itself.

The reason tenants are prevented from triggering a global re-count is that they tend to request this repeatedly, in a small space of time, which causes a great deal of unnecessary server load.

Scripted Prim Auto-Return

As of version 1.21 R9, the prim counter now adds support for LSL scripted OBJECT RETURN. It will return prims for the current tenant, and any additiional tenant, *IF* the feature is enabled on the rental unit - it's disabled by default because it's a potentially dangerous feature. We accept no responsibility for any destroyed sims/regions.

Please note: This is a capability of the version 2.x (and up) prim counters ONLY, not any bot you may be using, and not any version 1.x prim counters you may still have rezzed out. You MUST have a prim counter properly rezzed in order to use this feature. "Properly rezzed" in this context means that the prim counter is owned by the land owner (you or a group) and that as the individual land owner or as the owner of the land group you answered "yes" to the permissions popup asking if the prim counter can return objects on your behalf.

  • Group-owned land: It can't ask you for permission if you don't have "owner" role in the group. That's an LSL permission restriction. If you are not the group owner, you CAN pass the prim counter to the group owner and have them rez it out instead. It will work once they rez it out and grant permission.
  • Group-owned land: Scripts need to be allowed BEFORE deeding. It's enough to set the prim counter to group for a few seconds and allow it to run, before deeding.
  • All land: If you deny permissions, it will still work as just a prim counter.
  • All land: Once permissions have been granted once, it should not ask again.

If someone has multiple rentals, and only ONE expires, then:

  • Prim Consolidation OFF: If rentals are on DIFFERENT parcels, then the prims on the expired parcels will be returned
  • Prim Consolidation ON: If rentals are on the SAME parcel, then the prims for the expired rental will NOT be returned.

How can Landlord / Tenant / Manager check land impact?

The landlord/manager simply needs to click their rental unit, choose "TENANTS" submenu, then "LAND IMPACT" on the next page.

Tenants can simply click "LAND IMPACT" from the first popup menu screen they get.

LSL Limitations

Warning - Parcel '((name of land parcel))' may have too many prim owners - I can only count prims belonging to a maximum of 100 avatars per parcel. The prim count on this parcel may not be accurate.

LSL can only count up to 100 prim owners in a given parcel. This does NOT affect the scripted auto-return function, if it is enabled.

Sample Configuration Tricks

Rental lots all on same parcel (Example: Most Malls)

One person renting multiple units? Use "prim consolidation" to prevent one or more units from showing "over limit". Rental units are configured to reflect the total prim allowance - when prim consolidation is turned on, then the box compares all prims belonging to that tenant, anywhere in the sim, and compares it to the total prim allowance of all the rentals that they have.

FAQ / Troubleshooting

Q. If my rental units are parceled off on group land, can I see the prim count for each parcel?
A. Yes, keep the prim counter rezzed out, but disable "prim consolidation" and the units will count on a per-unit, per-parcel basis.
Q. The system is saying my tenants are over prims, but they really aren't, so something is wrong...
A. Often, nothing is *wrong* per se. What could have happened is any of the following:
  1. Your tenants may have picked up the extra prims since the last count
  2. Your tenants might be using a "temp rezzer", and you might be seeing the prim count inbetween rezzing. (Look for a constantly fluctuating prim count to verify) Note from Casper: I don't think temp prims are counted, but I haven't tested this - will do when I find some time!
  3. They may have prims rezzed somewhere other than the area they're normally allowed to rez, that the prim counter sees.
Q1. Why isn't the prim counter feature working?
Q2. My meters/boxes aren't properly counting tenant prims - help!
A1. If the land is owned by a group, is the prim counter rezzed out and deeded TO that land group.
A2. Rental boxes / meters need to be rezzed under the SAME land group (but not deeded) in order to communicate properly with the prim counter. (The script is looking at the group the rental unit OBJECT itself is rezzed under.)
A3. If it seems to be counting way too many prims then UNcheck "Count Prims From All Users".
A4. Do you need to UNcheck "disable prim counting"?
A5. Is the prim counter in the same sim/region as the rental properties? It cannot count prims from a different sim/region - this is an SL limitation.
A6. Are there any stray tenant prims in places they shouldn't be?
Q. My tenants want to know if there's a way to see their prim count?
A. Yes, the option is in the touch menu - they need to click the rental unit then select "Land Impact" to get their current prim/impact total. If YOU want to see the land impact, you can find the option under the "Tenants" submenu.
Q. How long does the web page take to update after tenants add or remove objects?
A1. The prim counter checks about every three to six hours (newer prim counters three, older versions six).
A2. To get it to recheck, click the prim counter and tell it to recount - then wait PATIENTLY for it to finish. It will be red while it is counting, and revert to green when it is done. When it turns green, it may still take a few minutes before it finishes updating your meters.
Q. Is there a maximum distance on the prim counter?
A1. No, but they only count parcels that are owned by the same person (or group) that owns the counter on THAT sim. SL limitations prevent it from counting prims on parcels that are owned by different individuals, a different group, or on a totally different sim/region.
A2. They only check every 3 or 6 hours to avoid lagging the sim. (New counters - Oct 2013 - every 3 hours, older counters every six hours)
Q. How do I know if the prim counter is working?
A1. It turns yellow when it's counting, and green when it's done. This will take several minutes. Do *NOT* keep clicking it because every time you click it, it abandons the current counting process and triggers another manual count from the beginning.
A2. Version 1.21 and up are SLOWER in the counting process by design.
Retrieved from "https://wiki.casperdns.com/index.php?title=CasperLet/Prim_Counter&oldid=5985"