URBAN MUSEUM

**** OPENSIM AIO (ALL-IN-ONE) WATCHDOG V2 UPDATED RELEASED ******

** OpenSIM Watchdog V2 – All-in-One Notification System (Telegram + Discord + Staff + Secure Keys)
(Scripted originally made by Satyr Aeon but fully modified by ChatGPT and DeepSeek AI)

OpenSIM Watchdog V2 is a complete region monitoring and notification system designed for reliability, security, and ease of use.

This new version introduces secure key storage, automatic sim-restart detection, improved staff handling, and a fully integrated control menu.

---

**Key Features**

• Avatar enter / leave notifications, SIM position (x,y,z coordinates and how long one remained on region!
• Automatic SIM restart notification (when region comes back online)
• Telegram notifications
• Discord webhook notifications
• In-world IM notifications to owner and staff
• Secure storage of API keys (not stored in the main object)
• Staff system via notecard
• Timezone configuration if needed (UTC -12 to +12)
• Touch menu configuration (no chat commands)
• Works even if you do not own the region (rez rights only)

---

**New in V2**

✅ Secure “split-keys” system
Telegram and Discord secrets are stored in child prims (TG_key and DC_key), not in the main object description.

✅ Improved staff system
Staff UUIDs are loaded from a notecard and automatically reloaded when the notecard changes.

✅ Smart SIM restart detection
Automatically sends a message when the region finishes restarting and is back online.

✅ Faster visitor detection
Checks region avatars every 5 seconds.

✅ Full menu control
Enable/disable Telegram or Discord, configure tokens, webhooks and timezone directly in-world.

---

**Notifications are sent to**

• Object owner (always)
• Staff avatars listed in the notecard (optional)
• Telegram (optional)
• Discord (optional)

Offline users receive messages when they log in (if their avatar exists on the grid).

---

**Use cases**

• Region owners
• Estate managers
• Shop owners
• Event regions
• Roleplay regions
• Grid administrators
----------------------------------------------------------------------------------------------------------------------
HOW TO USE: (SAME INFO ON "READ ME" NOTECARD):
OPENSIM WATCHDOG V2 – ALL-IN-ONE NOTIFICATION SYSTEM
SECURE SPLIT-KEYS VERSION + SIM RESTART AUTO NOTIFICATION

Based on the script from Satyr Aeon
Fully modified and extended by ChatGPT and DeepSeek AI

USER MANUAL
=============================================


1) REZ THE OBJECT
----------------

Rez the object in your region.

The script will start automatically.

You do NOT need to edit the script.


2) STAFF NOTECARD (OPTIONAL)
---------------------------

Notecard name: NOTIFICATION STAFF

- Add ONE avatar UUID per line.
- These avatars will receive in-world IM notifications:
• Avatar entering the region and position
• Avatar leaving the region

- The owner ALWAYS receives notifications.
- If the object is group-owned, any group member with edit rights can modify the notecard.
- Leave the notecard empty if you do not want to use staff notifications.

Example:

a8c9e85e-8076-4bd8-842d-083f0fe7c2e4
9d425ade-c383-4dae-9622-187a594ee927
340d6df7-658b-4cb8-820c-61b5cbc86cb1


**************************************************************
IMPORTANT – AUTOMATIC SECURITY ON TRANSFER
**************************************************************

You NO LONGER need to manually wipe this notecard before sharing the object.

When ownership changes:

- Telegram token is wiped
- Telegram chat ID is wiped
- Discord webhook is wiped
- Script is reset automatically
- The STAFF notecard is wiped out.

**************************************************************


IMPORTANT STAFF NOTES
---------------------

- Staff members receive messages ONLY if:
• Their UUID exists on the grid
• They have logged into the grid at least once
• UUID is valid (no missing numbers, letters or spaces)

- Staff notifications include:
• Avatar entering the region and position
• Avatar leaving the region, position and how long one remained on region.

- SIM RESTART messages:
• Are sent to the OWNER, STAFF Telegram, and Discord
• Are NOT (most of the time) sent to staff when hypergridding or UUIDs of HG avatars or when UUIDs are invalid or partial and may be ignored silently.


3) TELEGRAM SETUP
-----------------

a) Open Telegram and search for: @BotFather
b) Send command: /newbot
c) Follow the instructions
d) Copy the BOT TOKEN provided

e) Create a private chat or group for notifications
f) Obtain the CHAT ID:
- Private chat: use @userinfobot
- Group chat: add a bot and retrieve the chat ID

g) In OpenSim:
- Touch the object
- Select "Telegram"
- Choose "Set Token"
- Choose "Set ChatID"
- Enable Telegram if it is disabled


4) DISCORD SETUP
----------------

a) Open Discord
b) Go to your server
c) Server Settings → Integrations → Webhooks → New Webhook
d) Copy the webhook URL

e) In OpenSim:
- Touch the object
- Select "Discord"
- Choose "Set Webhook"
- Enable Discord if it is disabled


5) TIMEZONE SETTINGS
--------------------

Default: UTC-8

To change:

Touch object → TIMEZONE → enter a value between -12 and +12

Reference:
https://www.utctime.net/
􀀁

****************************************************************
TIME DISPLAY LABELS - IMPORTANT NEW FEATURE
****************************************************************

The script now displays different time labels in notifications:

1. GRID TIME - When using grid's default timezone
• Appears when timezone is set to match grid time
• Shows time as it appears on the grid server

2. Defined user time - When using a custom timezone
• Appears when you manually set a timezone
• Shows time adjusted to your chosen timezone

Examples in notifications:
• "John Resident entered Main Region (14:30:15 PM GRID TIME)"
• "John Resident entered Main Region (14:30:15 PM Defined user time)"

****************************************************************

Note:
- The script uses grid Unix time + your offset.
- Daylight Saving Time is handled by the grid time reference if supported.
- Changing timezone affects ALL notifications (Telegram, Discord, IM).


6) OBJECT NAME (OPTIONAL)
-------------------------

You may rename the object to identify the region:

Examples:
- Main Region
- Shop
- HQ
- Sandbox
- Event Area


7) STATUS LIGHTS and COLOR MEANINGS
------------------------------------------------
IM_light
- GREEN → In-world IM system active (always on)

STAFF_light
- RED → STAFF notecard missing
- YELLOW → Notecard exists but empty or invalid UUID(s)
- GREEN → At least one valid staff UUID loaded

TG_light (Telegram)
- RED → Token or Chat ID missing or NOT configured
- YELLOW → Telegram disabled
- GREEN → Telegram enabled and configured

DC_light (Discord)
- RED → Webhook missing or NOT configured
- YELLOW → Discord disabled
- GREEN → Discord enabled and configured


8) SECURE STORAGE
-----------------

Secrets (*) are NO LONGER stored in the main object description.

They are stored in:

- Telegram → child invisible prim named: TG_key
- Discord → child invisible prim named: DC_key

These prims store encrypted-style data in their description field.

Do NOT DELETE or UNLINK them.

(*) Token, ChatID and Webhook provided by the user.


9) WHAT GETS NOTIFIED
---------------------

Avatar enters region and SIM position (x,y,z coordinates):
- Owner (IM)
- Staff (IM)
- Telegram (if enabled)
- Discord (if enabled)

Avatar leaves region, SIM position (x,y,z coordinates) and how long one remained on region:
- Owner (IM)
- Staff (IM)
- Telegram (if enabled)
- Discord (if enabled)

Region restart (when region comes back online):
- Owner and Staff (*) (IM)
- Telegram (if enabled)
- Discord (if enabled)

(*) It often fail if hypergridding, offline or hypergriders UUIDs.



10) DETECTION SYSTEM
--------------------

- Avatar scan runs every ~5 seconds.
- NPCs are flagged as (NPC).
- Position is reported using integer coordinates. (x,y,z)
- When leaving script also detects how long it remained on region.


11) CROSS-GRID UUIDS
--------------------

- UUIDs from other grids may fail.
- Best results are with avatars that have logged into your grid at least once.


12) TROUBLESHOOTING
-------------------

STAFF NOT RECEIVING
- Avatar must exist on the grid
- Avatar must have logged in at least once
- UUID must be valid
- No spaces before/after UUID
- No empty lines

TELEGRAM NOT WORKING
- Check bot token
- Check chat ID
- No spaces
- Ensure Telegram is enabled in menu

DISCORD NOT WORKING
- Verify webhook URL
- No spaces
- Must start with:
https://discord.com/api/webhooks/
- Ensure Discord is enabled in menu

SIM RESTART MESSAGE NOT RECEIVED
- Owner always receives it
- Telegram / Discord must be enabled

TIMEZONE NOT CHANGING
- Only values between -12 and +12 are accepted
􀀀

TIME LABEL CONFUSION
- "GRID TIME" = Using grid's default timezone
- "Defined user time" = Using custom timezone you set
- Both show accurate time, just different labels to indicate source

SCRIPT NOT RESPONDING
- Reset the script
- Touch object again

INVENTORY CHANGES
- Editing the STAFF notecard reloads automatically
- If not, reset the script


13) REGION OWNERSHIP
--------------------

You do NOT need to own the region.

You only need rez rights.


=================================================
END
=================================================

Enjoy,
Jimmy Olsen

I`ve been working all these days on a V2 version of the Watchdog (using ChatGPT and DeepSeek AI)... Still running some tests here and there and check if all ok/stable. On this V2 version, calling it AIO - (ALL-IN-ONE) you can see the messages also on Discord and Telegram. Also now not only tells you when someone is entering or leaving your region, but also the SIM position (coordinates x,y,z) and how long they remained on region once they left!! And flags if its a npc in the region!!! O.o
E.g:
Jimmy Olsen entered NORGE (06:32:02 PM GRID TIME) | Pos: 1507, 930, 27
Jimmy Olsen left NORGE (08:23:14 PM GRID TIME) | Last Pos: 1505, 934, 29 and remained for 01h 51min 06sec
-----
Baldur (NPC) entered NORGE (06:28:27 PM GRID TIME) | Pos: 1185, 1243, 47
Baldur (NPC) left NORGE (06:33:07 PM GRID TIME) | Last Pos: 1185, 1243, 47 and remained for 00h 04min 34sec

------
Will advertise it when its done (will rez a vendor on URBAM MUSEM SIM, of course).
Thx Arielle for the idea. (couldn`t make it work on cell phone as it would require a paid server and API) but what it offers now is similar! Both Telegram and Discord have apps for cell phones and desktops!
Also thx for my friends Xenon, Luke, Crazy, Mc Cracken and Essensual who has been helping me testing it

***OPENSIM WATCHDOG V1 NEW RELEASE *****
A low-lag visitor tracking system for OpenSim regions, designed for grid owners, estate managers, and staff teams.(based on the old watchdog script made by Satyr Aeon and full modified by ChatGPT).
PLEASE READ NOTECARD "READ ME" BEFORE STARTING USE IT

This script automatically monitors your region and sends real-time notifications when avatars ENTER but also LEAVE, with accurate local time based on a selectable city and automatic Daylight Saving Time (DST) handling.

### Main features

• **Enter & Leave detection** – Notifies when avatars arrive and when they leave the region
• **Name-safe system** – Prevents name loss after teleport or logout
• **Staff notifications via notecard** – Add unlimited staff UUIDs to receive alerts
• **HG enabled messages notification - works across Hypergrid
• **City-based local time** – Choose a capital city from a notecard database (190 capital cities around the world)
• **Automatic DST calculation** – Supports Northern & Southern hemispheres
• **Fuzzy city search** – Accepts partial or approximate city names
• **Persistent settings** – City and timezone saved in object description, even after a SIM crash or reset.
• **Owner-only configuration** – City selection via private textbox
• **Low lag** – Timer-based scan, optimized lists
• **Sim restart detection** – Detects region reset and resumes tracking automatically
• **Back-online detection** – Continues tracking after the sim comes back online
• **Automatic reload on inventory change**

### Example notifications

> John Resident entered MyRegion at 14:32:10
> John Resident left MyRegion at 15:01:44

### Included notecards

• `NOTIFICATION STAFF` – list of staff UUIDs
• `CITIES` – city | standard offset | dst offset | hemisphere (N/S)

### Ideal for

• Store owners
• Club owners
• Rental estates
• Roleplay regions
• Security monitoring
• Staff coordination
• Visitor statistics (manual or scripted expansion)

If you need a reliable, customizable, and grid-safe visitor tracker with correct local time and DST support, this system is ready to drop into your region.

Enjoy :)

OPENSIM MULTI DESTINATION TELEPORTER ** NEW RELEASE***
Use only ONE teleport script for many, many destinations!
Teleport within a same region, to different regions or even for different grids!
Easy to use! No need to mess with script, just insert data inside a notecard!
Available for FREE and FULLPERM at URBAN MUSEUM, ground area, inside the building.

*** URBAN MUSEUM - ALL for URBAN, CITY RELATED ***
Unlock a world of urban knowledge with FREE and FULLPERM copies of all things city-related! At the Urban Museum, you’ll find an extensive collection covering roads, scripts, equipment, commercial buildings, and furniture that define urban living. Perfect for enthusiasts, students, and professionals alike. Don’t miss this opportunity to enrich your understanding of the urban landscape—visit us today!