Alathra:Towny: Difference between revisions

mNo edit summary
m Updated Wiki Guide
Line 197: Line 197:
==Permissions==
==Permissions==


=Managing the Town=
 
==Town Rank==
==Managing the Town==
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.
====Town Rank====
=== Default Resident Permissions === All town members automatically have access to:
Within a town, players may be assigned specific ranks that determine their responsibilities and access to various town interactions. While all residents have access to basic commands, higher ranks allow for more administrative interaction.
* Deposit money: <code>/town deposit (amount)</code>
====Default Resident Permissions====
* Claim or unclaim personal plots: <code>/plot claim</code>, <code>/plot unclaim</code>
All town members automatically have access to:
* Manage own plot settings: <code>/plot set perm</code>, <code>/plot set reset</code>
* Deposit money: <code>/t deposit (amount)</code>
* Use basic town functions: <code>/town spawn</code>, <code>/town leave</code>
* Town Spawn: <code>/t spawn</code>
* Town Lists: <code>/t list</code>
* Town Reclaim: <code>/t reclaim</code>  
* Leaving Town: <code>/t leave</code>


====Town Rank Overview====
====Town Rank Overview====
{| class="wikitable"
{| class="wikitable"
! Rank             !! Description                                                                 !! Key Abilities
! Rank             !! Description !! Example Permissions
|-
|-
| '''Mayor'''       || Town leader with full control.                                             || Invite/kick, claim land, set ranks, set taxes, withdraw funds. Tax-exempt.<br /><code>/town invite</code>, <code>/town claim</code>, <code>/town withdraw</code>
| '''Mayor'''     || The town’s leader with complete authority. Can manage claims, finances, ranks, and town settings. Always tax-exempt. || <code>/t set taxes</code><br /><code>/t claim</code>
|-
|-
| '''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.<br /><code>/town set mayor</code>, <code>/town delete</code>
|'''Co-Mayor''' || Shares all mayoral powers, but cannot delete the town or assign a new Mayor. Tax-exempt. || Manages residents, finances, plots, and invites.<br /><code>/t claim</code>, <code>/t withdraw</code>
|-
|-
| '''Deputy Mayor'''|| High-level assistant without destructive powers (e.g., can't delete town or assign mayors). Tax-exempt. || Most town management.<br /><code>/town set taxes</code>, <code>/town claim</code>
| '''Deputy Mayor''' || A trusted manager with broad authority, but restricted from critical changes like deletion or renaming. Tax-exempt. || <code>/t kick</code><br /><code>/t set name</code>
|-
|-
| '''Steward'''     || General administrator combining permissions of multiple specialized roles. || Plot, finance, invitation, and utility management.<br /><code>/town set plotprice</code>, <code>/town withdraw</code>
| '''Steward'''   || A general overseer with a blend of building, financial, and invitation rights. || <code>/t withdraw</code><br /><code>/t set plotprice</code>
|-
|-
| '''Land Manager'''|| Oversees claiming, unclaiming, and plot access.                           || <code>/town claim</code>, <code>/town unclaim</code>, <code>/plot set perm</code>
| '''Land Manager''' || Manages land claims and plot access across town plots. || <code>/t claim</code><br /><code>/plot set perm</code>
|-
|-
| '''Finance Manager'''|| Manages town economy including taxes and pricing.                       || <code>/town set taxes</code>, <code>/town withdraw</code>, <code>/town set plotprice</code>
| '''Finance Manager''' || Controls town taxes, plot pricing, and bank access. || <code>/t set taxes</code><br /><code>/t withdraw</code>
|-
|-
| '''Culture Manager'''|| Handles town culture-related settings and permissions.                 || <code>/town toggle</code>, <code>/town set name</code>
| '''Culture Manager''' || Handles town naming and ceremonial elements. || <code>/t set name</code><br /><code>/t toggle</code>
|-
|-
| '''Sheriff'''     || Responsible for jail and outlaw systems.                                   || <code>/town jail</code>, <code>/town outlaw</code>, <code>/town unjail</code>
| '''Sheriff'''   || Enforces town law through jail and outlaw systems. || <code>/t jail</code><br /><code>/t outlaw</code>
|-
|-
| '''Builder'''     || Trusted with general build access across town land.                       || <code>/plot set perm build on</code>, <code>/towny claimed townowned</code>
| '''Builder'''   || Granted general build rights on town-owned land. || <code>/plot set perm build on</code>
|-
|-
| '''Assistant'''   || Can invite/kick players, manage switches, and set unowned plots.           || <code>/town invite</code>, <code>/plot set</code>
| '''Assistant''' || Helps with resident management and minor plot settings. || <code>/t invite</code><br /><code>/plot set</code>
|-
|-
| '''Tax-Exempt''' || Assigned to residents who are exempt from town taxes.                     || <code>/towny tax_exempt</code>
| '''Tax-Exempt''' || Assigned to residents who are exempt from town tax. || <code>/t tax_exempt</code>
|}
|}


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


Line 241: Line 244:
* Visitors: Shown in the town’s info screen via <code>/t (town name)</code>.
* Visitors: Shown in the town’s info screen via <code>/t (town name)</code>.


==Closed/Open Town==
===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.
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.
 
<br>
====Open Towns====
If a town is set to open, any player can freely join using the command, <code>/t join (town name)</code>.
If a town is set to open, any player can freely join using the command, <code>/t join (town name)</code>.
Open towns are marked with <code>(Open)</code> next to their name in the town list displayed via: <code>/t list</code>
Open towns are marked with <code>(Open)</code> next to their name in the town list displayed via: <code>/t list</code>
<br>
Mayor, Co-mayor, Deputy Mayor can toggle their town’s status between open and closed at any time with: <code>/t toggle open</code>


====Changing AccessSettings ====
====Identifying Public Towns====  
Mayors can toggle their town’s status between open and closed at any time with: <code>/t toggle open</code>
 
=== Public and Private Towns ===
By default, all towns are set to '''private'''. This restricts teleportation to the town spawn—only the following players can access it:
- Town residents
- Members of the same nation
- Members of allied nations
If a town is set to '''public''', any player on the server can teleport to its town spawn.
==== Identifying Public Towns ====  
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.
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.
==== Changing Public Status ====  
==== Changing Public Status====  
To toggle between public and private status, use: <code>/t toggle public</code>
To toggle between public and private status, use: <code>/t toggle public</code>


==Town Taxes==
===Town Taxes===
Towns can apply multiple types of taxes to their residents and landowners. These taxes help manage town revenue and encourage active participation.
Towns can impose multiple types of taxes to sustain steward upkeep, encourage participation, and manage land ownership. Taxes apply daily and can be adjusted by town Mayor, Co-Mayor, Deputy Mayor, Steward, Financial Manager.
 
====Resident Tax====
====Resident Tax====
This is a general tax charged to all town members.
This is a general tax charged to all town members.
- Set using: <code>/t set taxes (amount or percentage)</code>
* Set using: <code>/t set taxes (amount or percentage)</code>
- Toggle flat vs. percentage mode: <code>/t toggle taxpercent</code>
* Toggle flat vs. percentage mode: <code>/t toggle taxpercent</code>
====Flat Tax====
'''Flat Tax'''<br>
* Charges a fixed amount from each resident's balance daily.
* Charges a fixed amount from each resident's balance daily.
** If a resident cannot pay, they are automatically removed from the town.
** If a resident cannot pay, they are automatically removed from the town.
====Percentage Tax====
'''Percentage Tax'''<br>
* Charges a percentage of each resident’s current balance.
* Charges a percentage of each resident’s current balance.
** Residents unable to pay are also removed.
** Residents unable to pay are also removed.
* Use <code>/t set taxpercentcap (amount)</code> to set a maximum tax limit.
* Use <code>/t set taxpercentcap (amount)</code> to set a maximum tax limit.
 
====Resident Plot Tax====
===Resident Plot Tax===
A per-plot tax charged to residents who own plots within the town.
A per-plot tax charged to residents who own plots within the town.
* Set using: <code>/t set plottax (amount)</code>
* Set using: <code>/t set plottax (amount)</code>
** If a resident cannot pay, ownership of the affected plots is revoked.
** If a resident cannot pay, ownership of the affected plots is revoked.
** Unpaid plots are automatically listed for sale.
** Unpaid plots are automatically listed for sale.
 
====Shop Plot Tax====
===Shop Plot Tax===
Tax applied specifically to plots containing shop signs or shops.
Tax applied specifically to plots containing shop signs or shops.
* Set using: <code>/t set shoptax (amount)</code>
* Set using: <code>/t set shoptax (amount)</code>
** Failure to pay results in loss of the shop plot.
** Failure to pay results in loss of the shop plot.
** Any shop signs are removed when the plot is lost.
** Any shop signs are removed when the plot is lost.
 
====Embassy Plot Tax====
===Embassy Plot Tax===
A tax applied to non-residents who own embassy plots in your town.
A tax applied to non-residents who own embassy plots in your town.
* Set using: <code>/t set embassytax (amount)</code>
* Set using: <code>/t set embassytax (amount)</code>
** If unpaid, the embassy plot is removed from the owner and returned to town control.
** If unpaid, the embassy plot is removed from the owner and returned to town control.
 
====Tax Stacking====
===Tax Stacking===
Taxes are additive. Below are common stacking examples:
Taxes are additive. Below are common stacking examples:
* A resident who owns a shop plot pays: Resident Tax + Plot Tax + Shop Plot Tax
* 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
* A non-resident who owns an embassy plot pays: Plot Tax + Embassy Plot Tax


==Titles and Surnames==
===Titles and Surnames===
Certain players with permissions in a town or nation can assign custom names to residents. These names appear in chat and consist of:
In both towns and nations, players with the appropriate permissions can assign custom titles and surnames to residents. These appear in chat and consist of:
* A title (prefix) appears before the player’s name.
*A title (prefix) displayed before the player’s name
* A surname' (suffix) appears after the player’s name.
*A surname (suffix) displayed after the player’s name
 
Both titles and surnames may be up to 15 characters long.


===Titles===
====Assigning Titles====
* Titles appear before a player's name in chat.
* They can be up to 15 characterslong.
====Granting a Title====
* Town Titles
* Town Titles
Granted by: Mayor or Co-Mayor
Granted by: Mayor, Co-Mayor or Deputy Mayor
Command: <code>/t set title (player) (title)</code>
Command:
<code>/t set title (player) (title)</code>
* Nation Titles
* Nation Titles
Granted by: Nation Leader or Co-Leader
Granted by: Nation Leader or Co-Leader
Command: <code>/n set title (player) (title)</code>
Command: <code>/n set title (player) (title)</code>


===Surnames===
====Assigning Surnames====
* Surnames appear after a player's name in chat.
* Granted by: Mayor, Co-Mayor, Deputy Mayor
* They can also be up to 15 characters long.
====Granting a Surname====
* Granted by: Mayor or Co-Mayor
* Command: <code>/t set surname (player) (surname)</code>
* Command: <code>/t set surname (player) (surname)</code>


===Removing a Title or Surname===
====Removing Titles and Surnames====
* Remove Town Title: <code>/t set title (player)</code>
* Remove Town Title: <code>/t set title (player)</code>
* Remove Nation Title: <code>/n set title (player)</code>
* Remove Nation Title: <code>/n set title (player)</code>
* Remove Surname: <code>/t set surname (player)</code>
* Remove Surname: <code>/t set surname (player)</code>


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


===How to Transfer Mayorship===
===How to Transfer Mayorship===
To assign a new Mayor, use the following command: <code>/t set mayor (new mayor's name)</code>
To assign a new Mayor, use the following command: <code>/t set mayor (player)</code>
Once the transfer is successful:
Once the transfer is successful:
- The selected resident becomes the new Mayor with full leadership powers.
* The selected resident becomes the new Mayor with full leadership powers.
* The previous Mayor is automatically demoted to a regular resident and loses all assigned town ranks.
* 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.
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.


== Deleting a Town ==
===Deleting a Town===
Deleting a town will cause the town to go into ruin and after 24 hours of run will be permanent deleted. The following will be deleted when the town gets deleted.
Deleting a town will cause the town to go into ruin and after 24 hours of being in ruin will be permanent deleted. The following will be deleted when the town gets deleted.
* Name and identity
* Name and identity
* Claimed land
* Claimed land
Line 347: Line 334:
**Only the Mayor has the authority to delete the town.
**Only the Mayor has the authority to delete the town.
==== How to Delete a Town ====
==== How to Delete a Town ====
To delete your town, follow these steps:
To delete your town:
* Withdraw funds first. Any money left in the town bank will be permanently lost. Use: <code>/t withdraw (amount)</code>
* 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>
* Delete the town: <code>/t delete</code>
* Then confirm with: <code>/confirm</code>
* Then confirm with: <code>/confirm</code>
After confirmation, the town enters a ruin period, where its former territory can be reclaimed or looted by others.


After confirmation, the town enters a ruin period, where its former territory can be reclaimed or looted by others/
===Town Ruin Period===
 
When a town falls into ruin, whether due to inactivity or deletion, it enters a 24-hour ruin period. During this time:
Certainly! Here's a refined and MediaWiki-friendly version with improved clarity and structure:
* All town Stewards are downgraded to Level 1, except for the Bailiff.
 
== Town Ruin Period ==
When a town falls into ruin, whether due to inactivity or manual deletion, it enters a 24-hour ruin period. During this time:
* PvP is automatically enabled across all town claims.
* All town Stewards are downgraded to Level 1.
* If the town is not reclaimed within 24 hours, it is permanently deleted, and all data (bank, claims, residents, etc.) is lost.
* If the town is not reclaimed within 24 hours, it is permanently deleted, and all data (bank, claims, residents, etc.) is lost.
 
====Reclaiming a Ruined Town====
==== Reclaiming a Ruined Town ====
Former residents may reclaim a ruined town during the 24-hour window using:
Former residents may reclaim a ruined town during the 24-hour window using:
<code>/t reclaim</code>
<code>/t reclaim</code>
Line 368: Line 350:
* The player who reclaims the town becomes the new Mayor.
* The player who reclaims the town becomes the new Mayor.
* Upon reclaim:
* Upon reclaim:
** PvP is disabled across all town claims.
** The town is fully restored under the new leadership.
** The town is fully restored under the new leadership.
** A 7-day activity grace period begins.
** A 7-day activity grace period begins.