DG Talismans

DG Talismans предоставляет инструмент для создания уникального снаряжения с разнообразными атрибутами, эффектами зелий и пассивными навыками без необходимости редактирования YAML-файлов.

DG Talismans позволяет администраторам создавать уникальные талисманы, броню, оружие и инструменты. Основная особенность проекта — полная настройка параметров через внутриигровые GUI, что исключает необходимость ручного редактирования конфигурационных файлов.

Механика работы основана на назначении эффектов конкретным типам предметов. Эффекты активируются мгновенно при экипировке и удаляются сразу после извлечения предмета из соответствующего слота.

⚙️ Типы предметов и условия активации

Система поддерживает более 40 различных эффектов, разделенных на категории:

• Атрибуты: дополнительные сердца, урон, скорость, броня, прочность брони, удача, сопротивление отбрасыванию, скорость атаки, дистанция блока.
• Эффекты зелий: 27 видов с уровнями от I до X.
• Боевые параметры: % уменьшения урона, шанс критического удара, множитель крита, кража жизни, шипы и 7 видов иммунитетов (к огню, взрывам, падению и др.).
• Пассивные навыки: авто-обжиг, авто-сбор, ночное зрение, дыхание под водой, отсутствие голода, сохранение инвентаря, двойной опыт и дроп, магнитный сбор (8 блоков), мгновенный рост урожая.
• Перемещение: двойной прыжок, отсутствие урона от падения, рывок при приседании, увеличение высоты прыжка (+500%).
• Частицы: 14 видов шлейфов (пламя, сердца, портал и др.).
• Разное: множитель опыта (1–10x), восстановление еды.

Для визуального отличия предметов используется система редкости с 6 уровнями и цветовой маркировкой:

⚙️ Настройка через GUI

Все настройки проводятся через меню /talismans. В интерфейсе доступны выбор категории, создание предметов и детальная конфигурация всех эффектов с помощью кликов.

/talismans → Category Selector (Talismans / Armor / Weapons / Tools)
               └─ Edit Item → Attributes, Potions, Combat, Passive,
                               Movement, Particles, Misc, Material, Rarity

Основные команды плагина:

Доступные алиасы: /talisman, /dgt.

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

Технические детали и ограничения:

• Идентификация предметов происходит через PersistentDataContainer (NBT), а не через описание (lore).
• Эффекты используют нативную систему AttributeModifier.
• Изменения экипировки фиксируются мгновенно (смена предмета в руке, переключение рук, клик по броне).
• Все эффекты автоматически очищаются при выходе игрока, смене мира или отключении плагина.
• Предметы не могут складываться (макс. размер стака — 1).
• Анти-эксплойт: блокировка крафта, переименования в наковальне и перетаскивания в GUI.
• Запреты на действие применяются во всех обработчиках эффектов для миров из черного списка.
• Плагин обеспечивает нулевое влияние на TPS.

Пример базовой конфигурации префикса в файле конфигурации:
prefix: "&8[&6DGtalismans&8] "