Information - Towny

What is Towny?

Towny is a land claiming plugin that lets you create towns and claim land with them. Towns add an entirely new layer of gameplay to the server. Towns can be sources of political drama, the birthplace of an economic empire, or even a regional power that has plans to rule the world. There are endless possibilities, but the primary purpose of Towny is to protect your land from outsiders. You have full control of the land that your town has claimed, and you can modify the permissions of your town, sell portions of your land to your residents to live on, have embassies built on your land from other towns, create farms, etc.

Nations are collections of towns that have decided to work together. Nations offer a bonus of 100 claims to every town in the nation. However, nation upkeep is very steep compared to towns. Towns and nations are costly to make, and if you are new, we suggest you join one and learn how towns work before diving into creating one of your own.

Section 1: Upkeep and Costs

As stated above, towns and nations are expensive. Towns are free to create and Nations cost $80,000 to create. The upkeep for nations is $5,000 per town in the nation. The upkeep for towns can be found below. Land does not cost anything to claim. You can purchase more claims by typing /town buy bonus [amount]. Bonus claims cost $12,500 per claim, to a maximum of 200 bonus claims. Lastly, overclaiming is when you have claimed more land than you have claims available. This can happen when a player leaves your town and your town downgrades or if you leave your nation. The cost is $250 per overclaim per day to prevent abuse.

Section 2: Town and Nation Ranks

Town Ranks

  • Dignitary
    • Exempt from taxes
  • Co-Mayor
    • Exempt from taxes
    • Everything that a mayor can do except disband the town
  • Accountant
    • Exempt from taxes
    • Withdraw/deposit to/from the town bank
    • Buy bonus town claims
  • Sheriff
    • Exempt from taxes
    • Toggle the jail status
    • Jail outlaws when killing
    • Can outlaw people or remove them from being an outlaw
  • Deputy
    • Toggle the jail status
    • Jail outlaws when killing them
    • Can outlaw people or remove them from being an outlaw
  • Architect
    • Exempt from taxes
    • Bypass town/plot permissions
  • Builder
    • Bypass town/plot permissions
  • Recruiter
    • Exempt from taxes
    • Invite/kick people to/from the town
    • Set plots for sale
    • Set plots not for sale

Nation Ranks
  • Co-King
    • Everything that a king can do except disband the nation
  • Accountant
    • Withdraw/deposit to/from the nation bank
    • Deposit money from nation bank into a town in the nation
  • Recruiter
    • Add/kick towns to/from the nation

Section 3: Ruined Towns

Towns that fall due to not having enough money in the bank for upkeep no longer get deleted. Instead, they fall into ruins. The new ruins system is in place so that people who forget to put enough in their bank, or people who unexpectedly have to be offline for a week or more, do not get severely punished and lose everything. Instead, the town will be put into a ruined state where the town is still there, but any members of the town or mayor cannot run any town related commands.

In addition to that, all permissions are turned on inside of every plot in the town when a town is in ruins. This is so that town members can take their stuff and leave if they wish to, or still be able to somewhat play. This does not mean that people are allowed to grief. Griefing is still not allowed within claimed land. The mayor will be replaced with a fake NPC mayor. The town will stay in limbo until the town is reclaimed.

Once your town is in ruins, any member of the town can type /town reclaim to reclaim the town and make it no longer in ruins. The person who reclaims the town will be made mayor for saving the town. The town will return to exactly how it was, but the new mayor will be in charge. Towns that are not reclaimed after 30 days get deleted forever and the area is up for grabs to anyone who would like to take it over.

Section 4: Commands

Below is a list of all Towny related commands and their functions. If you need more help, ask in chat or create a ticket in the #support-tickets channel on Discord.

Towny Commands

  • /towny
    • ? - List of towny commands
    • map - Shows the towny map, nearby towns, etc.
    • prices - Shows the costs associated with running a town
    • time - Shows the time until next day
    • top [residents/land] [all/town/nation] - Show a list of top residents/land owners
    • universe - Shows full towny statistics

Plot Commands

  • /plot
    • ? - List of plot commands
    • claim - Claim the plot you are currently standing in
    • unclaim - Unclaim the plot you are currently standing in
    • forsale [price] - Set a plot for sale with a price
    • notforsale - Set a plot as no longer for sale
    • evict - Evict a resident from a plot
    • perm - View the permissions of a plot
    • set
      • reset - Reset a plot type
      • shop - Set plot to shop type
      • embassy - Set plot to embassy type
      • arena - Set plot to arena type
      • wilds - Set plot to wilds type
      • inn - Set plot to inn type
      • jail - Set plot to jail type
      • bank - Set plot to bank type
      • outpost - Set plot to outpost type
      • name - Set the name of a plot
      • perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off] - Edit the permissions of a plot
      • perm reset - Reset the permissions of a plot to default
    • toggle [fire/pvp/explosion/mob] - Toggle various things for a plot
    • clear - Clear the signs from a plot
    • ? - Resident command list
    • [resident] - Information about a player
    • friend - Manage your friends
      • add [resident] - Add an online player as your friend
      • add+ [resident] - Add an offline player as your friend
      • remove [resident] - Remove an online player as your friend
      • remove+ [resident] - Remove an offline player as your friend
      • clearlist - Clear your list of friends
    • list - List of all residents
    • jail paybail - Pay bail if you are in jail
    • spawn - Teleport to your town spawn
    • toggle [map/townclaim/plotborder/constantplotborder/ignoreplots/reset] - Toggle various things
    • set perm [friend/ally/outsider] [build/destroy/switch/itemuse] [on/off] - Set permissions for your owned plots
    • tax - Check how much tax you pay

Town Commands

  • /town
    • ? - List of town commands
    • [town] - Show information about a town
    • here - Show information about the town you are standing in
    • leave - Leave a town
    • list - List of towns by type
      • by name [page]
      • by resident [page]
      • by balance [page]
      • by townblocks [page]
      • by online [page]
      • by open [page]<
    • online - List online members of your town
    • plots [town] - Show list of plots and types owned by a town
    • new [town] - Create a new town
    • add [resident] - Invite a person to your town
    • kick [resident] - Kick a resident from your town
    • spawn - Teleport to your town spawn
      • [town] - Teleport to another town's spawn, must be public
    • claim - Claim land for your town
      • outpost - Claim an outpost for your town
    • unclaim - Unclaim land
      • all - Unclaim all land
    • withdraw [money] - Withdraw money from your town
    • deposit [money] - Deposit money to your town
    • buy bonus [amount] - Buy bonus claims for your town
    • delete [town] - Delete your town
    • outlawlist [town] - List of outlaws in a town
    • outlaw [add/remove] [name] - Add or remove outlaws from your town
    • outpost - Teleport to your town outpost
      • [#] - Teleport to a specific outpost
      • list - List of your town's outposts
    • ranklist - List of ranks available in your town
    • rank [add/remove] [resident] [rank] - Add or remove ranks from a resident
    • reslist [town] - List of residents and their ranks in your town
    • say [msg] - Broadcast a message to everyone in your town
    • set - Set various things in your town
      • board [msg] - Sets the login message residents see when they log in
      • mayor [resident] - Sets a new mayor
      • homeblock - Sets a chunk as your town's home block
      • spawn - Set the spawnpoint of your town
      • spawncost [money] - Set the cost for non-town members when teleporting to your town spawn
      • name [name] - Change the name of your town
      • outpost - Set a plot as an outpost
      • jail - Set a plot as a jil
      • perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off] - Manage permissions for your town
      • perm reset - Reset permissions in your town
      • tag [4characters] - Set town tag
      • taxes [money] - Set the taxes for your town
      • plottax [money] - Set the plot taxes for your town
      • plotprice [money] - Set the default plot price for your town
      • shopprice [money] - Set the default shop price for your town
      • shoptax [money] - Set the shop taxes for your town
      • embassyprice [money] - Set the default embassy price for your town
      • embassytax [money] - Set the emassy taxes for your town
      • title [resident] [title] - Change a resident's title
      • surname [resident] [surname] - Change a resident's surname
    • toggle - Toggle various things in your town
      • explosion - Toggle explosion block damage in your town
      • fire - Toggle firespread in your town
      • mobs - Toggle mob spawns in your town
      • public - Toggle anyone to teleport to your town spawn
      • pvp - Enable PVP in your town
      • taxpercent - Switch between percent or flat tax
      • open - Toggle whether people can join your town without an invite
      • jail [number] [resident] - Jail a resident, [number] is optional and is the jail number
      • jail [number] [resident] [days] - Jail a resident for a certain amount of days
    • join [name] - Join a town

Nation Commands

  • /nation
    • ? - List of nation commands
    • list - List of nations by certain things
      • by name [page]
      • by resident [page]
      • by balance [page]
      • by towns [page]
      • by townblocks [page]
      • by online [page]
    • online - List of online members in your nation
    • [nation] - Information about a specific nation
    • leave - Leave your nation
    • withdraw [money] - Withdraw money from your nation
    • deposit [money] - Deposit money into your nation
    • deposit [money] [town] - Deposit money into a town within your nation
    • new [name] - Create a new nation
    • rank - Set up ranks in your nation
    • add [town] - Add a town to your nation
    • kick [town] - Kick a town from your nation
    • delete [nation] - Delete your nation
    • ally [add/remove] [nation] - Add or remove an ally
    • enemy [add/remove] [nation] - Add or remove an enemy
    • rank [add/remove] [resident] [rank] - Give or remove a resident a rank
    • say [msg] - Broadcast a message to everyone in your nation
    • set - Set various things in your nation
      • king [resident] - Set a resident as king of the nation
      • capital [town] - Set the capital of your nation to a different town
      • board [msg] - Set the login message for your nation members
      • taxes [money] - Set the taxes for your nation
      • name [name] - Change the name of your nation
      • spawn - Teleport to your nation spawn
      • spawncost - Modify the cost of non-nation/ally members teleporting to your spawn
      • title [resident] [title] - Set a title of a resident
      • surname [resident] [surname] - Set the surname of a resident
      • tag [4characters] - Set the tag of your nation
      • tag clear - Clear your nation tag
      • mapcolor [color] - Changes the color that your nation will have on the map. Available colors: Aqua, Azure, Beige, Black, Blue, Brown, Cyan, DarkBlue, DarkCyan, DarkGrey, DarkGreen, DarkKhaki, DarkMagenta, DarkOliveGreen, DarkOrange, DarkOrchid, DarkRed, DarkSalmon, DarkViolet, Fuchsia, Gold, Green, Indigo, Khaki, LightBlue, LightCyan, LightGreen, LightGrey, LightPink, LightYellow, Lime, Magenta, Maroon, Navy, Olive, Orange, Pink, Purple, Violet, Red, Silver, White, and Yellow.
    • toggle open - Toggle whether people can teleport to your nation spawn
    • join [nation] - Join a nation
    • merge [nation] - Merge two nations together. Complicated, do research before doing this
    • townlist [nation] - List of towns in a nation
    • allylist [nation] - List of allies a nation has
    • enemylist [nation] - List of enemies a nation has