Allied: Teams

[!NOTE] Форки и вклад в этот мод приветствуются.

---

Allied

Серверный мод для команд на Fabric. Создавайте команды с тегами, приглашайте игроков, общайтесь в личном чате, делитесь метками и хранилищем и управляйте уроном по своим — всё через /allied.

---

---

Требования

• Minecraft 26.2, Fabric Loader 0.19.5+
• Fabric API (обязательно)
• Placeholder API (необязательно, см. Плейсхолдеры)
• Только для серверов. Игроки заходят с обычным ванильным клиентом. Мод работает на выделенных серверах, а не в одиночной игре или мирах по локальной сети

Возможности

• Команды с тегами: цветной [TAG] отображается в чате, в списке игроков и над головами игроков
• Приглашения и заявки на вступление с кликабельными кнопками [ACCEPT]/[DENY]. Работает для офлайн-игроков — они увидят ожидающие приглашения при входе
• Роли: один владелец и любое число офицеров. Офицеры могут приглашать, принимать и отклонять заявки, исключать участников и удалять метки
• Передача владения, чтобы команда не застряла, когда её владелец перестаёт играть
• Командный чат, включается через /allied tm
• Урон по своим — переключатель для каждой команды
• Подсветка: невидимые сокомандники отображаются полупрозрачными со светящимся контуром, видимым только вашей команде
• Координаты смерти: когда сокомандник умирает, ваша команда видит где (клик — скопировать)
• Метки: общие именованные координаты для вашей команды. Чисто информация, без телепортации
• Общее командное хранилище: сундук на 18 слотов, доступный всей команде, по одному игроку за раз, с защитой от дюпа предметов и полным логированием
• Поддержка Placeholder API для модов чата, списка игроков и скорборда

Команды

Команды

• `/allied create ` Создать новую команду и стать её владельцем
• /allied info Показать название, тег, владельца, офицеров и участников вашей команды (игроки онлайн — зелёным)
• /allied leave Покинуть текущую команду
• /allied disband Распустить команду. Недоступно, пока в командном хранилище есть предметы (Владелец)
• `/allied set <name|tag|color> ` Изменить название, тег или цвет тега команды (Владелец)
• /allied settings Показать настройки команды с кнопками для их изменения (Владелец)
• /allied tm Переключить командный чат

Участники

• `/allied invite ` Пригласить игрока, даже если он офлайн (Владелец/Офицер)
• `/allied invAccept ` Принять приглашение
• `/allied invDeny ` Отклонить приглашение
• `/allied join ` Попроситься в команду
• `/allied accept ` Принять заявку на вступление (Владелец/Офицер)
• `/allied deny ` Отклонить заявку на вступление (Владелец/Офицер)
• `/allied kick ` Исключить игрока, даже если он офлайн. Офицеры могут исключать только участников (Владелец/Офицер)

Роли

• `/allied promote ` Сделать участника офицером (Владелец)
• `/allied demote ` Снять с игрока звание офицера (Владелец)
• `/allied transfer ` Передать команду другому участнику после подтверждения по клику. Вы становитесь офицером (Владелец)

Метки

• `/allied mark ` Сохранить текущую позицию как метку для команды
• `/allied mark ` Сохранить конкретные координаты
• /allied marks Показать метки команды с координатами, измерением и расстоянием
• `/allied unmark ` Удалить метку (тот, кто её поставил, офицеры и владелец)

У каждой команды может быть до 30 меток.

Хранилище

• /allied storage Открыть общее хранилище команды. Сначала его должен включить админ

Настройки команды

Владелец меняет их через /allied settings:

Хранилище команды

Общий сундук на 18 слотов для команды, открывается через /allied storage. Использует обычный ванильный интерфейс сундука.

• Один игрок за раз. Если его открыл кто-то другой, тебе скажут кто, и можно попробовать снова, когда он закроет
• Дюп предметов невозможен. Содержимое сохраняется при каждом изменении, перед каждым автосохранением и при закрытии, вместе с инвентарём игрока. Даже если сервер упадёт, предметы нельзя задублировать
• Ведётся лог. Каждое открытие и закрытие записывается в config/allied/storage/audit.log со временем, игроком и тем, что было добавлено и взято
• Отключено по умолчанию. Админы включают его для отдельной команды или для всех (см. ниже)
• Команду нельзя распустить, пока в её хранилище есть предметы

Команды админов

Требуются права оператора.

Команды

• /alliedAdmin list Показать все команды на сервере
• `/alliedAdmin info ` Показать информацию о любой команде
• `/alliedAdmin modifySettings [ ]` Посмотреть или изменить настройки любой команды
• `/alliedAdmin blockSettings ` Запретить владельцу команды менять её настройки
• `/alliedAdmin transfer ` Передать команду одному из её участников — для команд, чей владелец перестал играть

Хранилище

• `/alliedAdmin storage ` Включить или отключить хранилище для одной команды
• `/alliedAdmin storageAll ` Включить или отключить хранилище для всех команд и задать, будет ли оно у новых команд

Настройки сервера

• `/alliedAdmin memberCap ` Максимум участников на команду, не считая владельца (по умолчанию 5)
• `/alliedAdmin maxTeamNameLength ` Максимальная длина названия команды (по умолчанию 16)
• `/alliedAdmin maxTeamTagLength ` Максимальная длина тега команды (по умолчанию 4)
• `/alliedAdmin exportJson Поддерживатьconfig/allied/teams.json` в актуальном состоянии со всеми командами — полезно для показа команд на сайте
• `/alliedAdmin reset []` Стереть все данные Allied. Выдаёт код, действительный 60 секунд, для подтверждения

Все команды админов, кроме reset, также работают из консоли сервера.

Плейсхолдеры

Если установлен Placeholder API, Allied добавляет эти плейсхолдеры (пустые для игроков без команды):

• %allied:team_name% Название команды
• %allied:team_tag% Тег команды
• %allied:team_color% Цвет команды
• %allied:team_prefix% Цветной префикс [TAG] , используемый в списке игроков
• %allied:team_members% Количество игроков в команде, включая владельца

Файлы данных

Всё хранится в config/allied/:

• teams.dat Все данные команд (NBT, сохраняется безопасно, чтобы падение не повредило файл). Файлы старых версий обновляются автоматически
• teams.json Читаемый экспорт всех команд, только когда включён exportJson
• `storage/.dat` Содержимое хранилища каждой команды
• storage/audit.log Лог открытий и закрытий хранилища

Это описание актуально для версии v2.0.0 мода

Если вам нравится мод, рассмотрите возможность пожертвования в поддержку моей разработки

Любые проблемы, баги или предложения следует оставлять на странице задач GitHub

Вдохновением для мода послужило отсутствие актуальных командных модов для Fabric

Спасибо за использование моего мода <3