Treevite

Treevite

Серверный мод для Minecraft на Fabric, реализующий систему вайтлиста на основе дерева приглашений для управления доступом игроков через цепочку приглашений.

Обзор

Treevite позволяет контролировать, кто может присоединиться к вашему серверу, через иерархическую систему приглашений. Начиная только с консоли в качестве корневого администратора, игроки из вайтлиста могут приглашать других, создавая «дерево» авторизованных игроков. Это даёт гибкий, органичный способ управления доступом к серверу без ручного добавления каждого игрока в вайтлист. Ключевые возможности:

• Система вайтлиста на основе дерева, начиная с консоли как корня
• Система приглашений от игрока к игроку с командой /invite
• Отзыв приглашений с автоматической корректировкой привилегий
• Суточные лимиты приглашений на игрока (настраиваемые)
• Поддержка игроков как Java, так и Bedrock Edition
• Отслеживание истории приглашений
• Команды на основе прав (через Fabric Permissions API)

Требования

• Minecraft Server 26.1.2 (или совместимый)
• Fabric Loader 0.19.2 или новее
• Java 25 или новее
• Fabric API

Установка

1. Скачайте файл мода tree-invite.jar
2. Поместите его в папку mods вашего сервера
3. Запустите сервер
4. (Необязательно) Установите Fabric Permissions API для доступа к командам на основе прав

Команды

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

**`/invite [java|bedrock]`**

• Пригласить игрока на сервер
• Если платформа не указана, подразумевается Java Edition
• Имена пользователей ищутся через Mojang API (Java) или преобразуются в формат XUID (Bedrock)
• Ограничено суточным лимитом (по умолчанию: 4 приглашения в день, сброс в 02:00 по серверному времени) **`/revokeinvite [java|bedrock]`**
• Отозвать приглашение, отправленное игроку
• Только отправитель приглашения может его отозвать
• Платформа необязательна; если не указана, проверяются обе платформы
• Игроки теряют доступ, если у них нет альтернативного пути обратно к консоли
• Данные приглашения сохраняются для автоматического восстановления при повторном приглашении /inviteinfo [player]
• Просмотреть информацию о приглашениях
• Показывает, кто пригласил игрока и кого пригласил он
• По умолчанию используется отправитель команды, если игрок не указан

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

**`/setmaxinvites `**

• Установить индивидуальный суточный лимит приглашений для игрока
• Переопределяет глобальный лимит по умолчанию
• Установите 0, чтобы отключить приглашения для игрока **`/setglobalmaxinvites `**
• Установить суточный лимит приглашений по умолчанию для всех игроков
• Доступно только консоли или администраторам с высокими правами

Как это работает

1. Инициализация: Изначально в вайтлисте только консоль
2. Приглашения: Любой игрок из вайтлиста может приглашать других с помощью /invite
3. Контроль доступа: Игрок может присоединиться, если у него есть хотя бы один действительный путь обратно к консоли через цепочку приглашений
4. Отзыв: Когда приглашение отозвано, затронутые игроки теряют доступ, если у них нет другого пути к консоли
5. Восстановление: Если отозванного игрока приглашают снова (напрямую или косвенно), он автоматически возвращает доступ

Пример сценария

Console (root)
├── Alice (invited by Console)
│   ├── Bob (invited by Alice)
│   └── Carol (invited by Alice)
└── Dave (invited by Console)
    └── Eve (invited by Dave)

• Все игроки могут присоединиться
• Если Console отзывает приглашение Dave, Eve теряет доступ (нет альтернативного пути)
• Если Console отзывает приглашение Alice, Bob и Carol теряют доступ
• Если Console приглашает Dave обратно, Eve автоматически возвращает доступ

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

Конфигурация хранится в config/tree-invite-messages.json и сохраняется между перезапусками. Мод управляет данными вайтлиста автоматически — вам не нужно изменять ванильный вайтлист.

Права

Когда доступен Fabric Permissions API, распознаются следующие права:

• tree-invite.invite — разрешить команду /invite
• tree-invite.revoke — разрешить команду /revokeinvite
• tree-invite.info — разрешить команду /inviteinfo
• tree-invite.admin.setmaxinvites — разрешить команду /setmaxinvites
• tree-invite.admin.setglobalmaxinvites — разрешить команду /setglobalmaxinvites

База данных

Treevite по умолчанию использует SQLite для постоянного хранения, но также может использовать PostgreSQL. Все связи приглашений и данные о лимитах сохраняются автоматически.

Поддержка

• Проблемы: Сообщайте об ошибках в репозитории на GitHub
• Вопросы: Ознакомьтесь с документацией или задайте вопрос в обсуждениях репозитория
• Автор: AwesomestOwl

Лицензия

GNU General Public License v3.0 — подробности см. в файле LICENSE