CobbleRegions

CobbleRegions

Серверный сайдмод для Cobblemon, добавляющий региональные ограничения уровней с прогрессией для каждого игрока.

Каждый мир/измерение Minecraft привязан к региону. У каждого региона свой упорядоченный список ограничений (например: 14 -> 22 -> 28). Игроки могут свободно перемещаться, но покемон никогда не сможет превысить уровень, разблокированный в его родном регионе.

Основное поведение

• Текущий регион игрока определяется его измерением/миром.
• Активное ограничение — это текущее разблокированное ограничение этого региона.
• У каждого покемона есть постоянный родной регион (при поимке/вылуплении/получении).
• Опыт блокируется, чтобы покемоны не могли превысить ограничение родного региона, даже в регионах с более высоким ограничением.

Конфиг

Конфиг хранится в config/cobbleregions.json на сервере.

Пример:

{
  "battleDisallowOverCapSendOut": true,
  "battleOverCapSendOutMessage": "<red>Over-cap Pokemon cannot be sent out in battle: {pokemon_list}</red>",
  "battleInsufficientCapPokemonMessage": "<red>Battle canceled: you need at least {required} non-fainted Pokemon within your current cap.</red>",
  "battleInsufficientCapPokemonReason": "<red>Not enough cap-legal Pokemon are available to start this battle.</red>",
  "regions": [
    {
      "id": "region_a",
      "dimensions": ["minecraft:overworld"],
      "caps": [14, 22, 28, 40],
      "capMessages": {
        "14": "Level cap reached for this region.",
        "22": "Another cap reached."
      }
    },
    {
      "id": "region_b",
      "prerequisite": "region_a",
      "prerequisiteMessage": "Complete {prerequisite} before leveling in {region}.",
      "dimensions": ["minecraft:the_nether"],
      "caps": [14]
    }
  ]
}

Если у региона не настроены ограничения, он считается безлимитным.

battleDisallowOverCapSendOut по умолчанию false. Если true, CobbleRegions удаляет покемонов сверх ограничения из боевых составов игроков в начале боя. Если после этого остаётся слишком мало неослабленных покемонов для формата, бой отменяется.

Сообщения боевых ограничений настраиваются через MiniMessage:

• battleOverCapSendOutMessage использует {pokemon_list}.
• battleInsufficientCapPokemonMessage использует {required}.
• battleInsufficientCapPokemonReason использует {required}.

Команды

Доступ к командам использует permission-узел cobbleregions.command.regions (по умолчанию уровень прав 2). Опциональные команды прогресса используют permission-узел cobbleregions.command.regions.progress.

• /regions открывает админ-интерфейс управления регионами.
• `/regions progress get ` показывает ограничение игрока для региона.
• `/regions progress set ` устанавливает значение ограничения игрока для региона.
• `/regions progress advance ` переходит к следующему ограничению.
• `/regions progress reset ` сбрасывает к первому ограничению.
• `/regions progress complete ` устанавливает прогресс на финальное ограничение.

API

Класс RegionProgressApi предоставляет программное управление прогрессом для других модов или интеграций.

Примечания:

• Ограничения должны строго возрастать.
• Родной регион устанавливается автоматически при поимке, вылуплении или получении покемона.
• Установка прогресса требует значения ограничения, которое существует в списке ограничений региона.
• Регион может определять предварительное условие; игроки не могут получать опыт в этом регионе, пока не завершён регион-предусловие.
• Сообщения поддерживают форматирование MiniMessage и плейсхолдеры {cap}, {region}, {prerequisite}, {pokemon}.
• Админ-интерфейс открывает список регионов; используйте Create, чтобы ввести id в чате, левый клик — редактировать, правый клик — удалить.
• Экран редактирования региона управляет измерениями, ограничениями, сообщениями ограничений и прогрессом игроков.