**** 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