Просмотр кода страницы SCUM Настройка оповещений на сервере

== Оповещения на сервере SCUM (Notifications.json) на XLGAMES.GG ==

'''Что это?''' SCUM поддерживает плановые сообщения для игроков через файл '''Notifications.json''' — удобно для предупреждений о перезапусках, напоминаний и т. п.

'''Важно про время:''' на стендах XLGAMES.GG используется время '''UTC'''. Локальное время нужно предварительно перевести в UTC.
Например, если вам нужно показать уведомление в '''12:00''' по местному времени, а ваш часовой пояс сейчас '''UTC−4''', то в файле нужно указать '''16:00'''.

----

=== Где лежит файл ===
Путь на сервере:  
'''SCUM/SCUM/Saved/Config/WindowsServer/Notifications.json'''

Открыть/редактировать можно прямо в панели:
# Зайдите на вкладку '''Редактор конфигов'''.  
[[File:scum-open-config-editor.png|none|700px|Где открыть вкладку «Редактор конфигов»]]
# Найдите и откройте файл '''Notifications.json'''.  
[[File:scum-open-notifications-json.png|none|700px|Открытие файла Notifications.json]]

'''Перезапуск не требуется''' — изменения применяются сразу после сохранения.

----

=== Структура файла ===
Файл содержит список объектов внутри массива '''"Notifications"''':
<syntaxhighlight lang="json">
{
  "Notifications": [
    {
      "day": "Monday",
      "time": "7:00",
      "message": "Доброе утро выжившие!"
    }
  ]
}
</syntaxhighlight>

==== Доступные поля ====
* '''day''' — когда показывать сообщение. Допустимые значения:
** конкретный день: '''"Monday"''', '''"Tuesday"''' и т. п.
** диапазон: '''"Monday-Friday"'''
** спец-варианты: '''"Weekend"''', '''"Everyday"'''
* '''time''' — во сколько показывать:
** одно время: '''"7:00"'''
** несколько: '''["15:12", "11:14"]'''
** диапазон минут: '''"14:00-15:00"''' (повтор каждую минуту в окне)
* '''wait''' — интервал ('''в минутах''') между повторами внутри '''time'''-окна. Пример: '''"wait": "2"'''
* '''duration''' — длительность показа ('''в секундах'''). Пример: '''"duration": "10"'''
* '''color''' — цвет текста в формате '''R-G-B''' (0–255 через дефис). Пример: '''"255-0-0"''' — красный
* '''message''' — текст уведомления (поддерживает плейсхолдеры, см. ниже)

==== Плейсхолдеры в сообщении ====
* '''#NumPlayers''' — текущее число игроков онлайн  
* '''#Date''' — текущая дата сервера  
* '''#Time''' — текущее время сервера  

Отдельные специальные плейсхолдеры ('''используются в одиночку''', без дополнительного текста):
* '''#RestartIn(HH:MM)''' — показывает обратный отсчёт до указанного времени
* '''#RestartAt(HH:MM)''' — показывает уведомление о перезапуске в указанное время

----

=== Простой пример (проверка работы) ===
Покажем розовое сообщение по выходным в 11:17 на 5 секунд:
<syntaxhighlight lang="json">
{
  "Notifications": [
    {
      "day": "Weekend",
      "time": "11:17",
      "duration": "5",
      "color": "255-180-190",
      "message": "Приятной игры! Сервер активен."
    }
  ]
}
</syntaxhighlight>

----

=== Пример: регулярные предупреждения о перезапуске на официальных серверах ===
Логика: за 1 час, затем каждые 15 минут, последние 5 минут — каждую минуту:
<syntaxhighlight lang="json">
{
  "Notifications": [
    {
      "time": ["3:00", "3:15", "3:30", "3:45", "3:55-4:00"],
      "color": "255-180-50",
      "message": "#RestartIn(4:00)"
    },
    {
      "time": ["9:00", "9:15", "9:30", "9:45", "9:55-10:00"],
      "color": "255-180-50",
      "message": "#RestartIn(10:00)"
    },
    {
      "time": ["15:00", "15:15", "15:30", "15:45", "15:55-16:00"],
      "color": "255-180-50",
      "message": "#RestartIn(16:00)"
    },
    {
      "time": ["21:00", "21:15", "21:30", "21:45", "21:55-22:00"],
      "color": "255-180-50",
      "message": "#RestartIn(22:00)"
    }
  ]
}
</syntaxhighlight>

----

=== Полезные советы ===
* Всегда проверяйте корректность JSON (запятые, кавычки, массивы). Ошибка синтаксиса отключит весь блок уведомлений.
* Сначала протестируйте на одной записи, затем добавляйте остальное.
* Не забывайте переводить локальное время в '''UTC'''.
* Поле '''"color"''' строго в формате '''R-G-B''' через дефис (например, '''"255-255-255"''').

----

'''Нужен свой сервер SCUM?''' Закажите его на [https://xlgames.gg/ru/games/scum XLGAMES.GG].