Перейти к основному содержимому

Создание контента EliteMobs

EliteMobs позволяет создавать обширный кастомный контент для вашего сервера через конфигурационные файлы YAML. Весь контент создаётся путём размещения правильно отформатированных .yml-файлов в определённых папках внутри каталога плагина EliteMobs.

Типы контента​

EliteMobs поддерживает 8 основных типов контента:

  1. Кастомные боссы — создавайте уникальных элитных мобов с кастомными способностями, снаряжением и умениями
  2. Кастомные предметы — проектируйте кастомное оружие, броню и предметы с зачарованиями
  3. Кастомные задания — стройте цепочки заданий с целями и наградами
  4. Кастомные события — настраивайте боссовые события по таймеру или по триггеру
  5. Кастомные NPC — добавляйте раздающих задания, магазины и интерактивных NPC
  6. Сундуки с сокровищами — размещайте сундуки с добычей с кастомными наградами и механикой мимиков
  7. Арены — проектируйте волновые боевые испытания со столкновениями с боссами
  8. Червоточины — создавайте телепортационные порталы между местами

У каждого типа контента есть своя конфигурационная папка и структура полей.

Быстрый старт​

Весь кастомный контент следует этому шаблону:

  1. Создайте YAML-файл с расширением .yml
  2. Назовите его в формате lowercase_with_underscores.yml
  3. Поместите его в подходящую папку
  4. Настройте контент с помощью полей YAML
  5. Перезагрузите EliteMobs или перезапустите сервер

Расположение файлов​

Каждый тип контента хранится в своей папке:

  • Кастомные боссы: ~/plugins/EliteMobs/custombosses/
  • Кастомные предметы: ~/plugins/EliteMobs/customitems/
  • Кастомные задания: ~/plugins/EliteMobs/customquests/
  • Кастомные события: ~/plugins/EliteMobs/customevents/
  • Кастомные NPC: ~/plugins/EliteMobs/npcs/
  • Сундуки с сокровищами: ~/plugins/EliteMobs/customtreasurechests/
  • Арены: ~/plugins/EliteMobs/customarenas/
  • Червоточины: ~/plugins/EliteMobs/wormholes/

Инструменты создания контента​

WebApp (рекомендуется новичкам)​

Используйте EliteMobs WebApp, чтобы генерировать конфигурационные файлы через визуальный интерфейс. Этот инструмент значительно ускоряет процесс и помогает избежать синтаксических ошибок.

Ручная настройка YAML​

Для опытных пользователей — создавайте YAML-файлы вручную для полного контроля над всеми доступными полями и параметрами.

Формат файла YAML​

Все конфигурации EliteMobs используют формат YAML. Ключевые правила:

  • Используйте для отступов пробелы, а не табуляцию
  • Строки с цветовыми кодами требуют одинарных кавычек
  • Списки используют формат с дефисом или формат со скобками
  • isEnabled контролирует, загружается ли контент; это поле необязательно и по умолчанию равно true в каждом типе контента (поэтому вам нужно задать isEnabled: false, только чтобы отключить файл)
  • Имена файлов должны использовать формат lowercase_with_underscores.yml

Подробную помощь по синтаксису YAML см. в Руководстве по конфигурационным файлам.

Обзор типов контента​

Кастомные боссы​

Кастомные боссы — это элитные мобы с улучшенными умениями, кастомным снаряжением и особыми способностями. Система боссов поддерживает 60+ конфигурационных полей, в том числе:

  • Тип сущности и уровень
  • Множители здоровья и урона
  • Снаряжение (броня и оружие)
  • Элитные способности и умения
  • Таблицы добычи и дроп
  • Сообщения и команды при спавне/смерти
  • Многофазовые механики
  • Кастомные модели и маскировки

Пример базового босса:

isEnabled: true
entityType: ZOMBIE
name: '&e Test Boss'
level: dynamic
healthMultiplier: 2.0
damageMultiplier: 0.5
helmet: GOLDEN_HELMET
chestplate: IRON_CHESTPLATE
mainHand: GOLDEN_AXE
powers:
  - invulnerability_knockback.lua
spawnMessage: A test boss has been spawned!
deathMessage: A test boss has been slain by $players!

Кастомные предметы​

Кастомные предметы позволяют создавать уникальное оружие, броню и инструменты с кастомными зачарованиями и эффектами. Система предметов поддерживает 15 конфигурационных полей, в том числе:

  • Тип материала
  • Отображаемое имя и лор
  • Список зачарований
  • Эффекты зелий
  • ID кастомных моделей
  • Вес дропа и масштабирование
  • Настройки уровня и привязки к душе

Пример базового предмета:

isEnabled: true
material: DIAMOND_SWORD
name: '&4Legendary Blade'
lore:
  - '&7A powerful weapon'
  - '&7forged in dragon fire'
enchantments:
  - DAMAGE_ALL,5
  - FIRE_ASPECT,2
level: 10
soulbound: true

Кастомные задания​

Кастомные задания создают цели для игроков с наградами по завершении. Система заданий поддерживает 17 конфигурационных полей, в том числе:

  • Цели и типы заданий
  • Награды (предметы, деньги, права)
  • Диалог принятия/завершения
  • Требования к сдаче NPC
  • Таймеры блокировки заданий
  • Отслеживание и звуки

Кастомные события​

Кастомные события вызывают спавн боссов на основе времени, шанса или других условий. Система событий поддерживает 18 конфигурационных полей, в том числе:

  • Тип события и список боссов
  • Шанс триггера и вес
  • Сообщения и команды начала/конца
  • Таймеры перезарядки (локальные и глобальные)
  • Минимальное количество игроков
  • Длительность события

Кастомные NPC​

Кастомные NPC предоставляют интерактивных персонажей для заданий, магазинов и арен. Система NPC поддерживает 18 конфигурационных полей, в том числе:

  • Имя, роль и профессия NPC
  • Местоположения спавна
  • Диалог (приветствия, диалог, прощание)
  • Типы взаимодействия
  • Ссылки на задания и арены
  • Кастомные модели и маскировки

Сундуки с сокровищами​

Сундуки с сокровищами дают награды в виде добычи с настраиваемыми таймерами пополнения и механикой мимиков. Система сундуков поддерживает 15 конфигурационных полей, в том числе:

  • Тип и ориентация сундука
  • Координаты местоположения
  • Таблица добычи
  • Таймеры пополнения
  • Шанс мимика и список боссов
  • Визуальные эффекты

Арены​

Арены создают волновые боевые испытания со столкновениями с боссами. Система арен поддерживает 19 конфигурационных полей, в том числе:

  • Границы арены (corner1, corner2)
  • Количество волн и задержки
  • Список боссов и точки спавна
  • Награды и ограничения игроков
  • Сообщения арены
  • Волны с передышкой

Червоточины​

Червоточины создают телепортационные порталы между двумя местами. Система червоточин поддерживает 11 конфигурационных полей, в том числе:

  • Две конечные точки-местоположения
  • Отображаемый текст для каждого местоположения
  • Визуальный стиль и цвета частиц
  • Стоимость в монетах и права
  • Эффект ослепления и множитель размера

Распространённые паттерны​

Ссылки на контент​

Типы контента ссылаются друг на друга по именам файлов:

  • Ссылка на способности в боссах: power_name.yml
  • Ссылка на предметы в добыче: filename: item_name.yml (см. формат Таблиц добычи для шанса, количества и прочего)
  • Ссылка на боссов в событиях: boss_filename.yml
  • Ссылка на задания в NPC: quest_filename.yml

Плейсхолдеры​

Используйте эти плейсхолдеры в сообщениях:

  • $players — список игроков, победивших босса
  • $distance — расстояние до местоположения босса
  • $eventBossLevel — динамический уровень босса события

Цветовые коды​

Используйте цветовые коды Minecraft в именах и сообщениях. Цветовые коды должны быть заключены в одинарные кавычки.

Стандартные цветовые коды Minecraft:

  • &0 — Чёрный
  • &1 — Тёмно-синий
  • &2 — Тёмно-зелёный
  • &3 — Тёмно-бирюзовый
  • &4 — Тёмно-красный
  • &5 — Тёмно-фиолетовый
  • &6 — Золотой
  • &7 — Серый
  • &8 — Тёмно-серый
  • &9 — Синий
  • &a — Зелёный
  • &b — Бирюзовый
  • &c — Красный
  • &d — Светло-фиолетовый
  • &e — Жёлтый
  • &f — Белый

Коды форматирования:

  • &l — Жирный
  • &m — Зачёркнутый
  • &n — Подчёркнутый
  • &o — Курсив
  • &r — Сброс

Система элитных способностей​

EliteMobs включает 60+ элитных способностей, которые можно назначить кастомным боссам. На способности ссылаются по имени файла в конфигурациях боссов.

Категории способностей​

Атакующие/боевые способности:

  • ArrowFireworks, ArrowRain, AttackArrow, AttackFireball, AttackLightning
  • AttackPush, AttackVacuum, BulletHell, DeathSlice

Стихийные способности:

  • Firestorm, FlamePyre, Flamethrower, FrostCone, FrostWalker
  • LightningBolts, Thunderstorm, PhotonRay, PlasmaBlaster

Защитные способности:

  • ShieldWall, InvulnerabilityArrow, InvulnerabilityFallDamage
  • InvulnerabilityFireworks, InvulnerabilityKnockback
  • ChannelHealing, SpiritWalk

Особые умения:

  • GroundPound, Implosion, MeteorShower, GoldExplosion, GoldShotgun
  • SkeletonPillar, SkeletonTrackingArrow, TrackingFireball, Taze, Taunt
  • ZombieBloat, ZombieFriends, ZombieNecronomicon, ZombieParents
  • SummonEmbers, SummonTheReturned, MovementSpeed

Способности, эксклюзивные для Дракона Края:

  • AimedFireball, ArrowBombardment, DiscoFireballs, EmpoweredLightning
  • Shockwave, Tornado (всего 11 способностей, специфичных для дракона)

Способности добычи:

  • BonusCoins, BonusLoot, HyperLoot

Способности добавляются боссам с помощью поля-списка powers:

powers:
  - invulnerability_knockback.lua
  - flame_pyre.lua
  - spirit_walk.lua

Продвинутые возможности​

Многофазовые боссы​

У боссов может быть несколько фаз с отдельными конфигурационными файлами. Используйте поле phases для ссылки на файлы фазовых боссов и phaseSpawnLocation, чтобы задать, где происходят переходы между фазами.

Elite-скрипты​

Elite-скрипты предоставляют продвинутые умения кастомных боссов с действиями, условиями и перезарядками, управляемыми событиями. Скрипты настраиваются с помощью поля eliteScript в конфигурациях боссов.

Кастомные модели​

Кастомные модели можно применять к боссам, NPC и предметам с помощью поля customModel. Это требует дополнительной настройки интеграции моделей.

Снаряжение босса​

Боссы могут носить кастомную броню и держать оружие:

helmet: DIAMOND_HELMET
chestplate: IRON_CHESTPLATE
leggings: LEATHER_LEGGINGS
boots: CHAINMAIL_BOOTS
mainHand: GOLDEN_AXE
offHand: SHIELD

Выполнение команд​

Боссы могут выполнять команды при определённых событиях:

  • onSpawnCommands — выполняются при спавне босса
  • onDeathCommands — выполняются при победе над боссом
  • onCombatEnterCommands — выполняются при начале боя
  • onCombatLeaveCommands — выполняются при окончании боя

Сообщения босса​

Настраивайте объявления босса:

  • spawnMessage — транслируется при спавне босса
  • deathMessage — транслируется при победе над боссом (поддерживает плейсхолдер $players)
  • escapeMessage — транслируется при побеге босса
  • locationMessage — показывает расстояние до босса (поддерживает плейсхолдер $distance)
  • deathMessages — список случайных вариаций сообщений о смерти

Уровни приоритета объявлений (0-3) контролируют диапазон трансляции. Используйте поле announcementPriority.

Региональные боссы​

Региональные боссы используют поле isRegionalBoss и могут иметь радиус привязи, ограничения спавна и изменения состояния блоков:

  • leashRadius — максимальное расстояние от точки спавна
  • onSpawnBlockStates — изменения блоков при спавне босса
  • onRemoveBlockStates — изменения блоков при удалении босса

Настройка добычи​

Контролируйте дроп босса:

  • dropsEliteMobsLoot — включить дроп кастомной добычи (по умолчанию: true)
  • dropsVanillaLoot — включить ванильный дроп (по умолчанию: true)
  • dropsRandomLoot — включить случайную добычу (по умолчанию: true)
  • uniqueLootList — конкретные предметы добычи с количеством

Пример:

uniqueLootList:
  - custom_sword.yml:1
  - rare_helmet.yml:1

Готовый контент​

EliteMobs включает 134+ готовых конфигураций боссов и шаблонов для всех типов контента. Их можно найти в соответствующих папках /premade/, и они служат примерами для создания вашего собственного кастомного контента.

Получение помощи​

  • Загляните в боковую панель за конкретными руководствами по созданию контента
  • Посетите Discord EliteMobs для поддержки сообщества
  • Изучите репозиторий GitHub для примеров исходного кода