The Mayor's Table is the central workstation for your colony. Use a crafting table to make the Mayor's Table, the recipe is shown below.

Crafting Recipe

Combine these materials at a crafting table to create your Mayor's Table.

Mayor's Table crafting recipe

Mayor's Table Abilities

The Mayor's Table provides access to all colony management functions:

• View Colony Info

  — Sends a chat message containing info about your colony. Only you can see this.

• Change Flag Color

  — Customize the flag color, and the color of your colonies display name

• Manage Members

  — Invite players, Purchase Citizens, and Manage Population. You can also use this menu to assign player permissions, and custom ranks. Learn more about Player Ranks here.

• Diplomacy

  — Set relationships with other colonies (ally/neutral/hostile), or declare war on your enemies.

• Rename / Delete Colony

  — Change your colony's display name, or permanently delete a colony.

• Transfer Ownership

  — Pass the crown to another player, transfers full ownership and administrative rights to them.

• Teleport Between Flags

  — Fast-travel to any of your colony's flags (Only appears if your colony has multiple flags)

Interface Examples

Mayors Table UI 1/2

Mayors Table UI 2/2

Crafting & Setup

Craft a Food Crate by combining a chest with two bread and some planks at a crafting table — place the crate inside the colony territory so citizens can access it.

Food Crate crafting recipe

How it Works

Citizens will automatically take one food item from any accessible Food Crate per in-game day. The crate must be within the colony's protected radius.

Food Crate

Food Crate UI

Types of Citizens

Citizen Purchase Menu

NPC Citizen

Job Selection UI

Feeding Citizens

Civilians require food to survive — see Feeding Citizens for more info. Check a citizens hunger by interacting with them.

Knights

Benefits & Mechanics

• Colony Buffs: Every 10 citizens unlocks a status effect for colony members within colony territory (up to 50 citizens worth of effects).
• Jobs: Assign jobs (botanist, miner, hunter, etc.). Citizens occasionally give items related to their job; a yellow exclamation mark appears above them when they have items to collect.
• Population Limits: Server admins can set NPC caps via the moderation tool, and adjust the price; be mindful of performance and balance when hiring many NPCs.
• Citizen Inventory Management: Crouch + Right Click / Tap and hold to manage the citizens inventory

Citizen ready to claim items

Citizen item claim UI

Colony Levels

Colonies can now level up through three primary activities:
(Colony Levels will become more useful in future updates)

• Having Citizens: Grow your population to increase colony experience
• Winning Wars: Victory in wars grants substantial colony experience
• Owning Flags: Multiple flags across the world contribute to your colony's level

Player Levels

Alongside colonies, individual players can now level up by killing other players during battle, but beware, dying causes you to lose personal points.

Custom Colony Ranks

Ranks can be assigned to members of your colony via the citizen management menu of the mayors table. You can create up to 10 different ranks with different permissions.

How Merchants Work

Mysterious Merchants spawn during the day and are slightly less common than witches. When you spot one, approach them to browse their special inventory.

Special Items for Sale

Mysterious Merchants offer three exclusive items:

🎺 Trumpet

A new musical item perfect for enhancing roleplay... or annoying people.

💍 Wedding Ring

An essential item for the new Marriage system. Use this to propose and merge colonies with another player.

💿 New Music Disc

A mysterious music disc that can only be obtained from Merchants. "The Arena"

Mysterious Merchant. He may look scary, but he's really nice!

How Democracy Works

When you create a colony, you have the option to enable democratic governance. In a democratic colony:

• Regular Elections: Leadership elections occur every 30 real-world days
• Member Voting: All colony members can vote for their preferred leader
• Fair Process: Votes must go through the new block, The Ballot Box
• No Going Back: You cannot disable Democracy

🗳️ The Ballot Box

The Ballot Box is a new block designed for democratic colonies.

The Ballot Box block used for voting

Using the Ballot Box

• Placement: Place Ballot Boxes in accessible locations within your colony
• Voting Period: At any point, members can interact with the Ballot Box to cast votes for the next election
• Vote Counting: The system automatically tallies votes and announces the winner
• Security: Each member can only vote for one player, but can change their vote at any time.

Democratic vs. Authoritarian

Choose your colony's governance style when creating it:

How Marriage Works

Marriage is a special system that allows two players to unite their colonies:

• Obtain a Wedding Ring: Purchase a Wedding Ring from a Mysterious Merchant
• Propose: Right-click another player while holding the Wedding Ring to propose
• Merge Colonies: When accepted, the two colonies merge into one (Highest level colony absorbs smaller colony)
• One Marriage: Each player can only be married to one other player at a time (Right click spouse to divorce)

How Taxation Works

The Taxation Table enables you to collect taxes from player citizens in your colony. This provides a steady income stream that can be used for colony development, purchasing citizens, and buying blueprints.

Tax Cycles

Choose from three different taxation cycles to suit your colony's needs:

• Weekly: Collect taxes every 7 real-world days - fastest income but smaller amounts
• Bi-Weekly: Collect taxes every 14 real-world days - balanced approach
• Monthly: Collect taxes every 30 real-world days - largest income but longest wait

Setting Up Taxation

• Craft the Table: Create a Taxation Table using the appropriate crafting recipe
• Choose Cycle: Select weekly, bi-weekly, or monthly taxation
• Set Rates: Configure how much each player citizen will be taxed
• Collect Income: Return to the table when taxes are due to collect your colony's income

How Mailboxes Work

Mailboxes allow you to send items, letters, and messages to other mailboxes placed anywhere in the world. This creates a postal network that enables long-distance communication and trade between colonies.

Delivery System

The delivery time for your mail depends on the distance between the sending and receiving mailboxes:

• Local Delivery: Nearby mailboxes receive mail quickly
• Regional Delivery: Medium distances have moderate delivery times
• Long Distance: Far-away mailboxes take longer to receive deliveries

Using Mailboxes

• Craft & Place: Create a mailbox and place it in your colony or desired location
• Send Items: Open the mailbox interface to send items to other mailboxes
• Address System: Target specific mailboxes by their location or owner
• Receive Mail: Check your mailbox regularly for incoming deliveries
• Letters: Send written messages along with or instead of items

Relations

Open the Relations menu at the Mayor's Table to view other colonies, set alliances, or mark another colony as hostile.

🤝

Diplomacy Options: Set relationships as Ally, Neutral, or Hostile to manage inter-colony relations.

Relations menu showing another colony

Declaring War

To declare war, use the diplomacy menu and choose Declare War against a hostile colony. The target colony must have 5 or more citizens. When a war is declared, the target colony receives a notification and a war timer starts.

Wars are timed events where the duration is chosen by the declaring colony. Score points in a war by eliminating opposing NPCs or player citizens. Victorious colonies may claim one of the other colony's flags (if they have more than one).

⚔️

War Requirements: Target colony must have at least 5 citizens before war can be declared.

📋

Server Rules: Be aware of server-specific rules — some servers may impose their own restrictions for war.

War declared notification message

War Mechanics

• Timer System: Wars have a set duration chosen by the declaring colony
• Scoring: Gain points by eliminating enemy NPCs and player citizens
• Victory Rewards: Winners can claim flags from defeated colonies (if they have multiple flags)
• Minimum Population: Both colonies should have adequate defenses and population

🏗️ Blueprint Workbench

The Blueprint Workbench is the new dedicated home for buying blueprints! This specialized workstation works exactly the same as the construction menu from the Mayor's Table, but provides a focused interface just for blueprint management.

🆕

New Feature: The Blueprint Workbench provides a dedicated interface for all your construction needs, separate from the Mayor's Table.

💰

Note: Blueprint prices are still configurable by server administrators through the moderation tool.

Blueprint Workbench purchase interface

Crafting the Blueprint Workbench

Craft your own Blueprint Workbench to access the construction system independently of the Mayor's Table. This allows for more organized colony management and easier access to building tools.

Placing a Blueprint

Select a blueprint, position the preview outline in the world, and confirm to build. You have a short preview window to cancel the placement. If you don't like where it is, you have one more chance to undo it.

Step 1: Select blueprint location

Step 2: Preview placement outline

Step 3: Confirm and watch it build!

Example City

Here's a city built using several different blueprints to demonstrate the potential of combining multiple structures:

Complete city built using various blueprints from the construction menu

Marauders Attack Starting

What are Marauders?

Marauders are hostile NPC raiders that spawn above colonies in small groups (commonly 3–5). They arrive in hot-air balloons and may target your colony for a raid that comes in multiple waves.

Attack Waves

Marauder attacks typically happen in two distinct phases:

Wave 1 — Aerial Bombing

Marauders remain in their balloons and drop explosive bombs over the colony. Bombs damage entities but do not break blocks.

Marauder Balloons

Marauder Bomb

Marauder Entity

Wave 2 — Ground Assault

After bombing, the marauders land and continue the attack on the ground, engaging players and NPC citizens directly in melee combat.

Defense Strategies

• Shelter Citizens: Keep citizens sheltered inside protected structures during raids to reduce civilian casualties
• Equip Knights: Equip knights and guards with good armor and weapons — they perform well defending against the ground wave
• Iron Golems: Use Iron Golems for defense — they deal heavy damage to Marauders, but Marauders deal heavy damage back
• Admin Settings: Admins can change the frequency via the moderation tool if raids are too frequent or too rare

🚩 Totem of Peace

The Totem of Peace is a powerful new defensive item that can provide temporary protection from marauder attacks.

Strategic Usage

• Post-Attack Recovery: Use after a devastating attack to rebuild safely
• Planned Expansion: Activate before major construction projects
• Resource Collection: Ensure safe gathering of materials outside colony walls
• Diplomatic Events: Secure peace during important negotiations with other colonies

What are Plagues?

Plagues are random events that can strike your colony, weakening all citizens for a duration. They represent disease outbreaks that can impact your colony's citizens.

Citizens affected by plague with weakness effect

Managing Plagues

• Prevention: There's no way to prevent plagues - they occur randomly
• Duration: Plagues last exactly 20 minutes once they start
• Admin Control: Server admins can adjust plague frequency via the moderation tool
• Strategy: Avoid major combat or important tasks during plague outbreaks

The Mod Tool Item

The mod tool is an item given to server admins that opens a powerful administration UI. Use it to quickly manage colonies, adjust global settings, and troubleshoot issues. To open the UI, right click or hold on any colony flag.

🔧

Admin Setup: To use the mod tool, grab it from the creative menu, then give yourself access via the command: /tag [username] add admin

Moderation tool item in inventory

Admin Interface

The moderation tool provides access to comprehensive colony management features:

Teleport and delete colony options

Toggle addon modules on/off

Land protection configuration

Administrative Features

• Global Settings: Tweaking addon settings and configurations
• Economy Control: Setting prices for citizens and blueprints
• Event Management: Triggering plagues, marauder attacks, and other events
• Fast Travel: Teleporting between colonies for administration
• Population Control: Setting citizen limits and managing colony size
• Colony Management: Force-deleting problematic colonies
• Protection Settings: Configuring land protection and build permissions
• Module Control: Enabling/disabling specific addon features

How do I give players permissions in my colony?

Go to the mayors table, click citizen management, then click player ranks, and create a rank with the permissions you want.

How do I access the mod tool?

Run the command /tag @s add admin and then right click a colony flag.

Why can't I place a flag?

Stand DIRECTLY in front of your flag pole, face-to-pole, and try again. If it still isn't working, join the Discord for help.