Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
plugins:towny [2025/02/02 23:25] – created jasper | plugins:towny [2025/03/07 00:34] (current) – created wingurr | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Towny (The Plugin) | + | ====== Towny Commands |
- | Towny is a land protection and town/nation simulation plugin that allows players to create, protect, and manage towns, own land, and form nations and alliances. | + | ===== /towny ===== |
- | This Guide is meant to describe each of the Towny plugin' | ||
- | The Towny plugin works in **1 real-life-day** intervals. When this interval begins, it is publicly announced in chat. This is called a **__Towny day__** . You can view the timer by using ''/ | + | Here are the basic Towny commands. |
- | ===== Town Basics ===== | + | |
- | Before diving into how to make your town, let's get familiar with what the Towny plugin | + | * ? - Shows more of the Towny commands. |
+ | * prices - Shows the taxes and costs tied to running a town. | ||
+ | * time - Shows time until a new day has become. A new day = tax / upkeep collection. | ||
+ | * map - Shows the Towny Map (it is shown as chunk markers). | ||
+ | * top residents (all/ | ||
+ | * top land (all/ | ||
+ | * top balance (all/ | ||
- | ==== Introduction | + | ===== /plot ===== |
- | A **chunk** is a 16x16 portion of the world that extends infinitely in the vertical direction. All chunks in the world are **Wilderness** by default, in which **all** players in the server can build; destroy; access doors, chests, etc. PvP is also permanently enabled in Wilderness. //Tip: Press F3 + G to view chunk borders//. | ||
- | A **town** is a collection of players, called **residents**, | ||
- | Each town has a **Mayor** who is the owner of a town, and has access to all town plots in their own town as well as all commands | + | Here are the /plot commands. |
- | The **town bank** is a town's virtual storage | + | |
+ | | ||
+ | | ||
+ | | ||
+ | * unclaim circle/rect – unclaim owned plots in a circle or rectangle shape. | ||
+ | * unclaim (# (radius around current position)) – Radius of area to unclaim. | ||
+ | * forsale/fs [amt] – Set a plot for sale. | ||
+ | * forsale/fs circle/rect – Set a shape. | ||
+ | * forsale/fs (# (radius around current position)) – Radius of area to set forsale. | ||
+ | * notforsale/ | ||
+ | * set reset – Sets a shop/ | ||
+ | * set shop – Sets a plot to a shop plot. | ||
+ | * set embassy – Sets a plot to an embassy plot. | ||
+ | * set arena – Sets a plot to an arena plot. | ||
+ | * set wilds – Sets a plot to a wilds plot. | ||
+ | * set inn – Set a plot to an inn plot. | ||
+ | * set name – allows a mayor or plot-owner to rename plots they own, overwriting | ||
+ | * perm – Shows the permission of the plot that the player is standing on | ||
+ | * set perm (resident/ | ||
+ | * set perm (build/ | ||
+ | * set perm (resident/ | ||
+ | * set perm reset – Resets the plot in which you are standing on to the original perms | ||
+ | * toggle | ||
+ | * toggle fire – Turn on/off firespread in the plot in which you stand. Please note this will have no effect, as firespread is disabled serverwide. | ||
+ | * toggle pvp – Turn on/off pvp in the plot in which you stand. | ||
+ | * toggle explosion – Turn on/off explosions in the plot in which you stand. | ||
+ | * toggle mob – Turn on/off hostile mobspawning in the plot in which you stand. | ||
- | A **nation** is a collection of towns, (at least 1) and residents of all towns in the nation are its **nation members**. | + | ===== /resident ===== |
- | ==== Town Creation & Inviting Players | + | |
- | To **create** your town, use ''/ | + | Here shows the player their resident screen. |
- | * Costs $? in Towny. | + | |
- | * Costs $? in Nations. | + | * (resident) – Shows a player another player’s resident screen. |
+ | * friend add (resident) – Resident adds online player to their friends list. | ||
+ | * friend add+ (resident) – Resident adds offline player to their friends list. | ||
+ | * friend remove (resident)– Resident removes online player from their friends list. | ||
+ | * friend remove+ (resident)– Resident removes offline player from their friends list. | ||
+ | * friend clearlist – Removes all friends from a resident’s friend list. | ||
+ | * toggle map – Turns on map which refreshes when moving across plot borders. | ||
+ | * toggle townclaim – Turns on mode where /town claim is automatically used when moving across plot borders. | ||
+ | * toggle plotborder – Turns on smokey plot-border view. Border shows when players cross to different townblocks. | ||
+ | * toggle reset – This turns off all modes that are active. | ||
+ | * set perm (friend/ | ||
+ | * set perm (build/ | ||
+ | * set perm (friend/ | ||
+ | * set perm reset – This takes the perm line seen in the /resident screen and applies it to all plots personally owned by the player typing it. | ||
- | You are also assigned the Mayor of your town after creating it. You can change your town's name with ''/ | + | ===== /town ===== |
- | **Invite** another | + | Here shows the player |
- | Any resident | + | * ? – Shows /town commands available. |
+ | * (town) – Shows a player another town’s town screen. | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | * spawn – Teleports you to your town’s spawn. | ||
+ | * spawn (town) – Teleports you to another town’s spawn. This town will need to be in your nation. | ||
+ | * claim – claims | ||
+ | * claim outpost – Claims an outpost for your town. | ||
+ | * claim (# (radius around current position)) – Claims an area of townblocks around you | ||
+ | * claim auto – Claims as many townblocks around you as is possible given Money in townbank and available townblocks. | ||
+ | * unclaim – Mayor command to unclaim the townblock in which you stand. | ||
+ | * unclaim all – Mayor command to unclaim all townblocks. | ||
+ | * unclaim (# (radius around current position)) – Command to unclaim an area of townblocks around you. | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | * rank (add|remove) (playername) | ||
+ | * reslist – See a full list of residents in your town. | ||
+ | * set board (message) – Sets message seen by residents upon logging in. | ||
+ | * set mayor (resident) – Mayor command to give mayor status to another resident. | ||
+ | * set homeblock – Sets the homeblock and spawn of your town. | ||
+ | * set spawn – Sets the town spawn, must be done inside the homeblock. | ||
+ | * set name (name) – Change | ||
+ | * set outpost – Sets a townblock as an outpost. | ||
+ | * set perm (resident/ | ||
+ | * set perm (build/ | ||
+ | * set perm (resident/ | ||
+ | * set perm reset – This takes the perm line seen in the /town screen and applies it to all plots owned by the town. | ||
+ | * toggle mobs – Turn on/off hostile mobspawning in town. | ||
+ | * toggle public – Turn on/off the co-ordinates of the town’s homeblock in the /town screen. | ||
+ | * toggle pvp – Turn on/off pvp in town. | ||
- | Towns don't allow access to its claims for anyone outside your town, only your own town's residents. If you don't like your residents messing with the town either, now is a good time to deny them from accessing it too by simply doing ''/ | + | ===== /nation ===== |
- | + | ||
- | ==== Claiming | + | |
- | + | ||
- | **Claiming** (or “annexing”) is the process of taking a chunk from Wilderness and adding it into your town, in order to expand and protect your land. All chunks that your town has claimed are called **claims** or **town plots**. At the moment of creating a town, you claim the chunk you are standing on. | + | |
- | + | ||
- | To **claim** a chunk, type '' | + | |
- | + | ||
- | * Costs $9 in Towny. | + | |
- | * Costs $9 in Nations, and 0.5% is added to the price per chunk claimed. | + | |
- | + | ||
- | In order to claim a chunk that is not adjacent to your existing claims, type ''/ | + | |
- | + | ||
- | * Costs $540 in Towny. | + | |
- | * Disabled in Nations. | + | |
- | + | ||
- | You can then claim adjacent chunks by typing ''/ | + | |
- | + | ||
- | * In **Towny only**, you gain 1 available chunk by being in a nation. The number of separate town outposts you can claim increases with the total number of nation members in the nation. This is called the **outpost bonus**. The exact values for it are listed at the end of this Guide. | + | |
- | + | ||
- | To **remove**/ | + | |
- | + | ||
- | There is a limit on the number of claims that a town may own at any point. That limit is determined by the town size. | + | |
- | + | ||
- | ==== Town Size ==== | + | |
- | + | ||
- | **Town size **is the number of a town's claims over the maximum number of claims it can have. You can view town size in your town information screen (''/ | + | |
- | + | ||
- | * The **__resident bonus__** : The number of residents in your town. | + | |
- | * The **__town bonus__** : Buying available chunks using ''/ | + | |
- | * Costs $50 per available chunk in Towny. | + | |
- | * Costs $9 per available chunk, and 1% is added to the price per bought chunk after the first, in Nations. | + | |
- | * The **__nation bonus__** : The number of nation members in your nation. | + | |
- | + | ||
- | Losing residents from your town and losing nation members from your nation means you also lose the respective claim bonuses from your town size. | + | |
- | + | ||
- | The exact values for town size and claim bonuses are listed at the very bottom of this Guide. | + | |
- | + | ||
- | ==== Town Upkeep ==== | + | |
- | + | ||
- | Town upkeep is the amount of money that the server automatically removes from your town bank at the start of each Towny day, so that the town can continue to exist. Not having enough money in the town bank to pay upkeep means that your town will fall. More town plots means higher town upkeep to pay each day. | + | |
- | + | ||
- | * $6 per town plot in Towny. | + | |
- | * $1 per town plot in Nations. | + | |
- | * $5.75 per town plot that is an overclaim in Nations. If your town has more claims than the maximum possible (this usually happens when you lose residents or nation members) then the additional chunks over the limit are called **overclaims**. | + | |
- | + | ||
- | In Towny, residents can use ''/ | + | |
- | + | ||
- | In Nations, the above command can only be used while standing in your own town's homeblock or bank plots (these concepts are explained later in this Guide). | + | |
- | + | ||
- | Generally, it is important to plan your town while also considering town upkeep. A very large town with unnecessary claims will be unnecessarily expensive, compared to a smaller and more organized town. | + | |
- | + | ||
- | ==== Buying & Owning Plots ==== | + | |
- | + | ||
- | Every resident of your town—including the Mayor—can own town plots, where they can have their space to build on and use, as much space as the Mayor can or wants to give, that other residents cannot normally access. The town plots that a resident owns are called their **resident plots**. Residents have full access to their own resident plots, and all commands for them. Residents can own multiple and separated resident plots. | + | |
- | + | ||
- | Residents have to **buy** a town plot first, to make it their own resident plot. | + | |
- | + | ||
- | * First, the Mayor must sell a town plot by using ''/ | + | |
- | * Then, a resident (or the Mayor) can type ''/ | + | |
- | + | ||
- | To withdraw a plot from sale, you may type ''/ | + | |
- | + | ||
- | A resident can use ''/ | + | |
- | + | ||
- | Residents owning their own land is a necessary feature of any town, because the land residents use to build and protect their items on, is differentiated from the public town land. A **well-organized town** will generally allow each resident to have their resident plots in convenient locations around the town, with all of their resident plots close or next to each other. This is strongly advisable for easier town management! | + | |
- | + | ||
- | ==== Town Spawn ==== | + | |
- | + | ||
- | Every town has a **homeblock** that exists because towns must always have at least one chunk claimed. When creating a town, the chunk you are standing on becomes the first homeblock, and your exact position becomes the first **town spawn**. The town spawn is located within the homeblock chunk and it is indicated by particles on the ground. | + | |
- | + | ||
- | * In Towny, you can teleport back to your town spawn by typing ''/ | + | |
- | * In Nations, you teleport to your town spawn after dying. | + | |
- | + | ||
- | The location of the homeblock as well as the town spawn can be changed by the Mayor. To change the location of the homeblock, and where in your town people teleport to when using ''/ | + | |
- | + | ||
- | The homeblock is an equivalent to the concept of the “town center”. The location of the town spawn and homeblock are best suited to a central place in the town, where residents have fast access to the rest of the town. | + | |
- | + | ||
- | ===== Joining a Nation ===== | + | |
- | + | ||
- | Being part of a nation is beneficial to towns for many reasons. Towns that have joined one can have extra protection from outsiders, are given more chunks to claim, and granted a variety of other gameplay benefits related to economy, influence, communication and community. A town that has joined a nation may also have to pay a daily **town nation tax**—in addition to upkeep—from its town bank. The town nation tax that your town pays every day is set by your nation' | + | |
- | + | ||
- | Generally, your town can join a nation after being invited. The Mayor may accept a nation invitation by typing ''/ | + | |
- | + | ||
- | On the other hand, if you do not wish to join a different nation, you can always make your own! Creating and managing nations is covered later in this Guide. | + | |
- | + | ||
- | ====== Permissions ====== | + | |
- | + | ||
- | Every claim has **permissions**, | + | |
- | + | ||
- | * By default, when **claiming** a chunk from Wilderness, its permission settings will allow the town's residents to have all permission types in it. | + | |
- | * By default, when **buying** a town plot, its permission settings will allow players in your friend list to have all permission types in it. | + | |
- | + | ||
- | You can view a town's permission settings on its town information screen. You can view an individual claim' | + | |
- | + | ||
- | While viewing permissions, | + | |
- | + | ||
- | ===== Configuring Permissions ===== | + | |
- | + | ||
- | Permission types, permission levels, and permission categories are explained below. \\ | + | |
- | + | ||
- | Permission Types | + | |
- | + | ||
- | Each of the 4 permission types are related to different actions. | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | ===== Permission Levels ===== | + | |
- | + | ||
- | Permission levels are similar to the notion of groups, and they have a hierarchy. Unowned town plots have different permission levels from resident plots (owned town plots). | + | |
- | + | ||
- | Town permission levels apply to **unowned town plots**: | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | Plot permission levels apply to **resident plots**: | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | ===== Permission Categories ===== | + | |
- | + | ||
- | There are 4 categories of permissions to configure. Each category applies to certain town plots. | + | |
- | + | ||
- | **General town permissions **and** individual town permissions** apply to **unowned town plots**. **Resident permissions** and **plot permissions** apply to **resident plots**. Town permissions become resident/ | + | |
- | + | ||
- | Configure **general town permissions** for **all unowned** town plots in the town by using ''/ | + | |
- | + | ||
- | * General town permissions also apply when claiming a chunk from Wilderness. \\ | + | |
- | + | ||
- | Configure **individual town permissions** for the **unowned** town plot you are standing on by using ''/ | + | |
- | + | ||
- | * Individual town permissions __override__ general town permissions—this practically means that configuring general town permissions, | + | |
- | + | ||
- | Configure **resident permissions** for **all** your owned **resident plots** by using ''/ | + | |
- | + | ||
- | * Resident permissions also apply when buying a town plot. \\ | + | |
- | + | ||
- | Configure **plot permissions** for the **resident plot** you are standing on by using ''/ | + | |
- | + | ||
- | * Plot permissions __override__ resident permissions—this practically means that configuring resident permissions, | + | |
- | + | ||
- | ===== Trusting ===== | + | |
- | + | ||
- | Trusting allows you to grant all permission types (build, destroy, switch, itemuse) for any claim in your town, to any player in the server. | + | |
- | + | ||
- | **Town trusting**: To trust a player with **all** claims of your town, use ''/ | + | |
- | + | ||
- | * Trusting a player with this command gives them permissions that are **equal to Mayor permissions**; | + | |
- | + | ||
- | **Plot trusting**: To trust a player with the town plot you are standing on, use ''/ | + | |
- | + | ||
- | Removing a player from being trusted does not necessarily mean that they stop having access to the town or the town plot. It means that the permissions you have configured for the town plot, will apply for them again. \\ | + | |
- | + | ||
- | ===== Per-Player Permissions ===== | + | |
- | + | ||
- | You can also allow specific players in the server to have, or deny specific players from having certain permissions in a town plot. The town plot can either be an unowned town plot or a resident plot. | + | |
- | + | ||
- | To add a player to this configuration, | + | |
- | + | ||
- | After adding a player, you may use ''/ | + | |
- | + | ||
- | * A grey option (**default**) means that the town plot's current town/plot permission settings apply for the player. | + | |
- | * A green option (**allowed**) means that the player is given the permission type in the town plot, regardless of the permission settings in it. | + | |
- | * A red option (**denied**) means that the player is **not** given the permission type in the town plot, regardless of the permission settings in it. | + | |
- | + | ||
- | After editing permissions, | + | |
- | + | ||
- | Removing a player from the per-player permissions does not necessarily deny them all permission types in the town plot. It means that the permissions you have configured for the town plot, will apply for them again. \\ | + | |
- | + | ||
- | ===== Resetting Permissions ===== | + | |
- | + | ||
- | You can apply the current general town permissions to every **unowned** **town** **plot** in your town, by using ''/ | + | |
- | + | ||
- | You can apply your current resident permission settings to every **resident plot** that you own, by using ''/ | + | |
- | + | ||
- | You can apply your current resident permission settings (if the plot is owned by a resident, or by you) or the current town permission settings (if the town plot is unowned) to the plot you are standing on, by using ''/ | + | |
- | + | ||
- | Resetting permissions does not remove trusted players, and it does not reset per-player permission settings. | + | |
- | + | ||
- | ====== Managing the Town ====== | + | |
- | + | ||
- | Use ''/ | + | |
- | + | ||
- | **__Town Information Screen__ ** | + | |
- | + | ||
- | * Town Tier | + | |
- | * Open Town (shows nothing if Closed) | + | |
- | * Public Town & Chunk Coordinates of Homeblock (shows nothing if Private) | + | |
- | * PvP setting (shows nothing if PvP disabled) | + | |
- | * Town Board | + | |
- | * Date of Founding | + | |
- | * Town Size & Outposts | + | |
- | * General Town Permissions | + | |
- | * Town Toggles | + | |
- | * Town Bank | + | |
- | * Town Upkeep | + | |
- | * Resident tax | + | |
- | * Nation that the town is in | + | |
- | * Residents & their Town Ranks | + | |
- | * Town-Trusted Players | + | |
- | + | ||
- | **-** In Nations, the town information screen will also display: | + | |
- | + | ||
- | * Debt Cap | + | |
- | * Occupation Status | + | |
- | * Peacefulness Status | + | |
- | * Occupying Nation | + | |
- | * Culture | + | |
- | * Town Resource Extraction | + | |
- | * Resources automatically extracted per Towny day (Daily Production) | + | |
- | * Resources Available for Collection | + | |
- | * Siege Information | + | |
- | * Siege Type | + | |
- | * Siege Status | + | |
- | * Attacking Nation | + | |
- | * Defending Nation | + | |
- | * Total Siege Points (Balance) & Pending Battle Points | + | |
- | * Siege Banner Coordinates | + | |
- | * Siege Deposit | + | |
- | * Plunder Status | + | |
- | * Victory Timer | + | |
- | * Immunity Timer | + | |
- | * Battle Information | + | |
- | * Banner Control List | + | |
- | * Battle Points | + | |
- | * Time Remaining until active Battle Session ends | + | |
- | + | ||
- | ===== Town Ranks ===== | + | |
- | + | ||
- | In a town, residents may have ranks to indicate their relative positions in the town. Each rank has access to different powers. | + | |
- | + | ||
- | When a resident joins a town, they do not have a town rank. All residents of a town can deposit money into the town bank, own town plots, change the plot permissions of their own resident plots, and rename their own resident plots. | + | |
- | + | ||
- | The Mayor and Comayors have the ability to use ''/ | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | Builders can: | + | |
- | + | ||
- | * Build and destroy in any town plot not owned by a resident. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | Police can: | + | |
- | + | ||
- | * Send residents to jail. | + | |
- | * Remove players from a jail. | + | |
- | * Declare or remove outlaws. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Police. Additionally, | + | |
- | + | ||
- | * Assign the '' | + | |
- | * Manage jail cells. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | Recruiters can: | + | |
- | + | ||
- | * Invite players to the town. | + | |
- | * Revoke invites to the town. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Recruiter. Additionally, | + | |
- | + | ||
- | * Kick residents from the town. | + | |
- | * Set town plots for sale or not for sale. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | Planners can: | + | |
- | + | ||
- | * Set town plots for sale or not for sale. | + | |
- | * Remove a resident' | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Builder, Recruiter, and Planner. Assistants have every town and plot permission in every town plot of their town. Additionally, | + | |
- | + | ||
- | * Toggle the town as open or closed. | + | |
- | * Claim chunks from Wilderness. | + | |
- | * Change the town board. | + | |
- | * Set the plot type of a town plot. | + | |
- | * Change permissions in town plots owned or not owned by a resident | + | |
- | * Manage plot groups. | + | |
- | * Rename all town plots, owned or not owned by a resident. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Police and Assistant. Additionally, | + | |
- | + | ||
- | * Withdraw money from the town bank. | + | |
- | * Unclaim chunks from the town. | + | |
- | * Manage trusted players in any town plot or the entire town. | + | |
- | * Change the homeblock and town spawn location. | + | |
- | * Give any town rank to other residents (except Mayor). Comayors cannot remove their own Comayor rank. | + | |
- | * Set and change town taxes. | + | |
- | * Buy extra town claims. | + | |
- | * Add a title or surname to another resident or themselves, and remove it. | + | |
- | * Set the town tag shown in chat. | + | |
- | * Change the town name. | + | |
- | * View the bank history of the town bank. | + | |
- | * Add the town to an open nation. | + | |
- | * Remove their own town from the nation it is part of. A capital town cannot be removed unless another town in the nation is set as a capital town, or the nation is deleted. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Comayor. Additionally, | + | |
- | + | ||
- | * **Delete the town.** | + | |
- | * Create a nation. | + | |
- | * Accept an invite for the town to join a nation. | + | |
- | * Remove Comayor rank from a resident. | + | |
- | * Give Mayor rank to another resident. The current Mayor will have no ranks after giving their mayorship. | + | |
- | + | ||
- | Certain ranks have distinct powers. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Residents with the Taxfree rank do not pay town taxes. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Administrator is used to denote a player that has access to a Naval Town in Nations. | + | |
- | * Has build and destroy permissions in a Naval Town. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Town Military rank with no other special privileges, for Nations. | + | |
- | + | ||
- | ===== Town Board ===== | + | |
- | + | ||
- | You can set a custom message for your town, called the **town board**. Use ''/ | + | |
- | + | ||
- | * The town's residents can view the town board when they enter the server, and in the town information screen. | + | |
- | * Other players can view your town board in your town's town information screen (''/ | + | |
- | * Anyone can view the town board in the Dynamic map. | + | |
- | + | ||
- | To remove a town board, type ''/ | + | |
- | + | ||
- | ===== Closed/Open Town ===== | + | |
- | + | ||
- | All towns are **closed** (invite-only) by default. Players can only join a closed town after being invited by a resident in the town. If the town is open, any player can join that town by using ''/ | + | |
- | + | ||
- | To switch between your town being open or closed, use ''/ | + | |
- | + | ||
- | ===== Private/ | + | |
- | + | ||
- | All towns are **private** by default. A private town only allows its residents, nation members, and allied nation members to teleport to its town spawn. If the town is public, any player on the server can teleport to its town spawn. If the town is public, it is denoted by '' | + | |
- | + | ||
- | To switch between your town being private or public, use ''/ | + | |
- | + | ||
- | The cost of outsiders teleporting to the town spawn of a public town can be set by using ''/ | + | |
- | + | ||
- | In **Towny only**, players may teleport to a public town's town spawn by using ''/ | + | |
- | + | ||
- | ===== Town Taxes ===== | + | |
- | + | ||
- | Town taxes are an amount of money collected from residents at the start of each Towny day. Money is transferred from the balance of residents (excluding residents with the Taxfree, Assistant, Comayor and Mayor rank) to the town bank. Residents can view the taxes they pay every Towny day, by typing ''/ | + | |
- | + | ||
- | 1) **Resident tax** | + | |
- | + | ||
- | Resident tax is a tax on residents for being part of your town. Set it by using ''/ | + | |
- | + | ||
- | The type of resident tax collected can be toggled with ''/ | + | |
- | + | ||
- | * **Percentage tax** means that resident tax is collected as a percentage of the resident' | + | |
- | * **Flat tax** means that resident tax is a fixed amount of money from the resident' | + | |
- | 2) **Resident plot tax** | + | |
- | + | ||
- | Resident plot tax (or simply “plot tax”) is a tax on residents, per resident plot they own. Set it by using ''/ | + | |
- | + | ||
- | 3) **Shop plot tax** | + | |
- | + | ||
- | Shop plot tax is a tax on residents, per shop plot they own. Set it by using ''/ | + | |
- | + | ||
- | 4) **Embassy plot tax** | + | |
- | + | ||
- | Embassy plot tax is an additional tax on players, per embassy plot they own inside your town. Set it by using ''/ | + | |
- | + | ||
- | Resident plot tax is separate from shop plot tax and embassy plot tax. An embassy plot owner pays resident plot tax and embassy plot tax to your town. A shop plot owner pays resident plot tax and shop plot tax to your town. \\ | + | |
- | + | ||
- | ===== Town & Plot Toggles ===== | + | |
- | + | ||
- | Toggles change gamerules in the plot(s) they are applied to. | + | |
- | + | ||
- | To enable or disable a toggle type in all plots in your town (town toggle) use ''/ | + | |
- | + | ||
- | Toggle types: | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | You can view town toggles in the town information screen. You can view an individual town plot's plot toggles by typing ''/ | + | |
- | + | ||
- | === Resident Toggles === | + | |
- | + | ||
- | Resident toggles are the plot toggles automatically applied to your resident plots once you buy them. You can change your resident toggles by using ''/ | + | |
- | + | ||
- | ===== Plot Types ===== | + | |
- | + | ||
- | There can be different types of plots with various uses in your town. By default, when you claim a chunk from Wilderness it becomes a **default plot**: a town plot that has no special use, other than being claimed by the town. | + | |
- | + | ||
- | * Default plots can be sold to and bought by a resident of the town; meaning, they can become resident plots. | + | |
- | * Default plots can stop being resident plots when one of the following takes place: | + | |
- | * The resident plot owner does not have enough money to pay resident plot tax and loses ownership of the plot. | + | |
- | * The resident plot owner removes their own ownership of the plot by using ''/ | + | |
- | * The Mayor, a Comayor or an Assistant removes the resident' | + | |
- | + | ||
- | To set the plot type of an unowned town plot in your town, use ''/ | + | |
- | + | ||
- | Plot types: | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | * //This is used in Nations// | + | |
- | * '' | + | |
- | * Owned embassy plots still function exactly as resident plots (except in taxes). | + | |
- | * '' | + | |
- | * Plant and destroy crops, plants, and trees | + | |
- | * Kill and breed cows, pigs, sheep, chicken, and mooshroom | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * Owned shop plots still function exactly as resident plots (except in taxes). | + | |
- | + | ||
- | To reset a plot back to a default plot, use ''/ | + | |
- | + | ||
- | You can view your town's plot types (as well as other information such as town size, estimated daily revenue from the town plots, etc.) by typing ''/ | + | |
- | + | ||
- | ===== Law Enforcement ===== | + | |
- | + | ||
- | Players can be punished by ranked town members for their lawless behavior and sent to jail. Jails can be managed by residents with the **Police**, **Sheriff**, | + | |
- | + | ||
- | ==== Jail Setup ==== | + | |
- | + | ||
- | You may set up jail cells for unlawful players to be jailed in. These jails must be secured within rooms in your town, so that the players may not escape. Jail plots are plots where jail cells may be placed. A jail cell is any set block/ | + | |
- | + | ||
- | First, you will need to set a town plot as a jail plot by using ''/ | + | |
- | + | ||
- | Jails and jail cell numbers are ordered ascendingly through time, but removing any will result in all numbers of jail plots or jail cells after the one removed to decrease by 1. | + | |
- | + | ||
- | * The first jail plot set is jail plot number '' | + | |
- | * The first jail cell set in each jail plot is jail cell number '' | + | |
- | + | ||
- | You may view all jail plots along with their **number**, name, as well as their number of jail cells, by typing ''/ | + | |
- | + | ||
- | ==== Outlaws ==== | + | |
- | + | ||
- | **Outlaws** are unlawful outsiders to a town, who must be caught by that town's residents. Their entrance to the town is not welcome, and as such they may be attacked and/or jailed, they cannot teleport to the spawn of the town that they are outlawed in, and they cannot join the town if it is an Open town. If a town declares a resident as an outlaw, that resident will also be kicked from the town. | + | |
- | + | ||
- | The list of outlaws may be declared by the Police, Sheriff, Comayors and Mayor of a town. They can add or remove outlaws by using ''/ | + | |
- | + | ||
- | * Outlaws of a town can be viewed by using ''/ | + | |
- | + | ||
- | ==== Imprisonment ==== | + | |
- | + | ||
- | The jail plot number '' | + | |
- | + | ||
- | The primary jail cell is where all outlaws are sent when caught, and where all jailed residents go, when no jail is specified in the command used to jail residents. | + | |
- | + | ||
- | To send a resident to jail, you may use the ''/ | + | |
- | + | ||
- | * If the command only includes the resident' | + | |
- | * If the command includes the resident' | + | |
- | * If the command includes the resident' | + | |
- | * If the command includes all parameters shown above—the resident will be sent to the given jail cell in the given jail plot, for the specified number of real-life hours. | + | |
- | + | ||
- | ==== Leaving Jail ==== | + | |
- | + | ||
- | A jailed resident may automatically exit the jail when the number of hours they were jailed for, pass. | + | |
- | + | ||
- | They may also be manually released from jail by a Police, Sheriff, Comayor, or Mayor using ''/ | + | |
- | + | ||
- | Outlaws must pay an amount of money in order to leave the jail, but residents can also choose to end their jail time prematurely, | + | |
- | + | ||
- | * In Towny, the bail is $20 for a regular player, $50 for a Mayor, and $100 for a Leader (all mutually exclusive). | + | |
- | * In Nations, the bail is $128 for a regular player, $256 for a Mayor, and $1,024 for a Leader (all mutually exclusive). | + | |
- | + | ||
- | ===== Transferring Mayorship ===== | + | |
- | + | ||
- | A Mayor can renounce their high position and give the title and powers of the Mayor rank to another resident of the town, by using ''/ | + | |
- | + | ||
- | The previous Mayor will not have any town ranks after giving up Mayorship. | + | |
- | + | ||
- | //If you are considering passing Mayorship to another player, only give it if you absolutely need to, and if you fully trust that person with the town//! \\ | + | |
- | + | ||
- | ===== Town Deletion ===== | + | |
- | + | ||
- | Deleting a town means removing the name, claims, residents, money in town bank, and everything associated with the town from the server. | + | |
- | + | ||
- | **Only the Mayor is able to delete their town**. As the Mayor, you may use ''/ | + | |
- | + | ||
- | * Make sure your entire town bank is withdrawn to your balance by using ''/ | + | |
- | + | ||
- | ===== Ruins (Nations only) ===== | + | |
- | + | ||
- | After a town falls—either due to being manually deleted, or due to lack of enough money for upkeep in the town bank—it enters **ruin mode** for 72 hours. PvP is also enabled in all of its claims. If the 72 hours end, called the **ruin timer**, then the town is automatically **deleted**. The ruin timer can be viewed in the town information screen. | + | |
- | + | ||
- | During ruin mode, and after 5 hours have passed after the town falling, any resident of the town can reclaim the town for $288 from their balance, using ''/ | + | |
- | + | ||
- | ===== Town Bankruptcy (Nations only) ===== | + | |
- | + | ||
- | After the money in the town bank of a town with the Town tier or higher, or Homestead tier, reaches 0 (due to upkeep/ | + | |
- | + | ||
- | The town's bank will keep going below 0 as money is taken from it due to upkeep or nation taxes. The town bank's value below 0 during bankruptcy mode is called its **debt**. The debt limit or **debt cap** is the maximum possible debt that a town under bankruptcy mode may have before falling, and it is calculated by the number of claims that the town owns. The debt cap is visible in the town information screen. Towns of the Homestead tier have a tiny debt cap, while higher tier towns will have a larger debt cap depending on their tier. | + | |
- | + | ||
- | During bankruptcy mode, a town faces a few restrictions. | + | |
- | + | ||
- | * The town cannot claim more chunks from Wilderness. | + | |
- | * More residents cannot be added to the town. | + | |
- | * No resident, including the Mayor, has **build** permissions inside the town's claims. Any other permissions are **unchanged**, | + | |
- | + | ||
- | To exit bankruptcy mode, enough money to remove the debt must be deposited in the town bank (''/ | + | |
- | + | ||
- | //The table of town tiers is at the end of this Guide//. | + | |
- | + | ||
- | ====== Plot Functions ====== | + | |
- | + | ||
- | There exist some commands and features that are strictly related to non-specific, | + | |
- | + | ||
- | Use ''/ | + | |
- | + | ||
- | **__Plot Information Screen__ ** | + | |
- | + | ||
- | * Chunk Coordinates | + | |
- | * Resident Plot Owner (if resident plot) / Town Name (if unowned town plot) | + | |
- | * Permission Settings | + | |
- | * Toggle Settings | + | |
- | * Plot Group name & total town plots in Plot Group (if in a plot group) | + | |
- | * Plot-Trusted Players * | + | |
- | + | ||
- | Wilderness chunks have a separate plot information screen called the Towny world screen, that shows applied gamerules and permissions enabled for all players in Wilderness, the world' | + | |
- | + | ||
- | * = //If a player is town-trusted (meaning, they have access to that plot, but at the town level and not for that specific plot only) then they will **__not__** | + | |
- | + | ||
- | ===== Plot Groups ===== | + | |
- | + | ||
- | Plot groups allow residents to easily manage multiple town plots at once, such as permissions and plot selling. Town staff can create plot groups and include any town plot in them, as well as manage any plot group within the town. Other residents can only include their own resident plots in a plot group and manage plot groups that only include their resident plots. | + | |
- | + | ||
- | There can exist multiple plot groups within a town. You can view a list of all plot groups within your town by typing ''/ | + | |
- | + | ||
- | **All** plot group commands only work while standing inside any plot of the plot group (the exception is adding a plot into a plot group). \\ | + | |
- | + | ||
- | ==== General ==== | + | |
- | + | ||
- | To include a town plot of your town in a plot group, use ''/ | + | |
- | + | ||
- | * Including town plots that are for sale into the plot group will add their for sale price into the plot group' | + | |
- | + | ||
- | The name of an existing plot group can be changed by using ''/ | + | |
- | + | ||
- | To remove the town plot you are standing on from the plot group, use ''/ | + | |
- | + | ||
- | ==== Management ==== | + | |
- | + | ||
- | Plot group management commands are equivalent to plot commands and work in a similar way to them. However, plot group management commands apply for **all** plots in the plot group you are standing on (as opposed to only the one town plot you are standing on). | + | |
- | + | ||
- | **Selling**: | + | |
- | + | ||
- | **Plot Types**: Use ''/ | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Resident plots, which are default plots, can still have a plot type other than default when in a plot group; however, some plot types (e.g. farm) may not work due to permissions. | + | |
- | + | ||
- | To prevent the above caveats explained in the asterisk '' | + | |
- | + | ||
- | **Toggles**: | + | |
- | + | ||
- | **Permissions**: | + | |
- | + | ||
- | Please also keep in mind that permissions do not change when adding a town plot to a plot group. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Plot permissions and town permissions still apply **separately** in each plot of the plot group. | + | |
- | * Configuring permissions for the '' | + | |
- | * Configuring permissions for the '' | + | |
- | * When adding plots to a plot group, the default town permission settings apply if the added plot is unowned, and your own resident permission settings apply if the plot is owned. | + | |
- | + | ||
- | To prevent the above confusions and caveats explained in the asterisk '' | + | |
- | + | ||
- | **Per-Player Permissions**: | + | |
- | + | ||
- | **Plot Group Trusting**: Use ''/ | + | |
- | + | ||
- | * As with town trusting, always **exercise caution** when trusting a player with all plots in a plot group, especially if the plot group includes a large number of plots in your town. | + | |
- | + | ||
- | ===== Plot Names & Notifications ===== | + | |
- | + | ||
- | Plot names allow for town plots to be labeled. Town staff can rename unowned and resident plots. Resident plots can be renamed by their owner. | + | |
- | + | ||
- | You can rename a town plot by using ''/ | + | |
- | + | ||
- | Town outposts assume the plot name or plot group group that their spawnblock is in. Jail plots assume their plot name. | + | |
- | + | ||
- | By default, a town plot's **name** along with its **attributes** are shown **above the hotbar**, when walking into a plot. These messages on screen are called **plot notifications**. Specifically, | + | |
- | + | ||
- | * Name of town, in the case of walking from Wilderness into a town or directly from a town into another town. | + | |
- | * '' | + | |
- | * Name of owner along with their title and surname in the case of walking into a resident plot that is **unnamed**. Name of plot instead of the owner' | + | |
- | * '' | + | |
- | * PvP setting—'' | + | |
- | * Plot type (no plot type shown for default plots). | + | |
- | * Name of plot group, in the case that it is part of a plot group. | + | |
- | + | ||
- | Walking from any claim into Wilderness shows '' | + | |
- | + | ||
- | ====== Chunk Map ====== | + | |
- | + | ||
- | You can show a 27x7-chunk map of nearby chunks in chat, by typing ''/ | + | |
- | + | ||
- | {{https:// | + | |
- | + | ||
- | An orange-highlighted symbol on the map indicates the chunk you are currently standing in. An orange highlighted letter on the compass on the left of the map indicates the cardinal direction that you are currently facing toward. | + | |
- | + | ||
- | Hovering over a chunk in the chunk map also shows a compact list of information for the plot, such as the town that has claimed it, its owner, its chunk coordinate, plot type, selling price (if for sale) and plot group name (if part of a plot group). If the chunk is a Wilderness chunk, only shows '' | + | |
- | + | ||
- | The legend below lists the symbols found on the chunk map, along with their meaning. | + | |
- | + | ||
- | |**Symbol** |**Description** | | + | |
- | |Towny Map (a, b)|Chunk coordinates.| | + | |
- | |Town:|The name of the town you are in. If not in a town, shows **None**.| | + | |
- | |Owner:|If the chunk is a resident plot inside a town, shows the name of its owner. If the chunk is a claim and not owned, shows **None**.| | + | |
- | |**—** |Wilderness chunk| | + | |
- | |White **+** |Chunks claimed by other, neutral towns.| | + | |
- | |Light Green **+** |Chunks claimed by your town.| | + | |
- | |Yellow **+** |Your owned resident plots.| | + | |
- | |Dark Green **+** |Chunks claimed by a town in an allied nation to yours.| | + | |
- | |Red **+** |Chunks claimed by a town in an enemied nation to yours.| | + | |
- | |**$** |Town plot for sale.| | + | |
- | |**H** |Homeblock.| | + | |
- | |(Other letters)|Indicate plot type (by the first letter): **A** is for Arena, **B** is for Bank, etc.| | + | |
- | + | ||
- | ====== Managing the Nation ====== | + | |
- | + | ||
- | A **nation** is a collection of towns, at least 1. Residents of all towns in a nation are called its **nation members**. Each nation also has its virtual storage for money, the **nation bank**—only the Leader, Coleaders, Chancellors, | + | |
- | + | ||
- | Being in a nation shapes a town's gameplay and strategy in multiple ways in both Towny and Nations. | + | |
- | + | ||
- | Use ''/ | + | |
- | + | ||
- | **__Nation Information Screen__ ** | + | |
- | + | ||
- | * Open Town (shows nothing if Closed) | + | |
- | * Public Town & Chunk Coordinates of Nation Spawn (shows nothing if Private) | + | |
- | * Nation Board | + | |
- | * Date of Creation | + | |
- | * Nation Bank | + | |
- | * Ranked Nation Members | + | |
- | * Towns in the Nation | + | |
- | * Allied & Enemied Nations | + | |
- | + | ||
- | **-** In Nations, the nation information screen will also display: | + | |
- | + | ||
- | * Vassalage & Vassal Nation Tax | + | |
- | * Xp Bank | + | |
- | * Cultural Composition (as a percentage of towns) | + | |
- | * Occupied Home Towns (towns in the nation that are occupied by a different nation) | + | |
- | * Occupied Foreign Towns (towns that the nation is occupying) | + | |
- | * Occupation Nation Tax | + | |
- | * Siege Statistics | + | |
- | * Nation Resource Extraction | + | |
- | * Resources granted from towns in the nation per Towny day (Daily Production) | + | |
- | * Resources Available for Collection | + | |
- | + | ||
- | ===== Nation Creation & Basics ===== | + | |
- | + | ||
- | To **create** your nation, use ''/ | + | |
- | + | ||
- | * Costs $2700 in Towny. | + | |
- | * Costs $1152 in Nations. | + | |
- | + | ||
- | The Mayor creating the nation is assigned its **Leader** (or **King**). A Leader has access to all commands for their nation. The town of the Mayor creating the nation, is declared the nation' | + | |
- | + | ||
- | Invite other towns into your nation by using ''/ | + | |
- | + | ||
- | You can remove a town from your nation by using ''/ | + | |
- | + | ||
- | Change the border color of all towns in your nation, as seen in the Dynamic map, by typing ''/ | + | |
- | + | ||
- | Any nation member can use ''/ | + | |
- | + | ||
- | * On Nations, players can also use the xp bank to deposit xp for storage. Any player can transfer to the xp bank using ''/ | + | |
- | + | ||
- | ===== Nation Upkeep ===== | + | |
- | + | ||
- | Nation upkeep is the amount of money that the server automatically removes from your nation bank at the start of each Towny day, so that the nation can continue to exist. More towns in the nation means higher nation upkeep to pay each day. //Nation taxes are collected before nation upkeep.// | + | |
- | + | ||
- | * $45 per town in the nation, in Towny. | + | |
- | * 0, in Nations | + | |
- | + | ||
- | ===== Nation Ranks ===== | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | Diplomats can: | + | |
- | + | ||
- | * Add and remove allies or enemies. | + | |
- | * Send messages in the diplomacy channel (''/ | + | |
- | * Abandon sieges. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | Helpers can: | + | |
- | + | ||
- | * Invite towns into the nation. | + | |
- | * Revoke invites to the nation. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Helper. Additionally, | + | |
- | + | ||
- | * Toggle the nation as open or closed. | + | |
- | * Change the nation board. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Soldier. Additionally, | + | |
- | + | ||
- | * Start sieges against other towns and abandon them. | + | |
- | * Pay other military-ranked nation members. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Assistant. Additionally, | + | |
- | + | ||
- | * Add and remove allies or enemies. | + | |
- | * Send messages in the diplomacy channel (''/ | + | |
- | * Kick towns from the nation. | + | |
- | * View the bank history of the nation bank. | + | |
- | * Withdraw from the xp bank. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of General and Chancellor. Additionally, | + | |
- | + | ||
- | * Request another nation to merge into the nation. | + | |
- | * Withdraw money from the nation bank. | + | |
- | * Deposit money in the town bank of any town in the nation. | + | |
- | * Give any nation rank to other nation members (not including Leader). Coleaders cannot remove their own Coleader rank. | + | |
- | * Change the nation name. | + | |
- | * Set the nation tag shown in chat. | + | |
- | * Add a title or surname to another nation member or themselves, and remove it. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | All abilities of Coleader. Additionally, | + | |
- | + | ||
- | * **Delete the nation.** | + | |
- | * Change the nation capital. | + | |
- | * Add or remove Coleader rank from a nation member. | + | |
- | + | ||
- | Certain ranks have distinct powers. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Can withdraw money from the nation bank. | + | |
- | * Can set and change nation taxes. | + | |
- | * Can view the bank history of the nation bank. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Can withdraw from the xp bank. | + | |
- | + | ||
- | '' | + | |
- | + | ||
- | * Nation military rank that can earn battle points, for Nations. | + | |
- | + | ||
- | ===== Nation Board ===== | + | |
- | + | ||
- | You can set a custom message for your nation, called the **nation board**. Use ''/ | + | |
- | + | ||
- | * Other players can view your nation board in your nation' | + | |
- | * Nation members can view the nation board when they enter the server, and in the nation information screen (''/ | + | |
- | + | ||
- | To remove a nation board, type ''/ | + | |
- | + | ||
- | ===== Closed/Open Nation ===== | + | |
- | + | ||
- | All nations are **closed** (invite-only) by default. Towns can only join a closed nation after being invited by a nation member. If the nation is open, a Comayor or the Mayor can have their town join that nation by using ''/ | + | |
- | + | ||
- | To toggle between your nation being open or closed, type ''/ | + | |
- | + | ||
- | ===== Private/ | + | |
- | + | ||
- | All nations are **private** by default. A private nation only allows its nation members and allied nation members to teleport to its nation spawn. If the nation is public, any player on the server can teleport to its nation spawn. If the nation is public, it is denoted by '' | + | |
- | + | ||
- | To switch between your nation being private or public, use ''/ | + | |
- | + | ||
- | The nation spawn can be anywhere within the claims of a town in the nation. It is set or changed by typing ''/ | + | |
- | + | ||
- | In **Towny only**, players can teleport to a public nation' | + | |
- | + | ||
- | ===== Nation Taxes ===== | + | |
- | + | ||
- | Nation taxes are an amount of money transferred from the town bank of towns your nation controls, to your nation bank, at the start of each Towny day. | + | |
- | + | ||
- | 1) **Town nation tax** | + | |
- | + | ||
- | Town nation tax is a tax on your towns for being part of your nation. Set it by using ''/ | + | |
- | + | ||
- | 2) **Vassal nation tax** (**Nations only**) | + | |
- | + | ||
- | Vassal nation tax is a tax on [[https:// | + | |
- | + | ||
- | ===== Alliances & Enemies ===== | + | |
- | + | ||
- | By default, nations have neutral relations to one another, but they can be friendly or hostile (allies or enemies). You can declare a nation and its members as your ally to help you and represent helpful or friendly diplomatic affairs with them, or declare another nation and its members as your foe in economy and battle. | + | |
- | + | ||
- | **__Allying__** : Request to be allies with a nation by using ''/ | + | |
- | + | ||
- | * Accept the alliance with ''/ | + | |
- | * Refuse to ally with you by using ''/ | + | |
- | + | ||
- | You can view ally requests your nation has sent by typing ''/ | + | |
- | + | ||
- | To remove an ally and become neutral to the nation again, use ''/ | + | |
- | + | ||
- | **__Enemying__** : Declare an enemy by using ''/ | + | |
- | + | ||
- | ===== Nation Merging ===== | + | |
- | + | ||
- | Nation merging is the action of transferring the **towns** and **nation bank** of one nation to another. | + | |
- | + | ||
- | The Leader or Coleader can request a nation to merge into their nation by using ''/ | + | |
- | + | ||
- | The nation that **receives** and **accepts** the merge request will be dissolved—its Leader and other ranked nation members will lose all their nation ranks, its name will be removed from the server, and its towns and bank will be transferred to the other nation, if possible. | + | |
- | + | ||
- | * A Leader or Coleader of **both** nations involved must be online while the request and merger take place. | + | |
- | + | ||
- | ===== Transferring Leadership ===== | + | |
- | + | ||
- | A Leader can pass the Leader rank (title and powers) to another nation member, by using ''/ | + | |
- | + | ||
- | Similarly, using ''/ | + | |
- | + | ||
- | In both cases (using either of the above commands), the Leader gives up their Leader rank, and their town is no longer the capital town of the nation. In addition, the nation spawn is removed when the capital town is changed. | + | |
- | + | ||
- | The previous Leader will not have any nation ranks after giving up Leadership. | + | |
- | + | ||
- | //If you are considering passing Leadership to another player, only give it if you absolutely need to, and if you fully trust that person with the nation//! \\ | + | |
- | + | ||
- | ===== Nation Deletion ===== | + | |
- | + | ||
- | Deleting a nation means removing the name, the money in the nation bank, and everything associated with the nation from the server, as well as removing all towns from the nation. | + | |
- | + | ||
- | **Only the Leader and Coleaders are able to delete their nation**. As the Leader or Coleader, you may use ''/ | + | |
- | + | ||
- | * Make sure your entire nation bank is withdrawn to your balance by using ''/ | + | |
- | + | ||
- | ====== Player Settings ====== | + | |
- | + | ||
- | All players have certain data linked to their name that anyone can view by using ''/ | + | |
- | + | ||
- | **__Resident Information Screen__ ** | + | |
- | + | ||
- | * Date of Registration | + | |
- | * Time & Date Last Online | + | |
- | * Number of Owned Town Plots | + | |
- | * Resident Permission Settings | + | |
- | * Resident Toggles | + | |
- | * Town that the player is in | + | |
- | * Nation that the player' | + | |
- | * Balance | + | |
- | * Towns of Owned Embassy Plots | + | |
- | * Friend List | + | |
- | * Ignored Chat Channels | + | |
- | * Muted Players | + | |
- | + | ||
- | In Nations, the resident information screen will also display: | + | |
- | + | ||
- | * Uncollected Plunder after Won Sieges | + | |
- | + | ||
- | ===== Friendly-Fire Protection ===== | + | |
- | + | ||
- | Being part of a town grants you additional PvP protection. PvP-tagging is completely **disabled** anywhere (outside of arena plots) between residents of the same town, nation members of the same nation, and nation members of allied nations. \\ | + | |
- | + | ||
- | ===== Chat Channels ===== | + | |
- | + | ||
- | Towny offers various chat channels that players can talk in, publicly or privately. All players automatically join the default chat when connecting to the server, called the **general** channel, global chat, or public chat. | + | |
- | + | ||
- | Typing a channel' | + | |
- | + | ||
- | Channels' | + | |
- | + | ||
- | * ''/ | + | |
- | * ''/ | + | |
- | * ''/ | + | |
- | * ''/ | + | |
- | * ''/ | + | |
- | Additionally in **Nations**, | + | |
- | + | ||
- | * ''/ | + | |
- | * ''/ | + | |
- | * ''/ | + | |
- | + | ||
- | To **hide** (ignore) **a channel' | + | |
- | + | ||
- | To **hide a player' | + | |
- | + | ||
- | //Tip: You may hide **all messages** of a certain player from your chat, by typing //''/// | + | |
- | + | ||
- | ===== Friend List ===== | + | |
- | + | ||
- | You can add certain players as friends, in order to manage their permissions in your resident plots easier. | + | |
- | + | ||
- | * To add a player into your friend list, use ''/ | + | |
- | * To remove a player from your friend list, use ''/ | + | |
- | + | ||
- | You can view all players in your friend list by typing ''/ | + | |
- | + | ||
- | ===== Resident Modes ===== | + | |
- | + | ||
- | Resident modes is the collective name for a variety of normally inactive special Towny functionalities that are linked to your character and have varying uses related to moving between chunks/town plots. Each resident mode is explained below. | + | |
- | + | ||
- | You can enable resident modes by using the ''/ | + | |
- | + | ||
- | Valid resident modes: | + | |
- | + | ||
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | * '' | + | |
- | ====== Titles ====== | + | |
- | + | ||
- | Special names can be given to residents or nation members to make them stand out in chat, or denote an honorable position in the town and/or nation. Residents can have prefixes, called titles, or suffixes, called surnames, to their name. \\ | + | |
- | + | ||
- | ==== Granting Titles ==== | + | |
- | + | ||
- | **Title**: The title of a resident or nation member comes before their player name in chat, and it can be up to 10 characters long. Generally, the Mayor' | + | |
- | + | ||
- | * ''/ | + | |
- | * ''/ | + | |
- | **Surname**: | + | |
- | + | ||
- | * ''/ | + | |
- | + | ||
- | ==== Removing Titles ==== | + | |
- | + | ||
- | **Title**: | + | |
- | + | ||
- | * To remove a resident' | + | |
- | * To remove a nation member' | + | |
- | + | ||
- | **Surname**: | + | |
- | + | ||
- | * To remove a resident' | + | |
- | + | ||
- | ====== Town Tiers ====== | + | |
- | + | ||
- | As your town and nation grow in population, town size also grows, and town tier is upgraded alongside it. Each tier comes with additional claim bonuses. | + | |
- | + | ||
- | By default, each resident in your town provides **10** available claims to your town size (including the Mayor). This is called the **resident bonus**. | + | |
- | + | ||
- | Beyond the resident bonus, available claims may also be increased by the **town bonus** (buying available claims) and the **nation bonus** (having more nation members in your nation). \\ | + | |
- | + | ||
- | ===== Town Tiers in Towny | + | |
- | + | ||
- | |**Tier Title** |**# of Residents** |**Town Bonus** | | + | |
- | |Homestead|1|5| | + | |
- | |Tribe|2|8| | + | |
- | |Hamlet|6|12| | + | |
- | |Village|10|20| | + | |
- | |Borough|15|30| | + | |
- | |Town|20|40| | + | |
- | |Large Town|30|60| | + | |
- | |Suburb|40|80| | + | |
- | |City|50|100| | + | |
- | |Urban City|60|120| | + | |
- | |Regiopolis|80|160| | + | |
- | |Metropolis|90|180| | + | |
- | |Conurbation|100|200| | + | |
- | |Megalopolis|150|300| | + | |
- | |Eperopolis|175|350| | + | |
- | |Ecumenopolis|200|400| | + | |
- | + | ||
- | Being in a nation grants available claims to **every town in the nation**. This is called the **nation bonus**. The capital town of a nation is also granted special titles with each town tier, that override the titles seen above, based on the total number of nation members in the nation. | + | |
- | + | ||
- | |**Capital Tier Title** |**# of Nation Members** |**Nation Bonus** | | + | |
- | |Territorrial Capital|1|10| | + | |
- | |Municipality|20|20| | + | |
- | |City State|35|30| | + | |
- | |Sovereign Capital|50|40| | + | |
- | |Union Capital|75|60| | + | |
- | |Kingdom Capital|100|100| | + | |
- | |Imperial Capital|150|140| | + | |
- | |Imperial Capital|200|180| | + | |
- | + | ||
- | In Towny, your town gains 1 available outpost to claim by being in a nation. The **outpost bonus** is the number of additional separate chunks a town can claim, and it is calculated from the total number of nation members in your nation (if your town is in a nation). | + | |
- | + | ||
- | |**# of Nation Members** |**Outpost Bonus** | | + | |
- | |1|**-** | | + | |
- | |2|**-** | | + | |
- | |6|1| | + | |
- | |10|1| | + | |
- | |15|1| | + | |
- | |20|2| | + | |
- | |30|2| | + | |
- | |40|3| | + | |
- | |50|3| | + | |
- | |60|4| | + | |
- | |80|4| | + | |
- | |90|4| | + | |
- | |100|5| | + | |
- | |150|6| | + | |
- | |175|6| | + | |
- | |200|7| | + | |
- | + | ||
- | ===== Town Tiers in Nations ===== | + | |
- | + | ||
- | |**Tier Title** |**# of Residents** |**Town Bonus** | | + | |
- | |Homestead |1|10| | + | |
- | |Hamlet|2|20| | + | |
- | |Village|6|50| | + | |
- | |Town|10|80| | + | |
- | |Large Town|16|110| | + | |
- | |City|22|140| | + | |
- | |Large City|28|170| | + | |
- | |Metropolis|36|200| | + | |
- | |Conurbation|54|230| | + | |
- | |Megalopolis|78|260| | + | |
- | |Eperopolis|100|300| | + | |
- | + | ||
- | Being in a nation grants available claims to **every town in the nation**. This is called the **nation bonus**. Capitals of a nation are denoted by (Capital City) before their name. | + | |
- | + | ||
- | |**# of Nation Members** |**Nation Bonus** | | + | |
- | |1|10| | + | |
- | |10|20| | + | |
- | |20|40| | + | |
- | |40|60| | + | |
- | |60|90| | + | |
- | |80|120| | + | |
- | |110|150| | + | |
- | |140|180| | + | |
- | |170|210| | + | |
- | |200|250| | + | |
- | + | ||
- | In Nations, towns are not granted outposts, so they cannot claim chunks that are not adjacent to their town's claims. | + | |
+ | Here shows the player their nation' | ||
+ | * ? – Shows /nation commands. | ||
+ | * list {page #} – Lists Nations. | ||
+ | * online – Shows players in your nation which are online. | ||
+ | * (nation) – Shows a player the /nation screen of another nation. | ||
+ | * leave – Mayor command to leave the nation they are a part of. | ||
+ | * withdraw {$} – King command to remove money from the nation bank. | ||
+ | * deposit {$} – King command to add money to the nation bank. | ||
+ | * new (nationname) – Mayor command to create a nation. | ||
+ | * add (town) – Invites/ | ||
+ | * kick (town) – Removes a town from your nation. | ||
+ | * delete – Deletes your nation. | ||
+ | * ally add (nation) – Add a nation to your nation’s ally list. | ||
+ | * ally remove (nation) – Removes a nation from your nation’s ally list. | ||
+ | * enemy add (nation) – Add a nation to your nation’s enemy list. | ||
+ | * enemy remove (nation) – Removes a nation from your nation’s enemy list. | ||
+ | * rank {add|remove} {playername} {rankname} – Grants or removes a rank to a resident of the nation. | ||
+ | * set king {resident} – King command to change the king of the nation. | ||
+ | * set capital {town} – Sets the capitol and king of the nation. | ||
+ | * set name {name} – Sets the nation’s name. |