Nicknames

Nicknames

Мод/плагин для Minecraft, добавляющий простую систему никнеймов. Игроки могут изменить своё отображаемое имя один раз; администраторы сервера могут управлять никнеймами свободно.

Поддерживает Forge (1.20.1), Fabric (1.21.1) и Bukkit/Paper/Purpur (1.21.1).

Возможности

• `/nick ` — установить свой никнейм (один раз на игрока)
• `/nick set ` — админ: установить никнейм игроку
• `/nick reset ` — админ: сбросить никнейм игрока
• /nick list — админ: список всех никнеймов со статусом
• Никнеймы отображаются в чате, TAB-списке и над головами игроков
• Никнеймы синхронизируются с клиентами для корректного отображения табличек с именами
• Мод необязателен на клиенте — сервер работает самостоятельно, клиент лишь получает синхронизацию табличек
• Поддержка локализации (английский, русский)
• Данные никнеймов сохраняются в config/nicknames/nicknames.json (Forge/Fabric) или plugins/Nicknames/nicknames.json (Bukkit)

Архитектура клиент-сервер

Мод использует собственный канал nicknames:sync для синхронизации никнеймов между сервером и клиентами.

Сервер хранит все никнеймы и является источником истины. Когда никнейм меняется или игрок заходит, сервер отправляет полную карту никнеймов (UUID -> отображаемое имя) всем подключённым клиентам.

Клиент (необязательно) получает пакет синхронизации и кэширует никнеймы локально. Этот кэш используется для отображения никнеймов над головами игроков (таблички с именами). Без клиентского мода игроки всё равно видят никнеймы в чате и TAB-списке — это обрабатывается на стороне сервера.

Это работает на всех платформах: сервер Bukkit/Purpur может синхронизировать никнеймы с клиентами Forge или Fabric через Plugin Messaging.

Структура проекта

nicknames-mod/
  common/    — общий код (NicknameStore, NicknameProtocol, NicknameEntry)
  forge/     — мод Forge 1.20.1 (клиент+сервер)
  fabric/    — мод Fabric 1.21.1 (клиент+сервер)
  bukkit/    — плагин Bukkit/Paper/Purpur 1.21.1 (только сервер)

Установка

Forge (1.20.1)

Положите nicknames-mod-x.x.x.jar из forge/build/libs/ в папку mods/ (сервер и, по желанию, клиент).

Fabric (1.21.1)

Положите fabric-x.x.x.jar из fabric/build/libs/ в папку mods/. Требуется Fabric API.

Bukkit/Paper/Purpur (1.21.1)

Положите nicknames-bukkit-x.x.x.jar из bukkit/build/libs/ в папку plugins/.

Сборка

./gradlew build

Собрать все модули сразу или указать конкретный:

./gradlew :forge:build
./gradlew :fabric:build
./gradlew :bukkit:build

Требуется Java 21.

Лицензия

MIT