Help & FAQ

Discord only lets a bot hand out roles that sit BELOW its own role in the server's role list. Lemon Bot creates its roles at the bottom of that list, which is also where Discord puts a newly invited bot — so until its role is moved up, it can create roles but not give them to anyone.

The fix — about fifteen seconds

1. 1Open Server Settings → Roles.
2. 2Drag Lemon Bot above every role it manages. Dropping it just under your own top staff role is a good place.
3. 3Close settings and press the role button again.

Still failing after the drag?

• If your server requires two-factor authentication for moderation, role changes fail until the bot's owner account has 2FA enabled — the error mentions code 60003.
• Check that the bot's role still has Manage Roles. If its permissions were edited after the invite, that one may have been removed.
• A role that someone created above the bot by hand has to be moved down, or the bot moved above it — run /repair afterwards to re-check.

Open the dashboard and press Add to Discord. You need Manage Server on the Discord you're adding it to — Discord only lists servers where you have that. Lemon Bot creates its channels on join, and the dashboard notices as soon as it lands.

Joining only creates the channels. The bot starts tracking once you tell it which Tibia world to watch — run this in its commands channel:

Setup builds that world's channels and notification roles. Until it runs, the dashboard shows the server as still needing setup.

Members link their own Tibia characters to their Discord account, server by server, pick which one is their main there, and Lemon Bot keeps their nickname in step with the character they are playing (the main when none is online). Links are per server: what you link here is not visible in any other Discord, so someone in two servers links in each — and can be a knight in one and a druid in the other.

The commands

• /charlink <name>Claim a character. If this server has no main for you yet, the character you just linked becomes it.
• /charlistShow everything linked to you, with ⭐ on this server's main and 🔒 on characters whose ownership was verified.
• /charmain <name>Change which of your characters is the main in this server.
• /charsync enabledTurn the nickname on or off for you, here. Turning it off restores the nickname you had before.
• /charunlink <name>Give a character up. Any nickname based on it is put back, and if exactly one character is left it becomes your main.

What the nickname looks like

A synced nickname is the level bracket, then the character name, then the vocation emoji. Long names lose their trailing words before anything is cut mid-word, so the nickname always fits Discord's 32-character limit.

Someone else already linked my character

Unclaimed characters link instantly, with no proof asked for. A character somebody else already holds can still be taken back, but only by whoever controls the Tibia account:

1. 1Run /char link with the character's name. The bot replies with a one-time code.
2. 2Log in on tibia.com, open that character's page and paste the code anywhere in its comment. Save.
3. 3Run /char link again. The character moves to you, and you can delete the code from the comment.

The nickname isn't changing

• Discord refuses to rename anyone whose highest role sits at or above Lemon Bot's own role. This is the same drag that fixes role buttons — see the role hierarchy answer.
• Lemon Bot needs the Manage Nicknames permission. If it was unchecked at invite time or removed later, nothing is renamed and /char sync says so.
• Discord never lets any bot rename the server owner — not even one with Administrator. Owners have to set their own nickname by hand.
• Nothing changes between brackets. If you were level 512 and are now 540, the nickname is correct and was never meant to move — it changes when you cross 550. Levels are re-checked roughly every ten minutes.

The Char Bazaar is where characters are auctioned on tibia.com. Point the command at a name and the bot fetches that character's live listing and lays it out as one panel — the auction itself, the character sheet behind it, and the seller's own pitch.

• /bazaar<name>The character's current auction, in full.

What's on the panel

• Level, vocation, world and sex, with the outfit the seller chose for the listing.
• The current or minimum bid in Tibia Coins, and when the auction ends.
• Gold carried, charm points, bestiary and bosstiary progress, hirelings, prey and hunting-task slots, imbuements and blessings.
• The seller's sales arguments — the bullets tibia.com shows under a listing — each with the icon for its category.
• Whether Soul War and Primal Ordeal are still open to a buyer, which depends on the quest lines already finished and the character's level.

The Up For Auction post

You do not have to run the command to find out. When a tracked player is put up for sale, the activity scanner posts a summary to the activity channel by itself — the same sales arguments, and a link straight to the auction.

A few Tibia items can only be used once every so many days, and nothing in the game tells you when one comes back. The tracker is a private panel: a line per item, a button that stamps it as used, and a direct message the moment it is ready again.

• /cooldownOpen your tracker panel.
• /cooldowncharacter:<name>Keep a separate set of timers under one character's name.

Items tracked

• Galthen's Satchel— 30-day cooldown
• Jade Dragon Head— 14-day cooldown

Using it

1. 1Run the command. The panel is ephemeral, so only you can see it — and only you can press its buttons.
2. 2Press an item's button the moment you use it in game. The panel then shows when it comes back.
3. 3Get on with your day. When the cooldown runs out the bot messages you, and you can stamp the next use straight from that message.

Mini world changes and imminent raids are not public information. Tibia Observer reports them per account — what one account is entitled to see on its own worlds, and raids in the regions its own characters have explored. There is no server-wide feed to subscribe to, so Lemon Bot can only show a world's changes if somebody who plays there lends it their access.

Getting the code

1. 1/observer in any channel of the server. The panel that opens is ephemeral — nobody else sees it.
2. 2Press Add. A small form opens asking for an access token.
3. 3In another tab, open your Tibia account page and follow Account Management → Tibia Observer → Connect.
4. 4Copy the code the page gives you. It is short, it can be used once, and it expires quickly.
5. 5Paste it into the form and submit. The reply tells you which worlds your link now covers.

What your link actually covers

The overlap between the worlds your account plays on and the worlds this server tracks — an account with characters everywhere still only covers what the server is watching. Tibia Observer also caps how many notification rules one account may hold, so the bot claims up to five worlds in priority order. If the reply says it covers nothing, the server has not set up any world your account plays on; an admin can add one with /setup.

What linking changes on your account

Tibia Observer only reports what a notification rule asks for, so linking sets rules on your account: one mini world changes rule and one raid rule per covered world. Only rules carrying Lemon Bot's name are ever touched, so your own Observer notifications keep working exactly as they did.

Renewing and removing

The credential lasts about ninety days and the bot renews it daily on its own, so a link in use never lapses. If one does — after a long absence, or because you revoked it on tibia.com — the panel says it needs renewing and Add becomes available again for a fresh code.

Remove on the same panel unlinks your account and takes the bot's rules back off it. Nothing of yours is kept.

The list only contains servers where all of the following are true:

• The bot is in the server — an invite that was cancelled before authorising adds nothing.
• You are the owner, an administrator, or hold a Discord role the owner granted dashboard access to.
• The bot has finished creating its channels, which takes a few seconds after joining.

Owners and administrators get in automatically. For everyone else, open Team Access on the server and pick which Discord roles grant access — a READ role lets holders view the data, a WRITE role lets them edit it too.

Access follows the Discord role: take the role away and dashboard access goes with it.

The hunted and allied lists — players and guilds — and everything built on them: the ally and enemy tags on death posts, exiva lists, fullbless pokes, cross-server trophies, /hunted, /allies, /remove, /exiva, /guild-summary and the war feed. Premium also covers the respawn board, raids and mini world changes from Tibia Observer, the live online lists, guild activity, boss predictions, the /warfeed, /killfeed and /playerfeed analytics, the streamer list and go-live alerts for Twitch, Kick, YouTube and TikTok and the moderation panel. The death feed, trophies, boosted alerts, daily info, cooldown timers, the event planner, the dashboard and the other commands work on a server that never pays.

Nothing you set up is lost without premium. The lists and settings are kept, and come back exactly as they were when premium is active again.

New servers start with a trial so you can see the premium feeds before deciding. Run /premium in Discord to check what your server has left.