Skip to content

Commands

Jump to bottom
Crypto Morin edited this page Nov 15, 2020 · 145 revisions

All the kingdoms commands are accessed from a main command /kingdoms
Aliases:

  • /kingdomx
  • /kingdomsx
  • /kingdom
  • /k

All the command names and aliases are customizable in commands.yml config.

If you want to disable a command entirely, it's recommended that you disable it via commands.yml config instead of removing the permission.
Also, it's possible to disable commands per WorldGuard region, for example if you don't want players to use /k fly in certain regions, you can use the command /rg flag <region> blocked-cmds k_fly

You can read about command permissions on the Permissions page.
Command options (arguments) are either in <> or [] Options:

  • <required> - You must to use this argument in the command.
  • [optional] - This argument can be used in the command. The parameter names that are possible to be used in that specific parameter, are separated with / (e.g. <first/second/third/...>)\

Commands

Players

/k help [page]

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.

/k create <name>

Create a new kingdom with the specified name. Duplicated and blacklisted names depend on the config options. This also can cost money if you're using Vault. Can be changed in config.yml -> economy
Options:

  • <name> The name of the kingdom. Must follow the naming convention specified in config.yml -> kingdoms-name

/k rename <name>

Rename your kingdom. Duplicated and blacklisted names depend on the config options. This also can cost money if you're using Vault. Can be changed in config.yml -> economy
Options:

  • <name> The new name of the kingdom. Must follow the naming convention specified in config.yml -> kingdoms-name

/k claim [auto/fill/x] <y>

Claims a land for your kingdom. All the claiming settings can be found in claims.yml option. Some are in invasions.yml that are for invasion purposes.
Options:

  • [auto/fill/x]
    • 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.
    • 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. These options can be found in claims.yml -> fill
    • 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.

/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. Supports color codes and must follow the rules specified in config.yml -> kingdoms-lore 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 [center/centerAxis/centerDirection]

Sets your kingdom home at your location. You need to have SET_HOME kingdom permission to use this command. 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. You need to have SET_HOME kingdom permission to use this command.

/k nexus [open/remove]

Changes your kingdom nexus location. You need to have NEXUS kingdom permission to use this command.
Options:

  • [open/remove]
    • open If you have the permission, you can open your nexus remotely.
    • remove Remove your kingdom's nexus remotely. You may want to check nexus -> allow-removal option in config.

/k bank <deposit/withdraw> <amount>

Put or take money from your kingdom. Kingdom banks are used for taxes. You need to have WITHDRAW permission to take money from your kingdom's bank.
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 <deposit/withdraw/transfer> [kingdom/nation] <amount>

Put, take or transfer resource points from your kingdom. You need to have WITHDRAW permission to take or transfer resource points.
Options:

  • <deposit/withdraw/transfer>
    • deposit Convert your money to resource points.
    • withdraw Convert your kingdom's resource points to money.
    • transfer Transfer your kingdom's resource points to your nation's and vice versa.
  • [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.

/k sell

Sell a kingdom item with the price specified in the config for resource points.

/k promote <player>

Promote a player in your kingdom to a lower priority rank.
Options:

  • <player> The player to promote.

/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 <kingdom>

Revoke your relationship with a kingdom.
Options:

  • <kingdom> The kingdom to revoke relations with.

/k demote <player>

Demote a player in your kingdom to a higher priority rank.
Options:

  • <player> The player to demote.

/k pvp

Toggle PvP to fight with someone else. You'll be able to attack people who are your allies, or even your kingdom member. Both players need to have this enabled for it work.
This mostly depends on kingdoms relations. 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 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 broadcast <message>

Broadcast a message to all your kingdom members. You need to have BROADCAST kingdom permission to use this. This broadcast will also play a sound to the members.

Options:

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

/k chat <channel> [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 <kingdom> <amount>

Donate resource points to another kingdom. You need to have WITHDRAW kingdom permission to use this.
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. You need to have FLY kingdom permission to use this. This will also disable fly if you want to toggle fly from other plugins too.
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 damaged by natural causes.
  • When in admin mode.
  • When in creative or spectator mode.
  • If you're op or have one of the kingdom flight bypass permissions.

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 invade

Invade another kingdom's land. You need to have INVADE kingdom permission to use this.

/k kick <member>

Kicks a member out of your kingdom. You need to have KICK kingdom permission to use this.
Options:

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

/k show [#KINGDOM/#PLAYER/kingdom/player] [kingdom/player]

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. You need to have SURRENDER kingdom permission for this to work.

/k tradable

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

/k visualize [toggle/permanent]

If no argument is specified, this will show the land indicators and the title of the kingdom. If the player has kingdoms.command.visualize.details permission, it'll also show almost every detail associated with this land.
Options:

  • [toggle/permanent]
    • toggle Toggle land indicators when you go from a land to another.
    • permanent Permanently keep the land indicators. (The titles will stay go away)

Nation commands are pretty much the same as kingdom's.

Admins

/k reload

Reloads the plugin completely. Please read here as well.

/k updates

Check for available updates on the Spigot page.

/k admin claim <kingdom>

Claim a land forcefully for a specific kingdom.
Options:

  • <kingdom> The kingdom to claim the land for.

/k admin kick <player>

Forcefully kick a player out of their kingdom.
Options:

  • <player> The player to kick.

/k admin disband <kingdom>

Disbands a kingdom.
Options:

  • <kingdom> The kingdom to disband.

/k admin join <player> <kingdom>

Forcefully make a player join a specific kingdom.
Options:

  • <player> The player to join the kingdom.
  • <kingdom> The kingdom to make the player join.

/k admin maxLandModifier <kingdom> <amount>

Gives a kingdom extra lands to claim to exceed their default max claims. This amount is not related to or affected by max-claims equation in claims.yml config at all.
Options:

  • <kingdom> The kingdom to give extra lands to.
  • <amount> The amount of extra lands to give to the kingdom.

/k admin nexus <kingdom> [tp]

Open another kingdom's nexus. This uses the kingdom's king instance for a few things. So you might see some things such as taxes differently.
Options:

  • <kingdom> The kingdom to open their nexus.
  • [tp] Teleport to this kingdom's nexus.

/k admin home <kingdom>

Teleport to a kingdom's home.
Options:

  • <kingdom> The kingdom to teleport to their home.

/k admin dailycheck

Performs a manual daily check for taxes, rewards and everything else related to daily checks and restarts the current daily timer.

/k admin rank <player> <rank>

Change a player's rank in a kingdom.
Options:

  • <player> The player to change their kingdom rank.
  • <rank> Their new kingdom rank. It has to be a rank name from their kingdom. Auto tab completion will make this easier.

/k admin resourcepoints <kingdom> [add/set/remove] <amount>

Gives, sets or takes a kingdom's resource points.
Options:

  • <kingdom> The kingdom to modify their resource points.
  • [add/set/remove]
    • add Add x amount of resource points.
    • set Set the kingdom's resource points value to x.
    • remove Remove x amount of resource points.
  • <amount> The amount of resource points to modify.

/k admin bank <kingdom> [add/set/remove] <amount>

Change a kingdom's bank.
Options:

  • <kingdom> The kingdom to modify their bank.
  • [add/set/remove]
    • add Add x amount of money to bank.
    • set Set the kingdom's bank value to x.
    • remove Remove x amount of money from bank.
  • <amount> The amount of money to modify.

/k admin spy

Toggle chat spy.

/k admin sound <sound> [volume] [pitch]

Test sound names before using them in the config. You can read here about how Minecraft sounds work.
Options:

  • <sound> The sound to play. It has to be one of the names from here.
  • [volume] The volume of the sound.
  • [pitch] The pitch of the sound.

/k admin test <message>

Test the unique features of the plugin message system before using it in the config. Note that some of these features will not work for normal chat formatting. This command is special and will format the message in a way to make some special features such as the line breaks to work.
Options:

  • <message> The message to display. Supports line breaks, complex messages, hex color codes and etc...

/k admin hologram <radius>

Remove bugged structure and turret holograms for any reason (such as server crashes) in a radius. This won't affect armorstands or holograms that are not markers (you don't really need to understand what a marker hologram is).
Options:

  • <radius> The block radius to delete the holograms.

/k admin unclaim

Forcefully unclaim a land.

/k admin toggle

Toggles admin mode.

/k admin evaluate <expression>

Evaluates an expression using the math engine. You can read about how the math engine works here.
Options:

  • <expression> The expression to evaluate.

/k admin dynmap <fullrender/remove>

Performs different async actions regarding to Dynmap.
Options:

  • <fullrender> Perform a manual render for the whole map.
  • <remove> Remove the markers, icons and everything else related to Kingdoms from the map.

/k admin masswar <start/end>

Manage masswar event.
Options:

  • <start/end>
    • start Starts the masswar event if it's not running already.
    • end Ends the masswar event if it's running.

/k admin shield <kingdom> [add/set/remove] <time>

Changes a kingdom's shield duration.
Options:

  • <kingdom> The kingdom to modify their shield.
  • [add/set/remove]
    • add Add x amount of time to shield.
    • set Set the kingdom's shield duration to x.
    • remove Remove x amount of shield from the kingdom.
  • <amount> The shield duration time for the kingdom. This supports time suffixes and uses hours by default.

/k admin player [player]

Show all the possible kingdom related information about a player.
Options:

  • [player] The player to show information about or the command sender if not the console.

/k admin land [world] <x> <z>

Teleports you to a specific land with the chunk coordinates, not location coordinates. Please make sure to teleport using creative game mode with your fly enabled. The land you're going to teleport to might be unloaded and you may fall into the void.
The y axis of this location is always the highest block found in the chunk coordinates.
Options:

  • [world] The world that this land belongs to.
  • <x> The x axis of the chunk location.
  • <z> The z axis of the chunk location.

You can also find the server's chunk location in the Debug Screen by pressing F3 in-game. See this screenshot.
Also, check /k visualize for land information.

Terminology - Spigot - Discord - History - Other Info

Basics

Advanced

Others

Clone this wiki locally