Discord Touch Version V 1.00.00 (2023-12-03)

IMPORTANT - IMPORTANT - IMPORTANT

This is a drop-in script for the "Discord Relay and Server Joiner" at version 3.0 or higher, which is available at https://marketplace.secondlife.com/p/p/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 3.0 or higher of the relay to work. It will report any clicks to selected objects to your Discord server, with configurable message templates. The message templates can include the clicker's name (as clickable link to their web profile), the object (as clickable link to the object), the clicker's group (as clickable web link), and even the texture of the object clicked - all available in your Discord channel.

Just a few examples of what kind of object-clicks you can send to your Discord server:

- doorbells or summoning bells
- doors or windows
- adboards, notice boards, rule givers, notecard or landmark givers
- maps, teleport maps, teleport routers
- online status indicators, customer service boards
- alarm systems, fire alarms, emergency alarms
- etc.

Each of those applications can have their special notice template, so that a click on a doorbell sends a different notice to Discord, than a click on an adboard.

Configuration
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Your "Discord Relay and Server Joiner" (Which needs to be purchased beforehand, if you have not done so already) is the Base for this add-on. It contains a configuration notecard. Make sure you configure this notecard for your Discord Channel before continuing.

Discord Touch comes with TWO scripts. The Interface script goes into your Discord Relay. The Logger script goes into all the objects, whose getting-touched you want to monitor on Discord. You need at least one Logger, but can have as many as you like.

For a basic setup, no additional configuration is needed!

Every click to the objects with the Logger script will be sent to Discord with a message like "Region-name: User-name clicked Object-name" and a preview of the object texture clicked.

Texture preview & touch indicators
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
The Logger script sends information about the touched "face" (the side of the object touched) and the texture on that face to the Discord Relay. If you don't use touchmsg parameters, or if you use $P in your touchmsg-configuration, that info is sent to your Discord channel (unless you have not enough permissions on the texture).

The texture sent to Discord will always be the FULL texture for that face (side), even if the actual texture on the object is stretched or warped to show only a portion of the whole image. To help you interpret what someone saw and where they clicked, additional information is provided in the form of several symbols:

⇖ ⇗ ⇘ ⇙ Those arrow symbols indicate on which quadrant of the texture someone clicked. Upper left, upper right, lower right, or lower left quadrant.

⇕ indicates that the texture is stretched or shrunk, either horizontally, or vertically, or both.

↻ indicates that the texture got rotated (to any degree).

1-8 indicates, on which face (side) of the object a toucher has clicked.

Please note, that this preview is not always useful. While it might work great on message boards, maps or infopoints, it can be rather confusing on highly meshed and/or texture-mapped/baked objects. It really depends on the object - use touchmsg to switch it off when needed.

Version history
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

1.00.00 2023-12-03 First public release