This little tool relays open chat to a Discord channel on a Discord server. it is one-way only, from SL to Discord. The chat appears in Discord using the display name and profile picture of the avatar. It doubles as a Discord Server Joiner / Discord Server Invite, so you can have your users join your Discord server easily.
How does it work?
The relay is chat activated, like your smartphone with "Hey Siri" or "Okay Google". Once you write the command - the default is "Oi Discord" - open chat is transmitted to Discord.
It transmits a maximum of 100 lines of text for a maximum of 20 minutes. Both values are configurable, the default is 5 lines of text within 60 seconds. The maximum limit is deliberate in order to avoid the object to siphon open chat indefinitely. Please contact me if you need a version without limits.
Once activated, the relay announces the relaying in open chat, indicating for how many lines of chat and for how long it relays. This gives avatars present enough warning to shut up if they don't want their chat relayed. Consequently, the relay also announces when it stops relaying. It only relays actual avatar chat and ignores objects. The chat appears in Discord using the display name and profile picture of the avatar.
The Mesh object
From version 1.4 on, an exclusive mesh object is included in the package. The mesh object is an original design, explicitly made for this product and optimized for SL. It is superior to all other Discord mesh logos you can currently find on the Marketplace, so there is no need to pay extra or go with a substandard solution.
The mesh object has an "on-air lamp" extension, that becomes visible when the relay transmits chat to Discord and switches off when the transmission stops. The white logo-area in the middle of the blue-ish bubble (Discord named this colour "blurple") doubles as an error indicator. If the Discord relay encounters any error, the face turns from white to red.
The behaviour of the "on air lamp" gets controlled via the "Discord Relay On Air Light" script. This script is included with full permissions, so you can alter or change its behaviour.
The mesh object comes in two versions. The standard version has a high level of detail (LOD) and looks good from afar and thus working great outdoors, but at the cost of having a land impact of 9. There is a second version which has just a land impact of 2, but looks less good from afar. This version is ideal for indoor spaces.
Other features
If an avatar touches the object, they get an instant message telling them how to activate the object.
If an avatar touches the object, the device can act as a Discord Server Joiner / Discord Server Inviter, giving the avatar the URL to join the Discord server. Within Discord, you can create an invite URL (attention: by default it is only valid one day - you need to actively change that) for any channel on your server.
If someone in open chat mentions Discord in a sentence - not the trigger phrase - the object advertises itself. I am unsure about this feature and might take it out or make it configurable in a future version.
The relay reports region restarts to the designated channel. It uses a map-view of the sim as icon for those purposes.
Extensions
From version 1.5 on, the Relay's functionality can be extended by drop-in scripts. Not everybody needs all the functions I get asked to develop or come up with myself, so I decided for this approach. Available extensions are listed as "Related Items" under this listing.
Known Issues & Limitations
Please be aware that this is a one-way-chat only, from SL to Discord. Two-way chat would need to have a server object outside of SL - which would incur not only a massive deal of development but would also incur running costs and create security and privacy issues. If you require two-way-communication, you might want to investigate into SL-Bots.
Version history
============
1.0 2020-06-05 Initial release
1.1 2020-07-02 Added Discord Server Invite / Join
1.2 2020-07-11 Better Output at Region Restart, less frequent open chat
1.3 2020-08-29 Added support for new webhook format, updated sim restart feature
1.4 2020-10-22 Mesh Logo object with on-air lamp, bugfix for server invite URL (case sensitive!), better config-warnings, increased limits to 100 lines and 20 minutes
1.5 2020-11-28 Added support for drop-in-scripts for additional functionality that does not need to go into main script, some cosmetic changes
1.6 2020-12-04 Support for new Discord invite URL format
1.7 2020-12-25 Maintenance Release with support for the Discord Region Tracker
1.8 2021-01-23 Added support for new Discord URL's, added support for silent-mode
1.9 2021-02-06 Added support for the Discord Online Tracker
2.01.03 2021-03-29 Changed version numbering, improved http-handling under high-load situations, improved "silent" bahviour, minor code optimization
- Send open chat to Discord
- Fully configurable
- Stay in touch when not inworld
- Reports region restarts to Discord
- Server Joiner functionality
very good
very good product works amazing
Thoroughly Impressed
Thank you for making this handy tool. I love how customizable it is.
Great job!
Simply USEFUL!
It's a really useful ADD-ON. From the price, I thought it might be something trivial, but it proved to be anything but! I mainly use it for commercial reasons and find it really useful! It also instantly updates avatars that enter and leave. I highly recommend it! ^^
Does what it says and is easy to use
I was not a discord user but I have been looking for a way to keep an eye open for when my favorite people are online. This product caught my eye and I bought it.
Very easy to install and configure. A little bit of learning to figure out Discord Servers and away we went. It has been working flawlessly!
I haven't tried any add-ons yet but if the basic tool is anything to go by, I would expect them to be good too.
Good job!
Nice to find an SL scripted product that is both intuitive and reliable!
This discord link is a lifesaver!
The Discord relay is amazing! Being able to monitor my parcel from my phone has solved a lot of problems for me. He also has several add-ons that even I was able to configure! LOL I will definitely be adding some of them.
