- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
- Ядра и Прокси
- Bukkit
- Spigot
- Paper
- Минимальная версия Java
- 17
hCustomEnchantments
Настраиваемые кастомные зачарования для Minecraft-серверов
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Настраиваемые кастомные зачарования для Minecraft-серверов
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hCustomEnchantments добавляет полноценную систему кастомных зачарований с отдельными конфигами, книгами зачарований, поддержкой наковальни, опциональной генерацией через стол зачарований, конфликтами, требованиями, действиями и игровыми эффектами для инструментов, оружия, брони, луков, арбалетов, трезубцев и полезных предметов.
В плагине уже есть 24 готовых зачарования. Каждое можно настроить через YAML: уровни, названия, lore, стоимость, предметы, конфликты, требования, эффекты и действия при срабатывании.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Возможности
24 кастомных зачарования
Плагин включает набор зачарований для разных типов предметов.
- Зачарования для инструментов
- Зачарования для мечей
- Зачарования для луков и арбалетов
- Зачарования для трезубцев
- Зачарования для брони
- Зачарования для ботинок
- Зачарование для тотема
- Проклятие для прочности предмета
Каждое зачарование имеет отдельный файл в папке enchants.
Код:
plugins/hCustomEnchantments/enchants/
────────────────────────────────────────
Отдельные конфиги зачарований
Каждое зачарование настраивается отдельно.
Можно изменить:
- Отображаемое название
- Текст уровня
- Название книги
- Lore книги
- Редкость
- Активные слоты
- Список подходящих предметов
- Стоимость в наковальне
- Настройки стола зачарований
- Конфликты
- Требования
- Настройки уровней
- Шансы эффектов
- Длительность эффектов
- Значения урона
- Поведение полезных механик
Это позволяет балансировать зачарования без изменения кода плагина.
────────────────────────────────────────
Поддержка наковальни
Книги с кастомными зачарованиями можно накладывать через наковальню.
Плагин поддерживает:
- Настраиваемую стоимость
- Бонус к стоимости по материалу предмета
- Объединение уровней
- Проверку конфликтов
- Проверку требований
- Настраиваемое имя предупреждающего предмета
- Сохранение других кастомных зачарований
Для каждого уровня зачарования можно отдельно включить или отключить работу через наковальню.
────────────────────────────────────────
Стол зачарований
Кастомные зачарования можно добавлять через стол зачарований, если это включено в конфиге конкретного зачарования.
Для каждого уровня можно настроить:
- Включение или отключение
- Диапазон уровней стола зачарований
- Шанс выпадения
- Проверку конфликтов
- Проверку требований
В стандартных конфигах генерация через стол зачарований отключена, поэтому вы сами решаете, какие зачарования игроки смогут получать таким способом.
────────────────────────────────────────
Конфликты и требования
Зачарования могут конфликтовать с другими кастомными или ванильными чарами.
Примеры формата:
Код:
PLUGIN:lifesteal:*
PLUGIN:drill:*
VANILLA:loyalty:*
Также зачарования могут требовать наличие другого зачарования.
Например, зачарование Возвращение может требовать ванильную Верность на трезубце.
────────────────────────────────────────
Книги зачарований
Администратор может выдать игроку книгу с нужным кастомным зачарованием.
Название и lore книги берутся из конфига зачарования.
Также есть команда для выдачи всех зарегистрированных книг. При необходимости плагин упаковывает книги в шалкер-боксы, чтобы выдача была аккуратной.
────────────────────────────────────────
Система действий
hCustomEnchantments имеет гибкую систему действий.
Действия могут выполняться:
- Когда игрок получает кастомное зачарование через стол зачарований
- Когда срабатывает конкретное зачарование
Поддерживаемые типы действий:
Код:
[Message]
[Broadcast]
[Console]
[Player]
[Sound]
[Title]
[ActionBar]
[BossBar]
[Particle]
[Firework]
[Effect]
[Vault]
[ACHIVEMENT]
Внутренние плейсхолдеры:
Код:
{prefix}
{player}
{enchant}
Если установлен PlaceholderAPI, значения PlaceholderAPI могут обрабатываться в поддерживаемом тексте действий.
────────────────────────────────────────
Опциональная поддержка Vault
Vault можно использовать в действиях для операций с экономикой.
Через систему действий можно выдавать, снимать, устанавливать и очищать баланс.
Vault не является обязательной зависимостью и нужен только при использовании Vault-действий.
────────────────────────────────────────
Обработка точила
Если кастомные зачарования снимаются через точило, плагин очищает lore кастомных зачарований у итогового предмета.
Для лучшей работы этой функции рекомендуется Paper или Purpur.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Зачарования
Инструменты и добыча
Код:
drill - Бур, ломает куб блоков вокруг добытого блока
magnetism - Магнетизм, отправляет добычу сразу в инвентарь
lava_walker - Лаваход, создаёт безопасную платформу поверх лавы
lumberjack - Лесоруб, быстро рубит связанные блоки дерева
autosmelt - Авто-плавка, автоматически переплавляет добычу
pinger - Пингер, предупреждает о низкой прочности инструмента
web - Паутина, ломает жилу одинаковых блоков
unstable - Нестабильный, ускоряет потерю прочности предмета
Мечи
Код:
glowing - Детекция, накладывает свечение на цель
armor_breaker - Окисление, быстрее ломает броню противника
lifesteal - Вампиризм, даёт регенерацию после удара
poison - Яд, отравляет противника
heavy - Тяжёлый, замедляет противника
Луки и арбалеты
Код:
homing - Самонаводка, направляет снаряд к приоритетной цели
sniper - Снайпер, увеличивает скорость снаряда
Трезубцы
Код:
attraction - Притяжение, притягивает цель к игроку
pull - Скаут, притягивает игрока к точке попадания трезубца
return - Возвращение, возвращает брошенный трезубец владельцу
explosive - Подрывник, создаёт настраиваемый взрыв при попадании
stupor - Ступор, накладывает слабость и замедление
Броня и полезные предметы
Код:
jumper - Попрыгун, даёт прыгучесть при ношении ботинок
minecart_resistance - Защита от вагонеток, снижает урон от взрыва TNT-вагонеток
last_chance - Последний шанс, перекладывает предмет в указанный слот при низком здоровье
experience - Опытный, увеличивает опыт с блоков и существ
────────────────────────────────────────
Алиасы зачарований
Некоторые зачарования имеют алиасы для команд:
Код:
detection -> glowing
oxidation -> armor_breaker
vampirism -> lifesteal
scout -> pull
recall -> return
magnet -> magnetism
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Команды
Код:
/hcustomenchants
/hcustomenchants give <player> <enchant> <level>
/hcustomenchants giveall <player>
Описание команд:
Код:
/hcustomenchants - показать помощь
/hcustomenchants give <player> <enchant> <level> - выдать книгу зачарования
/hcustomenchants giveall <player> - выдать все книги кастомных зачарований
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Права
Код:
hcustomenchants.admin - доступ к административным командам hCustomEnchantments
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Конфигурация
Основной конфиг:
Код:
plugins/hCustomEnchantments/config.yml
Папка с конфигами зачарований:
Код:
plugins/hCustomEnchantments/enchants/
Файлы зачарований, которые идут в комплекте:
Код:
armor_breaker.yml
attraction.yml
autosmelt.yml
drill.yml
experience.yml
explosive.yml
glowing.yml
heavy.yml
homing.yml
jumper.yml
last_chance.yml
lava_walker.yml
lifesteal.yml
lumberjack.yml
magnetism.yml
minecart_resistance.yml
pinger.yml
poison.yml
pull.yml
return.yml
sniper.yml
stupor.yml
unstable.yml
web.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Зависимости
- Java 17 или новее
- Minecraft 1.16 или новее
- Paper или Purpur рекомендуется
Опциональные зависимости:
- PlaceholderAPI
- Vault
PlaceholderAPI используется для обработки плейсхолдеров в поддерживаемом тексте действий.
Vault нужен только для Vault-действий с экономикой.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Установка
- Поместите hCustomEnchantments.jar в папку plugins.
- Перезапустите сервер.
- Откройте plugins/hCustomEnchantments/config.yml.
- Настройте основные параметры и действия.
- Откройте plugins/hCustomEnchantments/enchants/.
- Настройте нужные зачарования.
- Выдайте себе право hcustomenchants.admin.
- Выдайте книгу командой /hcustomenchants give <player> <enchant> <level>.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Примечания
- Все зачарования настраиваются через YAML.
- Работу через наковальню можно настроить отдельно для каждого уровня.
- Работу через стол зачарований можно настроить отдельно для каждого уровня.
- Конфликты и требования поддерживают кастомные и ванильные зачарования.
- Действия можно настроить глобально и отдельно для конкретных зачарований.
- Зависимости
- PlaceholderAPI, Vault (Опционально)
- Команды и права
- Выше в описании