### Основные возможности:

- ✨ 16+ миллионов цветов через HEX коды
- 🌈 RGB формат для удобного выбора цветов
- 📺 Title сообщения на весь экран
- 💬 Сообщения в чат с поддержкой множества строк
- 🎯 Динамические плейсхолдеры для персонализации
- ⚙️ Гибкая настройка через config.yml
- 🚀 Легковесный - минимальная нагрузка на сервер
- 🔧 Совместимость с Spigot, Paper, Purpur и другими

---

## Системные требования

### Минимальные требования:

| Компонент | Требование |
|-----------|------------|
| Сервер | Spigot 1.16.5+ / Paper 1.16.5+ |
| Java | Java 8 (1.8) или выше |
| Minecraft | 1.16.5 и выше |
| RAM | Минимум 512 MB |
| Процессор | Любой современный CPU |

### Рекомендуемые требования:

| Компонент | Рекомендация |
|-----------|--------------|
| Сервер | Paper 1.19+ или Purpur |
| Java | Java 17+ |
| RAM | 1 GB+ |

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

✅ Полностью совместим:
- Spigot (1.16.5+)
- Paper (1.16.5+)
- Purpur (1.16.5+)
- Airplane
- Pufferfish

❌ Не совместим:
- Vanilla Minecraft сервер
- Bukkit версии ниже 1.16.5
- Forge/Fabric серверы (без гибридных решений)

---

## Установка плагина

### Шаг 1: Скачивание плагина

1. Скачайте файл WelcomePlugin-1.0.0.jar из раздела releases
2. Убедитесь, что файл имеет расширение .jar
3. Проверьте, что файл не поврежден (размер около 8 KB)

### Шаг 2: Размещение на сервере

1. Откройте папку вашего сервера
2. Найдите папку plugins
3. Скопируйте WelcomePlugin-1.0.0.jar в папку plugins

server/

├── plugins/

│   └── WelcomePlugin-1.0.0.jar  ← Сюда

├── world/

├── server.jar

└── ...


### Шаг 3: Запуск и первичная настройка

1. Запустите сервер (или перезапустите, если он уже работает)
2. Дождитесь полной загрузки сервера
3. В консоли должно появиться:
[WelcomePlugin] WelcomePlugin успешно загружен!

   [WelcomePlugin] Автор: animesao


### Шаг 4: Проверка установки

Выполните команду в консоли или в игре (с правами администратора):
/plugins


В списке должен быть зеленый WelcomePlugin:
Plugins (1): WelcomePlugin


Если плагин красный - значит есть ошибка. Проверьте логи сервера.

### Шаг 5: Первичная конфигурация

1. Остановите сервер командой /stop
2. Перейдите в папку plugins/WelcomePlugin/
3. Откройте файл config.yml в текстовом редакторе
4. Настройте приветствия по вашему вкусу (см. раздел [Структура конфигурации](#структура-конфигурации))
5. Сохраните файл
6. Запустите сервер

Важно: После изменения конфигурации можно использовать команду /reload вместо полного перезапуска сервера, но это может привести к проблемам с другими плагинами.

---

## Структура конфигурации

Файл config.yml находится в папке plugins/WelcomePlugin/ и имеет следующую структуру:

yaml

# WelcomePlugin Configuration

# Автор: animesao

# Поддержка HEX и RGB цветов



welcome:

  # Главный переключатель плагина

  enabled: true

  

  # Настройки Title (большой текст на экране)

  title:

    enabled: true

    text: "&#FFD700&l✦ Добро пожаловать! ✦"

    subtitle: "&rgb(100,200,255)%player%"

    fade-in: 10

    stay: 70

    fade-out: 20

  

  # Список сообщений в чате

  messages:

    - ""

    - "&#FF5733&l============================================"

    - ""

    - "  &#FFD700&lДобро пожаловать, %player%!"

    - ""

    - "  &rgb(100,200,255)Рады видеть тебя на нашем сервере!"

    - ""

    - "  &aТекущий мир: &e%world%"

    - ""

    - "&#FF5733&l============================================"

    - ""


---

## Подробное описание параметров

### Параметр: welcome.enabled

Тип: Boolean (true/false)
По умолчанию: true
Описание: Главный переключатель плагина. Если установлено false, плагин не будет отправлять никаких приветствий.

Примеры:
yaml

enabled: true   # Плагин работает

enabled: false  # Плагин отключен


Когда использовать false:
- Временное отключение приветствий
- Тестирование других плагинов
- События на сервере, где приветствия не нужны

---

### Параметр: welcome.title.enabled

Тип: Boolean (true/false)
По умолчанию: true
Описание: Включает или отключает показ title на экране при входе игрока.

Примеры:
yaml

title:

  enabled: true   # Title показывается

  enabled: false  # Только сообщения в чате


Примечание: Даже если title.enabled: false, сообщения в чате будут отправляться (если welcome.enabled: true).

---

### Параметр: welcome.title.text

Тип: String (текст)
По умолчанию: "&#FFD700&l✦ Добро пожаловать! ✦"
Описание: Основной текст title, который появляется в центре экрана большими буквами.

Поддержка:
- ✅ HEX цвета (&#RRGGBB)
- ✅ RGB цвета (&rgb(R,G,B))
- ✅ Стандартные коды (&a, &l, и т.д.)
- ✅ Плейсхолдеры (%player%, %world%, и т.д.)

Примеры:
yaml

text: "&aПривет!"                                    # Зеленый текст

text: "&#FF0000Добро пожаловать!"                    # Красный HEX

text: "&rgb(255,215,0)&lСЕРВЕР"                      # Золотой жирный RGB

text: "&#00FF00Привет, %player%!"                    # С плейсхолдером

text: "&#FF0000&l⚔ &#FFFF00СЕРВЕР &#0000FF&l⚔"     # Разноцветный


Рекомендации:
- Держите текст коротким (максимум 30-40 символов)
- Используйте жирный шрифт (&l) для лучшей читаемости
- Эмодзи и символы Unicode поддерживаются

---

### Параметр: welcome.title.subtitle

Тип: String (текст)
По умолчанию: "&rgb(100,200,255)%player%"
Описание: Подзаголовок, который отображается под основным title меньшим шрифтом.

Поддержка:
- ✅ Все те же возможности, что и title.text
- ✅ Может быть пустым ("")

Примеры:
yaml

subtitle: "&eДобро пожаловать на сервер!"

subtitle: "&rgb(100,200,255)%player%"

subtitle: "&#FFD700Мир: %world%"

subtitle: ""  # Subtitle не показывается


---

### Параметр: welcome.title.fade-in

Тип: Integer (целое число)
По умолчанию: 10
Единицы: Тики (20 тиков = 1 секунда)
Описание: Время, за которое title плавно появляется на экране.

Диапазон: 0 - 200 (рекомендуется 5-30)

Примеры:
yaml

fade-in: 0    # Мгновенное появление

fade-in: 10   # 0.5 секунды (стандарт)

fade-in: 20   # 1 секунда

fade-in: 40   # 2 секунды (медленно)


Рекомендации:
- 5-10 - быстрое появление
- 10-20 - стандартная скорость
- 20-40 - медленное, драматичное появление

---

### Параметр: welcome.title.stay

Тип: Integer (целое число)
По умолчанию: 70
Единицы: Тики (20 тиков = 1 секунда)
Описание: Время, в течение которого title полностью виден на экране.

Диапазон: 10 - 500 (рекомендуется 40-100)

Примеры:
yaml

stay: 40   # 2 секунды (быстро)

stay: 70   # 3.5 секунды (стандарт)

stay: 100  # 5 секунд

stay: 200  # 10 секунд (очень долго)


Рекомендации:
- Короткие сообщения: 40-60 тиков
- Стандартные: 60-80 тиков
- Длинные сообщения: 80-120 тиков

---

### Параметр: welcome.title.fade-out

Тип: Integer (целое число)
По умолчанию: 20
Единицы: Тики (20 тиков = 1 секунда)
Описание: Время, за которое title плавно исчезает с экрана.

Диапазон: 0 - 200 (рекомендуется 10-30)

Примеры:
yaml

fade-out: 0    # Мгновенное исчезновение

fade-out: 20   # 1 секунда (стандарт)

fade-out: 40   # 2 секунды

fade-out: 60   # 3 секунды (медленно)


---

### Параметр: welcome.messages

Тип: List (список строк)
По умолчанию: См. config.yml
Описание: Список сообщений, которые будут отправлены в чат игроку при входе.

Поддержка:
- ✅ Неограниченное количество строк
- ✅ HEX и RGB цвета
- ✅ Плейсхолдеры
- ✅ Пустые строки для отступов

Примеры:
yaml

# Простое приветствие

messages:

  - "&aПривет, %player%!"



# Множество строк

messages:

  - ""

  - "&6=============="

  - "&eДобро пожаловать!"

  - "&6=============="

  - ""



# С HEX цветами

messages:

  - "&#FF5733Привет, %player%!"

  - "&#00FF00Добро пожаловать на сервер!"



# Пустой список (без сообщений в чате)

messages: []


Специальные символы:
- Используйте "" для пустой строки (отступ)
- Максимальная длина строки: 256 символов
- Поддержка Unicode символов и эмодзи

---

## Система цветов

WelcomePlugin поддерживает три системы цветов, которые можно комбинировать.

### 1. Стандартные коды Minecraft

Используйте символ & с кодом цвета или форматирования.

#### Таблица цветов:

| Код | Цвет | Пример | Результат |
|-----|------|--------|-----------|
| &0 | Черный | &0Текст | Текст |
| &1 | Темно-синий | &1Текст | Текст |
| &2 | Темно-зеленый | &2Текст | Текст |
| &3 | Темно-голубой | &3Текст | Текст |
| &4 | Темно-красный | &4Текст | Текст |
| &5 | Темно-фиолетовый | &5Текст | Текст |
| &6 | Золотой | &6Текст | Текст |
| &7 | Серый | &7Текст | Текст |
| &8 | Темно-серый | &8Текст | Текст |
| &9 | Синий | &9Текст | Текст |
| &a | Зеленый | &aТекст | Текст |
| &b | Голубой | &bТекст | Текст |
| &c | Красный | &cТекст | Текст |
| &d | Розовый | &dТекст | Текст |
| &e | Желтый | &eТекст | Текст |
| &f | Белый | &fТекст | Текст |

#### Коды форматирования:

| Код | Эффект | Пример | Результат |
|-----|--------|--------|-----------|
| &l | Жирный | &lТекст | Текст |
| &o | Курсив | &oТекст | Текст |
| &n | Подчеркнутый | &nТекст | Текст |
| &m | ~~Зачеркнутый~~ | &mТекст | ~~Текст~~ |
| &k | Обфусцированный | &kТекст | §kТекст |
| &r | Сброс форматирования | &r | - |

Комбинирование:
yaml

"&a&lЖирный зеленый"

"&c&oКрасный курсив"

"&e&nЖелтый подчеркнутый"


---

### 2. HEX цвета (16+ миллионов цветов)

Формат: &#RRGGBB

Где:
- RR - красный (00-FF)
- GG - зеленый (00-FF)
- BB - синий (00-FF)

Примеры:
yaml

"&#FF0000Красный"          # Чистый красный

"&#00FF00Зеленый"          # Чистый зеленый

"&#0000FFСиний"            # Чистый синий

"&#FFD700Золотой"          # Золотой

"&#FF1493Розовый"          # Deep Pink

"&#00CED1Бирюзовый"        # Dark Turquoise

"&#FF4500Оранжево-красный" # Orange Red


Генераторы HEX цветов:
- https://www.color-hex.com/
- https://htmlcolorcodes.com/
- https://colorpicker.me/

С форматированием:
yaml

"&#FF0000&lЖирный красный"

"&#00FF00&oЗеленый курсив"


---

### 3. RGB цвета

Формат: &rgb(R,G,B)

Где:
- R - красный (0-255)
- G - зеленый (0-255)
- B - синий (0-255)

Примеры:
yaml

"&rgb(255,0,0)Красный"       # Чистый красный

"&rgb(0,255,0)Зеленый"       # Чистый зеленый

"&rgb(0,0,255)Синий"         # Чистый синий

"&rgb(255,215,0)Золотой"     # Золотой

"&rgb(255,20,147)Розовый"    # Deep Pink

"&rgb(100,200,255)Голубой"   # Светло-голубой


Преимущества RGB:
- Интуитивно понятные значения
- Легче запоминать популярные цвета
- Прямая конвертация из RGB редакторов

Конвертация HEX ↔ RGB:
- &#FF0000 = &rgb(255,0,0)
- &#00FF00 = &rgb(0,255,0)
- &#FFD700 = &rgb(255,215,0)

---

### Градиенты и эффекты

#### Создание градиента вручную:

yaml

# От красного к желтому (5 шагов)

"&#FF0000A &#FF3300B &#FF6600C &#FF9900D &#FFCC00E &#FFFF00F"


#### Радужный текст:

yaml

"&#FF0000R&#FF7F00A&#FFFF00I&#00FF00N&#0000FFB&#4B0082O&#9400D3W"


#### Пример градиента в приветствии:

yaml

messages:

  - "&#FF0000→ &#FF3300→ &#FF6600→ &#FF9900→ &#FFCC00→ &#FFFF00Добро пожаловать!"


---

## Плейсхолдеры

Плейсхолдеры - это специальные переменные, которые автоматически заменяются на информацию об игроке.

### Доступные плейсхолдеры:

| Плейсхолдер | Описание | Пример замены |
|-------------|----------|---------------|
| %player% | Имя игрока | Steve |
| %displayname% | Отображаемое имя игрока | [VIP] Steve |
| %world% | Название мира | world |

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

yaml

# В title

title:

  text: "Привет, %player%!"

  subtitle: "Мир: %world%"



# В сообщениях

messages:

  - "Добро пожаловать, %player%!"

  - "Вы находитесь в мире %world%"

  - "Ваше имя: %displayname%"


### Комбинирование с цветами:

yaml

messages:

  - "&#FFD700Привет, &#00FF00%player%&#FFD700!"

  - "&eВы в мире: &a%world%"

  - "&bИмя: &f%displayname%"


### Примечания:

- Плейсхолдеры регистрозависимые (используйте точное написание)
- Работают в title, subtitle и messages
- Заменяются перед применением цветов

---

## Title система

Title - это большой текст, который появляется в центре экрана игрока.

### Анатомия Title:

┌─────────────────────────────┐

│                             │

│      TITLE TEXT HERE        │  ← Основной title

│     subtitle here           │  ← Subtitle (подзаголовок)

│                             │

└─────────────────────────────┘


### Временная шкала:

Time:    [0s]  [0.5s]  [4s]  [5s]

         │      │       │     │

         │      │       │     └─ Полностью исчез

         │      │       └─────── Начинает исчезать

         │      └─────────────── Полностью виден

         └────────────────────── Начинает появляться

         

         ├─────┤ fade-in (10 тиков)

                ├──────┤ stay (70 тиков)

                       ├────┤ fade-out (20 тиков)


### Расчет общего времени показа:

Формула: Общее время = (fade-in + stay + fade-out) ÷ 20 секунд

Примеры:
- 10 + 70 + 20 = 100 тиков = 5 секунд
- 20 + 100 + 20 = 140 тиков = 7 секунд
- 5 + 40 + 5 = 50 тиков = 2.5 секунды

### Рекомендуемые настройки:

#### Быстрое приветствие (2-3 сек):
yaml

fade-in: 5

stay: 40

fade-out: 5


#### Стандартное (4-5 сек):
yaml

fade-in: 10

stay: 70

fade-out: 20


#### Драматичное (7-10 сек):
yaml

fade-in: 20

stay: 120

fade-out: 30


### Отключение Title:

Если вам нужны только сообщения в чате:
yaml

title:

  enabled: false  # Title не показывается


---

## Примеры конфигураций

### 1. Минималистичное приветствие

yaml

welcome:

  enabled: true

  

  title:

    enabled: true

    text: "&aПривет!"

    subtitle: "%player%"

    fade-in: 5

    stay: 40

    fade-out: 5

  

  messages:

    - "&aПривет, %player%! Добро пожаловать!"


### 2. Профессиональное приветствие

yaml

welcome:

  enabled: true

  

  title:

    enabled: true

    text: "&#FFD700&l✦ СЕРВЕР ✦"

    subtitle: "&7Добро пожаловать, &#00FF00%player%"

    fade-in: 10

    stay: 70

    fade-out: 20

  

  messages:

    - ""

    - "  &#FFD700&l━━━━━━━━━━━━━━━━━━━━━━━━━"

    - ""

    - "      &#00FF00&lДобро пожаловать на сервер!"

    - ""

    - "      &7Игрок: &#FFD700%player%"

    - "      &7Мир: &#FFD700%world%"

    - ""

    - "  &#FFD700&l━━━━━━━━━━━━━━━━━━━━━━━━━"

    - ""


### 3. RPG стиль

yaml

welcome:

  enabled: true

  

  title:

    enabled: true

    text: "&#8B4513&l⚔ КОРОЛЕВСТВО ⚔"

    subtitle: "&rgb(218,165,32)Искатель приключений %player%"

    fade-in: 15

    stay: 80

    fade-out: 15

  

  messages:

    - ""

    - "  &#8B4513&l╔════════════════════════╗"

    - "  &#8B4513&l║  &6⚔ ВРАТА КОРОЛЕВСТВА ⚔  &8&l║"

    - "  &#8B4513&l╚════════════════════════╝"

    - ""

    - "    &7Приветствуем вас, &6%player%&7!"

    - "    &7Вы вступили в мир &e%world%"

    - ""

    - "    &aДоступные команды:"

    - "    &7• &e/spawn &7- Вернуться на спавн"

    - "    &7• &e/help &7- Список команд"

    - ""


### 4. Современный / Hi-Tech

yaml

welcome:

  enabled: true

  

  title:

    enabled: true

    text: "&#00FFFF&l▶ CYBER SERVER ◀"

    subtitle: "&rgb(0,255,255)&oПодключение... &f%player%"

    fade-in: 10

    stay: 60

    fade-out: 10

  

  messages:

    - ""

    - "  &#00FFFF&l▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰"

    - ""

    - "    &#00FFFF&l► &fCYBER SERVER &l◄"

    - ""

    - "    &#00FFFF[&f✓&00FFFF] &7Пользователь: &f%player%"

    - "    &#00FFFF[&f✓&00FFFF] &7Локация: &f%world%"

    - "    &#00FFFF[&f✓&00FFFF] &7Статус: &aОнлайн"

    - ""

    - "  &#00FFFF&l▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰"

    - ""


### 5. Праздничное приветствие

yaml

welcome:

  enabled: true

  

  title:

    enabled: true

    text: "&#FF0000🎄 &#FFFF00С &#00FF00Новым &#0000FFГодом! &#FF00FF🎄"

    subtitle: "&rgb(255,215,0)%player%, счастливых праздников!"

    fade-in: 20

    stay: 100

    fade-out: 20

  

  messages:

    - ""

    - "  &#FF0000❄ &#FFFF00❄ &#00FF00❄ &#0000FF❄ &#FF00FF❄ &#FF0000❄ &#FFFF00❄ &#00FF00❄"

    - ""

    - "    &#FFD700&lС НОВЫМ ГОДОМ, %player%!"

    - ""

    - "    &#FF0000🎁 &7Зимние подарки ждут вас!"

    - "    &#00FF00🎄 &7Праздничные события активны!"

    - ""

    - "  &#FF0000❄ &#FFFF00❄ &#00FF00❄ &#0000FF❄ &#FF00FF❄ &#FF0000❄ &#FFFF00❄ &#00FF00❄"

    - ""


### 6. Без Title (только чат)

yaml

welcome:

  enabled: true

  

  title:

    enabled: false  # Title отключен

  

  messages:

    - ""

    - "&6&m                                                  "

    - ""

    - "  &e&lДобро пожаловать на сервер, &6%player%&e&l!"

    - ""

    - "  &7Наш дискорд: &bdiscord.gg/example"

    - "  &7Сайт: &bexample.com"

    - ""

    - "&6&m                                                  "

    - ""


---

## Часто задаваемые вопросы

### Q: Плагин не работает после установки. Что делать?

A: Проверьте следующее:
1. Версия сервера 1.16.5 или выше
2. Используете Spigot/Paper (не Vanilla)
3. Проверьте логи на ошибки: logs/latest.log
4. Убедитесь что плагин зеленый в /plugins

### Q: HEX цвета не работают, показывается обычный текст

A: HEX цвета поддерживаются только в Minecraft 1.16+. Убедитесь что:
1. Версия сервера 1.16 или выше
2. Версия клиента игрока 1.16 или выше
3. Формат HEX правильный: &#RRGGBB

### Q: Как сделать чтобы Title не показывался, только сообщения?

A: Установите title.enabled: false:
yaml

title:

  enabled: false


### Q: Можно ли отключить сообщения в чате, оставив только Title?

A: Да, используйте пустой список:
yaml

messages: []


### Q: Как сделать градиент?

A: Создайте градиент вручную, меняя HEX коды постепенно:
yaml

"&#FF0000A&#FF3300B&#FF6600C&#FF9900D&#FFCC00E"


Или используйте онлайн генераторы градиентов для Minecraft.

### Q: Плейсхолдеры не заменяются

A: Убедитесь что:
1. Написание точное: %player% (не %Player%)
2. Символ процента двойной с обеих сторон
3. Нет опечаток

### Q: Как изменить время показа Title?

A: Настройте параметры в тиках (20 тиков = 1 секунда):
yaml

fade-in: 10   # Время появления

stay: 70      # Время показа

fade-out: 20  # Время исчезновения


### Q: Можно ли использовать emoji/Unicode символы?

A: Да! Большинство Unicode символов поддерживаются:
yaml

"✦ ★ ⚔ ⚡ ❄ 🎄 🎁 ✓ ► ◄ ▰"


### Q: Как применить изменения без перезапуска?

A: Используйте команду /reload, но учтите что это может вызвать проблемы с другими плагинами. Рекомендуется полный перезапуск.

### Q: Приветствие показывается всем игрокам или только новым?

A: Всем игрокам при каждом входе на сервер (пока enabled: true).

### Q: Можно ли сделать разные приветствия для разных игроков?

A: Текущая версия плагина не поддерживает эту функцию. Используйте плейсхолдеры для персонализации.

### Q: Как отключить плагин временно?

A: Установите enabled: false или удалите jar файл из папки plugins.

---

## Устранение неполадок

### Проблема: Плагин не загружается

Симптомы:
- Красный цвет в /plugins
- Ошибка в логах при запуске

Решение:
1. Проверьте версию Java (нужна 8+)
2. Проверьте версию сервера (нужна 1.16.5+)
3. Посмотрите логи: logs/latest.log
4. Пересоздайте config.yml

### Проблема: Ошибка в config.yml

Симптомы:
- Плагин не работает
- В логах ошибка парсинга YAML

Решение:
1. Проверьте синтаксис YAML (отступы, двоеточия)
2. Используйте YAML валидатор: https://www.yamllint.com/
3. Удалите config.yml и перезапустите сервер для создания нового

### Проблема: Title показывается некорректно

Возможные причины:
- Слишком длинный текст
- Неправильный формат HEX

Решение:
- Сократите текст title
- Проверьте формат: &#RRGGBB (6 символов HEX)
- Проверьте что клиент 1.16+

### Проблема: Сообщения дублируются

Причина: Возможно плагин установлен дважды

Решение:
- Проверьте папку plugins на дубликаты
- Удалите старые версии

### Проблема: Высокая нагрузка на сервер

Причина: Обычно плагин очень легковесный, но если много сложных цветов...

Решение:
- Упростите конфигурацию
- Уменьшите количество строк
- Используйте меньше HEX цветов

---

## Советы и трюки

### 1. Генерация цветовых палитр

Используйте онлайн инструменты:
- Coolors.co - генерация палитр
- Color Hunt - готовые палитры
- Adobe Color - профессиональный подбор

### 2. Тестирование конфигурации

Создайте тестовый мир для проверки настроек без влияния на игроков.

### 3. Backup конфигурации

Всегда делайте копию config.yml перед изменениями:
bash

cp config.yml config.yml.backup


### 4. Использование переменных

Создайте "шаблоны" с переменными для быстрого изменения:
yaml

# Цвет темы

# Основной: &#FFD700

# Акцент: &#00FF00


### 5. Комбинирование эффектов

yaml

"&#FF0000&l&oЖирный красный курсив"

"&#00FF00&n&lПодчеркнутый жирный зеленый"


### 6. ASCII Art

Создавайте ASCII арт в сообщениях:
yaml

messages:

  - "  &6  /\\"

  - "  &6 /  \\"

  - "  &6/____\\"

  - "  &6|    |"

  - "  &7Дом"


### 7. Сезонные темы

Создайте несколько config файлов для разных сезонов и переключайте их.

### 8. Минимализм

Иногда простое приветствие лучше сложного:
yaml

title:

  text: "&aПривет!"

  subtitle: "%player%"


---

## Техническая информация

### Архитектура плагина

WelcomePlugin/

├── WelcomePlugin.java    # Главный класс

├── JoinListener.java     # Обработчик входа

└── ColorUtils.java       # Обработка цветов


### Обработка цветов

Порядок обработки:
1. Стандартные коды (&a, &l)
2. HEX коды (&#RRGGBB)
3. RGB коды (&rgb(R,G,B))

### Производительность

- CPU: < 0.001% на обработку приветствия
- RAM: ~1 MB
- Нагрузка: Минимальная (только при входе игрока)

### Зависимости

Обязательные:
- Spigot API 1.16.5+

Опциональные:
- Нет

### Совместимость с другими плагинами

✅ Совместим:
- EssentialsX
- WorldGuard
- LuckPerms
- Vault
- PlaceholderAPI (плейсхолдеры не поддерживаются напрямую)

❌ Возможны конфликты:
- Другие плагины приветствия (отключите один)

---

## Поддержка и контакты

Автор: animesao

По вопросам:
1. Проверьте FAQ и Устранение неполадок
2. Посмотрите примеры конфигураций
3. Проверьте логи сервера

Полезные ссылки:
- Spigot документация: https://www.spigotmc.org/wiki/
- Minecraft цвета: https://minecraft.fandom.com/wiki/Formatting_codes
- YAML валидатор: https://www.yamllint.com/

---

Версия плагина: 1.0.0

Спасибо за использование WelcomePlugin! 🎮