Towny

From Octagami's Omniverse Wiki
Jump to: navigation, search

Towny is a server plugin that facilitates block protection and a resident-town-nation hierarchy. Players can create or join Towns, which are divided into 16x16 plots that are lined up with server chunks. The plugin was created by ElgarL, but the code used on OMM/Omni is completely custom, coded by Octagami. For information on creating and running a town, please view our Towny Guide.

Contents

All Towny Commands

Please Note: /t is interchangeable with /town You may be (deputy-)mayor only on your homeserver, and a resident on one town on all other servers. The highest rank you can have is Assistant on all other servers.

All Players

/t new (name)
Creates a town with the name specified (if available). The plot you are standing in when this command is entered will be set as
your new town's homeblock (this can later be moved at no cost: see "/t set homeblock"). You must not be currently within a town or within 8 plots of a town.
/t (name)
Shows a town's info and permissions. See the Checking Plot/Town Permissions guide to understand how to read what the permissions of the town are set as.
/t list
Lists all towns currently on the server.
/t here
Shows you the town info and permissions of the town you are standing in. See the Checking Plot/Town Permissions guide to understand how to read what the permissions of the town are set as.
/t spawn (town)
Teleports you to another town's spawn, you can only do this if the town is public
/t join (townname)
Command to join a town that is set to open (see "/t toggle open" command)
/t ?
Shows the player some town commands available.
/plot ?
shows some plot commands.
/plot perm
Displays plot permission information for the plot you are in. See the Checking Plot/Town Permissions guide for how to understand the format.
/towny top residents town
Displays towns by most residents

Mayors

/t unclaim all
Unclaims all plots the town owns.
/t delete
Deletes the town.
/t set mayor (resident)
Changes the town's mayor (You will lose your mayor rank as there can only be one mayor).

Deputy-Mayor+

/t kick (Resident) .. (Resident)
Kicks residents from your town, you can add as many people as you can fit in 1 line.
/t unclaim
Unclaims the plot in which you are standing.
/t unclaim # (radius around current position)
Unclaims an area of plots around you.
/t buy outposts (#)
Buys more outpost slots for your town. Each slot costs $500 each.
Note: As stated in "/t claim outpost" under surveyors, it will also cost $500 to claim the outpost.
/t withdraw #
Removes money from the town bank.
/t set banner
Sets the banner currently held as the town banner. This will change the color of the town border on dynmap according to the color of the banner.
/t set board (message)
Sets the town board to the designated message.
/t set name (name)
Sets the town name.
/t set spawn
Sets the town spawn and homeblock where you are standing.
Note: R, A, and O can be substituted for Resident, Ally, and Outsider perms.
/t set perm (on/off)
Toggles all permissions on or off for the town.
/t set perm (Resident/Ally/Outsider) (On/off)
Either gives or removes all of the selected groups perms.
/t set perm (Build/Destroy/Switch/Itemuse/Fly) (On/off)
Either gives or takes designated perm from all players who are not assistant+ in the town.
/t set perm (Resident/Ally/Outsider) (Build/Destroy/Switch/Itemuse/Fly) (On/off)
Either gives or takes designated perm from all players in the designated group.
/t set perm reset
Resets all perm permissions in all plots in the town.
/t set tag (upto4characters)
Sets the towns tag, which replaces the towns name in the chat line.
/t set tag clear
Clears the tag for the town.
Note: All Taxes are collected based on real life days, not in-game days.
/t set plottax ($)
Sets taxes collected from each resident daily, per plot that they own.
/t set plotprice ($)
Sets default price of a plot for the town.
/t set shopprice ($)
Sets default price of a shop plot for the town.
/t set shoptax ($)
Sets taxes collected from each resident daily, per shop plot that they own.
/t set embassyprice ($)
Sets default price of a embassy plot for the town.
/t set embassytax ($)
Sets taxes collected from each resident daily, per embassy plot that they own.
/plot set shop
Sets a plot to a shop plot.
/plot set embassy
Sets a plot to an embassy plot.
Note: Embassy plots allow non-residents (outsiders) to claim a plot in your town.
/plot set arena
Sets a plot to an arena plot. This is the only way to allow PvP with nation members.
/plot set wilds
Sets a plot to a wilds plot.
/plot set reset
Sets a shop/embassy/wilds/arena plot back to a normal plot.
/towny time
Shows the time when taxes will be next collected.

Town Assistants+

/t add (Resident) (Resident) ...
Adds residents to your town, you can add as many people as you can fit in 1 line
/t rank (add/remove) (playername) (rankname)
Grants/removes ranks to a resident in town, current ranks are: Resident, Surveyor, Assistant, Deputy-Mayor, and Mayor, you can only give people ranks lower than yours.
/t set outpost [#]
Moves the town block in which you will spawn for an outpost (when using "/t outpost (#)")
/t buy warps [#]
Buys {#} warps for town.
/t set warp [warp-name]
Sets a town warp where the player is standing.
/t delwarp [warp-name]
Deletes a town warp.
/t toggle explosion
Turns explosions on/off in the town.
/t toggle fire
Turns fire on/off in the town.
/t toggle mobs
Turns hostile mob spawning on/off in the town.
/t toggle public
Turns public teleporting to your town on/off.
/t toggle pvp
Turns pvp on/off in the town.
/t toggle open
Turns public joining on/off in the town. When this is on, any player without a current town can use "/t join (townname)" to join your town.
/plot fs (Price)
Sets a plot for sale.
/plot fs circle/rect #
Puts up plots for sale in a circle or rectangle shape.
/plot fs $$ circle/rect #
Puts up plots for sale for a certain price in a circle or rectangle shape.
/plot nfs
Sets a plot to not be for sale.
/plot nfs circle/rect #
Sets plots not to be for sale in a circle or rectangle shape.

Recruiter

/t add (Resident) (Resident) ...
Adds residents to your town, you can add as many people as you can fit in 1 line

Surveyors+

/t claim
Claims the plot in which you are standing for your town, needs to be adjacent to another plot of your town
/t claim outpost
Claims the plot in which you are standing for your town as an outpost. This is used to claim land that is not connected to your town.
Note: Claiming an outpost costs $500 and new towns have a limit of 1 outpost. More outpost slots can be purchased (see /t buy outposts [#]).
/t claim # (radius around current position)
Claims an area of plots around you for your town.
/t claim auto
Claims as many plots as possible as determined by the amount of money in your town's bank and available town blocks.

Town Residents

/t
Shows a player their town's info and permissions. See the Checking Plot/Town Permissions guide to understand how to read what the permissions of the town are set as.
/t spawn
Teleports you to your town's spawn.
/t online
Shows players in your town which are online.
/t deposit ($)
Adds money to your town's bank (from your balance).
The town bank can store up to $1,000,000.
Note: Only Mayors and Deputy-Mayors may withdraw money from town banks.
/t warp [warpname]
Teleports the player to their town's town warp of their choice.
/t warp [town] [warpname]
Teleports the player to the town warp of a town of their choice.
/t outpost (#)
Teleports the player to that outpost, they are numbered by claim order.
/t banner
Converts a held banner into a town banner.
/t ranklist
Displays residents and their ranks.
/plot claim
Personally claims a plot that is for sale.
/plot claim auto
Personally claim an area of plots that are for sale, around the player.
Note: When this is activated you will purchase plots that you walk onto if they are listed for sale.
/plot set perm [friend/ally/outsider] [build/destroy/switch/itemuse/fly] [on/off]
Sets the plot permissions on an owned plot. Mayors/deputy-mayors can edit the permissions on unowned plots.
/plot unclaim
Unclaims your plot you're standing on.
Note: After unclaiming, the plot will be an unowned plot for sale at the default price set by the Deputy-Mayor or Mayor (see /t set plotprice ($))
/plot unclaim circle/rect (#)
Unclaims personally owned plots in a circle or rectangle shape.

War Commands

/t ally add (town name)
Adds a town to your town's ally list.
/t ally remove (town name)
Removes a town from your town's ally list.
/t enemy add (town name)
Adds a town to your town's enemy list.
/t enemy remove (town name)
Removes a town from your town's enemy list.
/t set diplomacy hostile
Sets your town to declare war on anyone who declares war on your town.
/t set diplomacy neutral
Default state of towns where other towns can declare war on yours.
/t set diplomacy peaceful
Allows your town to avoid taking part in wars.
/t war
Displays the town war UI.

Notes

There are a lot of commands here that might seem overwhelming, but don't despair! You will likely only use some of the commands here. If you need further help, type "/h [your question here]" in the chat to ask in help chat. Good luck and have fun!

Below is a link to the official Towny Plugin's Wiki page.
Towny Wiki

Please take note that some implementations of the plugin are customized by our developer team so as to work in tandem with the other plugins on our server. Due to this, some information may be slightly different on OMM.

Town Labels and Mayor Prefixes

As your town gains more residents, the town's title, and the mayor's title will change as shown by the table below:

Residents Town label Mayor prefix
1 Settlement Hermit
2 Settlement Hermit
3 Hamlet Chief
4 Hamlet Chief
5 Village Elder
6 Village Elder
7 Town Mayor
8 Town Mayor
9 Large Town Baron
10 Large Town Baron
11 City Earl
12 City Earl
13 Large City Duke
14 Large City Duke
15 Metropolis Lord
16 Metropolis Lord

When you recruit more than 16 members your town will not get any new titles.

Plot Prices

The price for each plot that a town purchases is determined by the number of plots that the town possesses.

Amount of Plots Cost per plot
9-31 plots $100
32-63 plots $200
63-127 plots $300
128-255 plots $400
256-511 Plots $500
512-767 Plots $1000
768-1024 Plots $2000

Inactivity

When all town residents are inactive for the amount of time shown below the town will be removed. If one resident has logged in before the time below the town will remain untouched. Note: Residents are no longer kicked after 30 days of inactivity.

Amount of Plots Time until removal
10-15 plots 30 days
16-31 plots 45 days
32-63 plots 60 days
64-127 plots 90 days
128+ plots 1 year

Animal Limits

The limit for the amount of animals a town can have depends on the number of plots claimed. The animal limit for a town is the number of plots claimed for your town plus 16.

Example
If a town has 10 plots, the animal limit of the town would be 26.
Animals included in the limit
  • Chickens
  • Cows
  • Mooshrooms
  • Pigs
  • Rabbits
  • Sheep
  • Villagers
  • Polar Bears
  • Llamas

Nations

In addition to towns, a group of towns can band together to form a nation. These nations have a series of commands specifically for them, as well as nation ranks.

Creating a Nation

The mayor of a town may send a request to form a nation to a second town with the command /nation new [nation] [name of second town] To successfully create a nation:

  • Both towns must not already be part of a nation.
  • The mayor of the second town must be online and accept the request.
  • Both towns combined must have a minimum of 10 residents.
  • The nation name must not already be taken.

Nation Ranks

The three Nation Ranks are King, Prince, and Assistant. Each rank has a different role to play in the nation.

  • King: Has full control and command over the nation.
  • Prince: Has access to many administrative commands.
  • Assistant: Can invite towns to the nation and change nation allies and enemies.

Nation Titles

As your nation gains more residents, your nation's title and the leader's prefix title will change as shown by the table below:

Residents Nation label Leader prefix
1 Land Leader
8 Domain Regent
16 Kingdom Monarch
32 Empire Emperor
64 Holy Empire God Emperor

Note: When your nation reaches a population higher than 64 members, the nation and king will not gain any new titles. Note: Nations are only manually disbanded, so it is possible for a nation to have the title "Land" until the nation is disbanded due to resident count.

Nation Commands

Note: "/n" is interchangeable with "/nation"

Kings

/n set banner
Changes your nation's banner to the banner currently being held.
/n set name [name]
Sets the name for your nation.
/n set tag [name/clear]
Sets the nation abbreviation in chat (up to four letters) or removes a nation tag.
/n toggle open
Allows for any towns to join your nation without having to be invited.
/n toggle neutral
Allows for your nation to pay a daily fee so that you cannot be set as enemies by any other nation.
/n delete
Disbands your nation (this is permanent, please use caution).
/n set king [name]
Transfers ownership of a nation to a town mayor that is part of your nation.
/n set capital [name]
Sets the selected town as the nation's capital.

Princes+

/n kick [town]
Removes a town from your nation.
/n withdraw [amount]
Withdraws money from the nation's bank.
/n rank [add/remove] [resident] [rank]
Promotes a nation member to the designated rank.
/n set [title/surname] [resident] [text]
Adds text before or after the resident's name in chat.
/n set taxes [$]
Sets an amount that all towns in your nation must pay daily, which is collected from the towns' banks.
Note: If a town does not have the full amount in their town bank when taxes are collected, the town will be automatically kicked.

Nation Assistants+

/n add [town]
Invites a town to join your nation.
/n ally [add/remove] [nation]
Adds/removes nation allies for your nation's status and permissions.
/n enemy [add/remove] [nation]
Adds/removes nation enemies for your nation's status and permissions.

Town Mayors

/n new [name] [town]
Invites a town to create a nation with your town.
/n join [nation]
Joins the selected nation.
Note: The nation must be set to Open for joining to be automatic.
/n leave
Lets your town leave the nation.

Nation Residents

/n
Gives the status for your town's nation.
/nc [message]
Either sets your default chat channel to nation chat or sends a single message to nation chat.
/n online
Lists all of your nation's residents who are currently online.
/n banner
Converts a held banner into your nation's banner.
/n deposit [$]
Deposits a set amount into the nation's bank.

All Players

/n [nation]
Gives the status for the typed in nation.
/n list
Lists all nations on your current server.
/towny top residents nation
Lists the nations with the most residents in order.
/warp [nation]
Teleports you to the selected nation's capital.
/n ?
Lists nation commands in-game.
/n king ?
Lists nation commands that players with nation ranks have access to.

War Commands

/n ally add (nation name)
Adds a nation to your nation's ally list.
/n ally remove (nation name)
Removes a nation from your nation's ally list.
/n enemy add (nation name)
Adds a nation to your nation's enemy list.
/n enemy remove (nation name)
Removes a nation from your nation's enemy list.
/n set diplomacy hostile
Sets your nation to declare war on anyone who declares war on your nation.
/n set diplomacy neutral

Nation Inactivity

Once nations are formed, they are subject to be automatically deleted at any time if either of the following occurs:

  • The nation drops to less than 2 towns.
  • The nation drops to less than 10 residents (in all towns combined).

Deleted nations may be reformed immediately by any player using the above process. Nations that were disbanded due to the nation inactivity requirements are not restored back to their original state after they are recreated, and if the original name is claimed after the nation is disbanded the reformed nation cannot reclaim the name.