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

Создание контента 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 (маленькие_буквы_с_подчеркиваниями.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 во всех типах контента
  • Имена файлов должны использовать формат lowercase_with_underscores.yml

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

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

Пользовательские боссы​

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

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

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

isEnabled: true
entityType: ZOMBIE
name: '&e Тестовый босс'
level: dynamic
healthMultiplier: 2.0
damageMultiplier: 0.5
helmet: GOLDEN_HELMET
chestplate: IRON_CHESTPLATE
mainHand: GOLDEN_AXE
powers:
  - invulnerability_knockback.yml
spawnMessage: Тестовый босс был заспавнен!
deathMessage: Тестовый босс был убит игроком $players!

Пользовательские предметы​

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

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

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

isEnabled: true
material: DIAMOND_SWORD
name: '&4Легендарный клинок'
lore:
  - '&7Мощное оружие'
  - '&7выкованное в драконьем огне'
enchantments:
  - DAMAGE_ALL,5
  - FIRE_ASPECT,2
level: 10
soulbound: true

Пользовательские квесты​

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

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

Пользовательские события​

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

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

Пользовательские NPC​

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

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

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

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

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

Арены​

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

  • Границы арены (угол1, угол2)
  • Количество волн и задержки
  • Список боссов и точки спавна
  • Награды и лимиты игроков
  • Сообщения арены
  • Промежуточные волны

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

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

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

Общие шаблоны​

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

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

  • Ссылка на силы в боссах: power_name.yml
  • Ссылка на предметы в добыче: 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, ProjectileDamage

Элементальные силы:

  • 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.yml
  - flame_pyre.yml
  - spirit_walk.yml

Продвинутые функции​

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

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

Элитные скрипты​

Элитные скрипты предоставляют продвинутые пользовательские способности боссов с управляемыми событиями действиями, условиями и перезарядками. Скрипты настраиваются используя поле 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 для примеров исходного кода