Which server software does Spyglass run on?
Spyglass only uses standard Bukkit API, so the same jar runs unmodified on Paper, Purpur, Spigot, and plain Bukkit across 1.21 to 26.2. The three methods that are not on every platform are reached by reflection with a fallback. Spyglass detects which one it found on startup and logs it, and{platform} is available as a placeholder.
My bot is not coming online. What do I check?
Run/spyglass test. It checks the token, the channel ID, and the bot’s permissions in that channel in one go, and tells you which of the three failed. /spyglass status also shows the connection state and any config warnings.
Do I need to enable privileged intents?
No. Slash commands arrive over the interaction gateway, so nothing needs switching on in the Discord developer portal. Just invite the bot withbot and applications.commands.
Why do my slash commands take an hour to show up?
That happens whenguild-id is empty, because commands then register globally and Discord caches those for up to an hour. Set guild-id to your Discord server ID and they appear instantly.
What happens if I break config.yml?
Nothing gets applied. Spyglass parses both files before changing anything, so a syntax error leaves your running settings live and reports the line, column, offending text, and the fix:minecraft-command, come through as warnings that name the config line while the rest of the file still loads.
Will a busy server get my bot rate limited?
No. Lines are batched into one Discord message every few seconds rather than being sent one at a time. Tune it withbatching.interval-seconds and batching.max-lines-per-message. If Discord ever becomes unreachable the queue is capped rather than growing without limit, and /spyglass status reports how many lines were sent, queued, and dropped.
Will player passwords end up in Discord?
Not by default.login, register, changepassword, and the private message commands are on the ignore list out of the box. Add any others you use to ignored-commands, or switch to only-commands to relay just a short list of commands you care about.
Can a player break my Discord formatting with their name?
No. Markdown characters in anything a player typed are escaped,@everyone and role pings are defused, and placeholder values are inserted into in-game messages as plain text. A player named “ shows up as those five characters rather than recolouring your staff channel.
Can one Discord command run several Minecraft commands?
Yes. Giveminecraft-command a list instead of a single string and they run in order:
Does Spyglass phone home or collect data?
No. There is no update checker and no analytics. The only outbound connection it makes is to Discord, using the token you provide.Can I use hex colors in the messages?
Yes.messages.yml uses MiniMessage, so “ works alongside gradients, hover text, and clickable commands. Legacy & and &#RRGGBB codes are still supported for anyone upgrading from an older file.
