Scene Info Viewer Script

Description

Version 1.5.1 Put this script on an info sign, a desk or a totem: a click whispers a short report about your scene to the visitor (scene name, visitors in / maximum, instance role, gravity, how long the scene has been running, how long they have been there) and opens Sansar's details window of the scene, with its description, links and travel button. The same report answers the /sceneinfo chat command or an MPP - Action Button. A second, technical debug report (IDs, script memory, visitor names) and a short status are reserved to the scene owner and to the avatars you allow. Colored discs show at a glance how loaded the scene is, a Watch warns you in private when the script memory of the scene runs high or when the scene is full, and new: a Startup Check follows the script memory during the first seconds of the scene and whispers you a summary of how it started. No scripting skills needed. Fully standalone; works with MPP - Action Button for a "Scene info" button on a control desk. ________________________________________ Key Features Three ways to ask • Click on the object: simple report, debug report or nothing, plus the details window if you want • Nearby Chat commands /sceneinfo, /sceneinfodebug and /SceneStatus (your own words if you prefer) • Script Events from MPP - Action Button: the report goes to whoever pressed the button Three reports • Simple: scene name, visitors, instance role, gravity, script uptime, the visitor's own visit time • Debug: location handle, instance / world / event IDs, owner, access group, versions, build ID, API version, script memory with its thresholds, visitor names, your avatar scale and event ticket • Status: script memory, visitors, the state of the Watch and the result of the Startup Check • Whispered to the visitor, or posted to everyone Status icons • A colored disc in the chat in front of the script memory and visitor lines: green, yellow, orange, red • Memory levels are Sansar's own thresholds for your scene (warning, critical, limit), not invented ones • Visitors: yellow from 80 percent of the scene limit, red when the scene is full • One switch gives plain text instead of the discs The Startup Check (new) • On by default: during the first 30 seconds of the scene (10 to 60, 0 = Off), the script memory is read every second • Each rise of level and the return to normal are whispered to the scene owner and your Whitelist, with the disc • A summary at the end of the window: highest level reached and when, peak, activity • You, the scene owner, get that summary once per start, even when it was green and even if you arrive later; your Whitelist gets it when present, or later only if the start was not green • If a chat was not ready, the script tries again for 30 seconds • Works with the Watch Off The Watch • Checks the script memory of the scene every 1 to 60 minutes, and at once when Sansar reports a change • Whispers an alert to the scene owner and to your Whitelist only when the level changes, back to normal included: no repeated messages • One "Scene full" alert when the visitor limit is reached: the next visitors arrive in a new instance • If you arrive during an alert, you get it a few seconds later; alerts are also kept in the script console Access and anti-spam • Debug report and status by permission mode: owner only, owner + whitelist, everyone except a blacklist (handles or UUIDs) • Customizable refusal message • Per-visitor cooldown with a private "please wait" message showing the remaining time, and a public cooldown for reports posted to everyone ________________________________________ Technical Details • 37 settings in seven groups: Activation, Report, Watch, Access, Chat, Events, Debug • The script memory shown is the one of all the scripts of the scene together, against the limit Sansar gives the scene • Long reports split into several chat messages (120 to 2000 characters each) • Safe delivery: a visitor who leaves during a report, or a message delayed by Sansar, never stops the script • Warnings in the script console for a wrong setup (a click that would do nothing, empty commands, an unused list) • Optional Debug Logging with the avatar handle and UUID of every request ________________________________________ Example Uses • An info sign at the landing point • A public "who is here?" counter • An admin desk with the debug report for your helpers • A "Scene info" button on an Action Button control desk • A night watch for your events: you and your co-hosts are warned when the scripts run out of memory or the scene is full • A quick /SceneStatus before and after adding scripted objects, to see what they cost • A startup report each time the scene starts: did the scripts' memory stay normal while everything was loading? ________________________________________ Full documentation online: https://mpp-mainstore.com/sansar/SceneInfoViewer/ ________________________________________ Changelog — Version 1.5.1 • New Startup Check (On by default, 30 seconds, adjustable 10 to 60, 0 = Off): the script memory of the scene followed during its first seconds, each rise and the return to normal whispered to the owner and the Whitelist, then a summary of the start (highest level and when, peak, activity). • The scene owner gets the summary once per start, even when the start was green and even arriving later; a Whitelist avatar arriving later gets it only when the start was not green. A summary that could not reach a loading chat is tried again for 30 seconds. • /SceneStatus gets a Startup check line: Off, running, or the summary. • Lighter code (internal versions 1.4.1 and 1.5.0, never published): no behavior change. • Update from 1.4.0: all your settings are kept, the new one starts at 30 seconds (0 = Off). Changelog — Version 1.4.0 • Status icons: colored discs on the script memory and visitor lines (can be turned off). • Memory lines rewritten: used of limit, percentage, level, thresholds, activity in words. • Debug report: avatar scale and event ticket of the avatar who asked. • New /SceneStatus command: the health of the scene in three lines. • New Watch: private alerts to the owner and the Whitelist when the script memory changes level, and when the scene is full. • Update from 1.3.0: all your settings are kept, the five new ones start at their defaults (the Watch is Off until you turn it on). Changelog — Version 1.3.0 • First release on the Store. Useful Links: • Action Button Script: https://www.sansar.com/store/listings/3e1a3546-6c79-4527-bc1e-78d02648d19e/action-button-script • Commands Help On Chat Script: https://www.sansar.com/store/listings/fea2df6b-21ce-48eb-94fc-4b7a7aad2777/commands-help-on-chat-script ________________________________________ Enjoy and Keep Good Vibes. Hugs from Morgane. ________________________________________