FunTalismans (Фан талисманс)

Плагин для серверов Майнкрафт с RPG-экипировкой: талисманами, сферами, пассивными предметами и особыми тотемами бессмертия. Администратор создаёт их через HOCON-конфиги, задавая внешний вид, характеристики, эффекты и условия использования.

Возможности

• Создание неограниченного числа талисманов и сфер с именем, описанием, редкостью, зачарованиями, прочностью, размером стака, свечением, данными предмета и собственной моделью.
• Пассивные эффекты зелий для предметов в основной и второй руке, слотах брони, любом экипированном слоте или инвентаре.
• Изменение максимального здоровья, урона, скорости передвижения, брони, скорости атаки, удачи и других атрибутов.
• Особые тотемы бессмертия: сохраняют механику воскрешения и могут выдавать свои эффекты. Параметр vanillaEffects позволяет оставить либо отключить обычные эффекты тотема — регенерацию, поглощение и огнестойкость.
• Настройка кожаной брони с цветом, отделки брони, голов игроков с текстурами, фейерверков, козьих рогов и подписанных книг.
• Ограничения по миру, региону, праву, режиму игры и выражениям с плейсхолдерами; для сложных условий доступны and, or и oneof.
• Обновление уже выданных талисманов в инвентарях, рамках, контейнерах, сундуках, шалкеровых ящиках и загруженных чанках.

Команды

• /ftalismans give <player> <id> [amount] — выдать талисман.
• /ftalismans reload — перечитать конфигурации талисманов.
• /ftalismans forceupdate — обновить найденные существующие талисманы.

Алиасы: /ft, /talisman, /tali, /talismans.

Права

• funtalismans.give — выдача талисманов.
• funtalismans.reload — перезагрузка конфигураций.
• funtalismans.update — обновление существующих предметов.

Настройка

Конфиги талисманов в формате .conf загружаются из plugins/FunTalismans/talismans/ и вложенных папок. Для пассивных эффектов укажите слот в effects.slot; усилители начинаются с нуля: 0 — первый уровень, 1 — второй.

Для эффектов особого тотема длительность задаётся в секундах через duration или в тиках через durationTicks; 20 тиков равны секунде. durationMode: "SET" устанавливает указанную длительность, а durationMode: "ADD" добавляет её к совместимому действующему эффекту.

Встроенные плейсхолдеры работают без дополнительных плагинов: %player_name%, %player_world%, %player_uuid%, %player_gm%, а также варианты для цели с префиксом %target_player_.

Для запрета механик в регионах WorldGuard используются флаги fun-talismans-passive для пассивных эффектов и fun-talismans-use для общего использования, например: /rg flag <region> fun-talismans-passive deny.

Требования

Нужны серверные ядра Paper или Purpur и Java 21. Обязательная зависимость — PacketEvents; NBT-API не требуется.

WorldGuard добавляет работу с регионами и флагами, а PlaceholderAPI — поддержку его плейсхолдеров. Необязательный ресурс-пак содержит модели талисманов и тотемов; для их показа значение custom_model_data в конфиге должно совпадать с моделью ресурс-пака.