Peace Treaties - CryptoMorin/KingdomsX GitHub Wiki

Peace treaties are proposals sent from one kingdom to an enemy kingdom (/k enemy) to establish peace under certain conditions. The kingdom that sends the proposal can define these conditions, which are known as terms. The other kingdom can accept or deny the proposal. Denying it has no effect.

These proposals can be sent using the /k neutral command.

Terms

  • Take Resource Points: Requires the kingdom to pay the specified amount of rp.
  • War Reparations: Requires the kingdom to pay the specified amount of money from the kingdom’s bank.
  • Vassalize: Long-term restrictions on the kingdom. Read below for more info.
  • Leave/Disband Nation: Requires the kingdom to disband its nation if it is the capital or leave the nation otherwise.
  • Keep Lands: Every land captured by the attacker since the war started will be listed in a GUI, allowing the proposing kingdom to choose which lands to keep. Any land that isn't selected will be returned to the invaded kingdom. You might invade land not only to take it, but also to threaten the defenders, gain ground, capture strategic natural points on the map, humiliate the defender, or demonstrate enough strength to make them accept the treaty.

A peace treaty that doesn’t impose any terms on the other kingdom is called white peace. These conditions are then sent to the other kingdom by mail to review and accept. Each of these terms requires a certain amount of war points to be chosen.

After a treaty is agreed upon, a public announcement is made with the details of the contract. The two kingdoms can no longer enemy each other for a certain period. This prevents the stronger kingdom from repeatedly looting weaker kingdoms. Note that this period is separate for each kingdom and each treaty between them. It is also the duration of long-term terms (also known as vassalizations), which are explained below.

War Points

Kingdoms can gain war points for:

  • Every enemy you kill
  • Every invasion won
  • Every turret you break from an enemy kingdom
  • Every structure you break from an enemy kingdom

Kingdoms keep separate points for each enemy they have. This prevents kingdoms from creating fake kingdoms, using /k enemy on them, gaining war points, and disbanding them. This means that if you invade kingdom A multiple times but do nothing to kingdom B, you cannot use war points gained from kingdom A to specify terms for kingdom B.

Vassalization

Vassalization is a long-term relationship in which one kingdom imposes restrictions on another. The kingdom imposing the restrictions is called the overlord kingdom, and the restricted kingdom is called the vassal kingdom.

  • Scutage: The overlord kingdom takes a percentage of the vassal kingdom’s kingdom bank, which is collected during taxes. This percentage is specified as a config option.
  • Annul Treaties: Requires the kingdom to revoke its relationships with all kingdoms. When enabled, the vassal kingdom always inherits the relationships of the overlord kingdom and cannot change those relationships itself.
  • Limits the overall amount of lands the kingdom can claim.
  • Limits the total amount of turrets and structures a kingdom can place.
  • The overlord kingdom can modify the vassal kingdom’s relationship attributes.
  • The overlord kingdom can disable certain misc upgrades of the vassal.

Requirements

  • You cannot vassalize a kingdom that has a certain amount of members (configurable in config)
  • You cannot vassalize a kingdom that has a certain amount of lands (configurable in the config) A kingdom can be under several peace treaty contracts, which prevent it from enemying those kingdoms, but it can only be the vassal of one kingdom.

A kingdom can be freed from vassalization if it or another kingdom other than its overlord enemies the overlord and sends it a peace treaty. The treaty must require the overlord to free vassal kingdoms through the annul term, and the overlord must accept it. All the terms described above are the default layout for this concept. However, server owners can define their own grouped terms and customize war points and their conditions.

For new placeholders, see the placeholders page.

Commands

/k pt review

Used for viewing all the sent/received peace treaties.

/k pt resume

Resumes an unfinished peace treaty contract within the editor GUI.

/k pt accept

Accepts a peace treaty from a kingdom.

/k pt reject

Rejects a peace treaty from a kingdom.

/k pt miscUpgrades

Opens a vassal's misc upgrades GUI so you (the overlord kingdom) can enable and disable them

⚠️ **GitHub.com Fallback** ⚠️