> ## Documentation Index > Fetch the complete documentation index at: https://docs.rokroyalty.com/llms.txt > Use this file to discover all available pages before exploring further. # King account: teleport the King or pass the kingship > Leadership guide to !royal. R5 and heirs can teleport the King's city or pass the kingship to an heir from game chat, even when the King is offline. This page is for alliance leadership only. Only R5 and heirs on the Alliance tab can use `!royal`. It works in game chat only. There is no app screen or Discord command for it. The King account is the owner's own account. When the King is offline, an R5 or heir can type `!royal` in game chat to have the bot: * **Teleport the King:** move the King's city to any spot on the map. * **Pass the king:** hand the kingship to one of your alliance's heirs. The bot logs into the King account, does the action, and logs out. The owner gets a phone alert when each action starts and when it ends. In its replies, the bot calls the King account by its in-game name. The examples on this page use `Royal Y`. Until the bot learns the name, it says `King account` instead. ## Before you start * The **King Account** feature must be turned on for your kingdom. It is off by default. When it's off, the bot replies `!royal is turned off for this kingdom.` * The owner must have set up the King account login for the bot. * To pass the king, your heirs must be set on the Alliance tab. See [Leadership commands](/leadership/commands#in-game-council-chat) for setting council chat and other alliance tools. Each action is a real login on the King account. It logs the owner out of the game on their own phone or PC. ## How to answer the bot `!royal` is a short conversation. The bot asks a question and you reply. Type each answer on its own line, for example `1`, `512 640`, or `yes`. This works in chat channels and in private messages to the bot. Answers with `!` in front, like `!1`, also work. The bot replies where you typed `!royal`. To stop at any step, type `no` or `cancel`. If you don't answer within 5 minutes, the conversation ends and nothing is done. ## Teleport the King 1. Type `!royal`. The bot replies with the King account's name, for example `Royal Y: 1 teleport, 2 pass king. Reply 1 or 2.` 2. Type `1`. The bot asks `Coordinates? X Y`. 3. Type the X and Y coordinates, from 0 to 1200. You can write `512 640` or `X:512 Y:640`. 4. The bot asks you to confirm. Type `1` for yes or `2` for no. ```text theme={null} !royal → Royal Y: 1 teleport, 2 pass king. Reply 1 or 2. 1 → Coordinates? X Y 512 640 → Teleport Royal Y to X:512 Y:640? Reply 1 for yes, 2 for no. 1 → Royal Y teleport requested. ``` A little later, the bot posts the result: ```text theme={null} Royal Y teleported to X:512 Y:640 (Targeted Teleport, 2 left). ``` The bot only uses teleport items from the King's bag. It uses a Territorial Teleport when the spot allows it, and a Targeted Teleport otherwise. It never spends gems. ## Pass the king 1. Type `!royal`. 2. Type `2`. The bot lists your heirs with a number for each, up to 10. 3. Type the number of the heir. 4. The bot asks you to confirm. Type `1` for yes or `2` for no. ```text theme={null} !royal → Royal Y: 1 teleport, 2 pass king. Reply 1 or 2. 2 → Pass king to: 1 Heir One, 2 Heir Two. Reply the number. 2 → Pass king to Heir Two? Reply 1 for yes, 2 for no. 1 → Pass king requested. ``` A little later, the bot posts one of these results: | Message | What it means | | - | - | | `King passed to Heir Two.` | The King title moved to the heir. | | `R5 passed to Heir Two; the King title did not move.` | The heir is now R5, but the King title stayed on the King account. | You can only pass the king to an heir. The bot checks again when you confirm. If the person is no longer an heir, it replies `Pass king failed: Heir Two is not an heir.` ## When something goes wrong If an action fails, the bot replies `Royal Y teleport failed:` or `Pass king failed:` followed by the reason. Common reasons: | Reason | What to do | | - | - | | `no teleport item left` | The King has no teleport items. Nothing moved. | | `the spot is outside alliance territory and no Targeted Teleport is left` | Pick a spot inside your alliance territory, or get the King a Targeted Teleport. | | `it would cost gems` | The bot won't spend gems. Nothing moved. | | `the game refused that spot` | Pick a different spot. | | `the account is not the King` | The King account doesn't hold the King title, so nothing was sent. | | `the login for it is not set up` | Ask the owner to set up the King account login. | | `the account did not report - check it in game before trying again` | The action may have happened in game. Check the King's city or title before you try again. | Other replies you might see: * `!royal is for R5 and heirs only.` You aren't R5 or an heir. * `No heirs are set.` Add heirs on the Alliance tab first. * `Cancelled. Nothing was queued.` You cancelled the conversation. * `!royal ended: no answer in 5 minutes. Nothing was done.` The conversation timed out. `!royal` doesn't appear in `!help`. ## Related pages Set up council chat and other leadership tools. Check when a governor's peace shield ends. Get warnings before a shield ends or when a governor teleports. Auto-rebuild your alliance resource center. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.