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
Good Chat Relay for Discord
Works perfectly, fast, reliable and stable with Discord. It's also "The Heart" for all the other addons.
I can really recommend this one, same like all the addons from Peter.
Great tools/ Super outil
Vraiment que dire, celui ci et simple, facile a configuré, contiens toutes les explications
Merci Peter
-------------
Really what to say, this one is simple, easy to configure, contains all the explanations
Thanks Peter
Brilliant!
Does exactly what it says it does. easy to set up. The creator gives very detailed instructions along with videos that are very helpful. It's awesome to be able to monitor my land with out being there all the time. Exactly what i needed and highly recommend! Top of the line customer service as well! Can't go wrong here :) I got some of the other addons as well!
Awesome when paired with the parcel visitor tracker!
I use this to keep tabs on who enters and exits my parcel. I love the little Discord objects and that there is a high amount of customization within the script.
Fantastic Product!
Easy to set up and works flawlessly. If you want an easy way to keep track of what's going on, on your sim even when your away you Want this product. I purchased all the plug-in scripts as well. You can't go wrong with this product. Customer service is great. If you need help setting it up the creator is really friendly and helpful.
