Configuration

config/cobbletasks.json is created with defaults on first run. It is read at startup and again on every /reload. A changed task count is applied to the current day or week too: extra tasks are dropped from the end, missing ones are drawn from the pool.

Key	Default	Description
timezone	"system"	Time zone that decides where day and week boundaries fall (e.g. Europe/Madrid).
daily_task_count	3	How many daily tasks are active at once (0 to 10).
weekly_task_count	3	How many weekly tasks are active at once (0 to 10).
daily_rerolls	1	How many daily tasks each player may swap per day (0 to 10, 0 turns it off).
weekly_rerolls	1	How many weekly tasks each player may swap per week (0 to 10).
automatic_events	"singleplayer"	Who starts events on a timer from the "period": "event" tasks: "singleplayer" (only in single-player worlds), "always", or "never" (admins only).
event_interval_minutes	45	Minutes of play, with someone online, between two automatic events (1 to 1440).
event_duration_minutes	30	How long an event lasts when its task has no duration (1 to 10080).
event_claim_days	7	Days players have to claim a finished event (1 to 90).
event_min_contribution	1	How much a player must contribute to share an event’s reward (1 to 1000).
progress_feedback	true	Sends the progress toast when a task’s progress moves. false turns it off for everyone.
daily_warning_minutes	30	Minutes before the day ends at which players with finished, unclaimed daily tasks are warned (0 to 1440, 0 turns it off).
weekly_warning_minutes	120	The same for weekly tasks (0 to 10080).
audit_log	true	Writes claims, rerolls, failed rewards and admin actions to logs/cobbletasks.
audit_log_retention_days	30	Days audit log files are kept (1 to 3650).
notifications	true	Chat messages and sounds for finished tasks, new rotations, events and unclaimed rewards on login. false turns both off for everyone.
notification_sounds	true	The sounds that go with those messages. false keeps the messages and silences the sounds for everyone.

Player settings

The task screen has three small switches next to the claim button: the progress toast, chat messages and sounds. They are saved in the player’s own config/cobbletasks-client.json and sent to the server when joining and whenever one changes, so the server does not send what a player turned off. A switch that is off in the server config stays off for everyone, whatever the player chose.

Key	Default	Description
progress_toasts	true	The progress toast when a task moves.
chat_messages	true	Chat messages for finished tasks, new tasks, events and reminders.
sounds	true	The sounds that go with those messages.