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)
easy to use and set up
after all the money i spent of stuff in the past this is the best way to do it and it works perfect , its is really packed with info.
Does exactly what it says better than I had hoped.
I purchased this along with the Discord Chat Relay purely for added home protection, as my current parcel is within a relatively public sim and I'm not allowed to have ban lines (skybox home only). After following the very easy to understand instructions, it did everything I had hoped for and the alerts were near instant (only maybe a second or two after someone took a step into its scan range).
One small thing - it could've been that I simply didn't see it in the notecard, but I could not find just how big number-wise the actual scan range was. It stated 1/3rd of a sim, but what might that include height-wise? I put it to the test and in my 2048 parcel, I used the z-axis coordinates of: 21.8 to 2004.1. About 2k meters. On my Discord it states: "Scan area too large: 3,668,416 m³ / Vector distance: 1985 m". However, it was still able to scan people walking in from ground level. Sidenote: The "Ground" in this sim is mesh, not actual SL ground. It's at around 100m.
And it hasn't seemed to have failed yet. In fact I've already caught a few folks being a little too curious and tping into my home (who got booted by a security orb). One walked into my parcel at ground level and then tried to tp upward, while one tried to tp from outside of my parcel and right into my home. Both were logged and shown in Discord. I then had one more flying around at around 1000 meters. Not an intruder, but they were also found and reported by the scanner.
So overall, I'm greatly enjoying this product. Your mileage may vary if you make your scan range too large however, but for me it seems to be working just fine.
Brilliant & Worth It
Fantastic scripting! Before this the only area tracker you could do is a volume/collision tracker.. this is so well done! Works perfectly and lets me keep track of visitors when I can't be on SL. Raises my customer service level 100%!
Great Tracker
The Tracker worked as it is intended. I like that it lets you track selected areas within a parcel, most trackers won't do that. The set up is a little tricky, but the developer was very helpful. I would recommend this to a friend.
YAY!
this is really cool. i can keep track who comes and goes from my land while im not there. All the info is sent right to my discord. it was pretty simple to setup and get doing. maybe 15 mins tops. the creator was very helpful and very friendly! i would highly recommend this product. works exactly as it should and does what it says it does! love it!
