Mechanics

These are the special Kingdom mechanics other than the simple claiming stuff.

Invasion

Invading a kingdom is the only way to capture a land that belongs to another kingdom. The main point of invading a kingdom is to loot their stuff. If you use a plugin like Minepacks with unlimited storage, it'll destroy the whole purpose of the invasion mechanics. So make sure to limit these functionalities. You need to be in a kingdom and have enough resource points to invade a kingdom. There are also many other conditions that you'll occasionally have to deal with.

Preparing

Preparing yourself against invaders is easy if you're familiar with turrets and structures. They play a huge role on protecting your kingdom. A base is another factor, but actually a cliche problem as well. Most people build obsidian walls from 0 to 255th block for a single chunk. The only way to invade these lands are to build a flying machine using redstone around 250th block to invade the land.

Your nexus chunk, is the most important thing in your kingdom, and it has to have the most security around it. People can mine the nexus to get resource points for every time they break the block.
Powercell structures are specially made for invasions. They're extremely useful when used around the nexus land.

Champion

The champion is your kingdom main guardian. By default it's a zombie that can be upgraded in the nexus. This mob will spawn when someone tries to invade you. People getting 13 blocks close to the champion, will have the champion's health and time limit bossbars displayed for them.
You can successfully capture a land after you kill the champion. Note that multiple people can invade a single land, so whoever kills the champion faster will get the land. Champions cannot teleport through any portals. Champions will only target the invader and will not change their target under any circumstances.

Champions are immune to some natural occurrences such as transforming to another mob (zombie to Drowned) or burning under the sun.

Champions support MythicMobs and you can also change your champion type in your nexus.

During Invasion

• You're not allowed to teleport using any tools, commands, portals and etc...
• You're not allowed to use certain commands.
• You're not allowed to interact with certain blocks.

Ways to End Invasion

• One of the defender members with permission uses /k surrender.
• The attacker does /k surrender
• The attacker logs out.
• The attacker dies in any way.
• The land is unclaimed.
• The kingdom is disbanded for any sides.
• The attacker is kicked out of the kingdom.
• The champion timer ends.
• The champion gets killed.

Mass Wars

Mass wars are global server events that happen every 12 hours. By default, they only allow you to invade shielded kingdoms and invade for free as many times as you want, but there are many other features to disable/enable certain kingdom features during these events.
Mass wars start with a title announcement and a bossbar showing the progress of the event. They also end with the bossbar progress disappearing and a title announcement. You can manually start or stop a masswar by using /k admin masswar command.
All the mass war settings can be found in invasions.yml

---

Guards & Soldiers

Kingdom guards are the mobs spawned when a player enters a kingdom's land (without CEASEFIRE attribute) these mobs are stronger if the land is a nexus land.
Soldiers are mobs spawned from soldier turrets when the player is within their range.

All these mob types will spawn right next to the player and will only target that specific player. They will not change their target under any circumstances.
These mobs will disappear under specific conditions:

• Successfully killed their target.
• Their target logged out.
• Their target teleported without using Ender Pearls and Chorus Fruit
• If they couldn't kill their target within a certain amount of time.

Note that unlike soldiers, kingdom guards will not spawn if even a single guard from the same kingdom is still targeting them. Doesn't matter if their a nexus guard or a normal land mob. In order for the guards to spawn again, all the guards from that kingdom that are targeting the player must disappear.

Structures

Structures are stationary blocks that provide different functions in kingdoms.
Previously each land could only have a single structure, but now you can have multiple. Note that a single land still cannot contain both kingdom and nation nexus.

• Nexus: The most important thing in your kingdom that must be protected. Unlike other structures, nexus structures don't drop an item when they're broken. They'll be also removed automatically once the land is invaded. You can manage your nexus using (/k nexus)[https://github.com/CryptoMorin/KingdomsX/wiki/Commands#k-nexus] command. Related config settings for nexus can be found in config.yml -> nexus
• Powercell: Protects 3x3 lands around the powercell land. Which means invaders will have to invade powercell lands before invading the 3x3 lands around them (if they're claimed).
  • If the land is surrounded by walls, check if the kingdom has anti-explosion misc upgrade.
  • Check if the land has caves surrounding it so you can invade underground.
  • If all negative, build a flying slime plane.
• Extractor: Produces resource points over time with a maximum capacity.
• Outpost: Buy different items using resource points and access your nexus remotely.
• Warp Pad: Teleport to all the different structures in your kingdom. Each warp pad also has a name that appears inside the GUI for teleporting to other Warp Pads and above the hologram.

Regulator

Manage various things in your land. These are divided into several sections. One common misunderstanding with regulators is that they're not kingdom-wide, they only affect the current land that they're placed in. This means that for example disabling mob spawning, will only disable mob spawning in the land that the regulator was placed in. Mobs can still summon from surrounding lands and come to the regulator land.

Rules:

• Disable Mob Spawning: Disables mob spawning in certain situations (only natural spawns, lightnings and silverfishes), therefore this does not disable plugin-spawned mobs such as Kingdoms' guards, soldiers and champions.
• Disable Animal Spawning: The same situations as above apply.
• Disable Turrets: To temporary allow any players to enter the land without getting hurt.
• Allow Explosions: Normally this is disallowed because of Misc upgrades.
• Auto Fill Turrets: Automatically fills the turrets ammo fully with the cost specified for the full refill in each turret's config. Note that this only activates once the turrets hits 0 ammo and only if the kingdom has enough resource points to afford the costs.

Attributes: Allows certain players outside of your kingdom to manage things inside this land regardless of relationship attributes.

Interactions: Allows certain players outside of your kingdom to interact with certain blocks in this land regardless of relationship attributes.

Siege Cannon

Cannons that can break kingdom shields and other blocks once a kingdom's shield has been destroyed. These cannons require ammo that are loaded by putting an iron block in the structure's GUI. Players must sit on the cannon thru the GUI and then they are able to shoot by adjusting the cannon's tube and left-clicking. You can also right-click anywhere while sitting on a cannon to open the structure's GUI for convenience. The cannon will tell you about the situation of the land that it hit. Hitting anywhere in a land that belongs to a kingdom will reduce that kingdom's shield by 10mins. Cannons have a 10 second shooting cooldown.
Once a kingdom's shield has been destroyed, shooting the land of that kingdom can destroy its turrets and structures even with anti-explosion misc-upgrade. However, these cannons cannot break powercells and nexus structures, and are also intentionally effective for friendly lands — meaning that you could destroy your own land.

---

Turrets

Turrets are stationary blocks that shoot mobs or heal allies inside and outside of the land within a specific range. They're custom and you can make your own turrets with your own settings and levels in the Turrets folder.
They can only be placed on specific blocks. Namely fences and wall blocks. Although you can technically place them on these blocks and break them again and the turret will continue to function properly. They're cosmetic, it's not intended to be a restrictive measure for turrets, it'd cause lag in some situations.
Turrets are known to be laggy in Kingdoms, so try to keep the usage low. They need ammo to be able to shoot. You can purchase ammo by right-clicking on the turret. They can also be upgraded to increase their range, damage and etc.

I also recommend checking out Battle Drones a really cool plugin similar to turrets, but they fly around like your pet.

---

Power

Note: Not to be confused with powercell structure or powerups
This is the same as the old Factions power system which is not enabled by default.

Power is a number for each player in a faction that automatically increases over time. It's like a little mini currency. The faction can claim lands with the total number of powers from the faction members, so factions themselves don't have any power, the power comes from the members and nothing else. Players lose power when they die and when they're inactive for more than a day.

For example, let's say me and you are both in the same Faction. I have 10 power and you have 5 power. Let's say each land needs 5 power, so the faction can claim a total of 3 lands (10+5 = 15 -> 15/5 = 3). If your faction loses power more than it can hold lands, in our previous example, the faction claimed 3 lands, but I died a few times and now I only have 5 power (you still have your 5) the faction will have 1 extra claim. Because it can only hold 2 claims with 5+5=10 power. What other factions can do is that they can simply /k claim one of your faction lands. This is called overclaiming.

You can also take advantage of this system and instead of allowing overclaiming straight with /k claim, allow them to invade the faction instead /k invade

You can enable the power system from powers.yml config.

---

Plunders

An alternative to the champion invasion system. This method of invading doesn't involve champions at all.
Just like before, to invade a kingdom, a player has to do /k invade to begin the invasion.
In plunder invasions, both the attacker and the defender kingdoms will have to kill each other until one side loses all its lives and lose. If attackers fail to kill enough defenders after a certain amount of time, defenders will win.
Note: It doesn't matter how the players die in this fight, they could die from their opponent, mobs and even natural causes, and it will still count as a score for the other side, meaning that allies can participate in these invasions.

If there are more attackers in the invaded land than defenders after a certain amount of time, attackers will win. This is called capture progress, but if there are the same or more defenders in the invaded land than attackers, capture progress will not advance. A similar concept to KoTH and the Outpost event.
Note: Allies don't affect the capture progress.

Attackers will win if:

• They kill a certain amount of defenders.
• They keep defenders out of the land to win by capturing.

Defenders will win if:

• They kill a certain amount of attackers.
• They hold out against the attackers until the time limit is reached.

Configuration
Anything related to champions such as champion upgrades should be entirely removed from the GUIs when enabling plunder invasions as they're useless. Many options from invasions.yml are reused for plunder invasions. Note that you must set a player death limit to use plunders.

---

Others

Nether Portal Protection

When using the nether portals to teleport, if the destination location is owned by a kingdom that doesn't have casefire or turret ceasefire attributes, the teleportation will be canceled.

Beacons

When beacons are placed in a claimed land, only players with ceasefire attribute will be affected by the beacon.

Potion Effects

Players with ceasefire attribute cannot use any of the *debuff potions (such as poison and weakness) on another friendly player using splash or lingering potions.

Chat

Kingdoms chat supports various features:

• Spies
• DiscordSRV integration
• Supports relational placeholders
• Different formats for different ranks.
• Supports colored messages including hex colors and predefined color names with kingdoms.chat.colors permission.
• Supports discord-like tags with the @name format using kingdoms.chat.tag permission. This will change @name differently for the tagger, tagged player and other players seeing the tag. It will also play a sound to the tagged player and show an actionbar.
• Ranged channels with a prefix to bypass ! (not enabled by default for any channel)
• High compatibility with other chat-dependent plugins by adjusting various internal chat handler settings.