Skip to content
Cyrusbye720 edited this page Jun 6, 2026 · 3 revisions

FAQ

How do I change the bot's activity text?

Edit bot.activity.text in config.yml. The default is %online% players online. The %online% and %max% placeholders are replaced with the live values.

The status embed shows "Offline" but the server is running

ZDiscord marks the server as offline only on plugin disable, not on network loss. If the bot disconnects from Discord, the embed will keep editing the message but the JDA connection state can be checked with /zdiscord status.

My join messages show "-1 players online"

This was a bug in earlier versions where the player count was read synchronously on PlayerQuitEvent before the player was removed. It is fixed in 1.1.0 — the activity update is now deferred by two ticks.

Can I use this with Velocity or BungeeCord?

ZDiscord is a backend plugin (Bukkit-based) and runs on each backend. For a Velocity proxy, run ZDiscord on each backend. Account linking is per-server, so a player who links on one backend will not be linked on another.

Can I translate the messages?

Yes. messages.yml is plain YAML and accepts & colour codes. There is no built-in multi-language support; the file is just edited in place.

Why does the bot ignore my console command?

Either no misc.console-role is configured, or your account does not have the configured role and is not a server Administrator. The console bridge also rejects op, deop, stop, restart, reload confirm, and whitelist remove.

Where is the bStats ID?

29652, hardcoded in ZDiscord.java. You can disable bStats globally via the plugins/bStats/config.json file.


ZDiscord v1.1.0 · Home · Issues · Source

Clone this wiki locally