DonationAlerts-Minecraft

A modification that allows you to receive events from DonationAlerts

Supports:

• Donation
• Twitch Bits
• Twitch Points
• Subscriptions to YouTube and Twitch

Allows to:

• Send message to the chat
• Execute any Minecraft commands (include mods)

You can download this from: Modrinth, CurseForge or Releases

Setup

Setup your token

There are several ways to set your token here.

With minecraft command

1. Copy the token to the clipboard from DonationAlerts service
2. Execute command in your minecraft chat

   /da set

   NO NEED to insert a token into the chat! The token will be taken from your clipboard.

With file

1. Open the file
   Windows: C:\Users\<your user>\.donation-alerts-token
   Linux: ~/.donation-alerts-token
2. Paste your token to the file
3. Save

Connect to the Donation Alerts

To connect to Donation Alerts, use the command in Minecraft

/da connect

To check connection status you can use command

/da status

And there is the command to disconnect

/da disconnect

Configuration

The settings file is in .minecraft/donation-alerts-integrate/settings.yaml
The file format is yaml, example:

disableSettingsUpdateMessage: false
disableWelcomeMessage: false
triggers:
- name: default
  description: example trigger
  isActive: true
  sensitives:
  - properties:
      type: daintegrate/sensitive/donate
      value:
        from: 5
        to: 10
        currency: USD
  handlers:
  - delay: 0 # Any comment you can type here!
    properties:
      type: daintegrate/handler/message
      value:
        message: Hello, <donation_username>! This is an example message for all events from Donation Alerts
  - delay: 10
    properties:
      type: daintegrate/handler/command
      value:
        command: time set day # The sun is rising
- name: Subscribtion
  isActive: true
  sensitives:
  - properties:
      type: daintegrate/sensitive/subscribe
      value:
        type: YouTubeSubscription
  handlers:
  - properties:
      type: daintegrate/handler/message
      value:
        message: <donation_username> just subscribe to YouTube!

triggers is a list of events that can trigger by each message from donation alerts

Sensitive

Conditions for trigger activation.
The DonationAlertsIntegrate provides multiple sensitive

Always

Parameters

Has no parameters

Example

sensitives:
- properties:
    type: daintegrate/sensitive/always

Donate

Activates if the amount falls within the specified range (from <= amount <= to).
And the currency matches.

Parameters

Example

sensitives:
- properties:
    type: daintegrate/sensitive/donate
    value:
      from: 5
      to: 10
      currency: USD

Subscribe

Activates if the type is matches

Parameters

Available types

• YouTubeSubscription
• TwitchSubscription
• TwitchFreeFollow
• TwitchGiftSubscription
• TwitchPrimeSubscription

Example

sensitives:
- properties:
    type: daintegrate/sensitive/subscribe
    value:
      type: YouTubeSubscription

Twitch points

Activates if the amount of Twitch points falls within the specified range (from <= amount <= to).

Parameters

Example

sensitives:
- properties:
    type: daintegrate/sensitive/twitch/points
    value:
      from: 0
      to: 1000

Twitch bits

Activates if the amount of Twitch bits falls within the specified range (from <= amount <= to).

Parameters

Example

sensitives:
- properties:
    type: daintegrate/sensitive/twitch/bits
    value:
      from: 0
      to: 2000

Handlers

Handlers for the trigger.
Perform actions when the trigger is activated.

Delay

Each handler, in addition to the properties object, has a delay property, it indicates after how many ticks the command will be executed.
By default, 1 second in minecraft is 20 ticks

Replace patterns

In commands and messages, you can specify patterns that will be replaced with the corresponding values.

<donation_message>
<donation_amount>
<donation_currency>
<donation_username>
<minecraft_playername>

Message

Adds a message to your chat

Parameters

Example

handlers:
- delay: 10
  properties:
    type: daintegrate/handler/message
    value:
      message: Hello! It's day time!

Command

Sends a command to the server on your behalf

Parameters

Example

handlers:
- delay: 10
  properties:
    type: daintegrate/handler/command
    value:
      command: time set day

Sub-modifications

// todo: add information abount sub modifications

Contribute

If you want to contribute, you can:

• Translate or edit translation in the modification here
• See here what you can do

TODO for adding new Minecraft version

1. Create a new module in Modifications, example: "fabric_1.20"
2. Add module to Modifications/settings.gradle
3. Create a integrate machine

   var cfgSource = DonationAlertsIntegrateFactory.create(
       "donation-alerts-integrate",
       "settings.yaml",
       LOGGER::info);   

4. Create basic handlers
   • MessageHandler
   • CommandHandler
5. Register basic handlers

   DonationAlertsIntegrate.configure(Constants.ModId, Constants.ModUrl)
       .registerHandler(new MessageHandler())
       .registerHandler(new CommandHandler());

6. Add information abount update settings file

   cfgSource.addListener(settings -> { });

   Consider the setting that allows to disable this message!

7. Create client side commands
   • /da set
   • /da connect
   • /da status
   • /da disconnect
8. Create DonationAlertsClient

   var listener = new DonationAlertsEventListener(new EventProcessor(), DonationAlertsIntegrate.getEventListeners());
   var client = new DonationAlertsClient(Constants.DonationAlertsEventServer, listener);

9. Call cfgSource.startListening() as late as possible.
   For start watcher on the config file
10. Create welcome message with short guide
    Example: fabric_1.20/ClientEntryPoint.java

Required and used:

MinecraftForge: https://github.com/MinecraftForge/MinecraftForge
Socket.io: https://github.com/socketio/socket.io-client-java
JSON-java: https://github.com/stleary/JSON-java