sirBonus – A fun, lottery-style donation plugin that rewards players with random privileges once they successfully “win.” Perfect for boosting player engagement and integrating donation perks without overwhelming your server economy.


PREVIEW

Features

• Randomized Group Selection
  Configure multiple groups (e.g., donator, vip, supervip) with custom chances for each.
• One-Time Success
  Once a player wins, they cannot receive another bonus again (configurable).
• Cooldown System
  Prevents command spamming by enforcing a configurable cooldown in seconds.
• Persistent Winners
  Stores winners in a file so they remain ineligible even after server restarts.
• Multi-Language Support
  Built-in English, Russian, and French message files. Customize or add more if needed.
• LuckyPerms Integration
  Automatically adds inheritance nodes to players upon winning, ensuring easy permission management.
• Sound & Title Effects
  Play a celebratory sound (like fireworks) and show a big on-screen title when a player wins.

Command

• /freedonate
  • Main command to try your luck.
  • Requires permission: sirbonus.use (default: true).

Configuration
In config.yml, you can adjust:

• language: Choose en, ru, or fr.
• cooldown-seconds: Time in seconds between attempts.
• groups: A list of objects {name, chance} representing each group and its probability.
• reward-sound, sound-volume, sound-pitch: Control audio feedback on win.

Example snippet:

language: "en"
cooldown-seconds: 300
groups:
- name: "donator"
chance: 30
- name: "vip"
chance: 15
- name: "supervip"
chance: 5
reward-sound: ENTITY_FIREWORK_ROCKET_BLAST
sound-volume: 1.0
sound-pitch: 1.0

Installation & Setup

1. Welcome 1.20-1.21.4 | sirBonus - /freedonate PLUGINdoc
2. Welcome 1.20-1.21.4 | sirBonus - /freedonate PLUGINdoc
3. Welcome 1.20-1.21.4 | sirBonus - /freedonate PLUGINdoc

How It Works

1. A player runs /freedonate.
2. If they have not won before and are off cooldown, the plugin randomly picks a group from the config based on the assigned chances.
3. LuckyPerms grants that group to the player.
4. The player hears a celebratory sound, sees a title message, and cannot win again.
5. The plugin saves this result so it persists across restarts.

Permissions

• sirbonus.use: Allows usage of /freedonate. (Default: true)

FAQ

1. Why is LuckPerms required?
   • sirBonus uses LuckyPerms to assign group inheritance nodes seamlessly.
2. Can players spam the command?
   • No. The cooldown-seconds setting prevents spamming, and once they win, they cannot win again.
3. How do I add more languages?
   • Copy an existing messages_xx.yml, rename it, translate the lines, and update language in config.yml.
4. What if I want to reset winners?
   • Delete or edit the winners.yml file in the sirBonus folder. (Caution: This allows previous winners to attempt again.)

Need Help?

• https://discord.gg/XskQ76zFhx
  https://discord.gg/XskQ76zFhx
  https://discord.gg/XskQ76zFhx