05. Server Schedule

Automated server opening and closing hours, per day of the week, plus the welcome message and two optional schedule layers: Death Hours and HRP Hours.

Config file: rpessentials-schedule.toml.

Weekly schedule

Each day (MONDAY through SUNDAY) has its own block:

[Days.<DAY>]
enabled = true
open    = "19:00"
close   = "23:59"

A disabled day is treated as closed all day. Closing times support cross midnight ranges, for example open = 22:00, close = 02:00.

Option	Default	Description
enableSchedule	false	Master switch. When false the server is always open.
kickNonStaff	true	Kick non staff players when the server closes.
warningTimes	[30, 15, 5, 1]	Minutes before closing at which a warning is broadcast.

Commands: /calendar (aliases /schedule, /horaires) shows the full week with today highlighted. Staff only: /schedule forceopen, /schedule forceclose, /schedule resetforcestate, and /schedule whitelist add|remove|list to let specific players bypass closed hours entirely.

Welcome Message

This message is sent to the player when he join the world.

Option	Default	Description
enableWelcome	true	Master switch.
welcomeLines	multi line list	Supports {player} and {nickname}, and color codes.
welcomeSound	minecraft:ui.toast.challenge_complete	Sound played on login, "" disables it.
welcomeSoundVolume / welcomeSoundPitch	1.0	Sound parameters.

Death Hours

An optional schedule layer that force enables Death RP during specific time slots, independently of the manual global toggle.

Option	Default	Description
deathHoursEnabled	false	Master switch, disabled by default.
deathHoursSlots	["22:00-23:59"]	List of HH:MM-HH:MM ranges, cross midnight supported.

When active, all connected players receive a one time notification per slot start.

HRP Hours

An optional schedule layer for managing out of roleplay periods (HRP means out of roleplay in french, as I'm french, I kept that name).

Option	Default	Description
enableHrpHours	false	Master switch, disabled by default.
hrpToleratedSlots	["21:00-22:00"]	Slots where HRP is noted but not punished.
hrpAllowedSlots	["22:00-23:59"]	Slots where HRP is fully allowed.
hrpToleratedMessage / hrpAllowedMessage	see config	Broadcast once per slot start. Placeholders: {start}, {end}.
hrpMessageMode	CHAT	CHAT, ACTION_BAR, TITLE or IMMERSIVE.

Both Death Hours and HRP Hours are completely ignored when their master switch is false, with zero overhead.

Config commands

Most of the above can also be changed live with /rpessentials config set <option> <value>, see Commands.