Phat's Progression Framework

Phat's Progression Framework — это управляемая конфигом система уровней добычи для Minecraft. Переназначайте ванильные инструменты на новые уровни, ставьте железную руду за медью, продлевайте прогрессию дальше незерита — и всё это через JSON. Никакой регистрации предметов, никакой генерации мира, никакого контента. Просто гибкая основа для прогрессии модпаков.

Большинство модов на прогрессию в Minecraft либо добавляют свои уровни (заставляя вас использовать их инструменты), либо прикручивают новые металлы к ванильной системе (упираясь в незерит). Этот мод идёт другим путём: он позволяет разработчикам модпаков самим решать, как существующие инструменты, блоки и материалы из модов сочетаются друг с другом. Хотите, чтобы медь открывала доступ к железной руде? Одна строка в конфиге. Хотите инструменты из рунита выше незерита? Две строки в конфиге. Хотите, чтобы для адамантиновой руды нужны были эндгейм-инструменты из Mythic Metals? Вы поняли идею.

Зачем это ставить

• Разработчикам модпаков: превратите плоскую прогрессию во что-то с настоящей глубиной. Распределите 20+ руд из Mythic Metals по разным уровням. Вставьте металлы из модов между ванильными. Сделайте каждый металл значимым.
• Разработчикам модов: задавайте свои уровни через датапак, чтобы у пользователей сразу были разумные значения по умолчанию.
• Игрокам: поставьте модпак, который это использует, и наконец получите причину апгрейдиться дальше незерита.

Что он делает

• Система уровней 0-10: целые числа, легко рассуждать. 0-5 совпадают с ванилью (от руки до незерита), 6-10 расширяются модпаками.
• Принудительные уровни добычи: слишком слабые инструменты не выбивают предметы и добывают со скоростью голых рук. ТИП инструмента всё ещё важен (топор по-прежнему не добудет железную руду — только кирки).
• Гибкое сопоставление: задавайте уровни по точному ID предмета, glob-шаблону (*:copper_pickaxe), тегу (#c:tools/pickaxes) или ключевому слову-подстроке. Комбинируйте их для точности ({"keyword": "bronze", "tag": "c:tools/pickaxes"}).
• Поддержка датапаков: моды поставляют определения уровней, разработчики модпаков переопределяют их через конфиг.
• Горячая перезагрузка: правьте конфиги и делайте /reload прямо в игре. Перезапуск не нужен.
• Команда отладки: /progression info и /progression block показывают, к какому уровню сейчас отнесён любой предмет или блок.

Поведение по умолчанию

Из коробки мод идёт с разумными значениями по умолчанию, которые в основном повторяют ваниль. Сборка для 1.21.11 добавляет по умолчанию прогрессию «медь открывает железо» — медные инструменты (добавленные в ванили 1.21.9) теперь действительно нужны для добычи железной руды. Сборка для 1.21.1 сохраняет ванильную прогрессию нетронутой.

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

1. Установите Architectury API.
2. Закиньте этот jar в папку mods.
3. Запустите игру один раз. Файлы конфига по умолчанию создадутся в config/phats_progression/.
4. Правьте их или оставьте как есть — значения по умолчанию работают.

Совместимость

• Jade: работает без кода интеграции — подсказка при наведении на блок показывает правильные требования для добычи.
• Требуется на сервере: мод нужен и на клиенте, и на сервере. Ванильные клиенты подключиться не смогут.
• Требуется Java 21 (стандарт для Minecraft 1.21.x).

Конфигурация

Два файла конфига в config/phats_progression/:

• block_tiers.json — назначает блоки на уровни
• tool_tiers.json — назначает инструменты на уровни

Схема принимает гибридные записи — строку или объект:

{
  "ignore_datapacks": false,
  "tiers": {
    "6": [
      "mythicmetals:runite_ore",
      "*:adamantite_pickaxe",
      "#c:tools/pickaxes",
      {"keyword": "mithril", "tag": "c:tools/pickaxes"}
    ]
  }
}

Полную документацию смотри в [GitHub README](https://github.com/Phatdog731/phats_progression).

# Сообщение о проблемах

[GitHub Issues](https://github.com/Phatdog731/phats_progression/issues)

# Лицензия

MIT — изменяй и распространяй как хочешь.