Kingdoms
Powered by

# Commands

# Players

# /k help

Syntax: /k help [ page | command ]
Opens the interactive kingdoms help pages for the players. Only the commands that players have permission to are displayed in this list. So if you're op, you can see all the commands, or... can you?
Options:

  • [page] The page number.
  • [command] Gets information about a specific command.

# /k create

Syntax: /k create <name>
Create a new kingdom with the specified name. Options:

  • <name> The name of the kingdom.

# /k rename

Syntax: /k rename <name>
Rename your kingdom. Options:

  • <name> The new name of the kingdom.

# /k claim

Claims the current land that the player is standing on.

# /k claim
  • x The x axis of the chunk you want to claim. <y> Used only if [x] parameter from the previous parameter is used. The y axis of the chunk you want to claim. This is mostly meant to be used when players click on claims in /k map
# /k claim auto

Begin to automatically claim lands as you go from one chunk to another. This will start by attempting to claim the current land you're standing in.

The following commands don't instantly claim the chunks, but adds them to a clipboard where it shows which lands cannot be claimed and which will be claimed so the player can check and even add/remove extra lands and confirm the final process.

# /k claim fill

Attempts to fill the shape (by claiming them) with connected borders that are marked by claimed lands. There are default limits to stop the server from lagging if the shape is not found or is too huge to claim.

# /k claim square

Claims a square with an area of radius*radius chunks.

# /k claim corner < pos1 | pos2 >

This is simply just a WorldEdit //wand version of claiming. You go to a location and set /k claim corner pos1 then go to another location and /k claim corner pos2 and the plugin will get all the chunks between these two set corners as a rectangle.

# /k claim line

Claims x chunks in a straight line where the player is facing.

# /k claim clipboard

Shows all the selected lands from the previous claiming operations.

# /k claim confirm

Confirms to claim all the lands in the clipboard.

# /k unclaim

# /k unclaim all

Unclaims all lands that don't have a turret or structure in them.

# /k lore

Syntax: /k lore <description/remove>
Set your kingdom lore. This lore will display when players come from another land to your land. It might not display the lore depending if you came from the same land type. (Wilderness -> Wilderness, Another Kingdom -> Your Kingdom, etc...)
You need to have LORE kingdom permission to use this command.
Options:

  • <description> The description of the lore. There also some special keyword such as remove to completely remove this lore.

# /k tag

Syntax: /k tag <name/remove>
Set your kingdom's tag. This tag is usually a small name (smaller than the kingdom's name). Options:

  • <name> Supports color codes. There also some special keyword such as remove to completely remove this lore.

# /k home

Teleport to your kingdom's home. Moving or getting damaged during the teleportation, will cancel it.
Once you make a new kingdom, the plugin will automatically set your home at where you're standing if the land was automatically claimed successfully.

# /k sethome

Syntax: /k sethome [center/centerAxis/centerDirection]
Sets your kingdom home at your location. Your kingdom home is probably already set after you create your kingdom.
Options:

  • [Safe Options]
    • centerDirection Center the player pitch and yaw.
    • centerAxis Centers the player xyz block axis.
    • center Centers both player xyz block axis and player yaw and pitch (direction).

# /k unsethome

Removes your kingdom home.

# /k nexus

Syntax: /k nexus [open/remove]
Changes your kingdom nexus location. Options:

  • [open/remove]
    • open If you have the permission, you can open your nexus remotely.
    • remove Remove your kingdom's nexus remotely.

# /k vault

Syntax: /k vault [kingdom]
Opens your kingdom's chest directly.

# /k bank

Syntax: /k bank <deposit/withdraw> <amount> Put or take money from your kingdom. Kingdom banks are used for taxes.
Options:

  • <deposit/withdraw> Whether you want to put or take money.
  • <amount> The amount of money to take from or put to your account.

# /k resourcepoints

  1. /k resourcepoints converter
    Opens the resource point converter GUI from the nexus remotely.

  1. /k resourcepoints <"deposit" | "withdraw"> <amount>
  • <deposit | withdraw>
    • deposit Convert your money to resource points.
    • withdraw Convert your kingdom's resource points to money.
  • <amount> The amount of resource points.

  1. /k resourcepoints transfer <"kingdom" | "nation"> <amount>
    Transfers resource points from your kingdom/nation to your kingdom/nation. This is not used for transferring resource points to other kingdom/nations. You should use /k donate command for that instead.
  • <"kingdom" | "nation">
    • kingdom Transfer resource points to your kingdom from your nation.
    • nation Transfer resource points to your nation from your kingdom.
  • <amount> The amount of resource points to transfer.

# /k sell

Sell a kingdom item (turret & structure) for resource points.

# /k tradable

Shows a list of special items that can give you a specific amount of resource points for each item.

# /k promote

Syntax: /k promote <player> Promote a player in your kingdom to a higher priority rank.
Options:

  • <player> The player to promote.

# /k ally/truce/enemy

Syntax: /k ally/truce/enemy <kingdom> Send a request to a kingdom to change your relationship status with them.
Options:

  • <kingdom> The kingdom to request the relation.

# /k revoke

Syntax: /k revoke <kingdom> Revoke your relationship with a kingdom.
Options:

  • <kingdom> The kingdom to revoke relations with.

# /k demote

Syntax: /k demote <player> Demote a player in your kingdom to a lower priority rank.
Options:

  • <player> The player to demote.

# /k gui

Syntax: /k gui <name>
Opens a GUI remotely with its name. Options:

  • <gui> The name of the GUI to open.

Examples:

  • /k gui nexus
  • /k gui champion-upgrades

# /k pvp

By default, you can't PvP with your own kingdom members and allies due to relations attributes.
What this command does is only allow you to PvP these players that you normally can't.
If you don't have a kingdom, it'll only have effect when a kingdom set their PvP relation attribute for Naturals to false.

# /k top

View the top ranking kingdoms with the highest mights.

# /k teleport

If you're under attack by another kingdom, use this command to teleport to the champion. Moving or getting damaged during the teleportation, will cancel it.
This will teleport you to where the invasion was started to avoid getting stuck in traps.

# /k undo

Undo the last action in your claim history.

# /k redo

Redo the last action in your claim history.

# /k map

Syntax: /k map [ auto | reset | height] [width]
Show the map for your current location or change its settings. You can also claim lands from the map.
Options:

  • [auto/reset/height]
    • auto When you go from a land to another land, the map will automatically update.
    • reset Reset your map's height and width to the default size.
    • height Set your map's height.
  • [width] Set your map's width.

# /k extractor

Syntax: /k extractor [kingdom]
Collects resource points from all extractors in your kingdom. The permission for this command is for VIP only.

# /k broadcast <message>

Broadcast a message to all your kingdom members. This broadcast will also play a sound to the members.

Options:

  • <message> The message to broadcast. Supports color codes.

# /k chat

Syntax: /k chat [message]
Change your current chat channel.
Options:

  • <channel> The channel to switch to. Can be Nation (n), Kingdom (k), Ally (a) and Global (g)
  • [message] Send a message to this channel without switching your main channel.

# /k disband

Disbands your kingdom and all the lands and members will be lost. Only the kingdom king can do this.

# /k donate

Syntax: /k donate <kingdom> <amount>
Donate resource points to another kingdom.
Options:

  • <kingdom> The kingdom that you want to donate resource points to.
  • <amount> The amount of resource points you want to donate.

# /k fly

Toggle kingdoms flight.

Players will be charged $100 and their kingdom will be charged 100 resource points for players to activate the flight.
Players will also be charged $1 which and their kingdom will be charged that 1 resource points for every second players have flight enabled. Failing to pay this amount will disable their flight.

This will get disabled by the following things:

  • If you get close to someone with fly attribute (by default only enemies if the person in the kingdom didn't change their relation attributes.)
  • If you go to an unclaimed land or a land that the kingdom doesn't allow fly attribute for your relation.
  • If a player damages you even if the first scenario above is not happening.

Things that prevent kingdom flight from being disabled:

  • Getting close to a player without a kingdom.
  • Getting close to a player that has /k sneak on.
  • Getting damaged by natural causes.

Your flight will not be disabled instantly by default, you'll be given a few seconds before returning and if you fail to do this or do this but instantly go again, your flight will be disabled.

# /k sneak

Normally if you /k fly around a player that you're not friendly with, your flight will get disabled.
Now if that player enables /k sneak, that won't happen again for any nearby players.
It's like the /k pvp version of kingdom flight.

# /k language

Syntax: /k language [language]
Sets the language of each individual player. Options:

  • [langauge] If it's not specified, the plugin will open a GUI instead.

# /k invade

Invade another kingdom's land.

# /k ransack

Same as /k invade with the difference that after a successful invasion, the lands are not transferred to the winner, however extra bonuses are gained from invading the kingdom. These include more money and resource points.

# /k kick <member>

Kicks a member out of your kingdom.
Options:

  • <member> The member in your kingdom that you want to kick.

# /k king <member>

Transfers kingdom ownership to another member in your kingdom. This will announce a message to all the online kingdom members by default. There's also an option to announce it to all the online players.
Options:

  • <member> The member in your kingdom that you want to transfer the kingdom's ownership to.

# /k show

Syntax: /k show general-selectors Shows detail about a kingdom. These details can be different whether you're an admin, a member of the kingdom, or an outsider.
Options:

  • [#KINGDOM/#PLAYER/kingdom/player]
    • #KINGDOM It's a special parameter used to indicate that the 2nd parameter that's going to be used, is referring to a kingdom name.
    • #PLAYER It's a special parameter used to indicate that the 2nd parameter that's going to be used, is referring to a player name.
    • kingdom/player If the 1st parameter is not one of above, it'll first look for a kingdom named after the 1st parameter, if it couldn't find it, it'll look for a player name.
  • [kingdom/player] Only works if the 1st parameter is #KINGDOM or #PLAYER It'll look for the specific element based on the first parameter.

# /k surrender

Surrender during an invasion. If you're invading a kingdom and you surrender, the champion will despawn and the land owner will not change. If you're under attack and surrender, the champion will despawn and the attackers will get the land.

# /k elections

For more information on what elections are, refer to this section.
Commands below only work when elections are in progress.

# /k elections statement

Syntax: /k elections statement
Sign up as a candidate for the election. The statement that you set, will appear in the voting GUI that other members access via /k elections vote command.

# /k elections vote

Opens a GUI which allows kingdom members to vote for available candidates. Members can only vote for one person.

# /k challenge

Syntax: /k challenge <kingdom>

When challenges are enabled, kingdoms need to send a war declaration warning in advance before being able to /k invade them. The kingdom who wants to challenge another kingdom can choose the amount of preparation time before the other kingdom can be invaded. Each kingdom must challenge the kingdom that they want to invade individually. Once the challenge preparation time has ended, the invader kingdom has 6hrs to invade any of the other kingdom's lands. Once the time is over, they'd have to challenge them again and wait.

Options:

  • <kingdom> The kingdom you want to challenge.

# /k visualize

Settings related to land visualizers and indicators. If no argument is specified, this will show the land indicators and the title of the kingdom.


Arguments:

# /k visualize toggle

Toggle land indicators when you go from a land to another.

# /k visualize permanent

Permanently keep the land indicators. (The titles will stay go away)

# /k visualize markers <type>

Set your land indicators markers type. The difference between this and the F3+G Chunk Boundaries is that this option shows the borders in a different way for each relation.
Options:

  • <type> the markers type.
    • Default The default markers type.
    • Blocks The fake blocks shown in the corner of chunks.
    • Horizontal Horizontal fake particles that are displayed at the chunk borders.
    • Vertical Vertical fake particles that are displayed at the chunk borders.

# /k requestJoin

Syntax: /k requestJoin

Requests the specified kingdom to join their kingdom.

# /k joinRequests

Anyone with INVITE permission will be able to open this GUI which shows a list of players who have requested your kingdom to join you. You can deny or accept their request here.

# /k inviteCodes

Invite codes are physical produced invitation papers that any player can use to join the kingdom that produced them. You can add, remove and produce papers from this GUI.

# /k merge

Syntax: /k merge

Requests the specified kingdom to have your kingdom merged with them. It's important to note that the kingdom that requested the merge first will get merged into the other kingdom and not the other way around. When your kingdom gets merged to another kingdom, all your members, lands, resource points and bank money will be transferred to the other kingdom. Your upgrade levels will be transferred only if they're higher than the other kingdom's upgrade levels.

If there are issues while merging on either side, you'll be warned. These issues are usually related to limits, such as member limit, land limit, etc.

# Tab Completion

When you're writing a command such as /k cla you'll notice that the plugin will suggest a few commands with a small box above your chat box. To use one of the suggested commands, you can use the Tab key to navigate through this list and select one of the suggestions without writing the full command yourself. The plugin takes advantage of the new Minecraft command system and provides a very smart tab completion system. Unlike other plugins, this plugin will go through multiple analysis of your message and suggest the best matches that it can find. This robust system saves your players from going through the help page one by one just to find a command.

This system also works with translated commands and removes any duplicated suggestions.

Certain commands have arguments that aren't names of other players, kingdoms or nations. These arguments help the command to adjust its settings such as #KINGDOM and #PLAYER selectors which can be used to specify what the name you're passing to the command is referring to exactly.

# Selectors

Command selectors are words use to help some commands pick exact values when there are more than one possibilities. The concept is similar to Minecraft's target selectors for commands.

# General Selectors

For example, when using /k show command, you could just write /k show <name>, most people would assume that refers to a kingdom name since you're requesting information of a kingdom, but other times it's more convenient to write the player name instead and let the plugin check the kingdom they're in, so the plugin accepts both, but this causes an ambiguity issue. If a player have the same name as a kingdom, the plugin will prioritize the kingdom name, but sometimes you just want to be more precise if you don't want to memorize the ordering rules (or more importantly fore admins, you don't want a fail-safe behavior and execute certain important commands for the wrong kingdom)

For these reasons, general selectors are defined as follows: #NATION: The specified name is for a nation. #KINGDOM: The specified name is for a kingdom. #PLAYER: The specified name is for a player.

Examples:

  • /k nation show test: First checks if test is a nation name, if not, checks if it's a kingdom name, if not, checks if it's a player name, and if not, it'll fail.
  • /k show #PLAYER Domingo: Checks if a player with the name Domingo exists (doesn't matter if they're online or not) and if they're in a kingdom, otherwise fails.
  • /k show #KINGDOM CORE: Checks if a kingdom with the name CORE exists, otherwise fails.

© Copyright 2025. All rights reserved.