RPG Lore

RPG Lore

Книги лора на основе данных, выпадающие из мобов. Соберите их все в Кодексе лора. RPG Lore позволяет создателям модпаков и владельцам серверов добавлять в мир собственные книги лора с помощью простых JSON-файлов. Книги выпадают из мобов по настраиваемым условиям — тип сущности, биом, измерение, время суток, погода, уровень Y и другое. Программировать не нужно.

Ключевые особенности

Книги лора

• Полностью на основе данных — каждый .json-файл в папке конфигов становится книгой лора. Добавляйте, редактируйте или удаляйте книги без перекомпиляции.
• Условный выпад — точно управляйте тем, какие мобы дропают какие книги, с помощью 11 различных типов фильтров.
• Настраиваемое оформление — цвет заголовка, цвет автора, описание, переключатель блеска зачарования и метки поколения для каждой книги.
• Стилизованный титульный лист — каждая книга открывается автоматически сгенерированным титульным листом с названием книги (масштабированным, жирным, цветным) и автором.
• Собственный интерфейс книги — книги лора используют уникальную текстуру, отличную от обычных написанных книг.
• Лимиты копий на игрока — при желании ограничьте, сколько раз каждый игрок может получить конкретную книгу.
• Масштабирование от Добычи — при желании увеличьте шанс выпадения с зачарованием «Добыча».

Кодекс лора

• Личная книга коллекции — привязанный к душе предмет, который хранит ваши книги лора прямо внутри себя.
• Книги попадают в Кодекс — когда вы подбираете новую книгу лора, она исчезает из мира и сохраняется в Кодексе. Никакого беспорядка в инвентаре.
• Просматриваемый интерфейс — экран в стиле пергамента с постраничным списком книг, счётчиком коллекции (n/N) и действиями «Читать» и «Копировать» для каждой книги.
• Механика копирования — создайте физическую копию любой собранной книги в своём инвентаре. Копии всегда попадают в инвентарь с увеличенным номером поколения.
• Привязка к душе — выдаётся при первом входе, сохраняется после смерти, нельзя выбросить.
• Защита от дубликатов — переключатель, блокирующий подбор книг лора, которые вы уже собрали.
• Поддержка Curios API — экипируйте Кодекс в специальный слот Curios «codex». Мягкая зависимость — работает и без установленного Curios.

Для создателей паков

• Горячая перезагрузка — используйте /rpglore reload, чтобы применить изменения без перезапуска.
• 11 типов условий выпадения — тип сущности, теги сущностей, биом, теги биомов, измерение, диапазон Y, время суток, погода, требование убийства игроком, переопределение шанса для книги и лимиты копий на игрока.
• Категории книг — организуйте книги с помощью поля category для аккуратной группировки в Кодексе.
• Исключение из Кодекса — скрывайте отладочные или временные книги из Кодекса с помощью codex_exclude.
• Блеск для каждой книги — включайте и выключайте мерцание зачарования отдельно для каждой книги.
• Подробный README — автоматически создаваемый _README.txt в папке конфигов описывает каждое поле.

Администрирование

• /rpglore reload — горячая перезагрузка всех определений книг
• /rpglore give — выдать книги игрокам (с опциональным отслеживанием лимита копий)
• /rpglore list — список всех загруженных книг с категориями
• /rpglore collection — игроки могут просматривать свою коллекцию (права оператора не нужны)
• /rpglore codex give/reset/add/remove/status — полное администрирование Кодекса

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

1. Поместите JAR в папку mods/.
2. Запустите игру один раз — мод создаст примеры конфигов и образец книги.
3. Добавьте свои .json-файлы книг в config/rpg_lore/books/.
4. Используйте /rpglore reload, чтобы применить изменения.
5. Игроки получают Кодекс лора при первом входе. Нажмите ПКМ, чтобы просмотреть коллекцию.

Пример определения книги

{
  "title": "The Ancient Battle",
  "author": "Unknown Chronicler",
  "weight": 5,
  "title_color": "FFD700",
  "description": "A faded account of a great battle.",
  "category": "History",
  "drop_conditions": {
    "mob_types": ["minecraft:zombie", "minecraft:skeleton"],
    "biome_tags": ["minecraft:is_overworld"],
    "time": "NIGHT_ONLY"
  },
  "pages": [
    "Long ago, in these very fields...",
    "The battle raged for three days..."
  ]
}

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

Все настройки находятся в config/rpg_lore/server.toml и config/rpg_lore/client.toml. Каждую функцию Кодекса можно включать и выключать отдельно.

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

• Curios API (опционально) — экипируйте Кодекс в специальный слот Curios. Все функции работают как из инвентаря, так и из слота Curios. Мод полностью работает и без установленного Curios.

Локализация

Локализован на 60 языков, включая английский, китайский, испанский, хинди, арабский, французский, немецкий, русский, японский, корейский и ещё 50.

Требуется: Minecraft 1.20.1 | Forge 47.3.0+ | Java 17 Опционально: Curios API 5.4.7+ Лицензия: MIT Исходный код: GitHub