Discord Payment Version 3.00.03 (2023-11-01)

IMPORTANT - IMPORTANT - IMPORTANT

This is a drop-in script for the "Discord Relay and Server Joiner" at version 2.4 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 2.04 or higher of the relay to work. It will report all payments made to objects of the same owner on the same region, by means of a single, zero-config script dropped into these objects. This is useful for tip-jars, vendors, donation boxes, rent cubes etc. The object accepting the payments needs to be modifiable, so you can drop the script inside. This script does NOT need debit permissions and does NOT interfere with the actual payment process. Payments will be reported to Discord with the name and clickable position of the object, name and clickable profile of the avatar doing the payment, amount paid and total payments received.

Native CasperVend support
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This system natively supports the CasperTech® vendor products, so you can receive your sales notifications in Discord. For this, you have TWO options:

Individual vendor mode
================================
In thise mode, you add the "Discord Payment Logger" script to all(!) your CasperTech® CasperVend vendors (any version, even the headless vendors will do), it switches to native CasperVend support mode. In this mode, you get MORE information relayed to Discord:

- Name of the product being bought
- Recipient of the product if it was gifted
- Weblink to the transaction
- Location (clickable SLURL) of the vendor who registered the sale

Dropbox mode
================================
In thise mode, you add the "Discord Payment Logger" script to your CasperTech® DropBox. In this mode, you get LESS information relayed to Discord, with the advantage that you automatically get all sales notifications from all vendors from a central point:

- Name of the product being bought
- Recipient of the product if it was gifted
- Weblink to the transaction

Configuration
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Your "Discord Relay and Server Joiner" contains a configuration notecard that has, hopefully, already been configured for your Discord channel.

Add the "Discord Universal Payment Interface" script to the Discord Relay object.

Next, add a copy of the "Discord Payment Logger" script into each object whose received payments you want to log to Discord. You can add the script to as many objects as you like.

No additional configuration needed.

Known Issues & Limitations
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

Debit Permissions:
This script does NOT need debit permissions, as it never "touches" the actual L$ transaction. However, it can happen that after adding the "Discord Payment Logger" to an object, a debit permission dialog pops up. This dialog does NOT come from the Discord script, but from the original scripts in the object.

Mod Permissions:
The "Discord Payment Logger" can only be added to objects that can be modified by you.

Guilded.gg compatibility
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
This add-on also works with the Guilded.gg relay, available at https://marketplace.secondlife.com/p/p/23055008

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

0.00.01 2022-05-07 First version to testers
1.00.00 2022-05-15 First public release
1.01.00 2022-06-21 Native CasperVend support
1.02.00 2022-07-11 Support for CasperTech® Dropboxes for centralized reporting
1.02.01 2023-01-21 Added nototals config option
3.00.02 2023-04-16 Moved to V3 codebase
3.00.03 2023-11-01 Logger script now resets totals at month rollover

• Logs all payments to vendors, tip jars, rent cubes, etc. to Discord
• Works with any and all payable objects, as long as they are mod
• Native CasperVend support - single script in the CasperTech DropBox
• Zero-config - it just works
• Does NOT require debit permissions!