Alathra:Towny

Towny is a land protection and town/nation management plugin for Minecraft. It allows players to create towns, claim land, form nations, protect property, and cooperate with others through ranks and alliances. It adds strategic elements like diplomacy, taxation, and territory control.

By default, all chunks are considered Wilderness.

• Any player can build, destroy, open chests, and access doors.
• Nothing is protected — use caution!
• PVP is always enabled.

Tip: To view chunk borders, press F3 + G.

Towny Basics

Towns

A Town is a player-created community that can claim chunks to protect them from other players. The player who creates the town becomes the Mayor. The Mayor can claim Wilderness chunks to turn them into protected town land.

Players who join the town are called Residents.

• Claimed land:
  • Is protected from non-town members.
  • Prevents non-residents from building, breaking, accessing containers, or using items.

Town Bank

Each town has its own Town Bank used to manage the town's economy and pay for:

• Land claiming
• Stewards
• Nation taxes

Bank Access

• Anyone can deposit money into the bank by using the comannd /t deposit [amount] [town name]
• Only the following town ranks can withdraw money or view the bank's transaction history.
  • Mayor
  • Co-Mayor
  • Deputy Mayor
  • Steward
  • Finance Manager

To view the town’s bank transaction history, use the following command:/t bankhistory

Creating and Managing Your Town

To start your town:

1. Go to the spawn area and hire an Architect.
2. The Architect will follow you as you explore, even inbetween worlds.
3. When you find a suitable location, right-click the Architect and select "Create Town".
4. This will establish your town, and you will automatically become the Mayor.

The chunk you are standing in when creating the town will become the homeblock. The exact block you are standing on will become the town spawn, to travel to town spawn do /t spawn. If your a Mayor, Co-Mayor & Deputy Mayor and want to change the location of town spawn do /t set spawn, or change the homeblock location using /t set homeblock

Requirements

• You must have at least 300⌾ in your player bank.
• Your town must be at least 128 blocks (8 chunks) away from another town.
• If you are too close to another town, you will not be able to create a new one.

Renaming Your Town

To rename your town, use the command /t set name [new town name].

Inviting Players to Your Town

After creating your town, you can invite players who aren't already in a town by using the command/t add [username].

Leaving and Removing Players

Residents can leave the town anytime using /t leave. The mayor can also kick players from the town with /t kick [username].

Active Upkeep

ActiveUpkeep replaces the default Towny upkeep. Instead of requiring money to sustain your town, players must now remain active to keep it thriving. A variety of in-game actions contribute to a player’s individual activity score.

Activity Decay

Every player has an activity score that fluctuates based on their daily engagement, players must reach the activity threshold to be considered an active member of a town. The maximum score you can achieve far exceeds the threshold, allowing you to “bank” activity for a period of time. However your score will decay over time and will decrease faster the longer you haven’t played but slower if you have been consistently active.

Inactivity

If all residents of a town become inactive, the town will be marked as inactive, if this continues for 4 days then the town will be removed from the nation it’s in, this serves as a warning sign that the town is inactive. The town then has 3 days to increase activity otherwise on the 7th day of inactivity the town will go to ruin.

Checking Activity

Players can check their own activity and that of other players by typing /activity or /activity [username].

Claiming Land

Claiming is the process of converting an unclaimed chunk from the wilderness into part of your town’s territory. Every claimed chunk is referred to as a claim or town plot.

• When you create a town, the chunk you are standing on is immediately claimed as your homeblock.

Expanding Your Town

To add a new claim, stand on a wilderness chunk that is adjacent to your current town claims and type /t claim. After the first 3 or 4 first claimed chunks, any addtional claims must be adjecent to atleast 3 of your town's existing claims.

Maximum Claims

A town can have a maximum of 690 total claims. The claim bonus from active members caps at 500, which is fully reached once 14 residents are active. Any additional active residents beyond that point won’t increase the town's claim capacity further, however you can still add them into your town. The table below summarizes the sources that contribute to the total limit:

Source	Claim Cap	Notes
Base Claims	10	Default for all newly created towns
Bonus Claims (Residents)	500	+35 claims per active resident, only active players count
Nation Bonus	100	Granted for being in a full-sized nation
Housing Steward Bonus	80	Requires Level 3 Housing Steward

Claim Cost Breakdown

Claim	Type	Individual Cost	Cumulative Cost
10	Base	472⌾	3,188⌾
50	Bonus	221⌾	10,519⌾
100	Bonus	364⌾	24,915⌾
150	Bonus	598⌾	48,590⌾
200	Bonus	984⌾	87,527⌾
250	Bonus	1,618⌾	151,568⌾
300	Bonus	2,661⌾	256,894⌾
350	Bonus	4,376⌾	430,116⌾
400	Bonus	7,196⌾	715,000⌾
450	Bonus	11,835⌾	1,183,527⌾
500	Bonus	19,464⌾	1,954,091⌾
550	Bonus	25,000⌾	3,134,328⌾
600	Bonus	25,000⌾	4,384,328⌾
650	Bonus	25,000⌾	5,634,328⌾
690	Bonus	25,000⌾	6,634,328⌾

Claim Cost Calulator

Current Claim Summary
• Existing claims: 10 • 10

---

Bonus Claims to Purchase
• Bonus claims: 0 • 0 • (You can buy up to 680 bonus claims)

---

Cost Breakdown
• Cost for 0 bonus claims: 0 ◎
• Total cost for 10 claims: 2716 ◎

Buying & Owning Plots

Any member of a town—including the Mayor—can own plots (chunks) within the town. These are known as resident plots. Once claimed, a resident has personal control over the plot and can use it however they like, within town rules. Residents can own multiple plots.

Claiming a Plot

To claim a resident plot, it must first be put up for sale: The mayor (or other authorized official) stands on the plot and types:
/plot forsale (price)
A resident or mayor can then claim the plot by standing on it and typing:
/plot claim

Plots can be set at 0⌾ to allow free claiming, effectively granting the land.

Withdrawing or Unclaiming Plots

To remove a plot from sale, the mayor can stand on the plot and types:
/plot notforsale
To unclaim a plot, a resident can stand within their own plot and types:
/plot unclaim

Joining a Nation

To join a nation, a town must meet the following conditions:

• The town must have at least 3 residents.
• The town’s Mayor must be invited by an existing nation or create a nation themselves.

Accepting or Denying a Nation Invite

If a town has received a nation invitation, the Mayor can respond using one of the following commands:

• To accept the invitation: /accept (nation name)
• To deny the invitation: /deny (nation name)

Once accepted, the town officially becomes part of the nation.

Nation Tax

When a town joins a nation, it may have to pay a daily nation tax, if the nation has taxes enabled. from the town bank and set by the nation's leader.

• This tax is automatically withdrawn from the town’s bank each day.
• The amount is determined by the nation’s leader.

To view the current nation tax rate, use: /towny prices or /n

Managing the Town

Town Rank

In a town, players may be assigned ranks to represent their responsibilities and access levels. Every resident has basic permissions, but ranked roles allow further interaction with town systems and management commands. === Default Resident Permissions === All town members automatically have access to: - Deposit money: /town deposit (amount) - Claim or unclaim personal plots: /plot claim, /plot unclaim - Manage own plot settings: /plot set perm, /plot set reset - Use basic town functions: /town spawn, /town leave

Town Rank Overview

Rank	Description	Key Abilities
Mayor	Town leader with full control.	Invite/kick, claim land, set ranks, set taxes, withdraw funds. Tax-exempt. /town invite, /town claim, /town withdraw
Co-Mayor	Shares full permissions with the Mayor, including the ability to take over the town. Should be given only to trusted individuals. Tax-exempt.	All mayoral abilities including takeover. /town set mayor, /town delete
Deputy Mayor	High-level assistant without destructive powers (e.g., can't delete town or assign mayors). Tax-exempt.	Most town management. /town set taxes, /town claim
Steward	General administrator combining permissions of multiple specialized roles.	Plot, finance, invitation, and utility management. /town set plotprice, /town withdraw
Land Manager	Oversees claiming, unclaiming, and plot access.	/town claim, /town unclaim, /plot set perm
Finance Manager	Manages town economy including taxes and pricing.	/town set taxes, /town withdraw, /town set plotprice
Culture Manager	Handles town culture-related settings and permissions.	/town toggle, /town set name
Sheriff	Responsible for jail and outlaw systems.	/town jail, /town outlaw, /town unjail
Builder	Trusted with general build access across town land.	/plot set perm build on, /towny claimed townowned
Assistant	Can invite/kick players, manage switches, and set unowned plots.	/town invite, /plot set
Tax-Exempt	Assigned to residents who are exempt from town taxes.	/towny tax_exempt

Town Board

The town board is a customizable message set by town mayor. It serves as a public announcement for both residents and visitors.

To create or update your town board message, use the command: /t set board (your message) Once set, the board will be visible in the following places:

• Residents: Displayed when residents join the server and in /t.
• Visitors: Shown in the town’s info screen via /t (town name).

Closed/Open Town

By default, all towns are set to closed status, meaning they are invite-only. Players can only join a closed town if they are invited by a town official, typically a Mayor, Co-Mayor, Deputy Mayor, or Assistant.

Open Towns

If a town is set to open, any player can freely join using the command, /t join (town name). Open towns are marked with (Open) next to their name in the town list displayed via: /t list

Changing AccessSettings

Mayors can toggle their town’s status between open and closed at any time with: /t toggle open