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
Worked Perfectly, Easy To Setup!
I bought this and the region visitor tracker for my sim and was able to get it all setup in 10 mins at most. The instructions are straightforward and I am confident that anyone can get this setup based on them even without any discord web-hook experience.
Purrrfect
To keep a track of your sim and who lands on it. VERY HELPFUL C.S.
Not Just An Other Script!
this script system is perfect for those who can not be in world all the time. The ones who run clubs, business meetings, and whatever else they would need a discord to relay into SL. It works from Sl to discord chat and is very handy. I personally tested this and a few of the plugin scripts and it has helped a great deal! 10 stars! I would recommend this to any of my friends and encourage the creators to kep coming out with more plugins. The only thing i would ask is, the scripts so we can create some of our own plugins for those of us who know how to script. None the less a great piece of work and i can not wait to see what the next step is!
Best of its kind in SL
If you're looking for a discord relay for your venue, just blindly go with this one. The set-up is quick and easy and I'm extremely satisfied with my purchase.
Great product
easy to install and use love it
simple and easy
follow the instructions given to you, you will have this up and going in under 5 minutes. easy and straight forward. It's a great tool
