TezerX-Restart (Russian Version)

Удобный и функциональный плагин для Spigot/Paper, позволяющий красиво и информативно перезагружать сервер. Поддерживает как ручную (техническую) перезагрузку, так и автоматическую по расписанию. Также включает продвинутый режим технических работ (Maintenance) с авто-киком, расписанием и кастомизацией сетевого статуса (красный крестик).

Все уведомления для игроков (чат, тайтлы, боссбары, звуки) гибко настраиваются отдельно для каждого типа перезагрузки.

---

🚀 Особенности

• Два режима работы: Техническая (ручная) перезагрузка и Автоматическая (по расписанию).
• Раздельная настройка: Вы можете настроить разные тексты, цвета боссбаров и звуки для ручного и автоматического рестарта.
• Поддержка кастомных звуков: Можно использовать как встроенные звуки Minecraft (например, BLOCK_NOTE_BLOCK_PLING), так и любые свои звуки из ресурспака (например, minecraft:my.custom.sound).
• Переключатели в реальном времени: Включайте и выключайте отображение чата, боссбара, звуков и тайтлов прямо в игре без перезагрузки конфига.
• Режим технических работ (Maintenance): Включайте режим закрытого сервера. Доступен белый список, авто-кик, гибкое расписание работы, кастомный MOTD с плейсхолдерами времени и отображение красного крестика вместо пинга.

---

⚙️ Команды

| Команда | Описание | Право (Permission) |
|---|---|---|
| /trestart start | Запустить таймер технической перезагрузки. | tezerxrestart.tech |
| /trestart stop | Остановить любой текущий таймер перезагрузки. | tezerxrestart.tech |
| /trestart enable <chat/bossbar/title/sound> | Включить отображение функции. | tezerxrestart.tech |
| /trestart disable <chat/bossbar/title/sound> | Выключить отображение функции. | tezerxrestart.tech |
| /trestart auto enable [время] | Включить систему авто-рестартов. Если указано время (например, 15:30), оно будет добавлено в конфиг. | tezerxrestart.auto |
| /trestart auto disable | Выключить систему авто-рестартов (они не сработают по расписанию). | tezerxrestart.auto |
| /trestart reload | Перезагрузить конфигурацию плагина. | tezerxrestart.reload |
| /trestart m или /trestart maint | Помощь по командам режима тех. работ. | tezerxrestart.maintenance.admin |
| /trestart m on | Включить режим тех. работ (все неподходящие игроки кикаются). | tezerxrestart.maintenance.admin |
| /trestart m off | Выключить режим тех. работ. | tezerxrestart.maintenance.admin |
| /trestart m add <игрок> | Добавить игрока в белый список тех. работ. | tezerxrestart.maintenance.admin |
| /trestart m remove <игрок> | Удалить игрока из белого списка тех. работ. | tezerxrestart.maintenance.admin |
| /trestart m list | Показать список игроков в белом списке тех. работ. | tezerxrestart.maintenance.admin |
| /trestart m clear | Очистить белый список тех. работ. | tezerxrestart.maintenance.admin |
| /trestart m schedule <HH:mm> <HH:mm> | Установить расписание тех. работ с автоматическим включением и выключением. | tezerxrestart.maintenance.admin |
| /trestart m schedule off | Выключить режим тех. работ по расписанию. | tezerxrestart.maintenance.admin |
| /trestart m cross <on/off> | Включить или выключить отображение красного крестика вместо пинга. | tezerxrestart.maintenance.admin |

---

🛠️ Режим технических работ (Maintenance)

Режим технических работ закрывает доступ к серверу для всех игроков, за исключением операторов (OP), игроков с правом обхода или игроков из белого списка.

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

• Авто-кик при активации: При включении режима все игроки, не имеющие права на вход, моментально кикаются с сервера с настраиваемым сообщением.
• Автоматическое расписание: Позволяет задать интервал проведения работ (например, 14:00 - 15:00). Плагин сам включит тех. работы и кикнет игроков на старте, а по окончании расписания выключит режим. Поддерживается перенос через полночь (например, с 23:00 до 01:00).
• Красный крестик в пинге: На Paper-серверах включает отображение ошибки версии (красный крестик вместо пинга) и заменяет количество игроков на кастомный текст (например, §cТех. работы).
• Динамический MOTD: Во время тех. работ отображается специальный MOTD. Если включена опция show-schedule, плейсхолдеры %start% и %end% заменяются временем начала и конца работ из расписания.

Права (Permissions):

• tezerxrestart.maintenance.admin — Доступ к управлению режимом тех. работ (команды /trestart m).
• tezerxrestart.maintenance.bypass — Возможность заходить на сервер во время активного режима тех. работ.

---

🕒 Как работает авто-перезагрузка

В config.yml в блоке auto-restart.times вы указываете точное время, когда сервер должен уйти на перезагрузку (по системному времени машины, на которой стоит сервер).

Пример:
Если вы указали время 12:00, а countdown-time (время отсчета) равно 300 секундам (5 минут), то плагин автоматически запустит таймер и начнет уведомлять игроков в 11:55. Ровно в 12:00 сервер выполнит команду restart.

---

📝 Пример конфигурации (config.yml)

# Язык сообщений плагина (ru или en)
lang: ru

# Глобальные переключатели (управляются также через /trestart enable/disable)
features:
  chat: true
  bossbar: true
  title: true
  sound: true

# Настройки технической (ручной) перезагрузки
tech-restart:
  countdown-time: 300
  title-start-time: 30
  title-interval: 10
  title-sound: BLOCK_NOTE_BLOCK_PLING # Можно использовать свои звуки из ресурспака!
  attention-title: "&c&lВНИМАНИЕ!"
  main-title: "&fСервер перезагружается через: &e%time% сек"
  bossbar-text: "&cДо перезагрузки: &e%time% сек"
  bossbar-color: "RED"
  chat-message: "&c[ВНИМАНИЕ] &fСервер перезагружается через: &e%time% сек"
  chat-start-time: 30
  chat-interval: 60

# Настройки авто-перезагрузки
auto-restart:
  times:
    - "04:00"
    - "12:00"
  countdown-time: 300
  # ... (остальные настройки аналогичны блоку tech-restart)

# Режим технических работ
maintenance:
  enabled: false
  kick-message: "&cНа сервере ведутся технические работы!\n&fЗаходите позже."
  motd:
    line1: "&c&lTezerX &7| &cТехнические работы"
    line2: "&eРаботы пройдут с %start% до %end%!"
    show-schedule: true
    show-cross: true
    version-text: "&cТех. работы"
  whitelist: []
  schedule:
    enabled: false
    start: "14:00"
    end: "15:00"

---

🔊 Использование кастомных звуков

Чтобы использовать свой звук из ресурспака:

1. Загрузите ресурспак на сервер или клиент.
2. В конфиге плагина (config.yml) вместо названия встроенного звука напишите ключ вашего звука.
   Например: title-sound: "custom.warn"
3. Введите /trestart reload. Плагин автоматически поймет, что это кастомная строка, а не стандартный звук!

📦 Как создать Ресурспак (Resource Pack) для своего звука:

Создайте папку (например, CustomRestartSounds) со следующей структурой:

CustomRestartSounds/
├── pack.mcmeta
└── assets/
    └── minecraft/
        ├── sounds.json
        └── sounds/
            └── custom
                └── warn.ogg

1. Файл pack.mcmeta

Содержит метаданные вашего ресурспака. Создайте текстовый файл с этим именем и вставьте:

{
  "pack": {
    "pack_format": 6,
    "description": "Custom sounds for TezerX-Restart"
  }
}

(Примечание: pack_format зависит от версии вашей игры, например, 6 подходит для 1.16.2–1.16.5).

2. Файл sounds.json

Этот файл регистрирует ваш звук в игре. Создайте его в папке assets/minecraft/ со следующим содержимым:

{
  "custom.warn": {
    "category": "record",
    "sounds": [
      {
        "name": "custom/warn",
        "stream": true
      }
    ]
  }
}

В данном случае:

• "custom.warn" — это ключ (ID) звука, который вы будете прописывать в config.yml.
• "custom/warn" — путь к вашему аудиофайлу относительно папки assets/minecraft/sounds/ (расширение .ogg указывать не нужно).

3. Аудиофайл .ogg

• Конвертируйте ваш звук (например, из .mp3 или .wav) в формат .ogg (канал Mono, частота 44100Hz).
• Переименуйте его в warn.ogg и положите в папку assets/minecraft/sounds/.

4. Установка

Запакуйте файлы и папки (папку assets и файл pack.mcmeta) в .zip архив и поместите в папку resourcepacks в клиенте Minecraft (или настройте как серверный ресурспак).

---

TezerX-Restart (English Version)

A convenient and feature-rich Spigot/Paper plugin designed for stylish and informative server reboots. It supports both manual (technical) restarts and scheduled automatic restarts. It also includes an advanced maintenance mode (Maintenance) featuring auto-kick, schedule planning, custom MOTD, and version spoofing (red incompatible version cross).

All player notifications (chat messages, titles, bossbars, sounds) are highly configurable and can be customized separately for each type of restart.

---

🚀 Features

• Two Work Modes: Technical (manual) restarts and Automatic (scheduled) restarts.
• Separate Configurations: Configure different messages, bossbar colors, and sounds for manual and auto restarts.
• Custom Sound Support: Use built-in Minecraft sounds (e.g., BLOCK_NOTE_BLOCK_PLING) or your own resource pack sounds (e.g., minecraft:my.custom.sound).
• Real-Time Toggles: Enable/disable features like chat notifications, bossbars, sounds, and titles directly in-game without reloading the config.
• Maintenance Mode: Close server access to non-whitelisted/non-admin players. Features include a whitelist, auto-kick on activation, schedule intervals, custom maintenance MOTD, and a red cross version spoof status.

---

⚙️ Commands

| Command | Description | Permission |
|---|---|---|
| /trestart start | Start a technical (manual) restart countdown. | tezerxrestart.tech |
| /trestart stop | Stop any running restart countdown timer. | tezerxrestart.tech |
| /trestart enable <chat/bossbar/title/sound> | Enable a notification feature. | tezerxrestart.tech |
| /trestart disable <chat/bossbar/title/sound> | Disable a notification feature. | tezerxrestart.tech |
| /trestart auto enable [time] | Enable scheduled auto-restarts. If time is provided (e.g. 15:30), it is added to the config. | tezerxrestart.auto |
| /trestart auto disable | Disable the auto-restart system (scheduled restarts will not fire). | tezerxrestart.auto |
| /trestart reload | Reload the plugin configuration. | tezerxrestart.reload |
| /trestart m or /trestart maint | Show help commands for maintenance mode. | tezerxrestart.maintenance.admin |
| /trestart m on | Enable maintenance mode (kicks all players without join bypass). | tezerxrestart.maintenance.admin |
| /trestart m off | Disable maintenance mode. | tezerxrestart.maintenance.admin |
| /trestart m add <player> | Add a player to the maintenance whitelist. | tezerxrestart.maintenance.admin |
| /trestart m remove <player> | Remove a player from the maintenance whitelist. | tezerxrestart.maintenance.admin |
| /trestart m list | Show all players currently on the maintenance whitelist. | tezerxrestart.maintenance.admin |
| /trestart m clear | Clear the maintenance whitelist. | tezerxrestart.maintenance.admin |
| /trestart m schedule <HH:mm> <HH:mm> | Schedule maintenance with automatic activation and deactivation. | tezerxrestart.maintenance.admin |
| /trestart m schedule off | Disable scheduled maintenance checks. | tezerxrestart.maintenance.admin |
| /trestart m cross <on/off> | Enable or disable the red cross version spoof in server ping. | tezerxrestart.maintenance.admin |

---

🛠️ Maintenance Mode

Maintenance mode closes server access to everyone except operators (OPs), players with the bypass permission, or whitelisted maintenance players.

Core Functions:

• Auto-Kick on Activation: When maintenance mode is turned on, all players currently online who do not have bypass permission are kicked with the configured message.
• Automatic Scheduler: Set a time interval for maintenance (e.g., 14:00 - 15:00). The plugin will enable maintenance on start and disable it when the end time is reached. Supports midnight-crossing schedules (e.g. 23:00 - 01:00).
• Connection Red Cross Status: On Paper servers, spoof the server protocol version to -1 (shows a red cross instead of player connection bars) and display custom version text next to the cross (e.g., §cMaintenance).
• Dynamic MOTD: Displays a specific MOTD when maintenance is active. If show-schedule is true, the %start% and %end% placeholders in the MOTD lines will be replaced with scheduled times.

Permissions:

• tezerxrestart.maintenance.admin — Access to manage maintenance mode (commands under /trestart m).
• tezerxrestart.maintenance.bypass — Bypass maintenance mode to join the server.

---

🕒 How Auto-Restart Works

In the config.yml under auto-restart.times, specify the exact execution time for reboots (using the server machine's local system time).

Example:
If you set the restart time to 12:00 and the countdown-time to 300 seconds (5 minutes), the plugin will automatically initiate the countdown and start notifying players at 11:55. At exactly 12:00, the server runs the restart command.

---

📝 Example Configuration (config.yml)

# Language of plugin messages (ru or en)
lang: en

# Global feature toggles (also toggled via /trestart enable/disable)
features:
  chat: true
  bossbar: true
  title: true
  sound: true

# Technical (manual) restart settings
tech-restart:
  countdown-time: 300
  title-start-time: 30
  title-interval: 10
  title-sound: BLOCK_NOTE_BLOCK_PLING # Custom resource pack sounds can be defined here!
  attention-title: "&c&lATTENTION!"
  main-title: "&fServer is restarting in: &e%time% sec"
  bossbar-text: "&cRestarting in: &e%time% sec"
  bossbar-color: "RED"
  chat-message: "&c[ATTENTION] &fServer is restarting in: &e%time% sec"
  chat-start-time: 30
  chat-interval: 60

# Auto-restart settings
auto-restart:
  times:
    - "04:00"
    - "12:00"
  countdown-time: 300
  # ... (other options are identical to tech-restart)

# Maintenance mode settings
maintenance:
  enabled: false
  kick-message: "&cServer is undergoing scheduled maintenance!\n&fPlease join later."
  motd:
    line1: "&c&lTezerX &7| &cMaintenance Mode"
    line2: "&eMaintenance scheduled: %start% - %end%!"
    show-schedule: true
    show-cross: true
    version-text: "&cMaintenance"
  whitelist: []
  schedule:
    enabled: false
    start: "14:00"
    end: "15:00"

---

🔊 Using Custom Resource Pack Sounds

To use a custom sound from your resource pack:

1. Load your resource pack onto the server or your client.
2. In the plugin's config.yml, write your sound key instead of a built-in sound name.
   Example: title-sound: "custom.warn"
3. Execute /trestart reload. The plugin will automatically detect it as a custom sound key!

📦 How to Create a Sound Resource Pack:

Create a folder (e.g. CustomRestartSounds) with the following directory structure:

CustomRestartSounds/
├── pack.mcmeta
└── assets/
    └── minecraft/
        ├── sounds.json
        └── sounds/
            └── custom/
                └── warn.ogg

1. The pack.mcmeta file

Contains resource pack metadata. Create a text file with this name and paste:

{
  "pack": {
    "pack_format": 6,
    "description": "Custom sounds for TezerX-Restart"
  }
}

(Note: pack_format depends on your Minecraft version; e.g. 6 is for 1.16.2–1.16.5).

2. The sounds.json file

This file registers your sound in-game. Create it inside assets/minecraft/ with the following content:

{
  "custom.warn": {
    "category": "record",
    "sounds": [
      {
        "name": "custom/warn",
        "stream": true
      }
    ]
  }
}

In this example:

• "custom.warn" — The sound key (ID) that you will write in your config.yml.
• "custom/warn" — Path to your audio file relative to assets/minecraft/sounds/ (exclude the .ogg extension here).

3. The .ogg audio file

• Convert your sound (e.g. from .mp3 or .wav) to .ogg format (Mono channel, 44100Hz frequency).
• Rename the file to warn.ogg and place it in the assets/minecraft/sounds/custom/ folder.

4. Installation

Compress the contents of the root folder CustomRestartSounds (the assets folder and pack.mcmeta file) into a .zip file, and place it in the resourcepacks directory of your Minecraft client (or upload it as a server resource pack).