Malevolynt Player Guides

Towny

Towny is a classic survival plugin that allows players to own land in the overworld and create, protect, and manage towns and nations. This guide goes through each of Towny’s features. If you wish to focus on a particular feature, you may skip to the section you need.

Guide Contents

Introduction

Town Creation

Claiming Land

Town Management

Plot Management

Nations

Full Command List

Introduction

The Towny plugin manages the world in chunks. Chunks are 16x16 block squares that extend from bedrock to height limit. You can view chunks borders by pressing F3+G. Chunks start off as wilderness blocks, but when a town is created the owner of the town (mayor) can claim chunks for the town.


Many towny features run on a time clock called the Towny day. The towny day is a 24 hr real time clock that resets at a certain time. You can view Towny’s time by using: /towny time

Town Creation

To create a new town: /t new <town name> 

This will claim the chunk you are standing in as the home block for your new town. 


In Malevolynt, it costs 15,000gp to create a town.


To get information about your town: /t <name of town>

This will put important information in the chat box including:

  • Town size
  • Town residents
  • Town outposts
  • Permissions
  • Town bank balance


To invite other players to your town: /t add <player name>

To accept an invite to join a town: /t accept <name of town>

If a player is already in another town and they wish to join yours, they first must leave their current town.

To leave a town:  /t leave <name of town>

Claiming Land

Towns have a limit on how many chunks they can claim. Your town’s limit is shown in your town information. Each player that joins your town will give your town an additional 8 chunks the town can claim.


To claim a new town chunk, walk to a chunk next to your town homeblock or other previously claimed chunk, and use /t claim


Cost to claim chunk: 25gp


In the event that you run out of chunks that your town is allowed to claim, you are able to buy bonus townblocks. 

To buy a bonus townblock: /t buy bonus <# of chunks>


Cost to claim buyable bonus chunk: 25,000gp


If you want to claim a chunk that is not connected to your town’s claimed chunks, you can create an outpost.

To claim an outpost, walk to the chunk you want to claim, and use /t claim outpost

Town Management

Your town’s bank is an extremely important part of managing your town. There are daily costs called upkeep costs and taxes that have to be paid.

Town daily upkeep cost: 1gp per resident (Open Beta Discount)


Town Bank Management

To view your town’s bank, use /t <name of town>

To add money to your town’s bank: /t deposit <amount>

To withdraw money from your town’s bank: /t withdraw <amount>


Town Settings

If you are a town Mayor, you can control many aspects of your town, including resident ranks and taxes.

To change the town’s name: /town set name <new name>

To transfer mayorship of the town: /town set mayor <player>

To set the town’s board message: /town set board <message>

To set which chunk is the town’s home block: /town set homeblock

To set your town chat prefix when typing in general chat: /town set tag <tag>

To set what block players spawn in your town, walk to the block and use: /town set spawn


As mayor, you can also control what types of events can happen in your town.

To turn off/on explosions: /town toggle explosion

To turn off/on fire spread: /town toggle fire

To turn off/on hostile mob spawning: /town toggle mobs

To turn off/on non-residents being able to teleport to your town’s spawn: /town toggle public

To turn off/on PvP: /town toggle PvP

To turn off/on whether players can self-join your town: /town toggle open


Resident Ranks

As you gain more residents to your town, you can grant them privileges such as inviting other players, designating outlaws, building, plot management, and more. Below is an explanation of town ranks.


To set the rank of a resident: /t rank add <player name> <rank name>

  • Comayor - Gives a resident all of the permissions that the mayor has. Only give this to players you would trust your entire town to.
  • Assistant - Give a resident the ability to invite, kick, and jail other residents, manage all plots, and claim chunks.
  • Police - Gives a resident the ability to designate outlaws and jail other residents.
  • Builder - Gives a resident the ability to build on any plot, even if they do not own it.
  • Planner - Gives a resident full control over plot management commands.
  • Treasurer - Gives a resident full control over taxes, and can withdraw funds from the town’s bank.


Taxes

As mentioned before, it costs gp to run a town. If your town’s bank does not have enough gp in it when the towny day resets, you run a risk of your town being deleted, and your claimed land unprotected from all players who would be able to raid your town. To help avoid this, taxes can be set for your town, and there are several types.

  • Flat taxes take a set amount of gp from residents each towny day. If a resident cannot afford to pay the tax, they will automatically be kicked from the town.
  • Percentage taxes take a percentage of residents’ gp each towny day. However, in this tax option residents do not get kicked if they are unable to pay the percentage tax.
  • Plot taxes set taxes collected from each resident each towny day per plot that they own.
  • Shop taxes set taxes collected from each resident each towny day per shop plot that they own.
  • Embassy taxes set taxes collected from each player each towny day per embassy plot that they own in your town.


To toggle what tax type your town uses: /town toggle taxpercent

To set the amount or percentage taxed: /town set taxes <amount or percentage>

To set plot taxes: /town set plottax <amount>

To set shop taxes: /town set shoptax <amount>

To set embassy taxes: /town set embassytax <amount>


Jail and Outlaws

Towns are able to designate a specific plot as their town’s jail. If a resident of your town is jailed by the mayor, comayor, assistant, or police, they will be sent to this plot. The resident will be unable to teleport out of the jail, but can either escape and walk out of town, or pay the bail to become unjailed. 


Bail cost: 1,000gp


To jail a resident: /town toggle jail <player name>

To pay bail: /resident jail paybail


Towns are able to designate non-residents as outlaws. An outlawed player can be attacked inside the designating town’s chunks even if the town has PvP disabled. If an outlaw dies inside the town, they will automatically be jailed. 


To manage outlaws: /town outlaw <add/remove> <player name>

To see outlaw list: /town outlawlist

Plot Management

Claimed townblocks/chunks are called plots in towny. 1 plot = 1 chunk, so each plot is that same 16x16 block square that you can view using F3+G or /resident toggle constantplotborder

Plots can also be viewed using the map function: /resident toggle map


Plots have many settings that can be applied to them to help you manage your town, and are detailed below.


All plot commands must be used while standing inside the plot you want to edit.


To sell plots to your residents (default is 0gp): /plot forsale <price>

To change this default price: /town set plotprice <price>

To buy a for sale plot (gp paid gets deposited in town’s bank): /plot claim


When a resident buys a plot, they now have the ability to manage their plot using: /plot set perm <group> <permission> [on/off]


Groups (who your command is going to affect)

  • Friend - players on your friend list. You can edit your friend list with /res friend
  • Resident - players from your town.
  • Ally - players from your town, nation and allied nations.
  • Outsider - players not from your town, nation or an allied nation.


Permissions (what your designated group can or cannot do in your plot)

  • Build - controls whether a group can build in your plot
  • Destroy - controls whether a group can break blocks in your plot
  • Switch - controls whether a group can use chests, hoppers, furnaces, doors, dispensers, etc.
  • Itemuse - controls whether a group can place/destroy minecarts, use buckets and bone meal, etc.


Example: /plot set perm friend switch on means that anyone in your friends list can use chests, doors, etc.


Residents can further manage permissions for ALL of their owned plots at the same time using: /resident set perm <group> <permission> [on/off]


Mayors can manage permissions for all unowned plots using: /town set perm <group> <permission> [on/off]


Residents and mayors can further manage plots through changing the plot type using: /plot set <plot type>


Plot Types

  • Default - the default plot type. All plots are default when first claimed. Non-default plots can be made default again with /plot set reset.
  • Shop - designates a player shop area. The plot will appear red on the map.
  • Arena - arena plots have PvP and friendly fire enabled at all times.
  • Embassy - if for sale, embassy plots can be bought by any player, even if they're not a resident of the town.
  • Bank - designates a bank, which allows you to deposit and withdraw from your town and nation banks.
  • Jail - designates a jail, where players will be sent to if imprisoned - see the section on ranks.
  • Farm - designates a farm, where the only blocks that can be placed and destroyed are crops.
  • Wilds - designates a semi-protected wilderness plot, where trees, flowers, mushrooms etc can be broken but all other blocks cannot.

Nations

Towns can form nations. Nations are political entities which multiple towns can be part of. Joining or creating a nation gives towns multiple benefits, including:

  • Waging war against other nations
  • Claiming outposts
  • Bonus townblocks - the larger the nation the more bonus townblocks you can claim. (This is separate from buyable bonus townblocks)


Nation Creation

The town that creates the nation will become the new capital for that nation. The mayor of this town will also be promoted from the town’s mayor to the nation’s king. 


Cost to create a Nation (taken from creating town’s bank): 1,000gp


To create a nation: /n new <nation name>


Growing your Nation

Once your new nation is created, you can invite other towns to join it. However, a town must be within 300 chunks of your nation's capital's homeblock to be invited. When an invite is sent, it will go directly to that town’s mayor for them to accept or deny.


To invite towns to your nation: /n add <town name>


Nation Management

Just like your town’s bank, your nation’s bank is an extremely important part of managing your nation. Just like towns, nations have upkeep costs and taxes. To help manage your nation’s upkeep cost, you can set taxes on your towns that are paid by those town’s banks. 


Nation daily upkeep cost: 1gp (Open Beta Discount)


To set taxes on your nation’s towns: /n set taxes <amount>


Nations have a few settings that kings can manage, including:


To grant a nation member a custom title/prefix: /nation set title <player> <title>

To grant a nation member a surname/suffix: /nation set surname <player> <surname>

To change the nations name: /nation set name <new name>

To set which town is the nation’s capital: /nation set capital <town>

To transfer kingship to another player in the nation: /nation set king <player>

To set your nation’s chat tag: /nation set tag <tag>


Nations have a few ranks than be assigned to members to help manage the nation:


To set the rank of a member: /n rank add <player> <rank name>

  • Coleader - has all the abilities of the nation leader, including the ability to delete the nation! Give with caution.
  • Chancellor - can manage nation allies and enemies; invite and kick towns; grant titles and surnames; and withdraw from the nation bank.
  • Treasurer - can change the tax rate and withdraw from the town bank.

Full Towny Command List

Introduction

  • This list breaks each command down by word. Eg: /resident set perm {on/off}.
  • For resident commands, the add command would auto-match online players, while add+ requires exact spelling to choose offline players.
  • Just about every subcommand has its own help menu. Use /resident set, or a similar cutoff, to show all the options for that command in game. You can also use /resident set ?, you will probably need to use that in the case where a subcommand actually has a function by itself. Example: /town claim, and /town claim ? would show all its subcommands.
  • The { } brackets are used to show variables, or what you need to fill in. The ellipse ".." (or shortened ellipse) is used to show that you can specify multiple things at once (like inviting 10 residents at once).
  • The {bleh/blah/bluh} is used to show that the input can be multiple words.
  • An empty bullet represents that the subcommand itself does something and will not show a help menu.


/towny

  • /towny
  •      Shows basic towny commands.
  • ? - Shows more towny commands.
  • map - Shows the towny map.
  • prices - Shows taxes/costs associated with running a town.
  • time - Shows time until next new-day (tax/upkeep collection.)
  • Top
  • residents {all/town/nation} - Shows top residents.
  • land {all/resident/town} - Shows top land owners.
  • spy - Admin command to spy on all chat channels
  • tree - Shows lots of stuff.
  • universe - Shows full towny stats, resident/town/nation/world counts as well as townblocks claimed.
  • v - Shows towny version.
  • War
  • Stats
  • scores


/plot

  • /plot
  •      Shows the /plot commands.
  • claim - Resident command to personally claims a plot that are for sale.
  • auto - Resident command to personally claim an area of plots that are for sale, around the player typing the command.
  • unclaim - Resident command to unclaim personally owned plots.
  • circle/rect - Resident command to unclaim personally owned plots in a circle or rectangle shape.
  • {# (radius around current position)} - Radius of the area to unclaim.
  • {forsale/fs} - Set a plot for sale.
  • circle/rect - Set a shape.
  • {# (radius around current position)} - Radius of the area to set forsale.
  • $$ - Cost of plot.
  • circle/rect - Set a shape.
  • {# (radius around current position)} - Radius of the area to set forsale.
  • {notforsale/nfs} - Set a plot to not be for sale.
  • circle/rect - Set a shape.
  • {# (radius around current position)} - Radius of the area to set notforsale.
  • perm - Shows the perm line of the plot in which the player stands.
  • set
  • reset - Sets a shop/embassy/arena/wilds plot back to a normal plot.
  • shop - Sets a plot to a shop plot.
  • embassy - Sets a plot to an embassy plot.
  • arena - Sets a plot to an arena plot.
  • wilds - Sets a plot to a wilds plot.
  • name - allows a mayor or plot-owner to rename plots they own, overwriting the ~Unowned message. Personal-plots display both the plot's given name and the name of the plot-owner.
  • perm
  • {on/off} - Edits the perm line of the single plot in which the player is standing.
  • {resident/ally/outsider} {on/off}
  • {build/destroy/switch/itemuse} {on/off}
  • {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
  • reset - Resets the plot in which you stand to the default perm line of the /town or /resident screen (depending on if the plot is owned personally or by the town.)
  • toggle
  • fire - Turn on/off firespread in the plot in which you stand.
  • pvp - Turn on/off pvp in the plot in which you stand.
  • explosion - Turn on/off explosions in the plot in which you stand.
  • mob - Turn on/off hostile mobspawning in the plot in which you stand.
  • clear - Command to remove list of block id's from a plot, used by a mayor on town-owned land, or by a plot-owner on their personal plots.


/resident

  • /resident
  •      Shows a player their resident screen.
  • ? - Shows /res commands available.
  • {resident} - Shows a player another player's resident screen.
  • friend
  • add {resident} .. {resident} - Resident adds online player to their friends list.
  • add+ {resident} .. {resident} - Resident adds offline player to their friends list.
  • remove {resident} .. {resident} - Resident removes online player from their friends list.
  • remove+ {resident} .. {resident} - Resident removes offline player from their friends list.
  • clearlist - Removes all friends from a resident's friend list.
  • list - Lists residents in towny's data folder.
  • spawn - If deny_bed_use: true in the config.yml and player has a current bed spawn, command will teleport player to their bed.
  • toggle
  • map - Turns on map which refreshes when moving across plot borders.
  • townclaim - Turns on mode where /town claim is automatically used when moving across plot borders.
  • plotborder - Turns on smokey plot-border view. Border shows when players cross to different townblocks.
  • spy - Admins can turn on chat-channel spying.
  • reset - This turns off all modes that are active.
  • set
  • perm
  • {on/off} - Edits the perm line on the resident screen. See here for details.
  • {friend/ally/outsider} {on/off}
  • {build/destroy/switch/itemuse} {on/off}
  • {friend/ally/outsider} {build/destroy/switch/itemuse} {on/off}
  • reset - This takes the perm line seen in the /resident screen and applies it to all plots personally owned by the player typing it.
  • tax - Shows taxes a player pays.


/town

  • /town
  •      Shows a player their town's town screen.
  • ? - Shows /town commands available.
  • {town} - Shows a player another town's town screen.
  • here - Shows you the town screen of the town in which you stand.
  • leave - Leaves a town.
  • list - Lists towns.
  • online - Shows players in your town which are online.
  • new
  • {townname} - Creates new town.
  • {townname} {mayor} - Admin command to create town.
  • add {resident} .. {resident} - Mayor command to add residents to your town.
  • kick {resident} .. {resident} - Mayor command to remove residents from your town.
  • spawn - Teleports you to your town's spawn.
  • spawn {town} - Teleports you to another town's spawn.
  • claim - Mayor command to claim the townblock in which you stand for your town.
  • outpost - Claims an outpost for your town.
  • {# (radius around current position)} - Claims an area of townblocks around you for your town.
  • 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.
  • all - Mayor command to unclaim all townblocks.
  • {# (radius around current position)} - Command to unclaim an area of townblocks around you.
  • withdraw {$} - Removes money from town bank.
  • deposit {$} - Adds money from player to the town bank.
  • buy
  • bonus {amount} - Buys available bonus townblocks.
  • delete {town name} - Admin/Mayor command to delete a town from towny's data folder's files.
  • outpost
  • {# (where # equals the corresponding outpost's number)} - Teleports to an outpost.
  • ranklist - Displays residents and their ranks.
  • rank {add|remove} {playername} {rankname} - Grants or removes a rank to a resident of the town.
  • reslist - Displays a full list of residents in the town.
  • set
  • board {message} - Sets message seen by residents upon logging in.
  • mayor {resident} - Mayor command to give mayor status to another resident.
  • homeblock - Sets the homeblock and spawn of your town.
  • spawn - Sets the town spawn, must be done inside the homeblock.
  • name {name} - Change your town's name.
  • outpost - Sets a townblock as an outpost.
  • perm
  • {on/off} - Edits the perm line on the town screen. See here for details.
  • {resident/ally/outsider} {on/off}
  • {build/destroy/switch/itemuse} {on/off}
  • {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
  • reset - This takes the perm line seen in the /town screen and applies it to all plots owned by the town.
  • tag {upto4character} - Sets the town's tag, which is sometimes used on that chat line.
  • clear - Clears the tag set for the town.
  • taxes {$} - Sets taxes collected from each resident daily. Also sets percentage if taxpercent is toggled on.
  • plottax {$} - Set taxes collected from each resident daily, per plot that they own.
  • plotprice {$} - Sets default cost of plot for the town.
  • shopprice {$} - Sets default cost of a shopplot for the town.
  • shoptax {$} - Set taxes collected from each resident daily, per shopplot that they own.
  • embassyprice {$} - Sets default cost of a embassy plot for the town.
  • embassytax {$} - Set taxes collected from each resident daily, per embassy plot that they own.
  • toggle
  • explosion - Turn on/off explosions in town.
  • fire - Turn on/off firespread in town.
  • mobs - Turn on/off hostile mobspawning in town.
  • public - Turn on/off public /town spawning and the co-ordinates of the town's homeblock in the /town screen.
  • pvp - Turn on/off pvp in town.
  • taxpercent - Turn on/off taxing by percent/flatrate.
  • open - Turn on/off public joining to your town.
  • join {townname} - Command to join a town that doesn't require invites.


/nation

  • /nation
  •      Shows a player their nation's nation screen.
  • ? - Shows /nation commands.
  • list - 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.
  • {nationname} {capitaltown} - Admin command to create a new nation, set capitol.
  • rank - Command to set assistant/custom ranks in the nation.
  • add {town} .. {town} - Invites/Adds a town to your nation.
  • kick {town} .. {town} - Removes a town from your nation.
  • delete {nation} - Deletes your nation.
  • ally
  • add {nation} .. {nation} - Add a nation to your nation's ally list.
  • remove {nation} .. {nation} - Removes a nation from your nation's ally list.
  • enemy
  • add {nation} .. {nation} - Add a nation to your nation's enemy list.
  • remove {nation} .. {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.
  • captial {town} - Sets the capitol and king of the nation.
  • taxes {$} - Sets nationtax applied to the towns within the nation.
  • name {name} - Sets the nation's name.
  • title {name} {titlegoeshere} - King command to add a Title to a member of the nation.
  • surname {name} {surnamegoeshere} - King command to add a Suffix to a member of the nation.
  • tag {upto4character} - Sets the nation's tag, which is sometimes used on that chat line.
  • clear - Clears the tag set for the nation.
  • toggle
  • neutral - Sets whether your nation will pay daily to be neutral during towny war.


/townyadmin

  • /townyadmin
  •      Shows Memory, Threads, War status, Health regen setting, Time, Whether daily-timer/taxes are on.
  • ? - Shows /ta commands.
  • delete {playername} - Deletes a player's towny data.
  • town {town}
  • add {resident} .. {resident} - Admin command to invite/add a resident to a town.
  • remove {resident} .. {resident} - Admin command to remove a resident from a town.
  • kick {resident} - Admin command to remove a resident from a town.
  • rename {newname} - Admin command to rename a town.
  • pawn - Admin command to spawn at at town spawn.
  • utpost # - Admin command to spawn at any towns outposts.
  • delete - Admin command to delete a town.
  • nation
  • {nationname} add {town} - Admin command to invite/add a town to a nation.
  • {nationname} rename {newname} - Admin command to rename a nation.
  • {nationname} delete - Admin command to delete a town.
  • reset - resets the towny config.yml to its current default.
  • toggle
  • war - Turn on/off towny war.
  • neutral - Turn on/off a nation's ability to declare neutrality.
  • npc {residentname} - Toggles a player's resident file to isNPC=true, this exempts the player from taxes/upkeep.
  • debug - Turns on/off debug mode.
  • devmode - Turns on/off special devmode for when towny's devs join your server to find a bug.
  • withdraw - Turns on/off town/nation's ability to withdraw money from their town/nation banks.
  • set
  • capital {townname} - A command for admins to be able to change a nations capital. Town to be set must already be a member of the nation.
  • mayor
  • {town} {resident} - Admin command to set a resident as mayor of a town.
  • {town} npc - Admin command to set a town to have an npc mayor.
  • givebonus {town} {#} - Gives extra townblocks to a town.
  • reload - Reloads towny's config.yml.
  • backup - Creates a backup.
  • newday - Causes a new day to happen, this does not stop the next new day from happening when it was already scheduled.
  • unclaim
  • rect {radius} - Admin command to unclaim an area.
  • purge {# as in days} - Deletes old residents.


/townyworld

  • /townyworld
  • Shows world settings for the world in which you stand.
  • ? - Shows /tw commands.
  • list - Lists worlds.
  • {world} - Show settings for world.
  • toggle
  • claimable - Turn on/off whether mayors can claim townblocks in the world.
  • usingtowny - Turn on/off whether towny is used in the world.
  • pvp - Turn on/off pvp in the world.
  • forcepvp - Turn on/off whether pvp is forced on in all towns in the world.
  • explosion - Turn on/off whether explosions are on in the wilderness/towns in the world.
  • forceexplosion - Force explosions on in that world.
  • fire - Turn on/off whether firespread is on in the wilderness/towns in the world.
  • townmobs - Turn on/off hostile mobspawning in towns in the world.
  • worldmobs - Turn on/off the mobs listed in the world mobs in the world.
  • revertunclaim - Turn on/off the revert on unclaim feature for that world.
  • revertexpl - Turn on/off the reverting explosions in the wilderness feature for that world.
  • set
  • wildname {name} - Sets name of the wilderness.
  • wildperm {perm} .. {perm} - Deprecated.
  • wildignore {id} .. {id} - Deprecated.
  • wildregen
  • {Creeper,EnderCrystal,EnderDragon,Fireball,SmallFireball,LargeFireball,TNTPrimed,ExplosiveMinecart} - Sets what explosions are reverted in the wilderness.
  • usedefault - Deprecated.
  • regen - Regenerates the MC chunk in which back to the seed.
  • undo - Undoes /tw regen.


Chat Commands

  • /townychat reload - Reloads chatconfig.yml and channels.yml
  • /townchat, /tc
  • Put in from of text to speak with members of your town only, or without text afterwards to enter the channel.
  • /nationchat, /nc
  • Put in from of text to speak with members of your nation only, or without text afterwards to enter the channel.
  • /global, /g
  • Put in from of text to speak in globalchat, or without text afterwards to enter the channel.
  • /res set mode reset
  • Reset chat mode to default chat.
  • /a - admin chat.
  • /m - moderator chat.
  • /channel leave|join {channel} - Channel leaving and joining.
  • /leave {channel} - Leaves a channel.
  • /join {channel} - Joins a channel.
  • /chmute {channel} {player} - Mutes a player in a channel.
  • /mutelist {channel} - Displays mute list for a channel.
  • /chunmute {channel} {player} - Unmutes a player in a channel.


End of Guide!