Глобальная конфигурация (config.yml)

Файл config.yml — это мозг плагина. Он управляет тем, как плагин взаимодействует с вашим сервером на макроуровне, одинаково влияя на всех игроков.

---

🛠️ Переменные интерфейса

# Высота голограммы над головой игрока
# Рекомендуется: 0.35 для людей, 0.50 при использовании скинов с большими шляпами.
y_offset: 0.35

# Максимальная дистанция прорисовки в блоках
# Меньшие значения могут улучшить производительность клиента.
view_distance: 64

# Алиасы главной команды
# Все они будут открывать меню помощи или вложенные команды.
command_aliases:
  - "enametag"

---

💾 Подключение к базе данных (HikariCP)

В отличие от базовых плагинов, которые сохраняют настройки в текстовых файлах, EligiusNametag обеспечивает плавный параллельный поток с использованием отраслевого стандарта HikariCP, чтобы предотвратить падение производительности (Lag Spikes) во время массовых сохранений в огромных сетях Folia.

🔹 Вариант A: SQLite (Локально)

Идеально подходит для одиночных серверов (изолированное Выживание, Скайблок). Не требует внешней настройки. Файл database.db будет автоматически создан в папке плагина.

database:
  type: "SQLITE"

🔹 Вариант B: MySQL (Сети Velocity/Bungee)

Идеально, если у вас есть несколько связанных серверов, и вы хотите, чтобы настройка команды /enametag me (показывать или скрывать неймтег) перемещалась вместе с игроком от одного сервера к другому.

database:
  type: "MYSQL"
  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "eligius_network"
    username: "admin"
    password: "super_secure_password"

⚠️ ВАЖНО О MYSQL

Убедитесь, что база данных eligius_network уже существует на вашем сервере MySQL/MariaDB перед включением плагина. Плагин создаст таблицы внутренне, но не может создать корневую базу данных из соображений безопасности.

---

🔴 Синхронизация Redis Pub/Sub

Если вы используете прокси-сеть (BungeeCord, Velocity), опроса MySQL недостаточно для визуальных обновлений в реальном времени. Включив Redis, если игрок скроет свой бейдж в лобби, это изменение будет мгновенно реплицировано на сервере выживания менее чем за 5 миллисекунд.

yaml redis: enabled: true host: '127.0.0.1' port: 6379 password: 'my_secure_redis_password'