Friend

Плагин Friend для Minecraft: социальное взаимодействие на сервере

Плагин Friend — это социальное расширение для серверов Minecraft, позволяющее игрокам добавлять друзей, отправлять сообщения, письма и подарки, а также создавать партии. Инструмент работает в сетях BungeeCord и Velocity с нативной поддержкой архитектуры Folia. Данные хранятся в базе данных MySQL или SQLite, что обеспечивает синхронизацию между всеми серверами сети.

Возможности системы

Плагин Friend — это социальное расширение для серверов Minecraft, позволяющее игрокам добавлять друзей, отмечать лучших и любимых друзей, создавать группы с заметками и никами. Доступна система приватного чата с возможностью отправки сообщений игрокам, которые не находятся онлайн. Система подарков включает защиту от злоупотреблений с таймаутами и суточными лимитами. Партии поддерживают эффекты зелий, привязку компаса к ближайшему участнику или конкретной цели, а также систему waypoints для навигации. Лидеры партий автоматически получают права на постройки в территориях, защищенных плагин GriefPrevention. Для администраторов доступна функция проверки времени последнего онлайн любого игрока.

Команды и управление

Основное управление осуществляется через команды. Для работы с друзьями доступны /friend add, /friend remove, /friend accept, /friend deny, /friend list и /friend requests. Можно управлять статусом лучших друзей (/friend best), добавлять ника (/friend nick) и заметки (/friend note). Управление группами осуществляется командой /friend group. Для перемещения игроков предусмотрены /friend tp (телепортация) и /friend jump (переход на сервер друга). Частный чат запускается командой /msg или /reply для ответа, а общий канал друзей доступен через /fc. Система партий управляется командами /party create, /party invite, /party kick, /party disband и /party transfer. Для работы с подарками используется команда /gift. Все основные команды имеют алиасы с префиксом f (например, /fmsg), чтобы избежать конфликтов с другими плагинами.

Права доступа

Права доступа распределены по функциональным группам. Базовый доступ к командам друзей предоставляется по праву friends.use. Доступ к системе почты регулируется правом friends.mail, а к системе партий — friends.party. Расширенные возможности включают доступ к эффектам в партах (friends.party.effects), чату друзей (friends.chat), телепортации (friends.teleport) и переходу на сервер друга (friends.jump). Кросс-серверные функции доступны по праву friends.network. Администраторы могут использовать команду перезагрузки конфигурации (/freload) через право friends.reload и все административные команды через friends.admin. В таблице ниже представлены все доступные права и их настройки по умолчанию.

Права доступа и их назначение

Интеграции и API

Плагин разработан с возможностью глубокой интеграции в экосистему серверов. Поддерживается PlaceholderAPI с более чем 25 плейсхолдерами, такими как %friends_count%, %friends_online%, %friends_in_party% и статистика подарков. Для управления правами предусмотрен модуль интеграции с LuckPerms. Плагин автоматически делится группами доступа WorldGuard с друзьями и автоматически доверяет лидерам партий территории в GriefPrevention. Для разработчиков доступна полноценная Java API для управления списками друзей, запросами, сообщениями и партиями. Примеры методов включают FriendsAPI.getFriends(), FriendsAPI.sendMessage() и FriendsAPI.createParty().

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

```java
// Управление друзьями
FriendsAPI.getFriends(playerUUID);
FriendsAPI.getOnlineFriends(playerUUID);
FriendsAPI.areFriends(playerUUID, otherUUID);
FriendsAPI.addFriend(playerUUID, friendUUID);
FriendsAPI.removeFriend(playerUUID, friendUUID);

// Отправка сообщений и почты
FriendsAPI.sendMessage(senderUUID, receiverUUID, message);
FriendsAPI.sendMail(senderUUID, receiverUUID, content);

// Работа с партиями
FriendsAPI.createParty(leaderUUID);
FriendsAPI.disbandParty(partyId);
FriendsAPI.invitePlayerToParty(partyId, playerId);
FriendsAPI.getPartyEffects(partyId);

// Статистика и лидерборды
FriendsAPI.getPlayerSettings(playerUUID);
FriendsAPI.getLeaderboard(type, limit);
```

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

Для работы в сети BungeeCord или Velocity требуется установка одного файла Friends.jar на каждый сервер-бэкенд (Spigot, Paper, Folia). Никакие файлы не устанавливаются на прокси. Все серверы должны подключаться к единой базе данных MySQL. В конфигурации каждого сервера необходимо задать уникальное имя server-name (например, lobby, survival) и включить режим сети (network.enabled: true). Для BungeeCord в spigot.yml следует активировать параметр bungeecord: true. Для Velocity в paper-global.yml нужно включить proxies.velocity.enabled: true и указать секретный ключ. После перезапуска серверов запросы дружбы, сообщения и приглашения в партии будут синхронизироваться через сеть.

Пример конфигурации сети для Velocity

```yaml
proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: "your-velocity-secret"

network:
  enabled: true
  channel: "friends:network"

server-name: "lobby"
```

Конфигурация и настройки

Основной файл конфигурации config.yml содержит настройки для всех систем. В разделе settings можно задать лимит друзей (max-friends), включить/выключить лучших друзей и группы. Для телепортации и перехода на сервер друга настраиваются таймауты (cooldown). В разделе party регулируется максимальный размер партии (по умолчанию 8), включаются эффекты и магазин улучшений. Система почты поддерживает автоматическое удаление старых писем. Система подарков имеет настройки таймаута (cooldown), суточного лимита (max-daily) и черный список предметов, которые нельзя дарить (например, BEDROCK, BARRIER). В разделе integrations можно включить интеграцию с GriefPrevention и WorldGuard.

Пример настройки подарков и почты

```yaml
gifts:
  enabled: true
  cooldown: 60
  max-daily: 10
  max-stack-size: 64
  expiry-days: 7
  blacklist:
    - BEDROCK
    - BARRIER
    - COMMAND_BLOCK

mail:
  enabled: true
  auto-cleanup:
    enabled: true
    days-old: 30
```

База данных и миграция

Плагин поддерживает MySQL и SQLite. При первом запуске автоматически создаются необходимые таблицы. Для сетевых серверов рекомендуется использовать MySQL для обеспечения единого хранилища данных. В конфигурации базы данных необходимо указать хост, порт, имя базы, пользователя и пароль. Плагин автоматически создает таблицы при первом запуске, если их еще нет в базе данных. Поддерживаются драйверы SQLite для Linux (aarch64, x86_64) и macOS, а также для Windows (x86_64). Файл архива содержит исполняемые библиотеки SQLite, что позволяет использовать локальную базу данных без внешних зависимостей.

Совместимость и технические требования

Плагин совместим с загрузчиками Bukkit, BungeeCord, Folia, Paper, Purpur, Spigot и Velocity. Поддерживается широкий спектр версий игры от 1.20 до 26.3. Архив содержит 1446 файлов и весит около 5.3 МБ. Плагин не требует внешних зависимостей (status: known_none), кроме опциональных модулей для расширенного функционала. Клиентская часть не поддерживается, плагин работает исключительно на стороне сервера. Поддерживается полная архитектура Folia с использованием расписания на region-потоках. Плагин не использует миксины.

Решение проблем и частые вопросы

Если друзья не синхронизируются, проверьте, что все серверы указывают на одну и ту же базу данных MySQL. Если кросс-серверные сообщения не работают, убедитесь, что параметр bungeecord: true (для BungeeCord) или форвардинг Velocity включен. Если игроки показывают неправильный сервер, каждому серверу нужно задать уникальное server-name в config.yml. Если возникает конфликт команд с другими плагинами, используйте алиасы с префиксом f (например, /fmsg) или команду /friends: . Для проверки статуса любого игрока используйте команду /friend seen .

Связанные материалы

• GriefPrevention — похожий плагин

Автор: TheeCobra · Лицензия: MIT