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
easy to use
The step by step is actually pretty easy to follow. Even though I am a computer person, I found it very straight forward and easy to set up.
Thanks so much for this
Excellent~
Im using this one with the visitor tracker and its an excellent tool.
Highly recommended ♥
Does what it say
I was searching for something against bots and ran into this. So I bought this first. It is a nice basic tool and does wat it say. Shame the time is a bit short. And communication only one sided: SL > Discord. Setup was easy enough if you have a bit understanding of Discord.
As advertised
Does exactly what it says on the tin. I'm using this product to connect my club with the discord community created for it and its working wonderfully.
Amazing 10 stars!
Service was amazing the creator reached out to me and helped me set it up.
Works amazing. I am very impressed. Thank you so much!
Great prize great creator great product.
10/10 recommended.
Absolutely Fantastic
I had a little difficulty with the initial setting up however this was not a product issue and more of a "me" issue. Customer Service was impeccable with not only response time but with instructions how to resolve my issue. Will deffo buy more.
