Chat Bot (Discord and Telegram)

The chat bot connects Lords Bot to your own Discord or Telegram bot. From chat you can check which accounts are online, start and stop accounts, get logs and a screenshot, and receive alerts such as an expired access key. Guild members can also use the guild bank from chat.

How it works #

1. Create your own bot on Discord or Telegram and copy its token.
2. Connect it: paste the token into Lords Bot and click Connect.
3. Pick your chat: send !set in the channel or group you want to use. You become the chat bot’s admin.
4. Use it: control your accounts with commands, get alerts, and let your guild use the bank from chat.

Set up the chat bot #

Open Settings > Options > Other Settings in the main window and go to the Chat Bot tab. Then follow the steps for Discord or Telegram.

Discord #

1. Go to https://discord.com/developers/applications and create a new application.
2. Open the Bot page of the application and copy the bot’s token. Keep the token secret.
3. On the same page, turn on the Message Content Intent. Lords Bot needs it to read commands. Save your changes.
4. In Lords Bot, paste the token into Bot Token:, choose Discord, and click Connect.
5. When the status shows Discord Connected, click Add Bot to Discord and add the bot to your server.

Tip: If Discord says the integration “requires code grant”, go back to the developer portal and turn off the OAuth2 code grant option for your bot.

Telegram #

1. Open https://t.me/BotFather in Telegram and send /newbot.
2. Choose a name, then a username that ends in bot. BotFather sends you the bot’s token.
3. Send /setprivacy to BotFather, choose your bot, and choose Disable. This lets the bot read messages that start with ! in groups.
4. In Lords Bot, paste the token into Bot Token:, choose Telegram, and click Connect.
5. When the status shows Telegram Connected, click Add Bot to Telegram and add the bot to your group.

For Telegram only, you can tick Use Proxy? and pick one of your proxies for the chat bot connection.

Assign your chat #

Commands only work after you link the bot to one chat:

1. In the Discord channel or Telegram group you want to use, send !set (or /set).
2. The bot replies Group assigned successfully!

The chat where you sent set is now the chat bot’s chat, and you are its admin. Only the admin can use the chat bot commands, and only in that chat. On Discord, the commands also appear as slash commands in that server after you send set.

The chat bot’s admin (whoever sent set) is not the same as a guild bank’s authorised users. Those are added per bank on its Authorized Users tab.

To move the chat bot to another chat, send /cleargroup in the current chat, or click Clear Data on the Chat Bot tab, then send set again in the new chat.

Other buttons on the Chat Bot tab #

Item	What it does
Disconnect	Disconnects the chat bot.
View Log	Shows the chat bot’s connection log. Check it if the status says Something went wrong, check log.
Clear Data	Forgets the assigned chat and admin.
Info box	Shows the Chat ID, Admin ID and, on Discord, the Guild ID (your server).

Commands #

Only the chat bot’s admin can use these, in the chat set with set. Commands can start with /, ! or ,. On Discord they’re also slash commands, and the account box suggests account names as you type.

If someone other than the admin uses a command, the bot replies You are not authorized to use that command. In any other chat it replies Admin Commands can only be used in the chat where: /Set was used. The exception is /setcastle, which the admin can use in any chat the bot is in.

Guild bank in chat #

The guild bank can answer commands in any Discord channel or Telegram group your chat bot is in, not just the admin chat. Repeat these steps for each bank.

Add a bank to a chat (admin) #

In the group chat, send /setcastle followed by the bank account’s name or IGG ID, for example /setcastle MyBank. The bot replies Account Assigned to Chat. To remove it, send /unsetcastle MyBank in the chat bot’s admin chat.

Register as a bank user (each player) #

Each player links their Discord or Telegram account to their in-game name once:

1. In the group chat, send a bank command such as !bal. (Use the bank’s prefix if it was changed from !.)
2. The bot replies with Please send the bank: and a command such as !reguser 123456789.
3. Send exactly that command to the bank in the game, in guild chat or by mail. The bank replies Social account registered.
4. Send !bal in the group chat again. You get your balance.

You can now use any bank command your rank allows from the chat. To unlink, send !unreguser to the bank in the game. See Guild Bank Commands for the full list.

Note: Chat bot commands are read first. A bank command with the same name as a chat bot command, such as !stop, is treated as the chat bot command in chat. Send those bank commands in the game instead.

Account notifications #

The chat bot can post account alerts to the admin chat. Turn them on per account: open the account’s window and go to Settings > General > Advanced, then the Chat Bot group. You can use Global Settings or a template to set many accounts at once.

Option	What it posts
Post Status in Chatbot	Turns chat bot alerts on for this account.
Access Key Expiry	When the access key expires, is refreshed, or can’t be refreshed.
Connection Status Change	When the account connects, reconnects or disconnects.
Other Login	When someone else signs in to the account.
Schedule Status	When a schedule rest starts and ends, and when the account signs in during a rest to check its tasks.
Nearing RSS limit	When food, stone, wood, ore or gold reaches 4 billion, close to the game’s limit.
Post incoming rallies / attacks	When a rally or attack is coming at the castle, tagging the admin. One alert per attack: the next one comes once the watchtower has cleared.
Upload Stats	Posts the stats reports this account saves (gift stats, guild list and Guild Fest stats, turned on in the Guild page) as files to the chat where this account was added with /setcastle. Nothing is posted until you do that. With it on, the bank command !stats all sent from that chat also uploads the report as a file.

While Post Status in Chatbot is on, some alerts are always posted, for example when the account is banned or suspended, or when your account limit is reached.