IMPORTANT - IMPORTANT - IMPORTANT
This is a drop-in script for the "Discord Relay and Server Joiner" at version 1.7 or higher, which is available at https://marketplace.secondlife.com/p/Discord-Chat-Bot-Relay-Server-Joiner-Send-chat-to-Discord-for-fun-homes-clubs-meetings-shops/19908039
This script WILL NOT FUNCTION WITHOUT the Discord Relay! It NEEDS the Discord Relay in order to function!
IMPORTANT - IMPORTANT - IMPORTANT
What does it do?
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This script is an addition to the Discord Relay and will require version 1.7 or higher of the relay to work. It will report all avatar visits within a designated area and report on arriving and leaving avatars as well as avatars that log off or crash. The trackable area ist roughly 2/3 of a region at maximum. Arriving avatars have additional information show: A guess of the avatar's gender, current group tag worn, and avatar rendering weight.
Unlike older and less sophisticated visitor trackers, this script does not relay on slow and laggy sensors. Instead, avatars are detected inside a rectangular area.
The area gets defined by two opposing corners. Either get the coordinates from your SL viewer, or place the helper objects at the corners and touch them. They will print out the coordinates in open chat.
You can chose to ignore avatars with a specified active group from tracking.
That's it! No more configuration necessary. Just drop the Discord Visitor Tracker script into the same object the Discord Relay script and the configuration notecard resides in - ready!
Arriving visitors
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If a visitor arrives within the coordinates, the following information gets transmitted to the Discord channel configured:
- Avatar profile photo from their WEB(!) profile (if set)
- Display name in bold, followed by "bot" as an indicator from Discord that this message comes from outside of Discord
- the ">" sign to show it is an arrival
- Legacy name, linked to the web profile of the avatar
- Gender guess of the avatar (be aware that this fails for genderfluid avatars)
- Current group title, if set
- Avatar rendering weight (sometimes this can't get detected)
- Location of the avatar (pushpin-symbol is the link)
Leaving visitors
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If a visitor leaves the area within the coordinates, the following information gets transmitted to the Discord channel configured:
- Avatar profile photo from their WEB(!) profile (if set)
- Display name in bold, followed by "bot" as an indicator from Discord that this message comes from outside of Discord
- the "<" sign to show it is a departure
- Legacy name, linked to the web profile of the avatar, in italics
Logoffs / crashes
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
If a visitor logs off or crashes while in the monitored area, certain information can't be easily acquired. Therefore the following gets transmitted to the Discord channel configured:
- Babel logo
- Name of the object the Discord scripts reside in, followed by "bot" as an indicator from Discord that this message comes from outside of Discord
- the "<" sign to show it is a departure
- Unliked legacy name in italics, followed by the word "logged off"
Suggestions, Bug Reports, Feature Requests
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Please let me know if you run into trouble, or have any suggestions. Also let me know if you like it. I am open to feature requests and commissioned work. Let me know on Discord: https://discord.gg/9dAUeaH (where else).
Known Issues & Limitations
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
In order to have an avatar icon displayed, the user needs to have their SL web profile enabled and have uploaded a web profile pic. This can be done at https://my.secondlife.com/settings/profile - There is NO way to find out from within SL if the web profile pic is set, so I can't display an alternate texture. In this case, the avatar icon of the webhook is displayed.
If you want to have the visitor tracking go to a different channel than the general Discord chat, you need to place TWO copies of the Discord relay. Configure the additional copy for a different channel, and place the Discord Visitor Tracker into that copy.
Version history
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
1.0 2020-11-28 Initial Release
2.0 2020-12-26 Completely rewritten codebase
2.1 2021-01-24 Added feature to ignore avatars with same group
2.2 2021-01-24 Formatting fix
2.3.3 2021-03-29 Changed version numbering, added location to avatar
2.3.5 2021-05-03 Added ignore-list functionality
2.3.6 2022-01-23 Scan area overlapping parcels w/ same owner, fixed location pin for mobile devices
3.00.02 2023-04-16 Brought in line with V3 codebase. New coordinate getter. Changes to the ignore config-parameter.
3.00.03 2024-10-18 Added minimal mode, and nostartupmsg support.
- Reports arriving and leaving avatars to Discord Channel
- Avatar image, display name and legacy name linked to profile
- Any rectangular area of any size on the parcel can be tracked for enter/leave
- Reports avatar rendering weight, group title and guessed gender
- Ignore avatars with a specific active group (optional)
A great addition to the Discord relay!
I've hooked up the relay so I can see who pops in and out of my parcel. Works awesome and is easy to customize.
Fantastic addition to the Discord Chat Bot Relay + Server Joiner
Easy to set up and works flawlessly. If you want an easy way to keep track of what's going on, on your sim even when your away you Want this product. I purchased all the plug-in scripts as well. You can't go wrong with this product. Customer service is great. If you need help setting it up the creator is really friendly and helpful.
Brilliant!
*From my phone(the discord app)* I can see who comes in, which parcels they visit on my sim, and when they leave. This is brilliant!
Setting up discord was a breeze, and creating a webhook was a snap, and each of my trackers come through the same channel, as I'd hoped. And very soon after I'd set it up, the creator checked in to make sure I wasn't going crazy. ;-)
10 stars!
An excellent product for the price
This allowed us to get offline notifications when we had visitors to our parcel. We found the setup to pretty easy with the provided documentation.
Perfect!!
This is a very easy to use item and works great! We've been looking for a webhook for the longest time. When we're trying to greet our landers, its nice to have discord open to alert us that someone is on sim while being able to do things in RL. Whenever there was an issue, Peter has been great to get back to me as soon as possible to help answer my questions.
