📚Information

Highly optimized, feature-packed, and unique Donations plugin.

Elevate your server’s support system with our seamless donation integration! Our Donation plugin enables easy setup of multiple donation tiers and rewards, allowing players to contribute and receive exclusive perks.

Highlights:

• Unlimited Milestones: Create as many donation milestones as you want, both personal and global!

• Donation History: Players can view their donation history at ease, including price, timestamp and item!

• GGWave: Create GGWaves with rewards for entering!

• Donation Effects: Apply effects to players and execute commands when a player donates!

• Multi-Server Support: Donation History and Milestones can be shared across various servers!

Short Showcase Video

Need support or have some questions? Visit https://blockm.art or join our Discord server and open a ticket!

PlaceholderAPI Support

This plugin does not have any Placeholders.

Events

This plugin has events for listening to donations!

Events

final GGWaveEndEvent ggWaveEndEvent = new GGWaveEndEvent(product, player, spent);
final GGWaveStartEvent ggWaveStartEvent = new GGWaveStartEvent(product, player, spent);
final GGWaveMessageEvent ggWaveMessageEvent = new GGWaveMessageEvent(player, firstJoin, ggWaveStyle);

Commands

Arguments wrapped in diamonds <arg> are required for the command to run properly. Arguments wrapped in square braces[arg] are treated as optional

Admin Commands (Permission: tidedonations.admin)

• /ggwave start <player> <amount> [message] (Requires atleast one)

  • Starts a GGWave for the server!

Player Commands (Permission: None unless specified)

• /donationgoals

  • Views your personal goals and the global goals

• /donationhistory

  • Views your past donations!

Modules

Donation Effects

donationeffects.yml

hooks:
  ggwave: true
  donate: true

duration: 10

effects:
  - "JUMP;3"

Donation Goals

donationgoals.yml

goals:
  personal:
    tier-one:
      name: "Tier One"
      reward-description: "&3100 Experience, &2100 Emeralds"
      required-amount: 100
      commands:
        - "exp give %player% 100"
    tier-two:
      name: "Tier Two"
      reward-description: "&3200 Experience, &2200 Emeralds"
      required-amount: 110
      commands:
        - "exp give %player% 200"
    tier-three:
      name: "Tier Three"
      reward-description: "&3300 Experience, &2300 Emeralds"
      required-amount: 120
      commands:
        - "exp give %player% 300"
    tier-four:
      name: "Tier Four"
      reward-description: "&3400 Experience, &2400 Emeralds"
      required-amount: 130
      commands:
        - "exp give %player% 400"
    tier-five:
      name: "Tier Five"
      reward-description: "&3500 Experience, &2500 Emeralds"
      required-amount: 140
      commands:
        - "exp give %player% 500"
    tier-six:
      name: "Tier Six"
      reward-description: "&3600 Experience, &2600 Emeralds"
      required-amount: 150
      commands:
        - "exp give %player% 600"
    tier-seven:
      name: "Tier Seven"
      reward-description: "&3700 Experience, &2700 Emeralds"
      required-amount: 160
      commands:
        - "exp give %player% 700"
    tier-eight:
      name: "Tier Eight"
      reward-description: "&3800 Experience, &2800 Emeralds"
      required-amount: 170
      commands:
        - "exp give %player% 800"
    tier-nine:
      name: "Tier Nine"
      reward-description: "&3900 Experience, &2900 Emeralds"
      required-amount: 180
      commands:
        - "exp give %player% 900"
    tier-ten:
      name: "Tier Ten"
      reward-description: "&31000 Experience, &21000 Emeralds"
      required-amount: 190
      commands:
        - "exp give %player% 1000"
  community:
    tier-one:
      name: "Tier One"
      reward-description: "&3100 Experience, &2100 Emeralds"
      required-amount: 100
      commands:
        - "exp give %player% 100"
    tier-two:
      name: "Tier Two"
      reward-description: "&3200 Experience, &2200 Emeralds"
      required-amount: 110
      commands:
        - "exp give %player% 200"
    tier-three:
      name: "Tier Three"
      reward-description: "&3300 Experience, &2300 Emeralds"
      required-amount: 120
      commands:
        - "exp give %player% 300"
    tier-four:
      name: "Tier Four"
      reward-description: "&3400 Experience, &2400 Emeralds"
      required-amount: 130
      commands:
        - "exp give %player% 400"
    tier-five:
      name: "Tier Five"
      reward-description: "&3500 Experience, &2500 Emeralds"
      required-amount: 140
      commands:
        - "exp give %player% 500"
    tier-six:
      name: "Tier Six"
      reward-description: "&3600 Experience, &2600 Emeralds"
      required-amount: 150
      commands:
        - "exp give %player% 600"
    tier-seven:
      name: "Tier Seven"
      reward-description: "&3700 Experience, &2700 Emeralds"
      required-amount: 160
      commands:
        - "exp give %player% 700"
    tier-eight:
      name: "Tier Eight"
      reward-description: "&3800 Experience, &2800 Emeralds"
      required-amount: 170
      commands:
        - "exp give %player% 800"
    tier-nine:
      name: "Tier Nine"
      reward-description: "&3900 Experience, &2900 Emeralds"
      required-amount: 180
      commands:
        - "exp give %player% 900"
    tier-ten:
      name: "Tier Ten"
      reward-description: "&31000 Experience, &21000 Emeralds"
      required-amount: 190
      commands:
        - "exp give %player% 1000"

command:
  base-command: "donationgoal"
  aliases:
    - "donogoal"
    - "tidedonationgoal"

messages:
  "not-enough-progress-personal":
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &f&l→ &7To reach this donation goal, you need to donate &f%needed%.00 &7more!"
  "not-enough-progress-community":
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &f&l→ &7To reach this donation goal, the community needs to donate &f%needed%.00 &7more!"
  "claimed-reward":
    message:
      enabled: true
      value:
        - "&a&lTech&2&lTide &f&l→ &7You have successfully claimed the &a%goal-name% &7reward! &8(&7%type% Reward&8)"
  "already-claimed-reward":
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &f&l→ &7You have already claimed the &c%goal-name% &7reward!"
menus:
  category-menu:
    title: "&8&nDonation&r &8&nGoals"
    rows: 3
    borders:
      "gray":
        material: "BLACK_STAINED_GLASS_PANE"
        name: " "
        lore: []
        slots:
          - "0-26"
    items:
      personal-goals:
        slot: 12
        material: "SOUL_LANTERN"
        name: "&3&lPersonal &b&lRewards &8(&7Player Rewards&8)"
        lore:
          - "&8Menu Item"
          - "&7"
          - "&b&lStatistics:"
          - "&7- &b&lTotal: &f$%personal-total%.00"
          - "&7"
      community-goals:
        slot: 14
        material: "LANTERN"
        name: "&d&lCommunity &5&lGoals &8(&cServer-Wide &7Rewards&8)"
        lore:
          - "&8Menu Item"
          - "&7"
          - "&d&lStatistics:"
          - "&7- &d&lTotal: &f$%community-total%.00"
          - "&7"
  community-donation-menu:
    title: "&8&nCommunity&r &8&nDonation&r &8&nGoals"
    rows: 5
    reward-slots: [10, 12, 14, 16]
    borders:
      "gray":
        material: "BLACK_STAINED_GLASS_PANE"
        name: " "
        lore: []
        slots:
          - "0-44"
    items:
      claimed:
        material: "LIME_STAINED_GLASS_PANE"
        name: "&a&lClaimed &2&lReward"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&a&lINFORMATION:"
          - "&7- &a&lTier: &f%goal-name%"
          - "&7- &a&lReward: &f%reward%"
          - "&7- &a&lRequired: &f%required-amount%"
          - "&7"
      claimable:
        material: "ORANGE_STAINED_GLASS_PANE"
        name: "&6&lClaim &e&lReward"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&6&lINFORMATION:"
          - "&7- &6&lTier: &f%goal-name%"
          - "&7- &6&lReward: &f%reward%"
          - "&7- &6&lRequired: &f%required-amount%"
          - "&7"
      locked:
        material: "RED_STAINED_GLASS_PANE"
        name: "&c&lLocked &4&lTier"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&c&lINFORMATION:"
          - "&7- &c&lTier: &f%goal-name%"
          - "&7- &c&lReward: &f%reward%"
          - "&7- &c&lRequired: &f%required-amount%"
          - "&7"
      current-page:
        slot: 31
        material: "COMPASS"
        name: "&8&lCurrent &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      next-page:
        slot: 33
        material: "SPECTRAL_ARROW"
        name: "&8&lNext &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      previous-page:
        slot: 29
        material: "TIPPED_ARROW"
        potion-type: "INSTANT_HEAL"
        hide-flags: true
        name: "&8&lPrevious &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
  personal-donation-menu:
    title: "&8&nPersonal&r &8&nDonation&r &8&nGoals"
    rows: 5
    reward-slots: [10, 12, 14, 16]
    borders:
      "gray":
        material: "BLACK_STAINED_GLASS_PANE"
        name: " "
        lore: []
        slots:
          - "0-44"
    items:
      claimed:
        material: "LIME_STAINED_GLASS_PANE"
        name: "&a&lClaimed &2&lReward"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&a&lINFORMATION:"
          - "&7- &a&lTier: &f%goal-name%"
          - "&7- &a&lReward: &f%reward%"
          - "&7- &a&lRequired: &f%required-amount%"
          - "&7"
      claimable:
        material: "ORANGE_STAINED_GLASS_PANE"
        name: "&6&lClaim &e&lReward"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&6&lINFORMATION:"
          - "&7- &6&lTier: &f%goal-name%"
          - "&7- &6&lReward: &f%reward%"
          - "&7- &6&lRequired: &f%required-amount%"
          - "&7"
      locked:
        material: "RED_STAINED_GLASS_PANE"
        name: "&c&lLocked &4&lTier"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&c&lINFORMATION:"
          - "&7- &c&lTier: &f%goal-name%"
          - "&7- &c&lReward: &f%reward%"
          - "&7- &c&lRequired: &f%required-amount%"
          - "&7"
      current-page:
        slot: 31
        material: "COMPASS"
        name: "&8&lCurrent &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      next-page:
        slot: 33
        material: "SPECTRAL_ARROW"
        name: "&8&lNext &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      previous-page:
        slot: 29
        material: "TIPPED_ARROW"
        potion-type: "INSTANT_HEAL"
        hide-flags: true
        name: "&8&lPrevious &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"

GGWave

ggwave.yml

ggwave-duration: 10

styles:
  style: "DEFAULT" # If no Style is selected via TideCosmetics, or plugin is not enabled.
  default-ggwave-list:
    - "&a&lGG"
    - "&c&lGG"

reward:
  enabled: true
  value:
    - "exp give %player% 100"

command:
  base-command-name: "ggwave"
  aliases:
    - "ggw"
    - "tideggwave"
  sub-commands:
    "start":
      base-alias: "start"
      aliases:
        - "create"
      not-enough-args:
        sound:
          enabled: true
          value: "FIZZ"
          volume: 1
          pitch: 1
        message:
          enabled: true
          value:
            - "&c&lTech&4&lTide &f&l→ &7Invalid arguments! Proper usage: &c/ggwave start <player> <amount> {info}"

messages:
  "no-permission":
    sound:
      enabled: true
      value: "FIZZ"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &f&l→ &7You do not have &cpermission &7to execute this command."
  "admin-help":
    sound:
      enabled: true
      value: "BLOCK_NOTE_PLING"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&b&lGGWave &f&l→ &7To start a GGWave session, use the following command:"
        - "&b/ggwave start &e<player> <amount> &d<info>"
        - "&7Example: &b/ggwave start &eTechTide 10 &dGod Set!"
        - "&7This will start a GGWave session for the specified player with the provided info."
  "invalid-player":
    sound:
      enabled: true
      value: "FIZZ"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &f&l→ &7You have specified a(n) &cinvalid player&7."
  "invalid-amount":
    sound:
      enabled: true
      value: "FIZZ"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &f&l→ &7You have specified a(n) &cinvalid amount&7."
  "donate":
    sound:
      enabled: true
      value: "ORB_PICKUP"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&3&m--------------------------------"
        - " "
        - "&b&l   GGWave Event Activated"
        - " "
        - "&7&o  Congratulate &b&o%player%"
        - "&7&o for purchasing &b&o%package% for &b&o$%amount%&7&o!"
        - " "
        - "&3&m--------------------------------"

Donation History

history.yml

timezone: "America/New_York"

command:
  base-command: "donationhistory"
  aliases:
    - "donohistory"
    - "pastdonations"

menu:
  rows: 4
  title: "&8&nDonation&r &8&nHistory"
  history-slots: [10, 11, 12, 13, 14, 15, 16]
  borders:
    "gray":
      material: "BLACK_STAINED_GLASS_PANE"
      name: " "
      lore: []
      slots:
        - "0-9"
        - "17-35"
  items:
    history:
      material: "BOOK"
      name: "&d&lDonation &5&lHistory"
      lore:
        - "&8Informational Item"
        - "&7"
        - "&d&lINFORMATION:"
        - "&7- &d&lTime Stamp: &f%time%"
        - "&7- &d&lAmount: &f%amount%"
        - "&7- &d&lItem: &f%item%"
        - "&7"
    current-page:
      slot: 22
      material: "BOOK_AND_QUILL"
      name: "&8&lCurrent &7&lPage &8(&f%page%&8)"
      lore:
        - "&8Informational Item"
        - "&7"
        - "&8&lINFORMATION:"
        - "&7- &8&lPage: &f%page%"
        - "&7"
    next-page:
      slot: 24
      material: "SPECTRAL_ARROW"
      name: "&8&lNext &7&lPage &8(&f%page%&8)"
      lore:
        - "&8Informational Item"
        - "&7"
        - "&8&lINFORMATION:"
        - "&7- &8&lPage: &f%page%"
        - "&7"
    previous-page:
      slot: 20
      material: "TIPPED_ARROW"
      potion-type: "INSTANT_HEAL"
      hide-flags: true
      name: "&8&lPrevious &7&lPage &8(&f%page%&8)"
      lore:
        - "&8Informational Item"
        - "&7"
        - "&8&lINFORMATION:"
        - "&7- &8&lPage: &f%page%"
        - "&7"

Default Configuration Files

Modules Configuration

modules.yml

ggwave: true
donationgoal: true
donationeffects: true
history: true

Storage Configuration

storage.yml

storage:
  type: "JSON" # JSON | SQL
  host: 0.0.0.0
  username: "username"
  password: "password"
  database: "database"
  port: 3306