ExpChange Plugin

ExpChange - это современный плагин для Minecraft серверов на PaperMC, который позволяет игрокам конвертировать опыт в портативные книги и обратно.

🎯 Особенности

• Конвертация опыта в книги - Преобразуйте свой опыт в портативные предметы
• Система тиеров - Различные уровни книг с уникальными эффектами
• Adventure API - Современные компоненты сообщений с поддержкой цветов и форматирования
• Защита от дюпов - Встроенная защита от эксплойтов и дублирования
• Комиссионная система - Настраиваемая комиссия за конвертацию
• Кулдаун система - Предотвращение спама команд
• Современная архитектура - Чистый код с разделением логики

📋 Требования

• Minecraft: 1.20.4+
• Сервер: PaperMC или его форки (Paper, Purpur, etc.)
• Java: 21+

🔧 Установка

1. Скачайте последнюю версию плагина из Releases
2. Поместите .jar файл в папку plugins/ вашего сервера
3. Перезапустите сервер
4. Настройте конфигурацию в plugins/ExpChange/config.yml

📝 Команды

Команда	Описание	Права
/expchange	Конвертировать весь опыт в книгу	expchange.use
/expchange <кол-во> exp	Конвертировать указанное количество опыта	expchange.use
/expchange <кол-во> lvl	Конвертировать опыт равный указанным уровням	expchange.use
/expchange <кол-во> lvl all	Создать максимум книг с указанным количеством уровней	expchange.use
/givexpbook <игрок> <кол-во>	Выдать книгу опыта игроку (админ)	expchange.admin
/exphelp	Показать справку по командам	expchange.use

🔑 Права доступа

• expchange.use - Базовое использование команд (по умолчанию: true)
• expchange.admin - Админские команды (по умолчанию: op)

⚙️ Конфигурация

Основные настройки в config.yml:

# Комиссия с конвертации (0.1 = 10%)
commission: 0.1

# Материал для книг опыта
item:
  material: BOOK

# Максимальное количество опыта в одной книге
max_xp_per_book: 1000000

# Минимальное количество опыта для конвертации
min_xp_for_conversion: 100

# Кулдаун между использованиями (секунды)
cooldown: 5

🏗️ Сборка из исходников

git clone https://github.com/ваш-username/ExpChange.git
cd ExpChange
./gradlew build

Готовый .jar файл будет в папке build/libs/

🔄 Версии

v2.0

• ✅ Обновление до Paper API 1.20.4
• ✅ Интеграция Adventure API для сообщений
• ✅ Современная архитектура с менеджерами
• ✅ Улучшенная защита от дюпов
• ✅ Система тиеров для книг
• ✅ Команда bulk создания книг

v1.0

• Базовая функциональность конвертации опыта

🤝 Участие в разработке

1. Fork проекта
2. Создайте feature branch (git checkout -b feature/amazing-feature)
3. Commit изменения (git commit -m 'Add amazing feature')
4. Push в branch (git push origin feature/amazing-feature)
5. Откройте Pull Request

📄 Лицензия

Этот проект использует лицензию MIT. Подробности в файле LICENSE.

👨‍💻 Автор

BedePay - GitHub Profile

🐛 Баг-репорты

Если вы нашли баг, пожалуйста, создайте Issue с подробным описанием проблемы.

---

⭐ Если вам нравится этот проект, поставьте звездочку!