Guilds - Rumsfield/konquest GitHub Wiki

Konquest Guilds

A guild is a group of players in the same kingdom. Towns are included as part of a guild if the town lord is a guild member. Guilds pay their members based on the land and population of all member towns. Guilds also offer basic diplomacy, to restrict some trade with friendly guilds or make temporary peace with enemy guilds.

Guild Summary

  • A player can optionally join or create a guild. A player can choose to not be a member of any guild.
  • A player can only be a member of one guild at a time.
  • Guilds have a guild master with full control of the guild. There are also guild officers, which can add/kick members and control relationships with other guilds.
  • Guilds make periodic payments to their members, with bonus payment to officers and the master.
  • Guilds have a specialization, which is one of the villager professions (armorer, librarian, etc.). Villagers with this profession give discounts inside of guild town land.
  • Guilds have relationships with all other guilds: hostile or armistice with enemy guilds; treaty or sanction with friendly guilds.
  • It can cost Favor to do some guild management actions:
    • Create a guild: core.favor.guilds.cost_create, default 100
    • Rename a guild: core.favor.guilds.cost_rename, default 50
    • Change a guild's specialization: core.favor.guilds.cost_specialize, default 200
    • Change a guild's relationship with another: core.favor.guilds.cost_relationship, default 50

Guild Command and Menu

Use the guild command, /k guild or /k g, to do anything related to guilds. The guild menu is the primary GUI menu for managing a guild. To open the menu, use /k guild or /k guild menu. Creating a new guild with /k guild create (name) will also open the menu. For more info about the command, see the commands page.

Menu Layout

There are 3 different views of the guild menu, depending on your current status within your guild (or lack of a guild):

  1. Member view - 1 row of options
  2. Officer view - 2 rows of options
  3. Master view - 3 rows of options
Option Who Can Use? Description
Join No Guild Choose from a list guilds to request to join.
Leave Member, Officer Leave your current guild.
Invites No Guild, Member, Officer, Master View a list of guilds that have invited you to join.
List No Guild, Member, Officer, Master View a list of all guilds.
Relationships Officer, Master View a list of all guilds, with their status towards your guild and your status towards theirs.
Requests Officer, Master Approve or deny a list of players that request to join your guild.
Promote Master Make a guild member into an officer.
Demote Master Make a guild officer into a member.
Transfer Master Give ownership of the guild to a new guild master.
Specialization Master Change the guild profession.
Open Master Make the guild open to all players who request to join, or closed to require invites.
Disband Master Delete your guild.

Guild Features

Here are more detailed explanations of the different guild features.

Guild Payments

One of the main benefits of being in a guild can be receiving periodic Favor as passive income. Guild payments are given every core.guilds.pay_interval_seconds seconds, with a maximum amount of Favor limited by core.guilds.pay_limit. Payments are based on:

  • Player's total land of their towns: core.guilds.pay_per_chunk core.yml config option
  • Player's total population of their towns: core.guilds.pay_per_resident core.yml config option

Every guild member receives a payment of (core.guilds.pay_per_chunk x member's lord towns land) + (core.guilds.pay_per_resident x member's lord town population), up to a maxmimum of core.guilds.pay_limit, every core.guilds.pay_interval_seconds seconds.

If the player is a guild officer or guild master, they receive a bonus payment of a percentage of the total guild's town land and populations, core.guilds.bonus_officer_percent and core.guilds.bonus_master_percent respectively.

For example, if a guild member is the lord of 2 towns that both have 20 chunks of land total, with 5 residents total, and with default core.guilds.pay_per_chunk = 0.25, core.guilds.pay_per_resident = 0.1, then the guild payment would be (0.25 x 20) + (0.1 x 5) = 5.5 Favor.

For another example, if a guild master is the lord of 4 towns with 60 chunks of land total, and 10 residents, while all guild towns have a total of 200 land with 50 residents, the base guild payment would be (0.25 x 60) + (0.1 x 10) = 16, with a bonus of ((0.25 x 200) + (0.1 x 50)) x 0.5 = 27.5, for a total payment of 43.5 Favor.

Guild Specialization

Every guild can choose one villager profession to specialize, for example librarian. Any villager with the same profession inside of town land that belongs to a guild member will receive a discount on all trades. The discount is configured as a percentage of the original item amounts, core.guilds.discount_percent.

Note that the specializations "NONE" and "NITWIT" will not do anything, and give no discounts to any villager trades.

For example, for a default value core.guilds.discount_percent = 50 and specialization of librarian, if the first trade was originally 24 paper for 1 emerald, the discounted trade would be 24 x (50/100) = 12 paper for 1 emerald. The librarian must be located within town land that has a lord who is a member of a guild with the librarian specialization.

Guild Relations

Guilds have a relationship with every other guild, friendly and enemy. By default, enemy guilds are hostile and friendly guilds are treaty.

  • Friendly guilds (same kingdom)
    • Treaty - Default, other guild's members will receive your guild's villager specialization discounts.
    • Sanction - Other guild's members will not receive your guild's villager specialization discounts.
  • Enemy guilds (different kingdom)
    • Hostile - Default, other guild's members can PvP and attack your guild's towns as normal.
    • Armistice - Other guild's members can not PvP nor attack your guild's towns.

Both guilds must set their status to armistice with the other in order for the armistice to go into effect. One guild can set their status to armistice with another, but the other guild can still be hostile, and the armistice will not be active. When both guilds are in an armistice, if either guild turns back to hostile, then both sides become hostile and the armistice is broken.

When an armistice is active between two enemy guilds, the players and towns will appear as different colors, the guild members cannot PvP, and cannot attack the enemy guild's towns. It's basically a temporary state of peace between just those guild members, not the entire kingdoms.