Bot Presences

Bot presences that are relayed periodically

A bot presence allows you to show a more detailed online status. Mix that with a timer, and you have a periodically updating bot status!

Examples

Playing / Default

Watching

Listening

Streaming

Example #1

config/chatter/discord/theme.json5

{
	// ...

	// Bot presences relayed periodically
	"presence": {
		// The number of seconds between presence updates (must be >=15)
		"interval": 60,
		// True if the presences should be randomly selected
		"random": false,
		// Presences
		"entries": [
			{
				// The type of presence (see https://git.io/Jqkez)
				"type": "DEFAULT",
				// The text value that is put on display
				"value": "Minecraft",
				// If defined, sets the URL of the underlying media, e.g. Twitch stream
				"url": null
			},
			{
				// The type of presence (see https://git.io/Jqkez)
				"type": "STREAMING",
				// The text value that is put on display
				"value": "Xisumavoid",
				// If defined, sets the URL of the underlying media, e.g. Twitch stream
				"url": "https://www.twitch.tv/xisumavoid"
			},
			{
				// The type of presence (see https://git.io/Jqkez)
				"type": "LISTENING",
				// The text value that is put on display
				"value": "${tps} TPS",
				// If defined, sets the URL of the underlying media, e.g. Twitch stream
				"url": null
			},
			{
				// The type of presence (see https://git.io/Jqkez)
				"type": "WATCHING",
				// The text value that is put on display
				"value": "${player_count} player",
				// If defined, sets the URL of the underlying media, e.g. Twitch stream
				"url": null
			}
		]
	},

	// ...
}

Configuration

Made changes to the configuration? Type /reload to apply the changes immediately!

Update Interval

The number of seconds between presence updates.

A presence update interval shorter than 15 seconds will lead to rate limits!

config/chatter/discord/theme.json5

{
	// ...
	"presence": {
		// The number of seconds between presence updates (must be >=15)
		"interval": 30,
	}
}

Choose Randomly

By default, the presence entries are chosen on a round-robin basis, however, this can be changed to a random selection here.

Random

config/chatter/discord/theme.json5

{
	// ...
	"presence": {
		// True if the presences should be randomly selected
		"random": true,
	}
}

In-Order

Presence Entries

A list of presences to be conveyed throughout the lifecycle of the bot.

config/chatter/discord/theme.json5

{
	// ...
	"presence": {
		// Presences
		"entries": [
			// Add presence entries here
		]
	}
	// ...
}

Type

The type of presence status to be shown.

You can choose from the following types: DEFAULT, STREAMING, LISTENING, and WATCHING.

// The type of presence (see https://git.io/Jqkez)
"type": "DEFAULT",

Value

The text value that is put on display.

Please refer to the templating guide for instructions on substituting player names, etc.

Token	Type	Meaning	Example
${version}	String	The Minecraft server version	1.16.5
${ip}	String	The server's IP address (possibly empty)	192.168.1.90
${port}	Integer	The bound server's port	25565
${motd}	String	The message of the day (MOTD)	A Minecraft Server
${difficulty}	String	The world difficulty	easy
${max_players}	Integer	The maximum number of players allowed	20
${player_count}	Integer	The number of currently logged-in players	2
${tps}	Double	Average ticks per second (TPS)	20.00
${tps_time}	Double	Average ticks per second (TPS) timing in ms	12.513
${uptime[:format]}	Duration	For how long the server has been online	1 day 5 minutes
${datetime[:format]}	DateTime	The current date & time	01/01/2004

/**
 * The text value that is put on display
 * Use ${version}, ${ip}, ${port}, ${motd}, ${difficulty}, ${max_players}, ${player_count}, ${tps}, ${tps_time}, ${uptime} and ${datetime[:format]}
 */
"value": "Minecraft ${version}",

Media URL

If defined, sets the URL of the underlying media, e.g. Twitch stream. This is used in conjunction with the STREAMING presence type.

// If defined, sets the URL of the underlying media, e.g. Twitch stream
"url": "https://www.twitch.tv/xisumavoid",