Commands - Rumsfield/konquest GitHub Wiki

Updated for version 1.9.0

Konquest Commands

Below are all commands and their usage for Konquest. Every command begins with "/k". Arguments enclosed in “[ ]” are optional; “( )” are user-provided, and no surrounding characters are literal. The bar character “|” means “OR”. Arguments are separated by spaces.

Console Commands

These commands can only be used in the server console command line. Console commands do not have a forward slash "/".

Reload

Reloads plugin configuration files and updates the plugin with their current settings. NEVER use the "/reload" command! Uses:

k reload

Save

Saves all plugin data files. Uses:

k save

Version

Displays version information about Konquest. Uses:

k version

Player Commands

All commands can begin with "/k" or "/konquest".

Konquest

Displays an inventory GUI menu for every command, and a page with tips about Konquest. Uses:

/k
/konquest

Border

Toggle border particles on or off. Uses:

/k border [on|off]

Chat

Switch between global and Kingdom-only chat. While in Kingdom-only chat mode, your chat messages can only be seen by your fellow kingdom members. Kingdom chat is formatted in italics. Uses:

/k chat [global|kingdom]

Claim

Claim a chunk for the adjacent Town. Use no arguments to claim only the chunk in which the player’s standing. Use "/k claim radius (value)" to claim a region of chunks centered around the player. Use "/k claim auto" to claim chunks as you move through the wild. Uses:

/k claim [radius|auto] [(value)]

Favor

Display your current amount of Favor. The server economy's currency is referred to as Favor by Konquest. Also displays the various costs of Konquest commands. Uses:

/k favor

Fly

Enables flight. You must be in survival mode, and inside friendly territory. If you leave your kingdom land, the flying will be disabled and you will be teleported to the ground. Uses:

/k fly

Help

Prints all commands, arguments and descriptions into chat. Specify a command name to get more detailed usage information. Uses:

/k help [(page)] - Display general command help.
/k help (command) [(page)] - Display detailed help for a specific command.

Info

Display info about different things. Use no argument to open the Info Menu. Else provide the category of info and the name of the target. Uses:

/k info [menu]
/k info [player|kingdom|capital|town|sanctuary|ruin|camp|template] [(name)]

Kingdom

Create, join, or manage a kingdom. Uses:

/k kingdom [menu] - Opens the kingdom GUI menu for managing a kingdom, with the same options as the below commands.
/k kingdom create (template) (name) - Create a new kingdom using a monument template.
/k kingdom join (kingdom) - Request to join another kingdom.
/k kingdom invites - View pending invitations for you to join other kingdoms.
/k kingdom exile - Leave your current kingdom to become a barbarian.
/k kingdom templates - Lists all monument templates in a GUI menu.
/k kingdom manage ... - Manage your kingdom as an officer or master. See details below.
- /k kingdom manage disband - Delete your kingdom (master only).
- /k kingdom manage destroy (town) - Delete a town in your kingdom (master only).
- /k kingdom manage capital (town) - Change the capital to another town (master only).
- /k kingdom manage purchase (town) (amount) - Offer to purchase a town from another kingdom. (officer or master)
- /k kingdom manage offers [(town)] [(player)] accept|deny - Respond to an offer by another kingdom to purchase your towns. (officer or master)
- /k kingdom manage rename (name) - Give your kingdom a new name (master only).
- /k kingdom manage webcolor [(color)] - Show the current color used on web maps, or set a new color (master only).
- /k kingdom manage template [(name)] - Show the current monument template, or set a new one (master only).
- /k kingdom manage access open|closed - Set join access to open (anyone can join) or closed (invites required) (master only).
- /k kingdom manage diplomacy (kingdom) [(relation)] - Show the current diplomacy relationship with another kingdom, or request a new one (officer or master).
- /k kingdom manage requests [player] accept|deny - Show all player requests to join, or accept/deny a specific player's request (officer or master).
- /k kingdom manage member invite|kick|promote|demote|master (player) - Manage kingdom members by inviting players to join, kicking members from the kingdom, promoting or demoting officers, or giving kingdom master to another member (officer or master).

List

List all occurrences of a given category. Uses:

/k list [kingdom|town|camp|sanctuary|ruin|template] [(page)]

Map

Display a map in chat of chunks surrounding the player. Use no arguments to display a map of 9x9 chunks. Use "/k map far" to display a map of 19x19 chunks. Use "/k map auto" to display a 9x9 map every time you enter a new chunk (toggle on/off). Uses:

/k map [far|auto]

Prefix

Apply prefix titles to the in-chat player name, unlocked from different stat levels. Opens a GUI menu to select from unlocked prefix titles, or choose to disable your prefix. Uses:

/k prefix [menu] - Opens the Prefix GUI menu to choose or disable a prefix title.
/k prefix clear - Disables your prefix title.
/k prefix set (title) - Choose a new unlocked prefix title.

Quest

Display the tutorial quest log book. Uses:

/k quest

Score

Displays an inventory GUI menu with pages detailing the player's Kingdom score, player score, stats and Kingdom leaderboard. Use no arguments to display the score menu for yourself. Use "/k score all" to print a summary of all Kingdom scores in chat. Uses:

/k score [all] - Display a summary of all Kingdom scores in chat
/k score (player) - Show the Score GUI menu of a specific player.

Settle

Settle a new Town with the given name. Spawns the Kingdom's Monument Template in the chunk where the player is located. Uses:

/k settle (name)

Spy

Generate an unexplored map centered on the nearest enemy Town. This may cost Favor. Uses:

/k spy

Stats

Display the player's own stats book. The pages detail each stat and stat category, with unlocked prefix titles and progression towards the next title to unlock. Uses:

/k stats

Town

Manages towns/capitals which the player has access to. Also lets players join and leave towns as residents. Uses:

/k town [menu] - Opens the general town menu, where you can join towns, leave towns, respond to town invites, list all towns, and open town management menus.
/k town invites - List towns that have invited you to join as a resident.
/k town requests - List towns that you can manage which have requests by other players to join them.
/k town join (town) - Request to join a town as a resident.
/k town leave (town) - Leave a town and stop being a resident.
/k town lord (town) - Claim lordship of an abandoned town.
/k town manage (town) ... - Manage a town as a lord or knight, see details below.
- /k town manage (town) [menu] - Opens the town management menu for a specific town that you have access to.
- /k town manage (town) plots - Opens the town plots menu to manage plots for town residents.
- /k town manage (town) destroy - Deletes the town and all land claims.
- /k town manage (town) rename (name) - Gives the town a new name. Cannot rename the capital.
- /k town manage (town) upgrade [(name)] - Display available town upgrades, or apply new upgrades by name.
- /k town manage (town) shield [(name)] - Display the current remaining shield time, or apply new shields.
- /k town manage (town) armor [(name)] - Display the current remaining armor blocks, or apply new armor.
- /k town manage (town) specialize [(name)] - Display the current trade specialization, or apply a new specialization.
- /k town manage (town) option (name) [true|false] - Show the current value of a town option, or set a new value.
- /k town manage (town) requests [(player)] accept|deny - Show player join requests, or accept/deny a specific player's request to join the town.
- /k town manage (town) resident invite|kick|promote|demote|lord (player) - Manage town residents by inviting new players, kicking existing residents, promoting/demoting town knights, and giving town lord to another resident.

Travel

Teleport to the given Town, Kingdom Capital, Sanctuary, or your own Kingdom's capital, or to your bed respawn home, or to your Barbarian Camp, or to a random Wild location near the center of the world. Uses:

/k travel - Open the travel menu.
/k travel town (name) - Travel to a town's monument.
/k travel kingdom (name) - Travel to a kingdom's capital monument.
/k travel sanctuary (name) - Travel to a sanctuary.
/k travel capital|home|camp|wild - Travel to your own capital, your bed respawn location, your barbarian camp, or a random wild location.

Unclaim

Unclaim a chunk for the current Town. Use no arguments to unclaim only the chunk in which the player’s standing. Use "/k unclaim radius (value)" to unclaim a region of chunks centered around the player. Use "/k unclaim auto" to unclaim chunks as you move through the town. Only town lords can use this command on their own towns. Uses:

/k unclaim [radius|auto] [(value)]

Admin Commands

All admin commands can begin with "/k admin" or "/konquest admin".

Admin Bypass

Toggle admin bypass mode on/off, which allows the player to ignore certain plugin protections like block edits in protected territories. Uses:

/k admin bypass

Admin Camp

Create a new Barbarian Camp for the given player at your location, or destroy the current camp of the given player. Uses:

/k admin camp create|remove (player)

Admin Capture

Force the given town to be captured by the given kingdom, just like if a player destroyed the monument critical blocks. Uses:

/k admin capture (town) (kingdom)

Admin Claim

Claim a chunk for the adjacent Town or Capital. Ignores Favor checks. Use no arguments to claim only the chunk in which the player’s standing. Use "/k admin claim radius (value)" to claim a region of chunks centered around the player. Use "/k admin claim auto" to claim chunks as you move through the wild. Use "/k admin claim undo" to remove the claimed land for the previous claim command, up to 10 times. Uses:

/k admin claim [radius|auto|undo] [(value)]

Admin Flag

Manage property flags of various territories or kingdoms. See the property flags page for details. Uses:

/k admin flag set kingdom|capital|town|sanctuary|ruin (name) (property) true|false - Sets a new value for the given property flag for the given territory/kingdom.
/k admin flag show kingdom|capital|town|sanctuary|ruin (name) [(property)] - Displays all property flags, or the given property flag, of the specified territory/kingdom.
/k admin flag reset kingdom|capital|town|sanctuary|ruin (name) - Resets the given property flag of the specified territory/kingdom to the default value defined in properties.yml.
/k admin flag resetall kingdom|capital|town|sanctuary|ruin - Resets the given property flag of all territories/kingdoms to the default value defined in properties.yml.

Admin Help

Prints all admin commands, arguments and descriptions into chat. Specify a command name to get more detailed usage information. Uses:

/k admin help [(page)] - Display general command help.
/k admin help (command) [(page)] - Display detailed help for a specific command.

Admin Kingdom

Manage any kingdom as an admin. Uses:

/k admin kingdom menu (kingdom) - Opens the Kingdom GUI menu in admin mode to manage the specified kingdom.
/k admin kingdom create (template) (name) - Create a new Admin Kingdom using a monument template.
/k admin kingdom remove (kingdom) - Remove the kingdom and all towns that belong to it.
/k admin kingdom exile (player) - Remove a player from their kingdom and turns them into a barbarian, as if they are new to the server.
/k admin kingdom rename (kingdom) (name) - Change the name of a kingdom.
/k admin kingdom capital (kingdom) (town) - Change the capital of a kingdom to another town.
/k admin kingdom access (kingdom) open|closed - Change a kingdom's join access to open (anyone can join) or closed (joining requires invite).
/k admin kingdom type (kingdom) admin|player - Change a kingdom's type to admin (no master, managed by admins) or player (players manage the kingdom).
/k admin kingdom template (kingdom) [(monument)] - Display or change a kingdom's monument template, and update all of the towns to use the new monument.
/k admin kingdom webcolor (kingdom) [(color)] - Display or change a kingdom's color shown on web maps. Can use "&" color codes or hex codes, or default color names.
/k admin kingdom diplomacy (kingdom1) (kingdom2) [(relation)] - Display or set the diplomatic relation (war, peace, trade, alliance) between two kingdoms.
/k admin kingdom member (kingdom) add|kick|promote|demote|master (player) - Manage the members of a kingdom.

Admin Monument

Manage monument templates inside of Sanctuary territories. Uses:

/k admin monument create (name) (cost) - Begins the process to create a new monument template using the given name and cost.
/k admin monument loot (monument) (loot) - Sets the loot table, from loot.yml, used for all loot chests inside of this monument template.
/k admin monument reset (monument) (cost) - Resets the given monument template without removing it, allowing you to re-define the cost and region corners.
/k admin monument rename (monument) (name) - Changes the name of a monument template.
/k admin monument remove|show|status (monument) - Delete a monument template, or show the outline in colored particles of a monument template, or display detailed status in shat about a monument template.

Admin Reload

Reloads plugin configuration files and updates the plugin with their current settings. Uses:

/k admin reload

Admin Ruin

Manage Ruin territories in any world. Create, remove, rename or reset Ruins by name, or set the Critical and Spawn block locations within a specific Ruin. Resetting a Ruin will re-generate all critical blocks, re-spawn all Ruin Golems, and makes it ready to be captured. Uses:

/k admin ruin create (name) - Create a new ruin territory.
/k admin ruin loot (ruin) (loot) - Sets the loot table, from loot.yml, used for all loot chests inside of this ruin territory.
/k admin ruin rename (ruin) (name) - Change the name of a ruin.
/k admin ruin reset|remove|criticals|spawns (ruin) - Manage a ruin.

Admin Sanctuary

Manage Sanctuary territories in any world. Create, remove or rename Sanctuaries by name. Uses:

/k admin sanctuary create (name) - Create a new sanctuary territory.
/k admin sanctuary rename (sanctuary) (name) - Change the name of a sanctuary.
/k admin sanctuary remove (sanctuary) - Remove a sanctuary.

Admin Save

Save all Kingdom and player data to file. Uses:

/k admin save

Admin Settravel

Set the travel teleport location for the currently occupied territory to the player’s current location. Uses:

/k admin settravel

Admin Stat

Manage an individual player's stats. Specify a player name and stat name, and then either show its current value, set it to a new value, add onto its current value, or clear it to 0. Uses:

/k admin stat show|set|add|clear (player) (stat) [(value)]

Admin Town

Manage any town or capital. Uses:

/k admin town menu (town) - Open the Town Management GUI menu in admin mode to manage the specified town or capital.
/k admin town create (name) (kingdom) - Create a new town for the specified kingdom at the player's current location. You must be standing on the ground.
/k admin town remove (town) (kingdom) - Delete a town in the specified kingdom. Removes the monument structure and all land claims.
/k admin town rename (town) (name) - Give a town a new name.
/k admin town plots (town) - Open the plot editor GUI menu to manage town plots.
/k admin town specialize (town) [(profession)] - Display or set a town trade specialization to the given villager profession.
/k admin town upgrade (town) [(name)] (level) - Display available upgrades, or set an upgrade level for the given town.
/k admin town option (town) [(name)] [true|false] - Display or set town options.
/k admin town shield (town) [clear|set|add] (amount) - Manage town shields by clearing time to zero, setting a new time, or adding time to existing shields.
/k admin town armor (town) [clear|set|add] (amount) - Manage town armor by clearing block count to zero, setting a new count, or adding blocks to existing armor.
/k admin town resident (town) add|kick|promote|demote|lord (player) - Manage town residents by adding or kicking players, promoting or demoting residents as knights, or giving lord to a player in the same kingdom as the town.

Admin Travel

Teleport to the given territory. Ignores Favor cost and allows travel to enemy Towns. You may have to be in admin bypass mode before using this command to travel into territories with blocked entry. Uses:

/k admin travel town|kingdom|camp|ruin|sanctuary|monument (name)

Admin Unclaim

Unclaim a chunk for the nearest territory. Use no arguments to unclaim only the chunk in which the player’s standing. Use "/k admin unclaim radius (value)" to unclaim a region of chunks centered around the player. Use "/k admin unclaim auto" to unclaim chunks as you move.

/k unclaim [radius|auto] [(value)]