This file decides when raiding is allowed on your server. It only takes effect if the ServerSettings.ini selects global raid times as the protection type – otherwise the game reads it but nothing in it applies.
On a server with fixed raid times, other players' bases may only be attacked during certain windows. Those windows live in RaidTimes.json. Outside them, walls, doors and locks hold against any attack.
The idea: attacks become plannable. People with jobs know their base will not be taken apart at three in the morning. People who want to attack know when it is worth rounding up the squad. On servers without this rule, the group spread over the most time zones wins in the long run.
The file sits in the same folder as ServerSettings.ini. It holds a list of windows – each names days, times and two warning times.
This is the mistake that happens most often: the raid times are neatly in place, but scum.RaidProtectionType in the ServerSettings.ini is still 0 or 1. Then there is no protection, or only offline protection, and the windows do nothing.
Fixed raid times need scum.RaidProtectionType=3. The reverse also holds: with 3 set but no window in the file, raiding is never possible at all.
The day entry is where most people come unstuck, because it allows four different forms:
SCUM Easy Admin"day": "Thursday" – a single day."day": "Monday-Wednesday" – a range from Monday to Wednesday, both included."day": "Monday,Wednesday,Friday" – a list."day": "Everyday", "Weekdays" (Monday to Friday) or "Weekend" (Saturday and Sunday).Capitalisation matters. monday is not a day the server knows – it rejects the whole file.
The span is always start-end. Both may be written 18:00 or just 18; the minutes are optional. The end has to come after the start, otherwise the duration is zero and the server rejects the entry.
A single entry cannot cross midnight. A window from 22:00 to 02:00 has to be split in two: 22:00-24:00 on one day and 00:00-02:00 on the next.
What counts is the server's clock. On rented servers that is often UTC and therefore not your time. Check it once, before you wonder why the window opens two hours early.
Both announcement values are minutes. "30" means the server gives notice 30 minutes ahead. The messages only appear if they are not switched off in the ServerSettings.ini (scum.RaidProtectionGlobalShouldShowRaidAnnouncementMessage and scum.RaidProtectionGlobalShouldShowRaidStartEndMessages).
A warning longer than the window itself makes no sense – the announcement then falls into the previous window or into the middle of the night. Our check points that out.
SCUM validates the file on start and writes the result to the raid protection log. If validation fails, the entire file is not loaded – not just the faulty entry. In game you then get “Raid configuration failed to load”.
Rejected are, among others: a missing raiding-times list, an entry without day or time, an unknown day name, duplicate days, a malformed time span, a duration of zero, negative announcement times and overlapping windows. The number of entries is limited as well.
Our check mirrors exactly these cases. If it stays quiet, the server loads the file.
| Field | Default | Required | What does this setting do? |
|---|---|---|---|
dayDay or days | Weekdays | yes | Which days the window applies to. Allowed are a single weekday (Thursday), a range (Monday-Wednesday), a comma-separated list (Monday,Wednesday,Friday) and the three keywords Everyday, Weekdays and Weekend. The names are English and capitalised. |
timeTime span | 17:00-19:00 | yes | From when to when raiding is allowed, as start-end. A time may be written 17:00 or just 17. This is the server's clock, not in-game time and not your local time. |
start-announcement-timeWarning before the start | 30 | no | How many minutes before the window opens the server announces it. 0 means no warning. |
end-announcement-timeWarning before the end | 30 | no | How many minutes before the window closes the server announces it. Meant as a signal to withdraw. |
{
"raiding-times": [
{
"day": "Weekdays",
"time": "18:00-21:00",
"start-announcement-time": "30",
"end-announcement-time": "15"
},
{
"day": "Weekend",
"time": "14:00-22:00",
"start-announcement-time": "30",
"end-announcement-time": "30"
}
]
}Drag it into the configurator – on its own or with the whole folder. Checking happens in your browser, nothing is uploaded.
To the configurator →