# 🏘️ Townships: Build Your Legacy

In AshBlossom, you can gather your friends and establish a thriving community. Build a town, claim land, and level up to unlock powerful server bonuses. As a "forever world," our systems are designed for slow, meaningful growth and long-term community building.

> \[!IMPORTANT] You can only belong to one town at a time, and each town is led by one mayor.

***

### 🚀 Getting Started

Every player has the power to start a settlement. Find an empty location and use the following:

* Establishment: `/town create <name>` — Start your journey (Example: `/town create Oakvale`).
* Expansion: `/town claim` — Stand in a chunk to add it to your territory and protect your builds.
* Unclaim Land: `/town unclaim` — Removes a specific town claim.
* Travel: `/town spawn` — Teleport back to your community hub.
* Set Spawn: `/town setspawn` — Sets the location for the community hub (Members only).
* Map View: `/town map` — View nearby chunks in a grid; highlights your current standing position.

***

### 💎 Town Points & Upgrades

Towns run on Diamonds. By depositing diamonds, you earn Town Points used for leveling up.

* Exchange Rate: `1 Diamond = 10 Town Points`
* Deposit Command: `/td <amount>`
* Deposit All: `/tdall`

{% hint style="info" icon="butterfly" %}
No need to type your town name: The system automatically detects your town and deposits it for you.
{% endhint %}

{% hint style="danger" %}
\[!CAUTION] Important: Once deposited, diamonds are permanently converted into points and cannot be withdrawn.
{% endhint %}

***

### 👥 Managing Members

Once your town is established, use these commands to manage your population:

* `/town invite`: Invite a player to join your town.
* `/town evict`: Remove a player from your town.
* `/town promote`: Promote a Resident to a Trustee.&#x20;
* `/town leave`: Leave your current town.
* `/town disband`: Deletes the town (Mayor only).

***

### 👑 Town Roles & Permissions

#### Mayor (Town Leader)

The ultimate leader responsible for the town's identity and future.

* Identity: Set Town Description, Set Town Rules, Rename Town, Change Town Color.
* Leadership: Evict Players, Promote/Demote Members, Declare War.
* Growth: Upgrade Town Level (when enough points are available).

#### Trustee (Town Manager)

Trusted assistants who handle the daily operations and maintenance.

* Land & Plots: Claim/Unclaim Land, Set Farm Areas, Create/Manage Plots, Manage Plot Members.
* Access: Trusted Access to restricted areas, Spawn Privacy, Set Town Spawn.
* Social: Invite Players, Set Greeting/Farewell Messages, Manage Town Relations, View Town Logs.

#### Resident (Town Member)

The core members who live in and support the settlement.

* Contribution: Deposit to Town Treasury.
* Personal: Claim and manage personal building plots.
* Social: Access the private Town Chat channel.
* Travel: Teleport to the town spawn.

***

### 📈 Progression & Rewards

Towns level up by accumulating Town Points. When requirements are met, the Mayor runs `/town levelup` to increase member capacity, claim limits, and prestige.

#### Level Milestones

* Levels 1–5: Reachable for new towns.
* Levels 6–10: Require consistent teamwork.
* Levels 11–15: Represent established, thriving towns.
* Levels 16–20: Elite achievements for the most dedicated.

#### Rewards Table

| Milestone     | Reward Type                    | Description                                                   |
| ------------- | ------------------------------ | ------------------------------------------------------------- |
| Town Level 5  | Custom Town Tag                | A single color styled tag for your town.                      |
| Town Level 10 |                                |                                                               |
| Town Level 15 | Enhanced Town Tag              | An upgraded gradient custom made appearance for your tag.     |
| Town Level 20 | Legendary Statue at spawn      | A permanent statue at Spawn recognizing your achievement.     |
| Population 5  | Mayor Tag                      | Official "Mayor" title for the leader. Single Color           |
| Population 10 | Co-Mayor Tag                   | Official "Co-Mayor" title for the second leader. Single Color |
| Population 15 |                                |                                                               |
| Population 20 | Enhanced Mayor & Co -Mayor tag | A prestigious Gold Mayor & Co Mayor  tag.                     |

***

### ⚔️ Town Wars

Towns can declare war if both sides agree to the conflict.

Set the enemy town\
/town relations set enemy \<town>

Declare War

/town war declare \<town>

* Requirements: Declaration must be accepted within 10 hours; 25% of each town's members must be online.
* A claim in town with Spawn
* The War Zone: Battles occur in a 128-block zone near the defender's spawn.
* Truce: After a war ends, both towns must wait 7 days before starting another.

\
\- Should \<town> choose to accept, online members of both towns will be teleported to commence battle.\
\- The declaration will expire in 10 minutes.\
Once accepted:\
\- All online members must now fight!\
\- Combatants must not leave a 160 block radius of town spawn, else they be removed from battle.\
\- When users die, they are removed from battle.\
\- A war is lost if a town has zero remaining (online) combatants!

### ⚠️ Inactivity Policy

To keep the world healthy and free up land for new communities:

* If no members from a town log in for 90 days, the town may be deleted.

***

{% hint style="info" icon="sparkle" %}

#### Please open a [Ticket ](https://discord.com/channels/1466579163623194686/1468294775923937390)to claim your town rewards

{% endhint %}

#### 📈 Town Levels & Bonuses

{% hint style="info" %}
(**Default Claim Size:** Each claimed area is a 16x16 chunk)
{% endhint %}

Leveling up increases your member capacity, claim limits, and provides global buffs:

<table data-header-hidden><thead><tr><th width="79.2833251953125"></th><th width="104.5499267578125"></th><th width="138.550048828125"></th><th width="115.7166748046875"></th><th width="123.5333251953125"></th><th></th></tr></thead><tbody><tr><td>Level</td><td>Diamonds</td><td>Max Members</td><td>Max Claims</td><td>Crop Growth</td><td>Spawner Bonus</td></tr><tr><td>1</td><td>50</td><td>5</td><td>6</td><td>105%</td><td>+2.5%</td></tr><tr><td>5</td><td>750</td><td>25</td><td>22</td><td>118%</td><td>+7.0%</td></tr><tr><td>10</td><td>4,100</td><td>50</td><td>48</td><td>138%</td><td>+16.0%</td></tr><tr><td>15</td><td>13,500</td><td>75</td><td>88</td><td>152%</td><td>+25.0%</td></tr><tr><td>20</td><td>38,500</td><td>100</td><td>120</td><td>160%</td><td>+30.0%</td></tr></tbody></table>

***

#### 📜 Full Command Reference

| Command                  | Description                                        |
| ------------------------ | -------------------------------------------------- |
| /town help               | View the full list of town commands.               |
| /town about \[town]      | View detailed information about a town.            |
| /town list               | View all active towns.                             |
| /town invite \<player>   | Invite a player to join your town.                 |
| /town invite accept      | Accept Invite                                      |
| /town claim              | Claim the chunk you are standing in.               |
| /town unclaim            | Remove the claim from your current chunk.          |
| /town autoclaim          | Toggle auto-claiming as you walk.                  |
| /town map                | View a visual map of nearby town claims.           |
| /town spawn              | Teleport to your town's spawn point.               |
| /town setspawn           | Set the teleport location for `/town spawn`.       |
| /town promote/demote     | Manage the roles/hierarchy of your members.        |
| /town evict \<player>    | Remove a member from the town.                     |
| /town leave              | Leave your current town.                           |
| /town chat               | Toggle private town chat.                          |
| /town farm/plot          | Designate claims as public farms or private plots. |
| /town rules              | Edit your town's internal rules.                   |
| /town level              | Pay to level-up the town and unlock bonuses.       |
| /town deposit/withdraw   | Manage the town's money coffers.                   |
| /town log                | View the town's audit log (recent actions).        |
| /town relations          | Manage alliances or rivalries with other towns.    |
| /town war                | View and declare wars (if enabled).                |
| /town bio/rename         | Edit the town's description or name.               |
| /town greeting/farewell  | Edit enter/exit messages for your land.            |
| /town transfer \<player> | Transfer town ownership to another member.         |
| /town disband            | Permanently delete the town.                       |

***

#### Town Gamerules:

Mayor and Co-Mayors can change rules for town claims.

```yaml
  public container access:
    - container open

  public interact access:
    - ender pearl teleport
    - entity interact
    - redstone interact
    - block interact

  public farm access:
    - block interact
    - farm block break
    - farm block place
    - place vehicle
    - player damage entity
    - break vehicle
    - farm block interact

  public build access:
    - entity interact
    - redstone interact
    - start raid
    - empty bucket
    - break hanging entity
    - block interact
    - break vehicle
    - ender pearl teleport
    - place hanging entity
    - farm block interact
    - player damage monster
    - player damage persistent entity
    - container open
    - farm block place
    - place vehicle
    - use spawn egg
    - block break
    - block place
    - fill bucket
    - player damage entity

  monster spawning:
    - player damage monster
    - monster spawn
    - passive mob spawn

  fire damage:
    - fire spread
    - fire burn

  pvp:
    - player damage player

  explosion damage:
    - explosion damage terrain
    - explosion damage entity

  mob griefing:
    - monster damage terrain
```

#### ⚠️ Important Guidelines

* No Diamond Blocks: Please deposit regular diamonds only. The system may miscount blocks, resulting in lost points.
* Expansion Space: Do not build too close to existing towns. If you block another town's growth, your claims may be removed.
* Island Sovereignty: Towns on islands own the entire island. Unauthorized builds on a town's island will be removed.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ashblossom.gitbook.io/help/social-systems/townships-build-your-legacy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
