Features

Notices

Choose what the bot posts about your Minecraft servers on its own, in which channel, and who gets pinged.

Besides the chat, the bot posts notices about your Minecraft servers: start and stop, lost connections, low TPS, the weekly recap and more. The server has to be connected through chat sync for this. Every setting applies to all servers or to a single one.

Set up

In the dashboard, open "Notices & reports".
Under "Ping role", pick the role that gets mentioned by important notices.
Under "Channels", pick a channel for "Notices" and one for "Reports".
In the "Notices" table, click a cell to change a notice. "All servers" is on the left, each server has its own column to the right.

Run /notices ping-role role: @Staff.
Run /notices channel purpose: notices channel: #server-status.
Switch single notices with /notices set, for example /notices set notice: server-stop enabled: False.
Check what's on where with /notices show.

/notices needs the "Manage Server" permission. Each server's page in the dashboard also has a "Notices" and a "Channels" tab for that server alone.

Settings

Notices

Dashboard	`notice`	Default	Effect
Server started	`server-start`	on	The Minecraft server has started.
Server stopped	`server-stop`	on	The Minecraft server has shut down.
Connection	`connection`	on, with ping	The connection to the plugin has been silent for 20 minutes, is back, or never came up. Pings only when it's lost.
Low TPS	`tps`	off	TPS below the threshold (15 by default) for more than five minutes.
Delivery problem	`delivery`	on	A reply in the chat when a message from Discord doesn't reach the server. Never pings.
Console warnings	`console`	on	Warnings and errors from the server console. Only with a console channel, never pings.
Rank role blocked	`rank-role-blocked`	on, with ping	The bot can't assign a role from role sync because it's above the bot's own role.
Token leaked	`token-leaked`	always on	A token showed up publicly and was blocked. Can't be turned off.
Weekly recap	`weekly-recap`	on	A summary of the week, every Monday.

/notices set takes enabled, ping and, for tps, a threshold between 1 and 20:

/notices set notice: tps enabled: True threshold: 18 server: Survival

Channels

Dashboard	`purpose`	Contents	Without a channel
Events	`events`	Joins, leaves, deaths and advancements	Server's chat
Notices	`notices`	Start, stop, connection, TPS and the other notices	Server's chat
Reports	`reports`	The weekly recap	Server's chat
Console	`console`	Warnings and errors from the console	Not posted
Command log	`commands`	Every server command from Discord or the dashboard	Not posted

/notices channel purpose: console channel: #server-errors server: Survival

Run it without channel to fall back to the default for that purpose. One channel can serve several servers.

All servers or one

Without server, a setting is the default for all servers. With server: Survival, it applies to that server only. Whatever a server doesn't set itself, it inherits, field by field. reset: True removes a server's own setting again.

In the dashboard, inherited cells are dashed and marked "inherits". /notices show server: Survival marks what that server sets itself with ✏️. The ping role always applies to all servers.

To get notified yourself by email, webhook, push or direct message, see Watch servers.

Update notices

The plugin asks Modrinth whether there's a newer build for your server. If there is, it shows up:

in the server log, with a link to the download page,
in /mcsync status,
in the dashboard under "Connection & chat", with a "Download for this server" button.

Nothing is downloaded or installed. You replace the file yourself. To turn the check off in the plugin:

yaml

# Spigot, Paper, Folia: plugins/mc-sync/config.yml
update:
  mode: off

properties

# Fabric, Quilt, Forge, NeoForge: config/mc-sync.properties
update.mode=off

Problems

No notices arrive

The server has to be connected. Without a connection it reports neither start nor stop.
Check with /notices show server: Survival whether the notice is on and which channel it goes to.
The bot must be allowed to write in the channel ("View Channel" and "Send Messages").

The ping mentions nobody

Without a ping role, a ping mentions nobody. Set it with /notices ping-role role: @Staff. Only notices with ping turned on ping.

Console warnings don't show up

They need their own channel: /notices channel purpose: console channel: #server-errors. Without one, they aren't posted.

A change for all servers has no effect on one server

That server has its own setting for it. Remove it with reset: True, for example /notices set notice: server-stop reset: True server: Survival.

A short outage wasn't reported

A connection only counts as lost after 20 minutes without contact. The bot doesn't report shorter drops.