Discord Visitor Version 3.00.03 (2024-10-18)

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)