VExpPlugin - Полная Документация


VExpPlugin — это универсальный и многофункциональный плагин для Minecraft, который предоставляет игрокам и администраторам полный контроль над системой опыта. От удобного обмена опыта через GUI до продвинутой автоматической починки брони и оптимизации частиц — VExpPlugin делает управление опытом простым и эффективным.



✨ Основные Функции

Обмен Опыта через GUI

Легко конвертируйте свои уровни опыта в ценные бутылочки через интуитивно понятное меню.

• Гибкие уровни: Поддержка кастомных уровней (например, 5, 20, 100 lvl), полностью настраиваемых в конфигурации.
  
  
• Информативные подсказки: Каждая бутылочка в GUI имеет подробное описание, включая стоимость и эффект.
  
  
• Простое получение: Для создания бутылочки вам понадобится лишь пустая стеклянная бутылочка в инвентаре.

Автоматическая Переработка Опыта (/vexpauto)


Настройте плагин на автоматическую конвертацию вашего опыта в бутылочки, пока у вас есть необходимые ресурсы.

• Настраиваемый уровень: Вы можете указать, на каком уровне опыта будет происходить авто-обмен (например, /vexpauto 30).
  
  
• Гибкое управление:
  • Через команду: Активируйте и настройте уровень авто-обмена с помощью /vexpauto <уровень>.
    
    
  • Через GUI: В меню /vexp есть специальная кнопка для включения/выключения авто-обмена. Вы также можете указать уровень через чат с возможностью отмены ввода.
• Информативное автоматическое отключение: Плагин теперь чётко сообщает игроку, почему авто-обмен был остановлен (нехватка опыта, отсутствие стеклянных бутылочек, заполненный инвентарь), автоматически деактивируя его до устранения проблемы.

️ Починка Брони


Эффективно восстанавливайте прочность вашей экипировки.

• Мгновенный ремонт: Восстанавливает прочность всей надетой брони сразу.
  
  
• Настраиваемая стоимость: По умолчанию 1 уровень опыта = 1 единица прочности, но это легко изменяется в config.yml.
  
  
• Новое в 2.8: Частичный ремонт и возврат опыта: Если у вас недостаточно опыта для полного ремонта, броня будет починена на максимально доступное количество, а неиспользованный опыт будет возвращён игроку.
  
  
• Автоматическая починка: Опыт из используемой бутылочки может быть автоматически потрачен на ремонт надетой брони (включается в настройках).
  
  
• Улучшенные сообщения: Более точные сообщения о состоянии брони (например, "Вся ваша броня уже полностью починена!" или "На вас не надета броня, которую можно починить.").

Дополнительные Возможности

• Режим ванильных бутылочек: Настройте бутылочки опыта так, чтобы они разбивались как обычные ванильные бутылочки (с выпадением частиц опыта) или сразу добавляли опыт игроку.
  
  
• Оптимизация частиц опыта: В ванильном режиме плагин может спавнить одну большую частицу опыта вместо множества мелких, что значительно снижает нагрузку на сервер и улучшает производительность.
  
  
• Контроль создания кастомных бутылочек: Администраторы могут запретить создание бутылочек произвольного уровня через команду /vexpadd, обеспечивая дополнительный контроль над экономикой сервера.
  
  
• Гибкие настройки: Все аспекты плагина легко настраиваются через конфигурационные файлы config.yml, gui.yml и messages.yml.

⚙️ Установка

1. Скачайте актуальный .jar файл плагина с нашей страницы на SpigotMC.
   
   
2. Переместите скачанный файл в папку plugins/ на вашем сервере Minecraft.
   
   
3. Перезагрузите сервер (/reload или полный перезапуск).
   
   
4. При первом запуске плагин автоматически создаст необходимые конфигурационные файлы: config.yml, gui.yml и messages.yml.

Команды


Команда Описание Права
/vexp Открывает главное меню обмена опыта VExp. Vexp.use
/vexpauto <уровень> Включает автоматическую переработку опыта на заданном уровне. Vexp.auto
/vexpauto disable Отключает автоматическую переработку опыта. Vexp.auto
/vexpadd <уровень> Создает кастомную бутылочку опыта (доступно только админам). Vexp.admin
/vexpsettings Открывает меню настроек плагина. Vexp.settings
/vexp reload Перезагружает конфигурационные файлы плагина (config.yml, gui.yml, messages.yml). Vexp.admin


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


Все основные настройки плагина находятся в папке plugins/VExpPlugin/.



config.yml


(Содержимое файла config.yml вставлено без изменений)

# Основные настройки плагина VExp

# Настройки опыта и бутылочек
experience:
# Список уровней опыта, которые будут доступны для создания бутылочек в GUI.
levels:
- 15
- 20
- 25
- 35
# Максимальный уровень, который игрок может ввести для авто-обмена опыта.
max-level: 1000
# Настройки для ванильных бутылочек опыта.
# Если true, бутылочки будут разбиваться как обычные, давая опыт,
# но с учетом уровней VExp.
vanilla-bottle:
default: false # По умолчанию игроки будут получать уровни сразу, без разбивания.
# Задержка между использованием бутылочек опыта.
# Указывается в тиках (1 секунда = 20 тиков).
bottle-use-cooldown: 10 # 0.5 секунды (например, если хочешь 0.1 секунду, ставь 2)
# Оптимизация спавна орбов опыта при использовании ванильных бутылочек.
# Если true, опыт будет выдаваться одним большим орбом, а не множеством маленьких.
optimized-orbs: true
# Цвета для уровня в названии бутылочки опыта.
# Например, "1: &a" сделает уровень 1 зеленым.
default-level-color: "&f" # Цвет по умолчанию для уровня, если не указан конкретно.
colors:
15: "&a"
20: "&b"
25: "&e"
35: "&c"
# Настройки для автоматического обмена опыта
auto-exp:
enabled: true # Включить/выключить функционал авто-обмена опыта
check-interval: 20 # Интервал проверки (в тиках) для автоматического обмена опыта (20 тиков = 1 секунда)
# Если true, авто-обмен не будет автоматически выключаться при нехватке опыта или бутылочек.
# Игроку придется выключить его вручную.
# Если false, авто-обмен выключится, когда не будет хватать ресурсов.
disable-on-insufficient-resources: true

# Настройки для созданных бутылочек опыта
bottles:
name: "&eБутылочка опыта %level% lvl"
lore:
- "&7Кликните ПКМ, чтобы использовать."
- ""
- "&9Уровень: %level%"

# Настройки системы починки брони
repair:
enabled: true # Включить/выключить систему починки брони.
auto-repair:
default: true # По умолчанию включен ли авто-ремонт для игрока.

# Разрешить ли создание кастомных бутылочек через команды (если такие есть/будут)
allow-custom-bottle-creation: true

gui.yml

# Настройки графического интерфейса (GUI)

title: "&0Обмен Опыта" # Заголовок основного GUI обмена опыта
rows: 3 # Количество строк в основном GUI (мин. 1, макс. 6)

# Настройки для иконок бутылочек опыта в GUI
bottles:
# Слоты, в которых будут отображаться бутылочки опыта.
# Должны соответствовать количеству уровней в config.yml -> experience.levels.
slots:
- 10
- 11
- 12
- 13

# Настройки для кнопки авто-починки в GUI
auto-repair:
enabled: true # Отображать ли кнопку авто-починки в GUI
slot: 15 # Слот для кнопки авто-починки
material: IRON_CHESTPLATE # Материал иконки кнопки авто-починки
name: "&eАвто-починка: %status%" # Название кнопки. %status% будет заменен на ВКЛ/ВЫКЛ.
lore:
- "&7Автоматически чинит вашу броню"
- "&7при использовании бутылочек опыта."
- "&7Требует опыта."

# Настройки для кнопки авто-обмена опыта в GUI
auto-exp-toggle:
enabled: true # Отображать ли кнопку авто-обмена опыта в GUI
slot: 16 # Слот для кнопки авто-обмена опыта
material: DRAGON_BREATH # Материал иконки кнопки авто-обмена опыта
name: "&eАвто-обмен опыта: %status%" # Название кнопки. %status% будет заменен на ВКЛ/ВЫКЛ.
lore:
- "&7Автоматически обменивает опыт"
- "&7на бутылочки заданного уровня."

# Настройки для кнопки настроек в основном GUI
settings:
slot: 22 # Слот для кнопки настроек
material: COMPARATOR # Материал иконки кнопки настроек
name: "&e* Настройки VExp *" # Название кнопки настроек
lore:
- "&7Изменить пользовательские настройки плагина."
# Настройки GUI настроек
title: "&e* Настройки VExp *" # Заголовок GUI настроек
vanilla-bottle:
name: "&eВанильные бутылочки: %status%" # Название кнопки для ванильных бутылочек в GUI настроек
description: "&7Бутылочки разбиваются как ванильные" # Описание кнопки

messages.yml

messages:
no-permission: "&cУ вас нет разрешения для выполнения этой команды."
config-reloaded: "&aVExpPlugin успешно перезагружен."
# Сообщения для GUI и функционала обмена опыта
no-glass-bottles: "&cУ вас нет пустых стеклянных бутылочек!"
inventory-full: "&cВаш инвентарь полон! Освободите место."
bottle-received: "&aВы успешно создали бутылочку опыта %level% уровня!"
not-enough-exp: "&cУ вас недостаточно опыта для создания этой бутылочки!"
exp-bottle-cooldown: "&cПодождите %time% секунд, прежде чем снова использовать бутылочку опыта."
vanilla-bottle-enabled: "&aВанильный режим бутылочек опыта включен."
vanilla-bottle-disabled: "&cВанильный режим бутылочек опыта выключен."
# Сообщения для авто-починки
auto-repair-enabled: "&aАвто-починка брони включена."
auto-repair-disabled: "&cАвто-починка брони выключена."
no-armor-equipped: "&cУ вас нет надетой брони для починки."
repair-full-armor: "&aВаша броня полностью целая, починка не требуется."
armor-partially-repaired: "&aВаша броня частично починена. Потрачено %repaired% из %levels% доступных уровней."
not-enough-exp-to-repair: "&cНедостаточно опыта для починки брони."
# Сообщения для авто-обмена опыта
auto-exp-enabled: "&aАвто-обмен опыта включен на уровень %level%."
auto-exp-disabled: "&cАвто-обмен опыта выключен."
enter-auto-exp-level: "&eПожалуйста, введите уровень опыта, до которого вы хотите автоматически обменивать опыт."
type-cancel-to-abort: "&7(Напишите 'отмена' или 'cancel' для отмены)"
auto-exp-setup-cancelled: "&eНастройка авто-обмена опыта отменена."
invalid-level: "&cНекорректный уровень. Введите число от 1 до %max_level%."
invalid-input-for-level: "&cНекорректный ввод. Пожалуйста, введите числовой уровень."
# Новые сообщения для AutoExpManager
auto-exp-disabled-not-enough-exp: "&cАвто-обмен опыта выключен: у вас недостаточно опыта (требуется %level%)."
auto-exp-disabled-no-glass-bottles: "&cАвто-обмен опыта выключен: у вас закончились стеклянные бутылочки."
auto-exp-disabled-inventory-full: "&cАвто-обмен опыта выключен: ваш инвентарь полон для новых бутылочек."
auto-exp-success: "&aАвтоматически обменяно %level% уровня на бутылочку опыта."


❓ Поддержка


Если у вас возникнут вопросы, проблемы или потребуется помощь с плагином, вы всегда можете обратиться к нам:

Discord: ceroback