Kingdom Expansion

Quickstart

1. Find or build a cluster of five or more beds close together in your world. The mod automatically detects bed clusters and raises a kingdom around them — stone-brick walls, corner towers, castle structures, and royalty will appear with a server-wide fanfare announcement.
2. Approach the royalty (King, Queen, Prince, or Princess) that spawns in the throne room. Hold any item (emeralds or flowers work great), then press G to gift it.
3. After enough gifts to royalty, you will automatically receive the Kingdom Interaction Tool as a reward.
4. Use the Kingdom Interaction Tool (right-click or right-click on a villager) to read your friendship rank, quest progress, and ledger data at any time.
5. Keep gifting to climb through friendship ranks and unlock quest completions, culminating in becoming a Royal Ally of the kingdom.

---

Overview

Kingdom Expansion transforms ordinary bed clusters into living, defended settlements. When five or more beds are detected near each other, the mod generates a full stone-brick perimeter wall with gates and corner towers, places royal castles at spaced intervals, and populates the settlement with unique kingdom villagers and royalty. A one-time kingdom-founding fanfare plays for all online players.

The mod introduces a friendship and quest system based on gifting, a ledger that tracks your standing with the settlement, a freeze mechanic that keeps villager UIs stable, a construction system where villagers help themselves navigate, and a universal anger-reset system tied to player death.

---

What It Adds

Kingdom Structures

When a qualifying bed cluster is detected, the mod generates:

• Stone-brick perimeter walls with gates — sized to avoid overlapping existing kingdoms
• Corner towers at wall intersections
• Royal castles placed at intervals around the settlement, each with a throne room

Kingdom Villagers

Eleven unique villager types spawn within the settlement, each with their own trades:

Royalty (King, Queen, Prince, Princess) reside in castle throne rooms and are persistent — they will not despawn.

Items

• Kingdom Interaction Tool — Inspect your friendship rank, quest progress, and full ledger data for any villager or royalty you look at or right-click.
• Kingdom Expansion Tester — A utility item found in the Tools tab. Right-click to force-spawn kingdom villagers near a valid village location. Useful for testing or jump-starting a kingdom manually.

Both items are found in the Tools creative tab.

---

How To Use

Triggering a Kingdom

Simply place or locate five or more beds in a cluster. The mod scans nearby bed positions automatically while players are online. When the threshold is met, walls and castles generate and royalty spawns — you will see a chat message announcing the kingdom's founding coordinates and hear the fanfare sound.

Gifting (Press G)

Hold any item in your main hand, look directly at a villager or royalty within range, and press G (rebindable under Controls → Kingdom Expansion → Give Held Gift).

• The item is consumed (one at a time; not consumed in Creative mode).
• You receive a chat message showing friendship gained and your new total.
• Gifting royalty when your friendship is high enough triggers an automatic reward of the Kingdom Interaction Tool if you don't already have one.
• The Kingdom Interaction Tool and Kingdom Expansion Tester cannot be gifted.

Good gifts include food, flowers (Poppy, Dandelion, Blue Orchid, Allium, Oxeye Daisy), books, cake, emeralds, and rare treasures. Royalty value rare treasures more highly.

Kingdom Interaction Tool

Right-click while holding the tool (aimed at a villager or royalty) to see:

• The villager's name and your recognized friendship rank
• Current friendship score (out of 100)
• Active quest message describing your next milestone
• Ledger data: player hostility, faction anger, kingdom hostility, karma reset status, justice resolution, and remaining grace time

You can also right-click directly on a villager entity to inspect them.

Friendship Ranks and Quests

Friendship accumulates across all gifts in a world. As your score rises you pass through ranks, each accompanied by a quest message:

---

Abilities And Mechanics

Villager Interaction Freeze

Whenever you open any UI with a villager — trading, gifting, or any merchant screen — that villager is completely frozen in place. All AI, navigation, gossip updates, profession schedules, and panic behaviors pause until you close the screen. This prevents UIs from auto-closing mid-trade. Everything resumes normally the moment you close the screen. This applies to kingdom villagers, standard villagers, guards, royalty, and compatible modded villager-like entities.

Villager Pathfinding Construction

When a villager becomes stuck or struggles to navigate, it may temporarily place blocks to solve its path. These blocks are short-lived and automatically cleaned up after a few minutes. Each placement counts toward the settlement's infrastructure score, which grows as the kingdom expands and villagers actively move around it.

Player Anger Reset (Justice System)

When a player dies, the mod treats it as "justice served." This automatically:

• Clears village gossip and hostility toward that player
• Resets faction anger and kingdom enemy status
• Clears any Bodhi karma aggression (if applicable)
• Grants a short respawn grace window during which villagers, guards, and royalty cannot re-aggro the player

You will see a chat message confirming the reset. If you are still within the grace window when you return to a settlement, another message confirms that grace is active.

Use the Kingdom Interaction Tool to check your current ledger, including whether justice has been resolved and how many seconds of grace remain.

---

Progression And Strategy

• Start gifting early. Friendship is world-persistent, so every gift counts toward your rank.
• Prioritize royalty gifts. Gifting royalty awards more friendship and unlocks the Kingdom Interaction Tool — your main way to track progress.
• Use the Interaction Tool often. The ledger tells you exactly where you stand, what quest step is active, and whether any hostility is still active against you.
• Don't grieve villagers. Attacking villagers raises hostility. If you accidentally anger the settlement, dying once resets it — but the grace window is limited, so don't start a fight right away after respawning.
• Let the kingdom grow. Infrastructure score increases as villagers move and place path blocks, reflecting a living, expanding settlement. Larger settlements with more beds support more unique villager roles.
• Trade with specialists. Each kingdom role offers unique high-value items (Elytra from the Queen, Totem of Undying from the Occultist, Heavy Core from the King) unavailable through ordinary villager trades — but you may need sufficient friendship to earn their trust first.