Docs Guide

KvK and Chronicles alerts

Camp and kingdom roles, KvK timers, flag and healing maths, and alerts before Ruins, Altars and passes open.

Chronicles alerts

The KvK Chronicles page in your kingdom hub shows every chapter, each Ancient Ruins and Altar of Darkness opening, and the passes. The bot can post an alert before each one.

1
In the kingdom hub, open KvK Chronicles.
2
Under Discord alerts, turn alerts on and pick the channel.
3
Pick a role to ping and how long before the opening to post, for Ancient Ruins, Altars of Darkness and Passes.
4
Save. The bot posts once per opening and lead time, never twice.

Alerts need your server linked to the kingdom. If the hub says "Link a Discord server in the kingdom settings first", do that and come back.

KvK roles on a matchup server

1
Run /kvk setup and pick the map. A form opens: list the kingdoms of each camp, one camp per line, like Fire: 1234, 1688.
2
The bot creates King, Officer, Member and Pilot roles for each kingdom, camp roles and, if you want, camp channels.
3
Give each R5 their King role with /kvk role assign role_type: R5 (King).
4
From then on R5s give Officer roles, and R5s and Officers give Member and Pilot roles with /kvk role assign.

Already have the roles? /kvk link finds them by name instead.

/kvk

KvK settings

On the KvK tools page in the dashboard, or with /kvk settings, you choose: cross-kingdom assignment, nickname tags like [1234 R4], voice sorting so Kings list first, auto sync every 15 minutes, and a role change log channel.

The same page sets defaults for the calculators: Architecture levels for /flag, helps per heal for /heal, and whether /timer answers in public.

Timers during the war

1
Give KvK Commands a channel: /channel add group: KvK Commands channel: #kvk-timers.
2
Burns: /timer burn structure: Flag hp: 50000.
3
Shields: /timer shield structure: RCF status: Shielded timer: 06:30.
4
Buffs: /timer buff buff_type: Building Buff timer: 02:15.

Times appear in each reader's own time zone. Anything you type is UTC, game time.

/timer

Flags and healing

1
/flag cost tells you how many flags your crystal covers. Add end_date and hourly_production to plan ahead.
2
/heal calc tells you how many troops you can heal, the KP it brings, and what runs out first.

/flag /heal

Ruins and Altar reminders from the bot

Prefer to type the times yourself? /reminder setup pings for Ancient Ruins and the Altar of Darkness on its own schedule. See Events and reminders.

/reminder

Commands in this guide

/kvk Admin parts KvK camp and kingdom roles: assign, remove, set up and manage. /timer KvK timers: structure burns, shield cycles, structure heals and kingdom buffs. /flag How many alliance flags your crystal or credits can build. /heal Healing calculator: troops you can heal, kills, KP and your bottleneck.