Middle-Earth Additions: Factions

Дополнение Middle-Earth Additions: Factions представляет собой мощное расширение для мода Middle-Earth, которое автоматически отслеживает принадлежность игроков к различным фракциям и обеспечивает бесшовную интеграцию с модами, поддерживающими PlaceholderAPI. Идеальное решение для серверов, желающих отображать информацию о фракциях в чате, префиксах и других элементах интерфейса.

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

Автоматическое отслеживание фракций

• Мгновенное определение: Система автоматически обнаруживает, когда игроки присоединяются к фракциям в моде Middle-Earth
• Надежное хранение: Данные о фракциях сохраняются в формате JSON в папке сохранения мира
• Простота использования: Работает сразу после установки без дополнительной настройки

Интеграция с PlaceholderAPI

• Универсальная совместимость: Совместим со StyledChat, LuckPerms и любыми модами, поддерживающими PlaceholderAPI
• Разнообразные плейсхолдеры: Предоставляет различные форматы плейсхолдеров для разных сценариев использования
• Опциональная зависимость: Функционирует самостоятельно, но расширяет возможности при наличии PlaceholderAPI

Меню титулов (Новинка)

• Открытие меню: Нажмите клавишу O по умолчанию для открытия меню титулов фракций во время игры. Клавишу можно переназначить в настройках управления в категории "Middle Earth Additions"
• Панель фракции: Компактная панель показывает текущую иконку вашей фракции и пять узлов титулов
• Варианты для добра и зла: Меню адаптируется к вашей принадлежности (добро/зло), изменяя иконки кнопок и названия рангов (например, Солдат→Рыцарь→Капитан→Барон→Лорд против Воин→Урук→Вождь→Генерал→Повелитель)
• Линейное развитие: Разблокировка должна происходить последовательно. Попытка предварительного просмотра или разблокировки последующего узла показывает сообщение о необходимых условиях
• Требования и обратная связь: Всплывающие подсказки отображают требования к серебряным монетам, золотым монетам и уровню опыта с цветовой индикацией статуса. Недостаточные ресурсы или отсутствие необходимых условий отображаются через сообщения на панели действий
• Иконка фракции: Кнопка фракции в верхнем левом углу отображает соответствующий предмет для фракции (например, щит Гондора, деревянный щит Мордора и т.д.)
• Список разблокированных преимуществ: В панели перечислены преимущества для разблокированных рангов (примеры: +10% к скорости, +0.5 к урону стрелами, +1 сердце, аура сопротивления)

Команды для игроков

• Переключение отображения: Игроки могут управлять отображением своей фракции в чате
• Инструменты тестирования: Встроенные команды для отладки и тестирования функциональности плейсхолдеров

API для разработчиков

• Публичное API: Чистый интерфейс для других модов для доступа к данным о фракциях
• Безопасность типов: Правильная обработка null значений и управление ошибками
• Документация: Полная JavaDoc и примеры использования

Требования

Обязательные зависимости

• Minecraft: 1.21.1
• Fabric Loader: 0.16.14+
• Fabric API: Последняя версия
• Middle-Earth Mod: 1.5.3-1.21.1-alpha или совместимая версия

Опциональные зависимости

• PlaceholderAPI: 2.4.0+ (для расширенной поддержки плейсхолдеров)
• StyledChat: Для интеграции форматирования чата
• LuckPerms: Для интеграции префиксов/суффиксов на основе разрешений

Установка

1. Установите Fabric Loader и Fabric API
2. Установите мод Middle-Earth
3. Скачайте и поместите этот мод в папку mods
4. (Опционально) Установите PlaceholderAPI для расширенной совместимости
5. Запустите ваш сервер/мир

Доступные плейсхолдеры

Основные плейсхолдеры

Поддерживаемые фракции

Все фракции мода Middle-Earth поддерживаются с правильным форматированием:

Примеры использования

Интеграция с StyledChat

{
"chat": {
"format": "<%mefaction% {player_name}> {message}"
}
}

Результат: Всем привет!

Префикс LuckPerms

/lp user PlayerName meta setprefix 100 "%mefaction% "

Результат: Игрок отображается как Gondor PlayerName

Пользовательское форматирование чата

{
"style": {
"chat": "[%mefaction%] %player% » %message%"
}
}

Результат: [Gondor] PlayerName » Привет, Средиземье!

Команды

Команды для игроков

• /togglefaction - Переключить отображение фракции в вашем имени
• Показывает текущий статус вашей фракции
• Предоставляет предварительный просмотр того, как будет отображаться ваше имя

Команды администратора

• /viewfactiondata - Просмотреть все сохраненные данные о фракциях
• Список всех игроков и их фракций
• Показывает общее количество игроков
• /exportfactiondata - Показать расположение файла данных о фракциях
• Отображает путь к файлу хранения JSON
• Показывает текущую статистику хранения
• /testfactionplaceholder - Тестирование функциональности плейсхолдеров
• Инструмент отладки для администраторов сервера
• Показывает все доступные плейсхолдеры для игрока
• Отображает текущее состояние переключения

Хранение данных

Данные о фракциях автоматически сохраняются в [world]/faction_data.json:

{
"player-uuid-here": {
"playerId": "player-uuid",
"playerName": "PlayerName",
"disposition": "good",
"factionId": "me:gondor",
"spawnId": "me:gondor.minas_tirith",
"timestamp": 1672531200000
}
}

Поля данных

• playerId: Уникальный идентификатор игрока
• playerName: Текущее имя игрока
• disposition: Принадлежность фракции (добро/зло/нейтрально)
• factionId: Полный идентификатор фракции из мода Middle-Earth
• spawnId: Связанное место появления
• timestamp: Время последнего обновления в миллисекундах

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

Протестированная совместимость

• ✅ StyledChat - Полная поддержка форматирования чата
• ✅ LuckPerms - Интеграция префиксов/суффиксов
• ✅ TAB - Интеграция с таблицей лидеров и списком игроков
• ✅ MiniMOTD - Плейсхолдеры для сообщения дня сервера

Настройка

Этот мод разработан для работы без настройки. Все параметры автоматически определяются и настраиваются на основе вашей установки мода Middle-Earth.

Опции кастомизации

• Состояния переключения игроков сохраняются после перезапуска сервера
• Форматирование названий фракций можно настраивать через API
• Расположение данных JSON привязано к сохранениям миров для поддержки нескольких миров