Top up 
What it does
Runs the roles of a KvK server: a role per kingdom for King (R5), Officer (R4), Member and Pilot, plus camp roles.
One /kvk role assign gives the kingdom role, the camp role, the Ruins and Altar reminder roles and a nickname tag like [1234 R4] in one go.
Admins build the camps and roles with /kvk setup, or link roles that already exist with /kvk link.
When to use it
When a KvK matchup server fills up and leaders need to sort members into kingdoms and camps.
Who can use it
Who
Admins can do everything. R5s give Officer roles in their own kingdom. R5s and Officers give Member and Pilot roles in their own kingdom, or their whole camp when cross-kingdom assignment is on. Only admins give the R5 role.
Where
Any channel the bot can see.
Subcommands
Type the command, then pick one of these. Each has its own options.
/kvk role assign Assigns a KvK role with its camp role, reminder roles and nickname tag.
memberRequired memberThe member.
kingdomRequired type and pick a suggestionKingdom number. Suggestions show the kingdoms of this server's KvK setup.
role_typeRequired pick from a listRole type.
R5 (King)Officer (R4)MemberPilot
/kvk role remove Removes a KvK role from a member and fixes the tag.
memberRequired memberThe member.
kingdomRequired type and pick a suggestionKingdom number.
role_typeRequired pick from a listRole type.
/kvk role sync Fixes a member's camp roles and nickname tag after roles were changed by hand.
memberRequired memberThe member.
/kvk settings AdminOpens the KvK settings panel.
/kvk setup AdminBuilds camps and kingdoms with their roles. A form opens where you list the kingdoms of each camp, one camp per line, like Fire: 1234, 1688.
mapRequired pick from a listThe KvK map, for camp names and colours.
KvK 1KvK 2Light vs DarknessHeroic AnthemTides of WarKing of All BritainSong of TroySiege of OrleansStorm of StratagemsWarriors UnboundAlliance InvictusKeener BladesKing of the NileStrife of the EightchannelsOptional True or FalseAlso create each camp's category and channels.
Default: Yes
/kvk link AdminFinds KvK roles that already exist in the server and links them.
mapOptional pick from a listThe KvK map. Helps match camp names.
/kvk kingdoms Lists the camps and kingdoms of this server's KvK setup with each King role.
Examples
Copy one, paste it in Discord and change the values. Under each is what the bot answers.
/kvk role assign member: @Player kingdom: 1234 role_type: Officer "KvK role assigned: @Player is now 1234 Officer in Fire", with the roles added and removed and the new nickname.
/kvk role remove member: @Player kingdom: 1234 role_type: Member "@Player is no longer 1234 Member", and the tag is cleared.
/kvk setup map: Tides of War A form with one line per camp. Fill in the kingdoms and the bot builds the roles and camp channels.
/kvk kingdoms Every camp with its kingdoms and King roles.
Tips and mistakes
Tips
- Built your server with the server builder? Run /kvk link and everything is found by name.
- Turn on the role change log on the dashboard: every assign and remove is posted there with who did it.
Common mistakes
- /kvk link only finds roles named like "1234 King //", "1234 Officer //", "1234 Member //" and "Fire Leadership //". Other names are not matched.
- The bot can only give roles below its own role. Move the RokHub role up in Server Settings, Roles.
- Discord never lets a bot rename the server owner, so the owner's tag stays as it is.
Dashboard setting
KvK tools
Camps and kingdoms, cross-kingdom assignment, nickname tags, voice sorting, auto sync every 15 minutes, the role change log and the reminder roles are on the KvK tools page in the Discord Bot tab in your kingdom hub.