Timers

Patron feature

These commands only appear in authorized servers. Run /patreon verify with Manage Server to unlock them, then give Discord a few seconds to register them.

Timers turns the awkward “when will this be ready” questions of KvK into clean Discord timestamps. It covers how long a Flag, Fort, or City takes to burn, when a structure flips between shielded and unshielded, how long a damaged structure takes to fully heal, and when a kingdom buff comes off cooldown. Every answer comes back with a UTC time, a localized timestamp, and a relative countdown, so everyone in your server reads it correctly no matter their timezone. It is built for the whole alliance to use during a KvK push.

Tier	Patron
Command	/timer burn, /timer shield, /timer heal, /timer buff
Who can use	Everyone in an allowed channel

How it works

Each subcommand takes a small set of inputs and returns an embed with the key moments as Discord timestamps:

• UTC: a fixed UTC time string.
• Local: a timestamp that shows in each viewer’s own timezone.
• Relative: a live countdown (for example “in 3 hours”).

All four subcommands count down from the current time, so run them right when the event happens for the most accurate countdown. The one exception is /timer burn, which can start its countdown from an earlier time if you give it a last_burn.

Commands

/timer burn

Calculate structure burning time for a Flag, Fort, or City.

Flags and Forts burn at a base rate of 2 HP per second. A Flag takes damage every 20 minutes and a Fort every hour, so the embed shows the next burn tick, how many burns remain, and when the structure is fully destroyed if no one heals it. You can apply a burn speed buff with a duration; while the buff is active the burn rate is faster, then it drops back to the base rate once the buff expires. For a City, the HP value you enter is read directly as the seconds remaining until it is fully burned.

Option	Type	Required	Description
structure	choice	Yes	Structure type. Choices: Flag, Fort, City.
hp	number	Yes	Current structure’s HP.
burn_speed_buff	text	No	Burn speed buff percentage (for example 20%). Applies to Flag and Fort only.
burn_speed_duration	text	No	Duration of burn speed buff (for example 7d, 7h, 7m). Applies to Flag and Fort only.
last_burn	text	No	Time of the last burn in UTC. For example HH:MM or DD/MM/YYYY HH:MM. Defaults to now.

/timer burn structure: Flag hp: 50000 burn_speed_buff: 20% burn_speed_duration: 7h

/timer shield

Calculate the shield cycle for a structure: when it next unshields and when it shields again, or the other way around.

You pick the structure, say whether it is currently shielded or unshielded, and give the time left on that current status. The command projects the full cycle using fixed durations for each structure type. Unshielded windows and shielded windows differ by structure: for example RCF shields for 48 hours and stays unshielded for 6, Lost Temple shields for 168 hours and stays unshielded for 8, Ziggurat shields for 72 hours and stays unshielded for 8, and Other shields for 48 hours and stays unshielded for 4.

Option	Type	Required	Description
structure	text (autocomplete)	Yes	Select a structure. Autocomplete suggests: RCF, Lost Temple, Ziggurat, Other.
status	choice	Yes	Current status. Choices: Shielded, Unshielded.
timer	text	Yes	Time left on the current status in HH:MM format.

/timer shield structure: RCF status: Shielded timer: 06:30

/timer heal

Calculate how long a damaged structure takes to fully heal.

Give the current HP and the max HP. The command heals at 2 seconds per missing HP and returns the time the structure will be fully healed. Max HP must be greater than or equal to current HP, and neither value can be negative.

Option	Type	Required	Description
current_hp	number	Yes	Current structure HP.
max_hp	number	Yes	Max structure HP.

/timer heal current_hp: 30000 max_hp: 50000

/timer buff

Calculate when a kingdom buff will be ready again.

Pick the buff type and enter how much time is left on the buff that is currently active. The command finds when the buff was popped, when it will end, and when it comes off cooldown. Kingdom buffs are ready again 20 hours after they are popped. Each buff type has a maximum duration: Building, Research, and Training buffs last 4 hours, while Resource and Healing buffs last 8 hours. If your entered timer is longer than the buff’s maximum, the command caps it at the maximum for the calculation.

Option	Type	Required	Description
buff_type	choice	Yes	Type of Kingdom Buff. Choices: Building Buff, Research Buff, Training Buff, Resource Buff, Healing Buff.
timer	text	Yes	How long is left on your current Kingdom Buff, in HH:MM format.

/timer buff buff_type: Building Buff timer: 02:15

Tips

Tip

Times that ask for HH:MM are a duration left on the clock, not a clock time. For /timer shield and /timer buff, enter the time remaining you see in game (for example 06:30 for six and a half hours left). For dates in /timer burn, use UTC.