Towny

## Introduction

Towny is the land protection plugin used on GrimurRP. It allows you to create towns, which you can invite other players to. The owner of a town is called its mayor, whilst the members of a town are called its residents. Nations containing multiple towns can also be formed. Nations can wage war with each-other.

## Chat Commands

Local Chat: /l or /lc
Town Chat: /t or /tc
Ally Chat: /a or /ac
Nation Chat: /n or /nc
Global Chat: /g or /gc

## Town Creation

### Creating Your Town

To create a town, use the command **/t new 'town name'**. This command creates a town on the chunk you are currently standing on. For instance, **/t new Testgrad** will create a town called 'Testgrad' at your location.

Once you have created a town, you can get an overview of your towns stats and information by typing **/t 'town name'**. This shows useful information such as:

* Board (A town's description effectively)
* Town Size (by chunks) and limit
* Outposts (by chunks) and limit
* Town Bank
* Town Mayor
* Town Assistants
* Town Residents

These will be elaborated on as the tutorial continues.

### Inviting Other Players

To invite another player to your town, use the command **/t add 'player name'**. This player then simply has to use **/accept 'town name'** to join.

### Claiming Land

Your town is limited by a number of chunks (town size) that can be claimed. This is proportional to your amount of players within your town with each resident increasing this limit by 8 chunks. To make a standard town claim, type **/t claim**, this must be next to an existing contiguous claim. Making a claim costs $250 which will be withdrawn from your town bank. To deposit money into your town bank, type **/t deposit 'amount'**.

### Outposts

Outposts exist as a mean to claim land which is not contiguous to the rest of your town, these are important as they allow your town access to farming in biome types which would normally remain out of reach, albeit it at a heavy premium. These claims cost $2000 to make each and your town has a scaling but small number of them. You can create an outpost claim by using **/t claim outpost**.

## Town Management

### Useful Commands

* **/town set name 'new name'** - changes your town name.
* **/town set mayor 'player'** - allows you to transfer the mayorship of your town.
* **/town set board 'message'** - sets the town board, which is seen on the scoreboard and by players when logging in.
* **/town set tag 'tag'** - sets your town tag, which will be shown in chat instead of your full town name.

### Rank Management

Mayors can assign ranks to residents to aid them in administrating their town with /t rank add 'player' 'rank name'.

* **comayor** - has all the permissions **of a mayor** (including the ability to delete a town!). Give this rank with caution.
* **assistant** - has the ability to invite and kick residents and manage claims .

## Nations

Towns can form political entities which are called nations, these are a union of multiple towns. Being in a nation has numerous advantages including:

* The ability to wage war.
* Extra claim power - scaled to nation size overall.

### Nation Creation

As mayor, you can create a new nation by typing **/n new 'nation name'**. The founding town will then become the nation capital with its mayor becoming the nation leader.

### Inviting Towns to Nations

You can invite other towns into your nation by typing **/n add 'town name'**. The mayor of the invited town will then receive a message informing them of your offer.

To allow players from other towns in your nation to build and destroy in your town, the mayor uses the commands.

* **/t set perm nation build on**
* **/t set perm nation destroy on**

### Useful Commands

* **/nation set title 'player' 'title goes here'** - grants a nation member a title which will appear before their name in chat.
* **/nation set name 'new name'** - changes the nation name.
* **/nation set capital 'town'** - changes the nation's capital city and transfers nation leadership to its mayor.
* **/nation set king 'player'** - transfers nation leadership to a player in your nation.
* **/nation set tag 'tag'** - sets your nation tag, which will be shown in chat instead of your full nation name.

### Rank Management

Likewise with rank management within towns, nation leaders can assign ranks to nation members. This can be done by typing **/n rank add 'player' 'rank name'**.
**coleader** - has all the abilities of the **nation leader**, including the ability to delete the nation! Give with caution.
**chancellor** - can manage nation allies and enemies, invite and kick towns, grant titles and withdraw from the nation bank.