CobbleBoss

Руководство пользователя босса CobbleBoss

1. Структура пакета данных

Пакеты данных CobbleBoss используют пространство имен cobbleboss.

Обычные файлы Boss помещаются в:

data/cobbleboss/bosses/

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

data/cobbleboss/boss_teams/

Основная структура:

pack.mcmeta
data/cobbleboss/bosses/
data/cobbleboss/boss_teams/

Рекомендуемое имя файла:

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

2. Что контролирует JSON босса

Босс JSON контролирует:

• Какой покемон босс?
• Отображаемое имя босса
• Цвет свечения босса
• Естественные правила появления
• Награды после победы
• Наказания после поражения
• Ходы
• электромобили
• Пользовательская статистика боя
• Природа
• Способность
• Форма
• Удерживаемые предметы
• Режим боя
• Действия за ход
• Настройки щита
• Фазовые навыки
• Размер босса

3. Рекомендуемый порядок чтения

Новичкам сначала следует понять следующие части:

• Личность босса
• Правила появления
• Поощрения и наказания.
• Конфигурация боя
• Визуальные настройки
• Продвинутая механика рейдов

Наиболее важные поля:

• unique_id
• species_id
• random_configs

Рекомендуемые поля:

• display_name
• glow
• moves
• battle_mode
• actions_per_turn
• scale

Необязательные поля:

• spawn_rule
• reward_rule
• punish_rule
• effort_values
• custom_battle_stats
• phase_skills
• held_items
• nature
• ability
• form
• shield_layers
• shield_recover_per_turn
• shield_weaken_turns

4. Поля боссов высшего уровня

unique_id

Цель:

Уникальный внутренний идентификатор Босса.

Рекомендация:

Обязательно.

Примечания:

• Должен быть уникальным. — Команды используют этот идентификатор.
• Не используйте один и тот же идентификатор повторно в нескольких файлах Boss.
• Рекомендуемый формат: строчные английские буквы с подчеркиванием.

display_name

Цель:

Имя, отображаемое игрокам в игре.

Рекомендация:

Рекомендуется.

Примечания:

• Поддерживает цветовые коды Minecraft.
• Полезно для того, чтобы сделать имена боссов более очевидными.
• Если опущено, вместо него можно использовать название вида.

species_id

Цель:

Определяет, какой вид покемонов является Боссом.

Рекомендация:

Обязательно.

Примечания:

• Обычно использует пространство имен cobblemon.
• Это определяет фактического покемона, созданного системой Боссов.

glow

Цель:

Управляет цветом светящегося контура Босса после его появления.

Должность:

Поле верхнего уровня.

Рекомендация:

Необязательно.

Как это работает:

• Если установлено, Босс получает светящийся контур.
• Если отсутствует или пуст, Босс не светится.
• Использует названия цветов Minecraft.

Доступные цвета:

• black
• dark_blue
• dark_green
• dark_aqua
• dark_red
• dark_purple
• gold
• gray
• dark_gray
• blue
• green
• aqua
• red
• light_purple
• yellow
• white

Примечания:

• Неверные цвета могут привести к сбою загрузки файла Boss.
• Это контролирует только свечение объекта, а не цвет объявления.

spawn_rule

Цель:

Контролирует естественные правила нереста.

Рекомендация:

Необязательно.

Важно:

Для естественного нереста Боссу обычно нужны:

• spawn_locations
• spawn_times
• spawn_biomes или spawn_structures
• spawn_weight

Примечания:

• Босс без действующих правил появления не может участвовать в естественном появлении.
• spawn_biomes и spawn_structures проверяются как соответствие биома или структуры.

reward_rule

Цель:

Управляет наградами после победы игроков над Боссом.

Рекомендация:

Необязательно.

Может содержать:

• Прямые награды за предметы
• Прямые командные награды
• Пулы вознаграждений, которые выпадают один раз и случайным образом выбирают одну запись.
• Граф
• Шанс
• Вес
• Роллы

punish_rule

Цель:

Контролирует наказания после поражения игроков от Босса.

Рекомендация:

Необязательно.

Может содержать:

• Снижение уровня
• Снижение EV
• IV снижение
• Командное наказание
• Шанс

random_configs

Цель:

Определяет одну или несколько возможных конфигураций боя для этого Босса.

Рекомендация:

Обязательно.

Как это работает:

• Босс может иметь несколько случайных конфигураций.
• При создании Босса выбирается одна конфигурация.
• Различные конфигурации могут иметь разные движения, характеристики, удерживаемые предметы, режимы боя, настройки щита и размер.

5. Поля правил создания

spawn_locations

Цель:

Ограничивает место появления Босса.

Доступные значения:

• land
• water_surface
• underwater
• cave
• sky
• lava

Примечания:

• Для естественного нереста требуется действительный тип места появления.
• Используйте значения, соответствующие теме Босса.

spawn_times

Цель:

Ограничивает период времени, в течение которого может появиться Босс.

Доступные значения:

• all_day
• early_morning
• morning
• noon
• afternoon
• dusk
• night
• midnight

Отображение времени:

• early_morning: 0–2999 тиков
• morning: 3000–5999 тиков
• noon: 6000 - 11999 тиков
• afternoon: 12000 - 14999 тиков
• dusk: 15000 - 17999 тиков
• night: 18000 - 20999 тиков
• midnight: 21000 - 23999 тактов
• all_day: без ограничений по времени

Примечания:

• В Майнкрафте 24000 тиков в день.
• Можно использовать несколько значений времени.
• all_day означает, что Босс может появиться в любое время.

spawn_biomes

Цель:

Ограничивает биомы, в которых может появляться босс.

Как это работает:

• Обычный идентификатор биома ограничивает нерест только этим биомом.
• Тег биома, начинающийся с #, разрешает использование всех биомов в этом теге.

Примечания:

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

spawn_structures

Цель:

Позволяет боссу появляться, когда игрок находится внутри определенных структур.

Как это работает:

• Использует идентификаторы структур.
• Если игрок находится внутри соответствующей структуры, Босс может соответствовать этому правилу.
• Это проверяется вместе с правилами биома как соответствие биома или структуры.

Примечания:

• Это для идентификаторов структур, а не для тегов структур.
• Полезно для боссов подземелий, храмов, руин, крепостей или нестандартных построек.

spawn_weight

Цель:

Управляет естественным весом выбора порождения.

Как это работает:

• Если действительны несколько боссов, более высокий вес означает более высокий шанс выбора.
• Это не прямой процент.

Примечания:

• Используйте положительные значения.
• Если все допустимые веса равны 0, выбор может вернуться к случайному выбору действительного Босса.

6. Поля правил вознаграждения

reward_items

Цель:

Список прямых наград.

Как это работает:

• Каждая запись катится независимо.
• Если в трех записях есть chance: 0.1, каждая из них имеет свой шанс 10%.
• Игрок может получить несколько записей из одного списка reward_items.

Каждая запись о вознаграждении может содержать:

• item_id
• count
• command
• chance
• weight

weight используется только в том случае, если одна и та же запись о вознаграждении находится внутри reward_pools.entries. Это безвредно, но ненужно в прямом reward_items.

reward_pools

Цель:

Список пулов вознаграждений.

Как это работает:

• Каждый пул бросает один раз, используя свое chance.
• Если пул успешен, мод случайным образом выбирает одну запись из entries.
• Если rolls больше 1, пул выбирает такое количество записей.
• Выбор взвешивается по weight каждой записи.
• Выбор осуществляется с заменой, поэтому одну и ту же запись можно выбрать более одного раза, если rolls больше 1.

Каждый пул вознаграждений может содержать:

• chance
• rolls
• entries

Каждая запись пула может содержать:

• item_id
• count
• command
• chance
• weight

Важно:

• Уровень пула chance контролирует, дает ли пул что-либо.
• Начальный уровень chance анализируется на предмет совместимости, но записи пула выбираются по случайному весу после успешного создания пула.
• Если вам нужны отдельные независимые шансы, используйте reward_items.
• Если вы хотите «10% шанс для одного предмета из этого списка», используйте reward_pools.

item_id

Цель:

Предмет, данный игроку.

Примечания:

• Используйте действительный идентификатор элемента.
• Это может быть Minecraft, Cobblemon или другой предмет из мода.

count

Цель:

Количество предоставленных предметов.

Примечания:

• Если опущено, обычно действует как 1.
• Счет используется только для наград за предметы.
• Должно быть больше 0.

command

Цель:

Выполняет команду в качестве награды.

Примечания:

• Полезно для предоставления покемонов, денег, очков, титулов, разрешений или других наград сервера.
• Поддерживает заполнитель {player}.
• Пишите команду без косой черты.

chance

Цель:

Управляет вероятностью.

Для прямого reward_items:

• Если chance больше 0, используется этот специальный шанс.
• Если chance отсутствует или равен 0, для награды используется скорость выпадения по умолчанию из boss-reward.toml.

Для reward_pools:

• Если пул chance больше 0, используется этот специальный шанс.
• Если пул chance отсутствует или равен 0, пул использует скорость выпадения по умолчанию из boss-reward.toml.

Значение:

• 1 означает 100%.
• 0.5 означает 50%.
• 0.1 означает 10%.

rolls

Цель:

Контролирует, сколько записей выбрано из успешного пула вознаграждений.

Примечания:

• Если этот параметр опущен, по умолчанию он равен 1.
• Должно быть больше 0.
• Одна и та же запись может быть выбрана более одного раза.

weight

Цель:

Управляет шансом выбора внутри пула вознаграждений.

Как это работает:

• Более высокий вес означает более высокий шанс попасть в этот пул.
• Вес по умолчанию равен 1.
• Вес не является прямым процентом.

Пример:

• Запись А, вес 1
• Запись B, вес 3
• Вход B в этом пуле в три раза более вероятен, чем вход A.

Примеры вознаграждений

Независимые награды:

"reward_rule": {
  "reward_items": [
    {
      "item_id": "cobblemon:poke_ball",
      "count": 3,
      "chance": 0.1
    },
    {
      "item_id": "cobblemon:great_ball",
      "count": 2,
      "chance": 0.1
    },
    {
      "item_id": "cobblemon:ultra_ball",
      "count": 1,
      "chance": 0.1
    }
  ]
}

Одна награда из пула:

"reward_rule": {
  "reward_pools": [
    {
      "chance": 0.1,
      "rolls": 1,
      "entries": [
        {
          "item_id": "cobblemon:poke_ball",
          "count": 3
        },
        {
          "item_id": "cobblemon:great_ball",
          "count": 2
        },
        {
          "item_id": "cobblemon:ultra_ball",
          "count": 1
        }
      ]
    }
  ]
}

Взвешенный пул:

"reward_rule": {
  "reward_pools": [
    {
      "chance": 0.25,
      "rolls": 1,
      "entries": [
        {
          "item_id": "minecraft:diamond",
          "count": 1,
          "weight": 1
        },
        {
          "item_id": "minecraft:emerald",
          "count": 3,
          "weight": 3
        },
        {
          "command": "give {player} minecraft:gold_ingot 8",
          "weight": 5
        }
      ]
    }
  ]
}

Прямые вознаграждения и пулы можно использовать вместе:

"reward_rule": {
  "reward_items": [
    {
      "item_id": "minecraft:gold_ingot",
      "count": 2,
      "chance": 1.0
    }
  ],
  "reward_pools": [
    {
      "chance": 0.1,
      "entries": [
        {
          "item_id": "cobblemon:poke_ball",
          "count": 3
        },
        {
          "item_id": "cobblemon:great_ball",
          "count": 2
        },
        {
          "item_id": "cobblemon:ultra_ball",
          "count": 1
        }
      ]
    }
  ]
}

7. Наказать поля правил

punish_items

Цель:

Список наказаний.

Каждая запись о наказании может содержать:

• level
• evs
• ivs
• command
• chance

level

Цель:

Снижает уровень покемонов после поражения.

Примечания:

• Уровень не будет понижен ниже 1.
• Используйте осторожно, потому что потеря уровня может оказаться серьезной.

evs

Цель:

Уменьшает значения усилий.

Доступная статистика:

• hp
• attack
• defense
• special_attack
• special_defense
• speed

Примечания:

• Заполняйте только ту статистику, которую хотите уменьшить.
• Отсутствующая статистика игнорируется.

ivs

Цель:

Снижает индивидуальные значения.

Доступная статистика:

• hp
• attack
• defense
• special_attack
• special_defense
• speed

Примечания:

• IV наказание очень суровое.
• Рекомендуется только для проектов Боссов с высоким риском.

command

Цель:

Выполняет команду в качестве наказания.

Примечания:

• Полезно для применения эффектов, получения валюты, телепортации, трансляции или запуска серверных систем.
• Поддерживает заполнитель {player}.
• Пишите команду без косой черты.

chance

Цель:

Управляет вероятностью этого наказания.

Важно:

• Если chance больше 0, используется этот специальный шанс.
• Если chance отсутствует или равно 0, наказание использует шанс штрафа по умолчанию из boss-penalty.toml.

8. Случайные поля конфигурации

shiny

Цель:

Управляет тем, блестит ли Босс.

Примечания:

• true делает Босса блестящим.
• false делает это нормальным.
• Если этот параметр опущен, обычно по умолчанию используется значение false.

effort_values

Цель:

Устанавливает разброс EV Босса.

Доступная статистика:

• hp
• attack
• defense
• special_attack
• special_defense
• speed

Правила:

• Каждый показатель должен находиться в диапазоне от 0 до 252.
• Общее количество электромобилей не должно превышать 510.

custom_battle_stats

Цель:

Переопределяет или ограничивает статистику битвы с боссом.

Доступная статистика:

• hp
• attack
• defense
• special_attack
• special_defense
• speed

Каждое правило статистики использует:

• value
• mode

value

Цель:

Целевое значение статистики.

Примечания:

• Обычно положительное число.
• Полезно для боссов рейдового типа.

mode

Цель:

Управляет применением значения статистики.

Доступные значения:

• exact
• minimum
• maximum

Значения:

• exact: используйте это значение напрямую.
• minimum: статистика будет не ниже этого значения.
• maximum: статистика будет не более этого значения.

moves

Цель:

Устанавливает ходы Босса.

Примечания:

• Обычно используют до 4 ходов. — Названия ходов должны соответствовать идентификаторам ходов Cobblemon.
• Неверные названия ходов могут привести к сбою при создании Босса.

nature

Цель:

Устанавливает характер Босса.

Примечания:

• Если этот параметр опущен, Босс использует природу по умолчанию.
• Используйте природные имена Булыжника.

ability

Цель:

Устанавливает способность Босса.

Примечания:

• Если этот параметр опущен, используется поведение способностей по умолчанию.
• Неверные имена способностей могут привести к сбою при создании босса.

form

Цель:

Устанавливает форму Босса.

Примечания:

• Используйте это для специальных форм.
• Оставьте пустым, если не нужно.
• Значение должно соответствовать форме или поведению аспекта Cobblemon.

held_items

Цель:

Устанавливает возможные предметы для Босса.

Примечания:

• Может содержать один или несколько идентификаторов элементов.
• Если настроено несколько предметов, Босс может случайным образом использовать один из них.
• Неверные идентификаторы предметов могут привести к сбою создания босса.

battle_mode

Цель:

Устанавливает режим битвы с боссом и схему боя.

Доступные значения:

• 1v1 / one_vs_one
• 2v1 / two_vs_one
• 3v1 / three_vs_one
• 4v1 / four_vs_one
• 5v1 / five_vs_one
• 6v1 / six_vs_one

Важно:

battle_mode не ограничивает actions_per_turn.

Примечания:

• Это поле управляет режимом боя и раскладкой.
• Количество действий босса контролируется отдельно с помощью actions_per_turn.

actions_per_turn

Цель:

Устанавливает, сколько действий Босс может совершить за ход.

Правила:

• Должно быть не менее 1.
• Не ограничено battle_mode.

Примечания:

• Более высокие значения делают Босса намного сложнее.
• Это один из основных элементов управления сложностью.

scale

Цель:

Устанавливает размер босса.

Должность:

Внутри random_configs.

Как это работает:

• Если установлено, Босс использует этот нестандартный размер.
• Если этот параметр опущен, размер Босса рассчитывается автоматически на основе его уровня.

Правила:

• Должно быть больше 0.
• Окончательное значение ограничено допустимым диапазоном размеров мода.

Примечания:

• Используйте это для создания гигантских боссов.
• Оставьте это поле пустым для автоматического размера на основе уровня.

9. Система щитов боссов

Цель:

Система щитов Босса дает Боссу дополнительную защиту во время боя.

Как это работает:

• Босс может начать битву со слоями щита.
• Некоторые атаки могут потреблять слои щита.
• Сверхэффективные разрушительные приемы могут поглощать слои щита.
• Специальные приемы могут потреблять настроенные слои щита.
• Хотя щит все еще существует, некоторые взаимодействия со щитом могут уменьшить или заблокировать урон.
• Когда щит достигает 0, щит ломается.
• После разрушения щита Босс может войти в ослабленное состояние.
• После окончания ослабленных ходов щит может восстанавливаться каждый ход, если настроено восстановление.

Важно:

Переключатель глобального экрана в boss-shield.toml должен быть включен.

Боссу также нужны защитные поля внутри random_configs.

shield_layers

Цель:

Устанавливает начальные слои щита Босса.

Должность:

Внутри random_configs.

Как это работает:

• 0 означает, что у этого босса нет щита.
• Значение больше 0 включает поведение щита для этого босса.
• Это значение также используется в качестве максимального количества слоев защиты.

Правила:

• Должно быть 0 или выше.

Примечания:

— Это основное поле, которое включает щит для конкретного босса.

• Если это значение равно 0, другие поля щита обычно не имеют никакого эффекта.

shield_recover_per_turn

Цель:

Определяет, сколько слоев щита Босс восстанавливает каждый ход после разрушения щита и ослабления.

Должность:

Внутри random_configs.

Как это работает:

• 0 означает, что щит не восстанавливается.
• Значение больше 0 позволяет восстановить щит.
• Восстановление щита не может превышать максимальное количество слоев щита.

Правила:

• Должно быть 0 или выше.

Примечания:

• Используйте 0 для однократного прорыва щита.
• Используйте более высокие значения для повторного разрушения щита в стиле рейда.

shield_weaken_turns

Цель:

Определяет, сколько ходов Босс будет оставаться ослабленным после разрушения щита.

Должность:

Внутри random_configs.

Как это работает:

• Когда щит достигает 0, щит ломается.
• Босс входит в ослабленное состояние на такое количество ходов.
• Во время ослабленных ходов восстановление щита ждет.
• После окончания ослабленных ходов может начаться восстановление щита, если оно настроено.

Правила:

• Должно быть 0 или выше.

Примечания:

• Используйте это, чтобы создать окно урона после пробития щита.
• Большие значения дают игрокам больше времени для атаки.
• 0 означает отсутствие ослабленной задержки.

10. Система фазовых навыков

phase_skills

Цель:

Изменяет движения босса в зависимости от процента здоровья.

Как это работает:

• Каждая фаза имеет процент HP.
• Когда HP Босса достигнет этого процента, Босс может переключиться на другой набор приемов.

Примечания:

• Полезно для многофазных боев с боссами.
• Избегайте дублирования пороговых значений HP.
• Ходы должны быть действительными именами ходов Cobblemon.

hp_percent

Цель:

Процент HP, запускающий фазу.

Правила:

• Обычно от 1 до 100.
• В эту фазу входит меньшее или равное количество HP.

Примечания:

• Более высокие значения срабатывают раньше.
• Более низкие значения срабатывают позже.

moves

Цель:

Ходы, используемые на этом этапе.

Примечания:

• Обычно от 1 до 4 ходов.
• Используйте это, чтобы изменить стратегию Босса во время битвы.

11. Справочник по ключам статистики

Следующие клавиши статистики используются в effort_values, evs, ivs и custom_battle_stats:

• hp
• attack
• defense
• special_attack
• special_defense
• speed

12. Файлы конфигурации

Все файлы конфигурации находятся в папке:

config/cobbleboss/

Единые файлы конфигурации:

• level-mapping.json
• pokemon-max-level.json
• boss-spawn.toml
• boss-level.toml
• boss-reward.toml
• boss-penalty.toml
• boss-battle-check.toml
• boss-capture.toml
• boss-immune.toml
• boss-music.toml
• boss-shield.toml
• player-level-limit.toml

Важно:

Fabric и NeoForge используют одни и те же имена полей и структуру TOML верхнего уровня.

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

level-mapping.json

Цель:

Сопоставляет уровень покемонов игрока с уровнем босса.

Примечания:

• Используется только тогда, когда включено отображение пользовательского уровня.
• Левая сторона — уровень игрока.
• Правая сторона — уровень Босса.
• Если сопоставление не найдено, можно использовать обычный расчет уровня.

pokemon-max-level.json

Цель:

Управляет глобальным максимальным уровнем покемонов Cobblemon.

Поля:

• configName
• maxPokemonLevel
• description

Примечания:

• Максимальный уровень по умолчанию обычно равен 900.
• Это влияет на глобальный лимит уровня покемонов, используемый Cobblemon.

boss-spawn.toml

Цель:

Управляет появлением естественных боссов.

Поля:

• enableBossSpawn
• checkIntervalTicks
• spawnChance
• enableSpawnTimeRandom
• randomValueMin
• randomValueMax
• spawnFrequency

Примечания:

• Диапазон checkIntervalTicks от 100 до 72000.
• Диапазон spawnChance от 0 до 1.
• Диапазон randomValueMin и randomValueMax составляет от 1 до 10000.
• Диапазон spawnFrequency от 0 до 100.

boss-level.toml

Цель:

Управляет расчетом уровня босса.

Поля:

• bossLevelMultiplier
• minBossLevel
• maxBossLevel
• includePCPokemon
• scaleByMaxLevel
• enableCustomLevelMapping
• enableLevelRandom
• randomMin
• randomMax

Примечания:

• Диапазон bossLevelMultiplier от 1,0 до 10,0.
• Диапазон minBossLevel от 1 до 100.
• Диапазон maxBossLevel от 50 до 200.
• enableCustomLevelMapping контролирует, используется ли level-mapping.json.

boss-reward.toml

Цель:

Управляет шансом награды босса по умолчанию.

Поля:

• minDropRate
• maxDropRate
• levelScale

Важно:

Записи с прямым вознаграждением и пулы вознаграждений с chance больше 0 используют свой собственный шанс.

Записи прямых вознаграждений и пулы вознаграждений без chance или с chance 0 используют скорость выпадения по умолчанию из этой конфигурации.

Примечания:

• Диапазон minDropRate и maxDropRate от 0 до 1.
• Диапазон levelScale от 1 до 1000.

boss-penalty.toml

Цель:

Управляет вероятностью наказания по умолчанию.

Поля:

• enablePenalty
• minPenaltyChance
• maxPenaltyChance
• penaltyLevelScale

Важно:

Наказывайте записи с chance больше 0, используя свой собственный шанс.

Наказывайте записи без chance или с chance 0, используйте шанс штрафа по умолчанию из этой конфигурации.

Примечания:

• Диапазон minPenaltyChance и maxPenaltyChance от 0 до 1.
• Диапазон penaltyLevelScale от 1 до 1000.

boss-battle-check.toml

Цель:

Управляет проверками ограничения битвы с Боссом.

Поля:

• enableBattleCheck
• cancelBattle
• enablePokemonCheck
• bannedPokemonList
• enableItemCheck
• bannedItemsList
• enableMoveCheck
• bannedMovesList

Примечания:

• enableBattleCheck — главный выключатель.
• cancelBattle контролирует, отменяется ли битва при обнаружении запрещенного контента.
• bannedPokemonList использует идентификаторы видов покемонов.
• bannedItemsList использует идентификаторы предметов.
• bannedMovesList использует идентификаторы перемещения.

boss-capture.toml

Цель:

Определяет, можно ли поймать покемона-босса.

Поля:

• preventBossCapture
• showCaptureMessage

Примечания:

• preventBossCapture обычно должен оставаться включенным.
• showCaptureMessage контролирует, видят ли игроки сообщение, когда захват заблокирован.

boss-immune.toml

Цель:

Контролирует, являются ли сущности-боссы неуязвимыми в мире.

Поля:

• enableBossImmune

Важно:

В основном это защищает существ-боссов, помимо обычного боевого урона.

Это не означает, что Босс невосприимчив к любому шагу в бою.

Примечания:

• Рекомендуется оставить включенным.
• Помогает предотвратить убийство боссов игроками небоевыми методами.

boss-music.toml

Цель:

Управляет музыкой битвы с боссом.

Поля:

• enableBossBattleMusic
• stopOnBattleEnd

Важно:

Музыкальная система больше не использует bossBattleMusicSoundId.

Когда начинается битва с Боссом, мод случайным образом выбирает музыкальное звуковое событие из:

1. В моде встроен assets/cobbleboss/sounds.json.
2. Включены пакеты ресурсов, определяющие музыку в sounds.json.

Пакеты ресурсов, которые размещены только в папке resourcepacks, но не включены в меню пакетов ресурсов клиента, игнорируются.

Примечания:

• Встроенное звуковое событие по умолчанию — cobbleboss:boss_battle_theme.
• Пользовательская музыка должна предоставляться в пакете ресурсов.
• Звуковой файл должен быть в формате OGG.
• Игрокам необходимо включить пакет ресурсов, чтобы слышать музыку из пакета ресурсов.
• Старые конфигурации, содержащие bossBattleMusicSoundId, следует восстановить или очистить.

boss-shield.toml

Цель:

Управляет глобальной системой щитов Босса.

Поля:

• enableBossShield
• superEffectiveLayers
• moveLayerOverrides

Значение:

• enableBossShield: включает или отключает поведение щита Босса.
• superEffectiveLayers: слои щита поглощаются сверхэффективными разрушительными движениями.
• moveLayerOverrides: специальные правила перехода к слою щита.

Примечания:

• Если enableBossShield имеет значение false, поля защиты Boss JSON не будут работать.
• moveLayerOverrides использует идентификаторы перемещения и значения слоя щита.

player-level-limit.toml

Цель:

Управляет пределом уровня покемонов игрока.

Поля:

• enableLevelLimit
• maxPlayerPokemonLevel

Примечания:

• enableLevelLimit включает ограничение уровня покемонов игрока.
• maxPlayerPokemonLevel устанавливает максимально допустимый уровень покемонов игрока.

13. Музыкальный пакет ресурсов

Музыку битвы с боссами можно настроить с помощью пакетов ресурсов.

Как это работает:

• В моде встроена музыка в формате assets/cobbleboss/sounds.json.
• Включенные пакеты ресурсов могут добавлять больше музыкальных событий.
• Когда начинается битва с Боссом, мод случайным образом выбирает одно доступное музыкальное событие.
• Нет необходимости указывать в конфиге один звуковой ID.

Пути пакетов ресурсов:

pack.mcmeta
assets/cobbleboss/sounds.json
assets/cobbleboss/sounds/music/

Пример структуры:

my_boss_music_pack.zip
pack.mcmeta
assets/cobbleboss/sounds.json
assets/cobbleboss/sounds/music/boss_1.ogg
assets/cobbleboss/sounds/music/boss_2.ogg
assets/cobbleboss/sounds/music/boss_3.ogg

Пример sounds.json:

{
  "music.boss_1": {
    "category": "music",
    "sounds": [
      {
        "name": "cobbleboss:music/boss_1",
        "stream": true
      }
    ]
  },
  "music.boss_2": {
    "category": "music",
    "sounds": [
      {
        "name": "cobbleboss:music/boss_2",
        "stream": true
      }
    ]
  }
}

Соответствующие файлы:

assets/cobbleboss/sounds/music/boss_1.ogg
assets/cobbleboss/sounds/music/boss_2.ogg

Примеры звуковых идентификаторов:

• music.boss_1 в assets/cobbleboss/sounds.json становится cobbleboss:music.boss_1.
• music.boss_2 в assets/cobbleboss/sounds.json становится cobbleboss:music.boss_2.

Обнаружение музыки:

Мод воспринимает звуковое событие как музыку Босса, если одно из следующих условий верно:

• Ключ события начинается с music.
• Ключ события содержит .music.
• В событии "category": "music".
• Один из путей к звуковым файлам находится в папке music/.

Примечания:

• Используйте формат OGG.
• Используйте stream: true для музыки.
• Игрокам необходим пакет ресурсов, чтобы слышать собственную музыку.
• Используйте только оригинальную или лицензионную музыку. — Если пакет ресурсов не включен, клиент не будет регистрировать свои звуковые события.

14. Исправлены команды точки появления.

Основная команда:

/spawnpokemonbossat

Разрешение:

Требуется разрешение администратора.

Функции:

• create
• addboss
• removeboss
• setweight
• remove
• list
• info
• trigger
• settext
• cleartext
• announcement enable
• announcement text
• announcement color
• announcement clear

create

Цель:

Создает фиксированную точку появления Босса.

Параметры:

• Идентификатор точки возрождения
• Размер
• координата X
• координата Y
• координата Z
• Уровень босса
• Секунды возрождения
• Дополнительный текст голограммы

Примечания:

• Идентификатор точки появления должен быть уникальным.
• Время возрождения указано в секундах.
• Диапазон уровней боссов от 1 до 900.

addboss

Цель:

Добавляет босса в фиксированный пул точек появления.

Параметры:

• Идентификатор точки возрождения
• Уникальный идентификатор босса
• Вес

Примечания:

• Уникальный идентификатор босса должен существовать в загруженных данных босса.
• Более высокий вес означает более высокий шанс попасть в фиксированную точку появления.

removeboss

Цель:

Удаляет босса из фиксированного пула точек появления.

setweight

Цель:

Изменяет вес Босса в фиксированном пуле точек появления.

remove

Цель:

Удаляет фиксированную точку появления.

Примечания:

• Удаляет данные о точке появления.
• Удаляет соответствующее отображение голограммы.
• Управляет текущим активным фиксированным боссом.

list

Цель:

Перечисляет все фиксированные точки появления.

Показывает:

• Идентификатор точки возрождения
• Размер
• Координаты
• Уровень босса
• Время возрождения
• Бассейн боссов
• Текущий активный босс

info

Цель:

Показывает подробную информацию об одной точке появления.

Показывает:

• Размер
• Координаты
• Уровень босса
• Время возрождения
• Следующий тик возрождения
• Текущий активный босс
• Текст голограммы
• Бассейн боссов
• Статус объявления
• Текст объявления
• Цвет объявления

trigger

Цель:

Вручную подготавливает точку появления снова.

Примечания:

• Полезно для тестирования.
• Не удаляет точку появления.

settext

Цель:

Устанавливает фиксированный текст голограммы точки появления.

Поддерживаемые заполнители:

• {id}
• {level}
• {time}
• {x}
• {y}
• {z}
• {dimension}
• {boss_count}
• {boss_pool}
• {active_boss_id}
• {active_boss}
• {active_weight}

Примечания:

• Используйте |, чтобы разделить несколько строк голограммы.
• Заполнители голограмм отличаются от заполнителей объявлений.

cleartext

Цель:

Очищает текст пользовательской голограммы и восстанавливает поведение голограммы по умолчанию.

announcement enable

Цель:

Включает или отключает объявление фиксированной точки появления.

Как это работает:

• true включает объявление.
• false отключает объявление.

Примечания:

• Отдельной команды отключения объявлений нет.
• Используйте announcement enable с истиной или ложью.

announcement text

Цель:

Устанавливает пользовательский текст объявления.

Поддерживаемые заполнители:

• {boss}
• {boss_id}
• {species}
• {point}
• {dimension}
• {x}
• {y}
• {z}
• {position}

announcement color

Цель:

Устанавливает цвет сообщения объявления.

Доступные цвета:

• black
• dark_blue
• dark_green
• dark_aqua
• dark_red
• dark_purple
• gold
• gray
• dark_gray
• blue
• green
• aqua
• red
• light_purple
• yellow
• white

Примечания:

• Цвет по умолчанию — gold.
• Это меняет цвет объявления, а не цвет свечения Босса.

announcement clear

Цель:

Восстанавливает текст объявления по умолчанию.

Примечания:

• Не удаляет точку появления.
• Не очищает текст голограммы.
• Сбрасывается только фиксированный шаблон объявления о появлении.

Исправлен вес пула боссов при появлении.

Цель:

Управляет вероятностью выбора внутри одной фиксированной точки появления.

Правила:

• Минимальный вес: 1
• Максимальный вес: 1000000

Примечания:

• Это отдельно от естественного spawn_rule.spawn_weight.
• Более высокий вес означает более высокий шанс попасть в этот фиксированный пул точек появления.

15. Основные команды босса

checkpokemonboss

Цель:

Проверяет, какие боссы могут появиться в текущем местоположении игрока.

Показывает:

• Время до следующего обновления босса
• Соответствующие боссы
• Отображаемые имена боссов
• Веса спауна

Разрешение:

Обычно доступно обычным игрокам.

spawnpokemonboss

Цель:

Непосредственно порождает босса рядом с игроком.

Параметры:

• Уникальный идентификатор босса
• Дополнительный уровень

Разрешение:

Требуется разрешение администратора.

Примечания:

• Использует уникальный идентификатор босса, а не идентификатор вида.
• Диапазон уровней от 1 до 900.
• Полезно для тестирования конфигурации босса.

spawnpokemonbossat

Цель:

Управляет фиксированными точками появления боссов.

Разрешение:

Требуется разрешение администратора.

16. Рекомендации по настройке для начинающих

Для самой простой настройки:

• Включить естественное появление боссов.
• Используйте разумный интервал появления.
• Сначала используйте низкий шанс появления.
• Включить предотвращение захвата босса.
• Включить иммунитет к Боссу.
• Используйте отображение уровней или множитель уровней.
• Добавляйте награды с разумными значениями шансов.
• Добавьте свечение, чтобы боссов было легче найти.
• Оставьте шкалу пустой, если вам не нужны гигантские боссы.

Для более строгих босс-серверов:

• Включить боевые проверки.
• При необходимости заблокируйте конкретного покемона.
• Запретите определенные предметы, если это необходимо.
• При необходимости запретите определенные движения.
• Увеличьте характеристики Босса до custom_battle_stats.
• Используйте actions_per_turn осторожно.
• Добавлены настройки щита для боев в рейдовом стиле.

Для случайных серверов:

• Держите наказания на низком уровне или отключите их.
• Используйте видимое свечение Босса.
• Используйте умеренный размер босса.
• Выдавайте гарантированно небольшие награды и редкие специальные награды.
• Используйте пулы вознаграждений для вознаграждений «один предмет из этой группы».
• Избегайте слишком высоких значений actions_per_turn.

17. Распространенные проблемы

Босс не загружается

Возможные причины:

• Дубликат unique_id.
• Неверный species_id.
• Неверное имя хода.
• Неверное название способности.
• Неверный идентификатор предмета.
• Неверный цвет свечения.
• Неверное значение масштаба.
• Неверный формат JSON.
• Пусто reward_pools.entries.
• Неверный пул вознаграждений rolls.
• Неверная запись в пуле вознаграждений weight.

Босс не появляется естественным образом

Возможные причины:

• Естественный нерест отключен.
• Вероятность появления слишком мала.
• Интервал появления не прошел.
• Текущий биом не соответствует.
• Текущая структура не соответствует.
• Текущее время не совпадает.
• Текущий тип местоположения не соответствует.
• spawn_weight отсутствует или слишком низкое.
• Файл босса не загружен.

Музыка босса не играет

Возможные причины:

• Конфигурация музыки босса отключена.
• Выбранное звуковое событие не зарегистрировано на клиенте.
• Пакет ресурсов не включен.
• Неверный путь к звуковому файлу.
• Звуковой файл не в формате OGG.
• У клиента нет пакета ресурсов.
• Пакет ресурсов был помещен в папку, но не перемещен в список включенных.
• Громкость музыки отключена.

Важно:

Мод случайным образом выбирает из встроенной музыки и включенных пакетов ресурсов.

Он не использует bossBattleMusicSoundId.

Щит босса не работает

Возможные причины:

• Конфигурация глобального щита босса отключена.
• shield_layers равен 0 или отсутствует.
• Используемый прием не расходует слои щита.
• superEffectiveLayers установлено на 0.
• Ход не суперэффективный.
• Этот ход не указан в moveLayerOverrides.
• Босс был создан на основе старых или устаревших данных.

Босс слишком маленький или слишком большой

Возможные причины:

• scale установлено слишком низко или слишком высоко.
• Уровень босса вызывает автоматический расчет масштаба.
• Масштаб ограничен допустимым диапазоном мода.

Босс не светится

Возможные причины:

• glow не установлено.
• Цвет свечения недействителен.
• Босс был создан из старых данных.
• Другая система убрала эффект свечения.

Цвет объявления не меняется

Возможные причины:

• Название цвета неверно.
• Был использован неправильный идентификатор точки появления.
• Объявление отключено.
• Проверяемое сообщение не является фиксированным объявлением о появлении.

Старый конфиг NeoForge не работает

Возможные причины:

• Конфигурация была создана до унифицированных полей конфигурации.
• Старые сгруппированные разделы TOML все еще присутствуют.
• Старые поля Shield Snake_case все еще присутствуют.
• Старый bossBattleMusicSoundId все еще присутствует.

Исправление:

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

18. Резюме

Конфигурацию CobbleBoss можно понять так:

• Используйте unique_id, species_id, display_name и glow, чтобы определить личность и внешний вид Босса.
• Используйте spawn_rule, чтобы определить, где и когда оно появится.
• Используйте reward_rule и punish_rule, чтобы определить результаты выигрыша и проигрыша.
• Используйте reward_items для независимых бросков на награду.
• Используйте reward_pools для «бросьте один раз, затем выберите одну награду из этого списка».
• Используйте random_configs, чтобы определить характеристики, движения, режим боя, количество действий, щит, фазовые навыки, удерживаемые предметы, форму, способности, блестящее состояние и размер.
• Используйте файлы конфигурации для управления глобальным поведением босса.
• Используйте пакеты ресурсов, чтобы добавить случайную музыку для битвы с боссом.
• Используйте команды фиксированной точки появления, чтобы создавать контролируемые места появления боссов.

19. Платная функция: многопользовательские командные битвы с боссами

Это расширенная платная функция.

Путь к пакету данных:

data/cobbleboss/boss_teams/

Файл команды Босса определяет групповую битву с Боссом.

Поля:

• team_id
• pokemon_unique_ids
• spawn_structures
• defeat_rewards
• punish_rule

team_id

Цель:

Уникальный идентификатор команды Босс.

Примечания:

• Если пространство имен не указано, используется cobbleboss. — Команды могут использовать этот идентификатор.

pokemon_unique_ids

Цель:

Уникальные идентификаторы покемонов-боссов, используемые этой командой.

Примечания:

– Эти идентификаторы должны соответствовать обычным значениям Boss JSON unique_id.

• Командная система создает покемонов-боссов на основе существующих определений боссов.

spawn_structures

Цель:

Определяет, какие структуры могут активировать эту команду боссов.

Примечания:

• Использует идентификаторы структур.
• Когда игрок находится внутри соответствующей структуры и отправляет покемона, может быть запущен командный бой.
• Экземпляры структур записываются, чтобы одна и та же структура не запускалась повторно.

defeat_rewards

Цель:

Награды после победы над командой Боссов.

Поля:

• reward_items
• reward_pools
• item_id
• count
• command
• chance
• rolls
• weight

Как это работает:

• reward_items ведут себя как независимые броски на награду.
• reward_pools бросьте один раз, затем случайным образом выберите записи из пула.
• Пулы командных наград имеют тот же формат, что и обычные пулы наград боссов.

Случайное замечание:

Если chance больше 0, используется этот специальный шанс.

Если chance отсутствует или равно 0, можно использовать шанс вознаграждения по умолчанию.

Пример:

"defeat_rewards": {
  "reward_items": [
    {
      "item_id": "minecraft:gold_ingot",
      "count": 4,
      "chance": 1.0
    }
  ],
  "reward_pools": [
    {
      "chance": 0.1,
      "rolls": 1,
      "entries": [
        {
          "item_id": "cobblemon:poke_ball",
          "count": 3
        },
        {
          "item_id": "cobblemon:great_ball",
          "count": 2
        },
        {
          "item_id": "cobblemon:ultra_ball",
          "count": 1
        }
      ]
    }
  ]
}

punish_rule

Цель:

Наказания после поражения от команды Босса.

Поля:

• punish_items
• level
• evs
• ivs
• command
• chance

Случайное замечание:

Если chance больше 0, используется этот специальный шанс.

Если chance отсутствует или равен 0, можно использовать шанс штрафа по умолчанию.

spawnpokemonbossteam

Цель:

Вручную запускает командный бой с Боссом для игрока.

Значение команды:

/spawnpokemonbossteam <player> <bossTeamId>

Разрешение:

Требуется разрешение администратора.

Примечания:

• bossTeamId можно записать с пространством имен или без него.
• Если пространство имен не указано, используется cobbleboss. — Эта команда в основном предназначена для тестирования и событий, контролируемых администратором.

Поведение в командном бою в многопользовательском режиме

Как это работает:

• Система сканирует ближайших действующих игроков.
• Ближайшие игроки не должны быть еще в бою.
• Зрители и удаленные игроки игнорируются.
• Текущая система командного боя рассчитана на участие до двух игроков.
• Текущая система командного боя с Боссом использует до двух покемонов-боссов.
• Это создает битву в стиле рейда 2 на 2, когда доступно достаточное количество игроков и боссов.
• Если условия многопользовательской игры не соблюдены, можно вернуться к одиночной командной битве с боссом.

Примечания:

• Эту функцию лучше всего объяснить после обычной настройки Boss.
• Он предназначен для серверов, которым нужен игровой процесс в рейдовом стиле.
• Характеристики боссов, награды, щит и actions_per_turn должны быть тщательно сбалансированы для командных сражений.