Features
Network maintenance
Close the whole network with one command, allow only bypass holders and freeze the time of every temporary rank while you work.
The maintenance module is configured in maintenance.yml and needs Redis. The rank clock freeze needs the ranks module. Maintenance always applies to the whole network.
Turning it on
/maintenance on &cUpdating the network --bonus 2h
/maintenance status
/maintenance offon kicks connected players without sofycore.maintenance.bypass and blocks new joins, with a single write. Players without bypass are checked again every kick-check-seconds. With ops-bypass: true, operators can always join.
Freezing rank time
By default, on also freezes the rank clock: temporary ranks stop losing time during maintenance. Use --no-freeze for a short maintenance such as a restart.
- It costs one conditional write of the central rank record, whether there are 20 thousand or 2 million temporary ranks.
--bonus <duration>keeps the clock stopped for that much longer after reopening, as a gift.freeze-limit(7 days by default, up to 30,0for no limit) restarts the clock even if maintenance is still on.- Sanctions, cooldowns and authorizations keep using real time.
Join checks
The check runs at the start of the pre-login, before any other sofyCore work. If the database does not answer, players are let in; if ranks do not answer during an active maintenance, the join is refused (operators still join).