Плагин mcFriends — друзья и личные сообщения 1.0.0-r3

Что делает mcFriends

Игроки отправляют и принимают заявки, управляют друзьями и пишут через /msg, /w, /tell, /fmsg и /reply. Пока дружба не принята обеими сторонами, личное сообщение невозможно. Party-команд и party-данных в плагине нет.

• GUI со скинами, страницами и лёгкой анимацией.
• Заявки, блокировки, broadcast, online-уведомления и переход на сервер друга.
• Опциональная защита от урона между друзьями.
• LuckPerms display names и PlaceholderAPI.
• Русский язык по умолчанию плюс девять переводов.
• H2 для одного сервера; MariaDB/PostgreSQL для MultiServer/MultiProxy.
• Безопасный dry-run/transactional импорт из Party and Friends и UUID-only CSV.
• Асинхронный API для других плагинов.

Команды и защита конфликтов

• /friends, /friend add|accept|deny|remove|requests|settings|block.
• /msg <друг> <текст>, /w, /tell, /fmsg, /reply.
• Алиасы перехватываются раньше CMI, EssentialsX, mcChat и mcAntiReLog; namespace/wrapper обходы закрыты.
• При недоступной базе сообщение fail-closed не уходит через соседний плагин.

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

• Spigot 1.12.2.
• Paper 1.12.2–1.21.11, 26.1.2 и 26.2 (16 точных версий).
• Purpur 1.16.5, 1.21.11, 26.1.2 и 26.2.
• BungeeCord; Velocity 3.4/4.0.
• Java 11+ по требованиям выбранного ядра.
• H2, MariaDB 11.4, PostgreSQL 16.

Установка сети

Один JAR ставится на proxy и серверы с GUI. Для одного сервера оставьте H2. В сети используйте общую MariaDB/PostgreSQL: одинаковые network-id, тип базы и table-prefix; уникальный node-id на каждом узле. Пароль — только через password-env или закрытый password-file; удалённая база требует TLS verification.

Импорт и приватность

Импорт сначала запускается без --apply. Старый пользователь БД должен быть read-only; применение выполняется одной транзакцией с fingerprint и не импортирует party. Хранятся UUID, последнее имя, дружба, заявки, настройки и короткое присутствие. Текст сообщения находится в очереди только до доставки/TTL и не пишется в обычный лог.

mcProfile bridge

mcFriends полностью работает standalone и публикует typed SocialPreferenceProvider с MOST_PRIVATE/origin/revision/freshness contract. Текущий mcProfile 1.0.0 ещё не реализует этот provider: активная двусторонняя синхронизация не заявляется до отдельного совместимого mcProfile adapter release.

Проверка релиза

Две byte-identical сборки; H2/MariaDB/PostgreSQL; 16 версий Minecraft; Bukkit/Spigot/Paper/Purpur/BungeeCord/Velocity; real CMI/EssentialsX/utilm/mcChat/mcAntiReLog/mcProfile/LuckPerms/PAPI conflict E2E; friendly-fire и PAF/CSV import gates. Скриншоты сняты настоящим Minecraft 1.21.11 Fabric client только на isolated 127.0.0.1 Paper.