> ## 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.
# Shield and teleport alerts: watch a governor for you
> Leadership guide to !shieldalert, !tpalert, and !alerts. Get a warning before a governor's shield ends and a message every time they teleport.
This page is for alliance leadership only. Only R5 and heirs can use these commands in game. In Discord, only members with the leadership role can use them.
Alerts let the bot keep an eye on a governor so you don't have to keep running [`!shield`](/leadership/shield-check). There are two kinds:
* **Shield alert:** warns you shortly before a governor's peace shield ends.
* **Teleport alert:** tells you every time a governor moves their city.
Use them to time a rally for the moment a shield drops, or to track where a target goes. To watch many players at once on a live board with alert DMs, use [activity watch](/leadership/activity-watch).
## Set a shield alert
Type `!shieldalert` followed by a governor name or ID. The bot warns you 5 minutes before the shield ends.
```text theme={null}
!shieldalert Kozan
```
To get the warning earlier, add how long before, from `1m` up to `24h`. See [How to write a time](#how-to-write-a-time).
```text theme={null}
!shieldalert Kozan 30m
!shieldalert 54980131 1h30m
```
The bot first checks the shield, then replies in the same channel:
```text theme={null}
Kozan: shield alert set, shield ends in 3h 12m (19:40 UTC), warning 30m before
```
If the governor has no shield, or the bot can't see the city, it replies `no shield` or `shield not readable` and no alert is set.
### What a shield alert tells you
While the alert is running, the bot posts in the channel where you set it:
| Message | What it means |
| - | - |
| `Kozan: shield ends in 30m (19:40 UTC)` | Your warning. The shield ends soon. |
| `Kozan: new shield, ends in 8h 0m (03:40 UTC)` | The governor's shield changed to a new end time, earlier or later. The alert keeps running with the new time. |
| `Kozan: shield dropped early` | The shield ended before its time. The alert stops. |
| `Kozan: shield is down` | The shield ended on time. The alert stops. |
| `Kozan teleported: X:568 Y:672 → X:601 Y:640` | The governor moved their city. |
## Set a teleport alert
Type `!tpalert` followed by a governor name or ID. The bot watches for 24 hours.
```text theme={null}
!tpalert Kozan
```
To watch for a different length of time, add a duration from `1h` up to `7d`. See [How to write a time](#how-to-write-a-time).
```text theme={null}
!tpalert Kozan 2h
!tpalert 54980131 3d
```
The bot replies with where the city is now:
```text theme={null}
Kozan: teleport alert set, at X:568 Y:672, until Oct 3 18:00 UTC
```
After that, the bot posts `Kozan teleported: ...` every time the city moves. When the time is up, it posts `Kozan: teleport alert ended`.
If the bot can't find the city when you set the alert, it replies `Kozan: position not readable` and no alert is set.
## How to write a time
Add the time after the governor name. Use `d` for days, `h` for hours, and `m` for minutes. You can combine them.
| You type | It means |
| - | - |
| `15m` | 15 minutes |
| `2h` | 2 hours |
| `1h30m` | 1 hour 30 minutes |
| `2d` | 2 days |
| `90` | 90 minutes. A number on its own always means minutes. |
For example, `!tpalert Kozan 90` watches Kozan for 90 minutes, not 90 hours.
## See and stop your alerts
Type `!alerts` to list every alert your alliance has running.
```text theme={null}
Kozan: shield ends 19:40 UTC, warning 30m before
Rival: teleport alert until Oct 3 18:00 UTC
```
To stop an alert, add `off` before the name:
```text theme={null}
!shieldalert off Kozan
!tpalert off Kozan
```
To change an alert, run the same command again with the new time. The bot replies `alert updated`.
## Use alerts in Discord
Leadership can use the same alerts from Discord:
| Command | What to fill in |
| - | - |
| `/shieldalert` | **governor**, and optionally **lead** (how long before the shield ends, for example `10m`) |
| `/tpalert` | **governor**, and optionally **duration** (how long to watch, for example `2h`) |
| `/alerts` | Nothing. Lists running alerts. |
Write **lead** and **duration** the same way as in game. If the time isn't written correctly, the bot replies `lead must look like 15m, 1h30m or 2d.` (or the same for **duration**).
To stop an alert from Discord, run `/shieldalert` or `/tpalert` and set **stop** to **Yes, stop it**.
Alerts started in Discord post through your alliance's alerts webhook in Discord. If your alliance hasn't set one, the bot replies `No AM webhook set for alerts.`
## How often the bot checks
By default, the bot checks each watched governor every 5 minutes. Leadership can change this in Discord with `/bot-config`. Pick **Shield/teleport alert check interval (minutes 1-60)** and enter a number of minutes from 1 to 60.
A shorter interval catches teleports and early shield drops sooner.
## Limits and good to know
* Your alliance can have up to 20 alerts running at once. After that, the bot replies `alert limit reached (20)`.
* If the bot can't see the city three checks in a row, it posts `alert stopped, city not readable` and stops the alert.
* Alerts only work for cities on the map the bot is on: your home kingdom, or the shared map during KvK.
* Alerts use the same **Shield Check** feature as `!shield`. When it's turned off, you can't set alerts.
* In game, these commands only work in your council group chat, alliance chat, or a private message to the bot. Anywhere else, the bot ignores them.
* Type `!help intel` in the council chat to see these commands in game.
* To watch many players on one live board with alert DMs, use [activity watch](/leadership/activity-watch).
## Related pages
Check when a governor's peace shield ends on demand.
Track rogue players, shields, and logins on a live board.
Teleport the King or pass the kingship.
Auto-rebuild your alliance resource center.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.