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)
Perfect
A very useful tool, very happy
Really cool stuff!
Works perfectly fine, is exactly what I needed and the creator is super helpful and friendly!
Great Product!
Setup is easy if following the instructions and it works perfect and reliable! Worth every single L$ for it!
Very Happy
Following the manual in the NC made the set up as easy as 1, 2, and 3. I love an easy set up and clear instructions, but what really won me over was the creator reaching out to me himself to check up on my purchase and installment. By doing so I felt very supported as a customer and because of his additional support we found a couple of lines in the text of the notecard for the script that needed to be corrected!
Great product, functionality, fabulous customer service, and interpersonal experience. Frankly, I wish this content creator made things I could continually purchase, these items I bought are more of a one-time purchase type deal.
Simple, Easy and Affordable
Setup was super simple and super easy. I'm not the brightest when it comes to the fancy toys, but Peter did an excellent job at making this easy to understand for me. Had it all set up in a matter of minutes. And for the price? Incredibly affordable and packed with features, you can't wrong.
Great investment for your business
I Wanted a simple visitor tracker but every one I've ever had was unreliable at best. I purchase this and the discord relay and it works perfectly. Keeps track of visitors, arrival, and departure time from your land. Very simple to setup too and documentation makes it even easier. Would definitely recommend.
