RokHub
Top up
Browse the docs

Docs KvK tools

/timer

KvK timers: structure burns, shield cycles, structure heals and kingdom buffs.

What it does

Works out KvK moments and shows them as Discord timestamps, so every member reads them in their own time zone.

Burn: when a Flag, Fort or City burns down. Shield: when a structure unshields and shields again. Heal: when a structure is back at full HP. Buff: when a kingdom buff can be popped again.

When to use it

During KvK, whenever leadership needs to know when to be online.

Who can use it

Who

Everyone.

Where

Only in the channel picked for KvK Commands, or in the All Commands channel. Set them with /channel.

Subcommands

Type the command, then pick one of these. Each has its own options.

/timer burn

When a Flag, Fort or City burns down.

  • structure Required pick from a list

    Structure type.

    FlagFortCity
  • hp Required number

    Current HP. For a City, the seconds left on the burn.

  • burn_speed_buff Optional text

    Burn speed buff, for example 20%. Flag and Fort only.

  • burn_speed_duration Optional text

    How long the buff lasts, for example 7h, 45m or 1h30m.

  • last_burn Optional text

    Last burn in UTC, HH:MM or DD/MM/YYYY HH:MM.

    Default: Now

/timer shield

When a structure unshields and shields again.

  • structure Required type and pick a suggestion

    RCF (48h shielded, 6h open), Lost Temple (168h, 8h), Ziggurat (72h, 8h) or Other (48h, 4h).

  • status Required pick from a list

    Current status.

    ShieldedUnshielded
  • timer Required text

    Time left on the current status, HH:MM, for example 06:30.

/timer heal

When a damaged structure is fully healed. Structures heal 1 HP every 2 seconds.

  • current_hp Required number

    Current HP.

  • max_hp Required number

    Max HP.

/timer buff

When a kingdom buff can be popped again, 20 hours after it was popped.

  • buff_type Required pick from a list

    Type of kingdom buff.

    Building BuffResearch BuffTraining BuffResource BuffHealing Buff
  • timer Required text

    Time left on the active buff, HH:MM, for example 02:15.

Examples

Copy one, paste it in Discord and change the values. Under each is what the bot answers.

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

A card with Next burn, Fully destroyed and Burns left, each as a time in your own time zone.

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

"Currently shielded, 6h 30m left." With the time it unshields and the time it shields again.

/timer heal current_hp: 30000 max_hp: 50000

"30,000 / 50,000 HP, 20,000 missing." With the time it is fully healed.

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

When it was popped, when it ends and when it is ready again.

Tips and mistakes

Tips

  • Flags take damage every 20 minutes and Forts every hour, at 2 HP a second. The bot does that maths for you.
  • Every card has an Open in KvK Timers button for the same tool on rokhub.app.

Common mistakes

  • A burn speed buff without burn_speed_duration is ignored and the base rate is used.
  • Burn buffs do not apply to a City.
  • Buffs last 4 hours (Building, Research, Training) or 8 hours (Resource, Healing). A longer timer is capped.

Dashboard setting

KvK tools

Timers in public on the KvK tools page decides who sees the answer. On (the default) posts it for the channel, off answers only the person who asked.