[Script Lab] Estate OS — Object setup

Estate OS manages parcels, listings, tenants and rental renewals.

1. LINK BOARDS TO THE LICENCE HOLDER

In the root prim of a LandSign or parcel Displayer, open or create a notecard named exactly:
Estate OS Config

Add:
REAL_OWNER_UUID=LICENCE_HOLDER_AVATAR_UUID

Use the Estate OS licence holder’s avatar UUID, never a name or a group, object, tenant or staff member UUID. Replace any all-zero example value.

When the licence holder rezzes the boards, this notecard is optional: their UUID is used automatically. When a team member rezzes them, enter the licence holder in the notecard. The team member must also have the required dashboard permissions; the notecard does not grant access.

For a LandSign on group-owned land, add where needed:
REAL_GROUP_UUID=LAND_GROUP_UUID

Keep the licence holder’s avatar UUID in REAL_OWNER_UUID. Save the notecard before resetting the object.

2. INSTALL THE OBJECTS

LandSign: place it on the parcel to present the land and support its sale.
Parcel Displayer: place it on site or at your office to show a listing and destination. It does not accept payments.
Terminal and HUD: find rentals and pay renewals.

Wait for registration confirmation. Accept the permission requested by objects that receive payments and issue refunds.

3. FINISH ON THE DASHBOARD

Open Estate OS, then Listings. Check the parcel, artwork, sale terms, included rental time and renewal rates.
Under LandSigns or Displayers, check or choose the linked listing.
Set team access and useful notifications, then make a test click.

If registration fails, check the active licence, UUID, exact notecard name and the permissions of the person who rezzed the object.


How does profit account for vacant days?
- Open Financial reports and select the dates and region. Enter its full weekly or calendar-month cost, with an effective date.
- Rent is allocated to the paid rental days, including payments received before the report period. Vacant days earn nothing, but region costs continue.
- Monthly costs use the actual number of calendar days. The current day is prorated up to now; future days are excluded.
- Daily bars compare allocated income and expenses. Unknown costs or missing rental dates leave profit undetermined. CSV exports include the daily, monthly and regional breakdown.

How do I record salaries and deduct paid commissions?
- The network owner can declare a salary or another expense already paid, with its region, payment date, amount and description. This records an expense; it sends no L$.
- Confirmed sale commission payouts are deducted automatically. Do not enter them again as manual expenses. Pending or uncertain transfers are not treated as confirmed payments.
- Void an incorrect manual expense and enter the corrected expense. The audit history is preserved; voiding an expense does not reverse a Second Life payment.

How are sellers ranked each month?
- Select the ranking month in Financial reports. The Estate OS ranking uses confirmed initial land sales with a recorded seller attribution.
- The default rank uses total sale value. You can also sort names, sale counts and amounts. Rent renewals are excluded. Older sales are included only when their seller attribution is known.

How is a sale assigned to an agent and paid?
- Priority goes to the identified manager who owns the LandSign, then to an active Take Sale assignment. Otherwise, one eligible agent detected on the parcel can be selected automatically. If several agents are present, the network owner chooses from those recorded.
- Set the percentage or fixed commission in the member’s Sale commissions tab. The owner reviews each commission. Approve and pay explicitly queues payment; accumulated commissions can be withdrawn together.
- Update Terminal Main and Payment and add Terminal Commissions. An available terminal owned by the network owner pays the total from that owner’s Second Life balance. No terminal means the payout waits.
- A transfer with an uncertain result is never automatically sent again. Check the terminal and Second Life transaction history before any manual correction. Reviewed sales and payout references remain in the history.

How do I offer a group link after purchase?
- In Estate OS Configuration, open After purchase, enter the group UUID and enable the group link. The confirmed purchase message offers the link in the buyer’s language.
- The group must allow open enrollment. This is a group profile link, not a direct invitation from a bot; the buyer still chooses to join.