Home Server settings The files in the config folder Notifications.json

Notifications.json – server announcements

This file lets your server say something regularly – the next restart, your rules, the Discord link. Messages appear at fixed times and can contain placeholders such as the time until the next restart.

Verified for SCUM 1.3.3.4.149664 Checked fully

What the file is for

Notifications.json holds a list of announcements. Each one has a text, days, times, a display duration and a colour. At the given time the server shows the text to every player.

The most common use is warning about restarts. Being thrown out of the game mid-fight or halfway across the map is annoying, rightly so – an announcement five minutes ahead costs you nothing and saves complaints.

If the file is missing, the server creates an empty one: { "Notifications": [] }. That is not an error but the normal state of a fresh server.

Placeholders in the text

The server fills in five placeholders when displaying. They start with a hash and have to be written exactly like this:

So a restart announcement needs no fixed time in the text. Change the restart schedule and the message still holds. Write the placeholders exactly as shown – #restartin stays in as raw text.

Announcing in two languages

On a server with German and English players, both belong in the message. There is room: separate the languages with a slash and keep the sentence short.

"message": "Neustart in #RestartIn. / Restart in #RestartIn."

That beats two separate announcements at the same time – those would overlap each other.

Colours

The colour is three numbers from 0 to 255: red, green, blue, separated by hyphens. 255-180-50 is orange, 255-80-80 red, 120-200-255 light blue, 255-255-255 white.

A hex value like #FFB432 does not work, and neither do commas instead of hyphens. Get into the habit: red for warnings, orange for restarts, blue for anything friendly. Then people know what it is about before they read it.

What the server itself rejects

As with raid times, SCUM validates the file on start. Explicitly complained about are: a missing Notifications list, anything other than an object inside the list, and an entry without message.

Days, times and colours go through the same reader as the raid times – unknown day names, malformed times and malformed colours are caught there. That reader also understands a date in D.M.Y form; it does not appear in any example file. If you use it, check the server log once to see whether it was accepted.

How often is too often

One announcement every six hours before a restart is sensible. Four rule reminders an hour are not – they cover the game and get dismissed by everyone after two days.

Rule of thumb: announce restarts, point to Discord or the rules once a day, and handle everything else through the message of the day. That one lives in the ServerSettings.ini and is only shown on joining.

Every field at a glance

FieldDefaultRequiredWhat does this setting do?
messageThe textyesWhat appears on screen. The only mandatory field – an entry without message is explicitly complained about by the server. Placeholders are allowed in the text, see below.
dayOn which daysEverydaynoThe same notation as for raid times: a weekday, a range with a hyphen, a comma-separated list, or Everyday, Weekdays, Weekend.
timeAt which times["12:00"]noA list of times in square brackets, for example ["05:55", "11:55"]. Each time may be written 18:00 or just 18. The server's clock applies.
durationHow long it stays20noDisplay time in seconds. Twenty is a sensible value: long enough to read, short enough not to annoy.
colorColour255-180-50noRed, green and blue as three numbers from 0 to 255 separated by hyphens – 255-180-50 is a warm orange. Not a hex value and not comma-separated.

Placeholders in the text

#RestartIntime until the next restart
#RestartAttime of the next restart
#NumPlayersnumber of players on the server
#Datetoday's date (day/month/year)
#Timethe server's current time

What the file looks like

{
    "Notifications": [
        {
            "day": "Everyday",
            "time": ["05:55", "11:55", "17:55", "23:55"],
            "duration": "20",
            "color": "255-180-50",
            "message": "Server-Neustart in #RestartIn. / Server restart in #RestartIn."
        },
        {
            "day": "Weekend",
            "time": ["19:00"],
            "duration": "15",
            "color": "120-200-255",
            "message": "Gerade sind #NumPlayers Spieler online. Viel Erfolg!"
        }
    ]
}

Matching settings in the ServerSettings.ini

Have this file checked

Drag it into the configurator – on its own or with the whole folder. Checking happens in your browser, nothing is uploaded.

To the configurator →

← All config files