MCobblemonRaidMixin

MCobblemonRaidMixin

Продвинутое улучшение Raid Dens для Cobblemon
Точный контроль IV · Чёрный список спавна · Система взвешенных наград · Мультиязычность

Русский

Обзор

MCobblemonRaidMixin — это мод для Cobblemon, который значительно улучшает работу Raid Dens на базе Necro's Raid Dens. Он даёт тонкий контроль над генерацией IV у покемонов-наград за рейды, возможность заносить отдельные виды в чёрный список спавна и гибкую систему взвешенных командных наград — всё настраивается отдельно для каждого уровня рейда. Работает и на сервере, и на клиенте, может использоваться независимо на любой из сторон.

Поддержка платформ

Зависимости

Установка

Сервер

1. Скачай подходящий JAR для своей платформы из Releases
2. Помести JAR в папку mods/ твоего сервера
3. Убедись, что все зависимости выше тоже лежат в mods/
4. Запусти сервер — конфиг по умолчанию автоматически создастся в config/mcobblemonraidmixin.yml

Клиент (одиночная игра)

1. Скачай подходящий JAR для своей платформы из Releases
2. Помести JAR в папку mods/ твоего клиента
3. Убедись, что все зависимости выше тоже лежат в mods/
4. Запусти игру — конфиг по умолчанию автоматически создастся в config/mcobblemonraidmixin.yml

Примечание: Мод работает независимо на обеих сторонах. Можно ставить только на сервер, только на клиент или и туда, и туда.

Основные возможности

Движок генерации IV

Четыре разных режима генерации IV, у каждого — независимые параметры для каждого уровня (1–7 звёзд):

Система переопределения для отдельных видов

Переопределяй правила генерации IV для конкретных видов покемонов — приоритет выше глобального режима. Каждое переопределение поддерживает все четыре режима IV независимо:

overrideSet:
  mewtwo: [10, 3, 31]        # [min, guaranteedV, max]
overrideRandom:
  ditto: 120                  # max total IV sum
overrideExact:
  ditto: [31, 31, 31, 31, 31, 31]
overrideMinMax:
  pikachu: [15, 31]          # [min, max] per stat

#### Черный список спавна

Запрещает появление определенных видов покемонов в рейд-денах. Поддерживает форматы `cobblemon:name` и сокращенный `name`:

```yaml
spawnBlacklist:
  - "mewtwo"
  - "rayquaza"
  - "cobblemon:arceus"

Система команд наград со взвешенным выбором

Выполняет произвольные команды со взвешенным случайным выбором, когда игроки завершают рейд-дены. Каждый уровень (1-7) может иметь свой набор команд наград:

rewardCommandsPerTier:
  Tier1:
    - command: "give {player} cobblemon:rare_candy 1"
      weight: 50
    - command: "give {player} cobblemon:super_rod 1"
      weight: 30
    - command: "give {player} cobblemon:luxury_ball 3"
      weight: 20

Отслеживание участников рейда

Автоматически отслеживает всех игроков, присоединившихся к рейду. Когда босс рейда побежден, награды распределяются между всеми участниками — не только между игроком, нанесшим последний удар.

Справочник по конфигурации

Путь по умолчанию: config/mcobblemonraidmixin.yml

language: "zh"
raidIVMode: "SET"

# ── Режим SET ──────────────────────────────────
guaranteedVPerTier: [0, 1, 1, 1, 2, 2, 3]
minIVPerTier:       [0, 0, 0, 0, 0, 0, 0]
maxIVPerTier:       [20, 20, 20, 20, 20, 20, 20]

# ── Режим RANDOM ───────────────────────────────
maxVPerTier:        [80, 90, 100, 110, 120, 130, 140]

# ── Режим MIN_MAX ──────────────────────────────
minIVRangePerTier:  [0, 5, 10, 15, 20, 25, 31]
maxIVRangePerTier:  [10, 15, 20, 25, 31, 31, 31]

# ── Режим EXACT ────────────────────────────────
exactIVsPerTier:
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]

spawnBlacklist: []
overrideExact: {}
overrideRandom: {}
overrideSet: {}
overrideMinMax: {}
rewardCommandsPerTier: {}

Все значения массивов соответствуют уровням рейда с 1 по 7 (индекс 0 = 1 звезда, индекс 6 = 7 звезд).

Локализация

Языковые файлы автоматически создаются в config/mcobblemonraidmixin/lang_*.yml при первом запуске. Установите language в конфиге для переключения.

Архитектура проекта

MCobblemonRaidMixin/
├── common/                          # Платформонезависимый общий код
│   └── src/main/java/
│       └── MengSama/Mod/mcobblemonraidmixin/
│           ├── Config.java          # Загрузчик YAML-конфигурации
│           ├── Lang.java            # Движок мультиязычной i18n
│           ├── RaidParticipantTracker.java
│           └── mixin/
│               ├── RaidBossMixin.java       # Инъекция IV + выдача наград
│               └── RaidRegistryMixin.java   # Фильтр черного списка спавна
├── fabric/                          # Точка входа загрузчика Fabric
│   ├── build.gradle                 # Fabric Loom
│   └── src/main/
│       ├── java/.../fabric/Mcobblemonraidmixinfabric.java
│       └── resources/
│           ├── fabric.mod.json
│           └── mcobbleraidmixinfabric.mixins.json
├── neoforge/                        # Точка входа загрузчика NeoForge
│   ├── build.gradle                 # NeoForge ModDev
│   └── src/main/
│       ├── java/.../neoforge/Mcobblemonraidmixin.java
│       ├── resources/mcobblemonraidmixin.mixins.json
│       └── templates/META-INF/neoforge.mods.toml
├── build.gradle                     # Корневой проект
├── settings.gradle                  # Мультимодульная конфигурация
└── README.md

### Сборка из исходников

**Требования:** JDK 21+

```bash
git clone https://github.com/MengSama0502/MCobblemonRaidMixin.git
cd MCobblemonRaidMixin

# Place dependency JARs in libs/:
#   - Cobblemon-fabric-1.7.3+1.21.1.jar
#   - cobblemonraiddens-fabric-0.11.1+1.21.1.jar

# Build Fabric
./gradlew :fabric:build
# Output → fabric/build/libs/MCobbleRaidMixinFabric-1.1.0.jar

# Build NeoForge
./gradlew :neoforge:build
# Output → neoforge/build/libs/MCobbleRaidMixinNeoForge-1.1.0.jar

# Build both
./gradlew build

FAQ

В: Работает ли этот мод на клиенте? О: Да. Мод работает и на сервере, и на клиенте независимо. Можно использовать его на сервере для мультиплеера, на клиенте для одиночной игры или и там, и там.

В: Можно ли использовать версии для Fabric и NeoForge на одном сервере одновременно? О: Нет. Выберите версию, соответствующую загрузчику модов вашего сервера. Функционал идентичен.

В: Что будет, если не настроить команды наград? О: Мод просто применит генерацию IV и фильтрацию по чёрному списку. Команды наград опциональны.

В: Как работает взвешенный случайный выбор? О: У каждой команды есть значение weight. Вероятность выбора команды = weight / totalWeight. Команды с большим весом выбираются чаще.

В: Правила переопределения применяются до или после глобального режима? О: Переопределения для конкретных видов имеют полный приоритет. Если для вида есть переопределение, глобальный режим для этого покемона полностью игнорируется.

Лицензия

MIT License

Copyright (c) 2025 MengSama0502 & niumadadi520

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Авторы

MengSama0502 — ведущий разработчик niumadadi520 — соразработчик NecroSo1 — соразработчик

中文

Обзор

MCobblemonRaidMixin — это мод для Cobblemon, который глубоко расширяет геймплей логовищ на основе Necro's Raid Dens. Предоставляет тонкий контроль над генерацией IV у покемонов-наград, фильтрацию видов по чёрному списку и гибкую систему наград в виде команд со взвешенным случайным выбором — всё настраивается отдельно по звёздам логовища. Поддерживает сервер и клиент, может использоваться независимо на любой стороне.

Поддержка платформ

Требования к зависимостям

Установка

Сервер

1. Скачайте JAR-файл для нужной платформы со страницы Releases
2. Поместите его в папку mods/ сервера
3. Убедитесь, что все перечисленные выше зависимости тоже лежат в mods/
4. Запустите сервер — конфиг по умолчанию автоматически создастся в config/mcobblemonraidmixin.yml

Клиент (одиночная игра)

1. Скачайте JAR-файл для нужной платформы со страницы Releases
2. Поместите его в папку mods/ клиента
3. Убедитесь, что все перечисленные выше зависимости тоже лежат в mods/
4. Запустите игру — конфиг по умолчанию автоматически создастся в config/mcobblemonraidmixin.yml

注意： Мод работает независимо на обеих сторонах. Его можно установить только на сервер, только на клиент или на обе стороны одновременно.

Основные функции

Движок генерации IV

Четыре режима генерации IV, каждый поддерживает независимую настройку параметров по звёздам 1-7:

Система переопределения по видам

Отдельные правила генерации IV для конкретных покемонов, приоритет выше глобального режима. Каждое переопределение независимо поддерживает все четыре режима IV:

overrideSet:
  mewtwo: [10, 3, 31]        # [мин, гарантированное V, макс]
overrideRandom:
  ditto: 120                  # максимальная сумма IV
overrideExact:
  ditto: [31, 31, 31, 31, 31, 31]
overrideMinMax:
  pikachu: [15, 31]          # [мин, макс] для каждой характеристики

Чёрный список генерации

Запрещает появление определённых покемонов в логовах. Поддерживает форматы cobblemon:name и сокращённый name:

spawnBlacklist:
  - "mewtwo"
  - "rayquaza"
  - "cobblemon:arceus"

Команды наград со взвешенным случайным выбором

Выполняет пользовательские команды после завершения логова игроком, поддерживает взвешенный случайный выбор. Для каждого уровня звёзд (1-7) можно независимо настроить пул наград:

rewardCommandsPerTier:
  Tier1:
    - command: "give {player} cobblemon:rare_candy 1"
      weight: 50
    - command: "give {player} cobblemon:super_rod 1"
      weight: 30
    - command: "give {player} cobblemon:luxury_ball 3"
      weight: 20

Отслеживание участников

Автоматически записывает всех игроков, присоединившихся к логову. После победы над боссом логова награды выдаются всем участникам — а не только игроку, нанёсшему последний удар.

Справочник по конфигурации

Путь по умолчанию: config/mcobblemonraidmixin.yml

language: "zh"
raidIVMode: "SET"

# ── Режим SET ──────────────────────────────────
guaranteedVPerTier: [0, 1, 1, 1, 2, 2, 3]
minIVPerTier:       [0, 0, 0, 0, 0, 0, 0]
maxIVPerTier:       [20, 20, 20, 20, 20, 20, 20]

# ── Режим RANDOM ───────────────────────────────
maxVPerTier:        [80, 90, 100, 110, 120, 130, 140]

# ── Режим MIN_MAX ──────────────────────────────
minIVRangePerTier:  [0, 5, 10, 15, 20, 25, 31]
maxIVRangePerTier:  [10, 15, 20, 25, 31, 31, 31]

# ── Режим EXACT ────────────────────────────────
exactIVsPerTier:
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]
  - [31, 31, 31, 31, 31, 31]

spawnBlacklist: []
overrideExact: {}
overrideRandom: {}
overrideSet: {}
overrideMinMax: {}
rewardCommandsPerTier: {}

Все значения массивов по индексам 0-6 соответствуют логовам 1-7 звёзд.

Мультиязычность

Языковые файлы автоматически создаются при первом запуске в config/mcobblemonraidmixin/lang_*.yml. Для переключения измените поле language в конфигурации.

Архитектура проекта

MCobblemonRaidMixin/
├── common/                          # Платформонезависимый общий код
│   └── src/main/java/
│       └── MengSama/Mod/mcobblemonraidmixin/
│           ├── Config.java          # Загрузчик YAML-конфигурации
│           ├── Lang.java            # Движок мультиязычности i18n
│           ├── RaidParticipantTracker.java
│           └── mixin/
│               ├── RaidBossMixin.java       # Инъекция IV + выдача наград
│               └── RaidRegistryMixin.java   # Фильтрация чёрного списка генерации
├── fabric/                          # Точка входа загрузчика Fabric
│   ├── build.gradle                 # Fabric Loom
│   └── src/main/
│       ├── java/.../fabric/Mcobblemonraidmixinfabric.java
│       └── resources/
│           ├── fabric.mod.json
│           └── mcobbleraidmixinfabric.mixins.json
├── neoforge/                        # Точка входа загрузчика NeoForge
│   ├── build.gradle                 # NeoForge ModDev
│   └── src/main/
│       ├── java/.../neoforge/Mcobblemonraidmixin.java
│       ├── resources/mcobblemonraidmixin.mixins.json
│       └── templates/META-INF/neoforge.mods.toml
├── build.gradle                     # Корневой проект
├── settings.gradle                  # Многомодульная конфигурация
└── README.md

Сборка из исходников

Требования: JDK 21+

git clone https://github.com/MengSama0502/MCobblemonRaidMixin.git
cd MCobblemonRaidMixin

# Поместите JAR-зависимости в каталог libs/:
#   - Cobblemon-fabric-1.7.3+1.21.1.jar
#   - cobblemonraiddens-fabric-0.11.1+1.21.1.jar

# Сборка Fabric
./gradlew :fabric:build
# Вывод → fabric/build/libs/MCobbleRaidMixinFabric-1.1.0.jar

# Сборка NeoForge
./gradlew :neoforge:build
# Вывод → neoforge/build/libs/MCobbleRaidMixinNeoForge-1.1.0.jar

# Сборка всего
./gradlew build

### 常见问题

**Q: 此模组可以在客户端使用吗？**
A: 可以。模组在服务端和客户端均可独立运行。可以在服务端用于多人游戏，在客户端用于单人游戏，或两侧同时使用。

**Q: 能在同一服务器上同时使用 Fabric 和 NeoForge 版本吗？**
A: 不能。请选择与服务器 Mod Loader 匹配的版本。两者功能完全一致。

**Q: 不配置奖励命令会怎样？**
A: 模组仅执行 IV 生成和黑名单过滤。奖励命令是可选的。

**Q: 权重随机是如何工作的？**
A: 每条命令有权重值 `weight`。选中概率 = `weight / totalWeight`。权重越高的命令越容易被选中。

**Q: 覆盖规则是应用于全局模式之前还是之后？**
A: 按物种覆盖具有完全优先权。如果某物种存在覆盖规则，则该宝可梦完全跳过全局模式。

### 开源协议

本项目采用 **MIT 许可证**。详见上方英文 License 部分。

### 作者

**MengSama0502** — 主要开发者
**niumadadi520** — 联合开发者
**NecroSo1** — 联合开发者