Towny
Towny is the plugin we are using for land protection/claims. It is a very powerful, advanced plugin with many features. Please use this guide here for anything Towny! There is a lot of different ways Towny can be configured - do not trust a guide from another website or a YouTube video!
There are two major parts to towny, Towns and Nations.
Town:
To start, let's go over the types of towns:
- Settlement (max 1 person, $10 daily upkeep)
- Hamlet (max 2 people, $20 daily upkeep)
- Village (max 6 people, $3,00 daily upkeep)
- Town (max 10 people, $5,00 daily upkeep)
- Large Town (max 14 people, $1,200 daily upkeep)
- City (max 20 people, $1,500 daily upkeep)
- Large City (max 24 people, $1,800 daily upkeep)
- Metropolis (max 28 people, $2,000 daily upkeep)
Note: The daily upkeep is taken out of the town's balance, make sure to deposit enough money to upkeep your town!
There are also different ranks & permissions you can have within a town:
- Mayor (leader)
- All Town commands/options
- Assistant
- All mayor permissions except nation permissions
- Advisor
- Control Tax
- Claim Chunks
- Invite to Town
- Manage Plots
- All permissions of Helper & Sheriff
- Helper
- Sheriff
Cost to start a Town: $250
Cost to claim a plot: $25 (+3% each additional plot claimed, compounding)
- Example: It will cost about $13,570 to claim your 25th chunk.
Commands:
There are many different towny commands, divided up into different sections.
All Commands:
- /towny
-
- Shows basic towny commands.
- ? - Shows more towny commands.
- map - Shows the towny map.
- hud - Activates the map in the player's scoreboard.
- 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.
- universe - Shows full towny stats, resident/town/nation/world counts as well as townblocks claimed.
- /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.
-
evict - Used to remove a plot from a plot owner, usually by the mayor or assistant.
-
trust
- add {name} - Adds a player as Trusted on the plot.
- remove {name} - Removes a player from being Trusted on the plot.
-
perm - Shows the perm line of the plot in which the player stands.
- gui - opens the GUI to configure the plot perm override.
- add {name} - Adds a player to the plot perm override.
- remove {name} - Removes a player from the plot perm override.
-
perm hud - Toggles on/off the plot perm hud scoreboard which shows the perm line of the plot in which the player stands along with more useful plot info.
- 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.
- inn - Set a plot to an inn plot.
- jail - Set a plot to an jail plot.
- farm - Set a plot to a farm plot.
- bank - Set a plot to a bank plot.
- outpost - Set a plot to an outpost plot, costs the same as /t claim outpost.
- spawn - Sets the spawn point inside of an existing outpost plot to where the player is standing.
- 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.
setperm
- {on/off} - Edits the perm line of the single plot in which the player is standing. 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 - 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.
- taxed - Turn on/off whether a plot will charge a plotowner taxes, while they own the plot personally.
-
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.
-
group
- add|new|create {groupname} - Creates a plot group where a player is standing, also adds plots to an existing group.
- remove - Removes the plot stood in from its plot group.
- delete - Deletes a plot group entirely.
- rename {newname} - Renames a plot group.
- set {plottype} - Sets the group to a specified plot type. Not able to be used for Jail plots.
- set perm ... - Used to set the perm line of the group you are standing in. See above section for /plot set perm for remainder of commands.
- toggle ... - Used to toggle plot settings. See above section for /plot set toggle for remainder of commands.
- forsale|fs {price} - Set the group for sale at the set price.
- notforsale|nfs - Set the group not for sale.
- trust
- add {name} - Adds a player as Trusted on the plot group.
- remove {name} - Removes a player from being Trusted on the plot group.
- perm
- gui - Opens the GUI to edit the plot perm override.
- add {name} - Adds a player to the plot perm override.
- remove {name} - Removes a player from the plot perm override.
-
jailcell
- add - Adds a jail cell to a jail plot, where the player is stood.
- remove - Removes a jail cell from a jail plot, where the player is stood.
- /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 - Returns a list of your friends.
- list - Lists residents in towny's data folder who are online.
- jail paybail - Allows a player to pay to get out of jail. Funds go to the town which owns the Jail.
- outlawlist {playername} - Display the list of towns in which a resident is outlawed in. Leave out the optional player name to see the towns in which you are an outlaw.
- plotlist
- {#} - Shows a player their own list of plots, with an optional page number.
- [name] {#} - Shows a list of plots for the given player name, with an optional page number.
- spawn - If deny_bed_use: true 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.
- constantplotborder - Turns on smokey plot-border view. Border doesn't disappear.
- bordertitles - Turns on/off the Title messages seen when entering/leaving town, when using_titles is true in the config.
- spy - Admins can turn on chat-channel spying.
- ignoreplots - Turns on/off plot notifications in town.
- reset - This turns off all modes that are active.
- infotool - Allows an admin to use the clay brick tool to determine the Bukkit names/classes of blocks and entities.
- adminbypass - Used to make admins play as non-admins.
- 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.
- about
- {message] - Sets a bio/about message shown in the /res status screen.
- {clear|none|reset} - Removes the current about message.
- tax {resname} - Shows taxes a player pays.
- /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
- by name {page #} - order alpabetically.
- by resident {page #} - order by town with most residents.
- by balance {page #} - order by town with the highest nation bank balance.
- by townblocks {page #} - order towns by how many townblocks they have claimed.
- by online {page #} - order by how many players are online at that moment.
- by open {page #} - lists open towns first, in order of most residents to least residents.
- by public {page #} - lists public towns first, in order of most residents to least residents.
- by ruined {page #} - lists ruined towns first, in order of most residents to least residents.
- by bankrupt {page #} - lists bankrupt towns first, in order of most residents to least residents.
- by founded {page #} - order by founded date, oldest first.
-
online - Shows players in your town which are online.
-
plots {townname} - Shows a helpful list of plots and their types/revenue which are owned by the town.
-
new {townname} - Creates a new town.
-
add {resident} .. {resident} - Mayor command to add residents to your town.
-
kick {resident} .. {resident} - Mayor command to remove residents from your town.
-
invite - Show a list of players who've been sent invites to your town.
- sent - Show a list of players who've been sent invites to your town.
- removeall - Denies all of your town's sent invites.
- received - Show a list of invites your town has received from nations.
- accept {nationname} - Accept an invite to join a nation.
- deny {nationname} - Deny an invite to join a nation.
- {playername} - Send an invite to a player to join 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 <#|{name}|{name:#} - Claims an outpost for your town. {name} uses the plot name. {name:#} is used when a plot name begins with a number.
- {# (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.
- fill - Flood fills a surrounded section of plots. You must claim your border before using this command.
-
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.
- outpost - Used to unclaim glitched outposts on MySQL Towny servers pre-0.92.0.0
-
/town cede plot {townname}
- Attempts to give the townblock the player is stood in, to the given town.
-
withdraw
- {$} - Removes money from town bank.
- all - Withdraws all of the money from the town bank.
-
deposit
- {$} - Adds money from player to the town bank.
- all - Deposits all of your money into the town bank.
- {$} {townname} - Deposits money from player into the specified town's bank.
-
baltop {townname} - Opens a book displaying the richest players in a town.
-
bankhistory {#} - Opens a book GUI with # number of transactions listed, showing the town bank history.
-
buy
- bonus {amount} - Buys available bonus townblocks.
-
allylist {townname} - Displays a list of allies for the Town.
-
enemylist {townname} - Displays a list of enemies for the Town.
-
delete {town name} - Admin/Mayor command to delete a town from towny's data folder's files.
-
forsale|fs [$] - Puts up a town for sale at the specified amount.
-
notforsale|nfs - Removes a town being available for sale.
-
buytown {townname} - Prompts a player to buy a town which is set for sale.
-
merge {town name} - {town name} is the town which will be merged into the town owned by the mayor using the command.
-
outlawlist {town} - Displays a list of outlaws for a town.
-
outlaw {add/remove} {name} - Adds or removes an outlaw from a town's outlaw list
-
outpost
- {# (where # equals the corresponding outpost's number)} - Teleports to an outpost.
- {list} - lists your town's outposts.
-
plotgrouplist {townname} {page #} - Lists a town's plotgroups with forsale and price indicated.
-
purge {days} - Kicks residents from the town who have been inactive for the given number of days, exempts npcs and mayors.
-
ranklist {townname} - Displays residents and their ranks, optional townname to view another town's rank list.
-
rank {add|remove} {playername} {rankname} - Grants or removes a rank to a resident of the town.
-
reclaim - allows a resident to reclaim their ruined town.
-
reslist {townname} - See a FULL list of all residents in a town.
-
say {msg} - Broadcast a message to online town members.
-
set
- board
- {message} - Sets message seen by residents upon logging in.
- none - Sets an empty board which will not be seen on login or in the /town status screen.
- 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.
- spawncost - Set the cost of spawning to a public town. Doesn't affect town residents, nation members and nation-allies.
- mapcolor {color} - Sets a town's mapcolor seen in the dynmap.
- name {name} - Change your town's name.
- outpost - Resets the outpost's spawn point to the player location. Must be used in an existing outpost plot.
- 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.
- taxpercentcap {$} - The maximum amount that can be taken when taxpercent is enabled.
- 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.
- title {name} {titlegoeshere} - Mayor command to add a Title to a member of the town.
- title {name} - Mayor command to remove a Title from a member of the town.
- surname {name} {surnamegoeshere} - Mayor command to add a Suffix to a member of the town.
- surname {name} - Mayor command to remove a Suffix from a member of the town.
- primaryjail - Sets your town's primary jail.
-
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.
- nationzone - Turn on/off the town's NationZone.
- open - Turn on/off public joining to your town.
-
takeoverclaim - Used by a mayor to take over land from an overclaimed town, when overclaiming is allowed in the config.
-
join {townname} - Command to join a town that doesn't require invites.
-
jail
- list - Shows jail number, name, coord, cellcount and which jail is the primary jail.
- When Bail is not Enabled:
- {name} - Jails the given player for 1 hour, must be a resident of your own town.
- {name} {hours} - Jails the given player for the given hours.
- {name} {hours} {jail} - Jails the given player for the given hours, in the given jail plot (which is a number.)
- {name} {hours} {jail} {cell} - Jails the given player for the given hours, in the given jail plot and jail cell (which are both numbers.)
- When Bail is Enabled:
- {name} - Jails the given player for 1 hour, must be a resident of your own town, with the default bail amount.
- {name} {hours} - Jails the given player for the given hours, with the default bail amount.
- {name} {hours} {bail} - Jails the given player for the given hours, with the given bail amount.
- {name} {hours} {bail} {jail} - Jails the given player for the given hours, with the given bail amount, in the given jail plot (which is a number.)
- {name} {hours} {bail} {jail} {cell} - Jails the given player for the given hours, with the given bail amount, in the given jail plot and jail cell (which are both numbers.)
-
unjail {name} - Unjails someone in your town's jail.
-
trust
- add {name} - Adds a player as Trusted to the entire town.
- remove {name} - Removes a player from being Trusted by the entire town.
- list - Displays a list of trusted players for the town.
-
trusttown
- add [townname] - Adds an entire town as trusted in your town.
- remove [townname] - Removes an entire town as trusted in your town.
- list - Displays a list of trusted towns in your town.
139
0
