Installation

Installation & Setup / Установка и настройка

(English / Русский)

---

English

Prerequisites

1. Minecraft Server running Paper (or Spigot) 1.20+ (recommended).

2. LuckyPerms plugin installed on the server.(TESTED LuckPerms-Bukkit-5.4.156)

3. Java 17 or higher (as required by modern Paper versions).

Steps

1. Download the sirBonus plugin (the .jar file) from your chosen source.

2. Place the .jar into your server’s plugins folder.

3. Ensure LuckyPerms is also installed. Without LuckyPerms, sirBonus cannot assign groups.

4. Start or restart your server. The plugin will generate a sirBonus folder containing:

   • config.yml

   • messages_en.yml, messages_ru.yml, messages_fr.yml (depending on your chosen language)

   • winners.yml (created automatically after first usage)

5. Edit the config to your liking:

   • language for your preferred language (en, ru, fr).

   • cooldown-seconds to set the waiting time between attempts.

   • groups list for group names and chances.

6. Reload or restart the server to apply changes.

LuckyPerms Integration

• sirBonus uses the LuckyPerms API to add inheritance nodes.

• Make sure your groups (e.g. donator, vip, etc.) exist in LuckyPerms.

• If you need to create them, use /lp creategroup <groupName> in-game or in console.

Command Permissions

• sirbonus.use (default: true) Allows players to use /freedonate.

---

Русский

Предварительные требования

1. Сервер Minecraft на Paper (или Spigot) версии 1.20+ (рекомендуется).

2. Плагин LuckyPerms, установленный на сервере. ( ТЕСТИРОВАЛ LuckPerms-Bukkit-5.4.156)

3. Java 17 или выше (как требуется для современных версий Paper).

Шаги

1. Скачайте плагин sirBonus (файл .jar) из выбранного источника.

2. Переместите .jar в папку plugins вашего сервера.

3. Убедитесь, что LuckyPerms тоже установлен. Без него sirBonus не сможет назначать группы.

4. Запустите или перезапустите сервер. Плагин создаст папку sirBonus, в которой будут:

   • config.yml - выберите ваш язык, после чего создадут файл ниже

   • messages_en.yml, messages_ru.yml, messages_fr.yml (в зависимости от языка)

   • winners.yml (создастся автоматически после первого использования, чтобы не абузили)

5. Отредактируйте config.yml по своим потребностям:

   • language — предпочитаемый язык (en, ru, fr).

   • cooldown-seconds — время ожидания между попытками.

   • groups — список групп с их шансами.

6. Перезагрузите или перезапустите сервер, чтобы применить изменения.

Интеграция с LuckyPerms

• sirBonus использует API LuckyPerms для добавления узлов наследования.

• Убедитесь, что группы (например, donator, vip и т.д.) существуют в LuckyPerms.

• Если нужно, создайте их командой /lp creategroup <имяГруппы> в игре или в консоли.

Права на команду

• sirbonus.use (по умолчанию true) Позволяет игрокам использовать /freedonate.