Alathra:Towny: Difference between revisions

'''Tip:''' To view chunk borders, press <code>F3 + G</code>.

* Kick: <code>/t kick [username]</code>

====Town Bank====

Each town has its own '''Town Bank''' used to manage the town's economy and pay for land, stewards, and nation taxes. Anyone can deposit money into the bank, even non-residents.<br>

{{calculator|id=total|type=plain|default=2716|formula=round(2716+150*((pow(1.01,min(515,original+buy-10))-1)/0.01)+ifgreater(515,buy+original-10,0,25000*(original+buy-10-515)))}} ◎

</div>

===Resident Plots===

==Permissions==

====Town Rank Overview====

{| class="wikitable"

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|-

|}

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

Once set, the board will be visible in the following places:

* Residents:  Displayed when residents join the server and in <code>/t</code>.

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 are marked with <code>(Open)</code> next to their name in the town list displayed via: <code>/t list</code>

Public towns are marked with <code>(Public)</code> in their town info screen (e.g., <code>/t</code> or <code>/t [town name]</code>). Additionally, the homeblock’s chunk coordinates are shown for public towns.

To toggle between public and private status, use: <code>/t toggle public</code>

====Resident Tax====

This is a general tax charged to all town members.

* Charges a fixed amount from each resident's balance daily.

** If a resident cannot pay, they are automatically removed from the town.

* Charges a percentage of each resident’s current balance.

** Residents unable to pay are also removed.

* Use <code>/t set taxpercentcap (amount)</code> to set a maximum tax limit.

A per-plot tax charged to residents who own plots within the town.

* Set using: <code>/t set plottax (amount)</code>

** If a resident cannot pay, ownership of the affected plots is revoked.

** Unpaid plots are automatically listed for sale.

Tax applied specifically to plots containing shop signs or shops.

* Set using: <code>/t set shoptax (amount)</code>

** Failure to pay results in loss of the shop plot.

** Any shop signs are removed when the plot is lost.

A tax applied to non-residents who own embassy plots in your town.

* Set using: <code>/t set embassytax (amount)</code>

** If unpaid, the embassy plot is removed from the owner and returned to town control.

Taxes are additive. Below are common stacking examples:

* A resident who owns a shop plot pays: Resident Tax + Plot Tax + Shop Plot Tax

* A non-resident who owns an embassy plot pays: Plot Tax + Embassy Plot Tax

* Town Titles

* Nation Titles

Granted by: Nation Leader or Co-Leader

Command: <code>/n set title (player) (title)</code>

* Command: <code>/t set surname (player) (surname)</code>

* Remove Town Title: <code>/t set title (player)</code>

* Remove Nation Title: <code>/n set title (player)</code>

* Remove Surname: <code>/t set surname (player)</code>

The current Mayor of a town can choose to step down and pass their leadership role to another trusted resident.

===How to Transfer Mayorship===

Once the transfer is successful:

* The previous Mayor is automatically demoted to a regular resident and loses all assigned town ranks.

Note: Only transfer mayorship if absolutely necessary and only to someone you trust completely. The new Mayor will have full control over the town, including its claims, finances, ranks, and even the ability to delete or rename the town.

* Name and identity

* Claimed land

**Only the Mayor has the authority to delete the town.

==== How to Delete a Town ====

* Withdraw funds first. Any money left in the town bank will be permanently lost. Use: <code>/t withdraw (amount)</code>

* Delete the town: <code>/t delete</code>

* Then confirm with: <code>/confirm</code>

* If the town is not reclaimed within 24 hours, it is permanently deleted, and all data (bank, claims, residents, etc.) is lost.

Former residents may reclaim a ruined town during the 24-hour window using:

<code>/t reclaim</code>

* The player who reclaims the town becomes the new Mayor.

* Upon reclaim:

** The town is fully restored under the new leadership.

** A 7-day activity grace period begins.

If the town does not meet the required activity threshold within those 7 days, it will re-enter ruin, and the cycle may repeat.

Toggles are settings that control certain game rules within town plots or the entire town. These can be applied globally (to all plots in a town) or individually (to specific plots), allowing mayors and residents to customize behaviors like PvP, fire spread, and explosions.

====Town-Wide Toggles====

* Per-Plot: View active toggles for your current plot using: <code>/plot perm</code>

Towns can assign names to individual plots for identification, organization, or flavor. These names appear in on-screen plot notifications when a player enters the area.

Plots can be renamed by:

* The plot owner – if it is a resident-owned plot.

To remove an existing plot name: <code>/plot set name</code>

When a chunk is claimed from the Wilderness, it becomes a default plot. This is a standard town plot with no special function until configured otherwise.

Default plots can be sold to or granted to a town resident, converting them into resident plots. These are personally owned plots within the town.

A resident plot may be lost or reverted to default if:

* The Mayor, Co-Mayor, Deputy Mayor, or Assistant evicts the resident using: <code>/plot evict</code>

To assign a type to an unowned town plot, use: <code>/plot set (plot type)</code><br>

To revert a plot to default: <code>/plot set reset</code><br>

You can view all plot types and relevant town statistics with: <code>/t plots</code><br>

{| class="wikitable"

! Plot Type !! Description

|}

lot groups allow players to manage multiple town plots at once—for example, updating permissions, setting plot types, or configuring sale pricing. Plot groups improve efficiency for both staff and residents managing several plots.

* Town staff (Mayor, Co-Mayor, Assistant) can create and manage plot groups involving any town plot.

Removing the last plot from a group deletes the group automatically.<br>

Note: If a plot for sale is added to a group, its sale price is added to the group's total price, and the group becomes listed for sale if it wasn’t already.

Plot group management commands apply to '''all plots''' within the group you're standing in.

====Selling====

* Reset all plots in the group to default type: <code>/plot group</code>