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
{
// ...
// 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!
{
// ...
"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.
{
// ...
"presence": {
// True if the presences should be randomly selected
"random": true,
}
}Presence Entries
A list of presences to be conveyed throughout the lifecycle of the bot.
{
// ...
"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.
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",Last updated
Was this helpful?