How to Play

## The Basics

In Dashworld, we use a system called Towny to make our towns & nations. With this plugin, we are also able to create custom cultures and war!

**Towns** cost 50 points (5 Hours of play) and **Nations** cost 270 points (27 Hours of play from one person. Can be divided among Town members).

Every person you add to your town gives you 8 new chunks, or **plots** you can claim to protect your territory.

# Towny Commands

## /towny

* /towny
	+ - Shows basic towny commands.
	+ ? - Shows more towny commands.
	+ allowedblocks - Opens a menu where you can check what blocks might be allowed to be built/destroyed in
	+ itemuse - Shows the items in the item\_use\_ids list.
	+ map - Shows the towny map.
		- hud - Activates the map in the player's scoreboard.
	+ plotclearblocks - Shows the blocks deleted using `/plot clear`
	+ prices - Shows taxes/costs associated with running a town.
	+ switches - Shows the blocks in the switch\_ids list.
	+ 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.
	+ wildsblocks - Shows the blocks that are usable in wilds plots, and which are allowed to be farmed in the wilderness.

## /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.
	+ 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.
	+ 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.
		- 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.
		- 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. 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.
	+ 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

* /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.
	+ 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.
	+ 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 {resname} - 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
		- 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.
		- 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.
	+ 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
	+ withdraw {$} - Removes money from town bank.
	+ deposit {$} - Adds money from player to the town 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.
	+ 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.
		- jail - Resets a jail plot's spawn to current position within a jail 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.
		- surname {name} {surnamegoeshere} - Mayor command to add a Suffix to 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.
	+ 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.
		- {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.)
	+ 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.

## /nation

* /nation
	+ - Shows a player their nation's nation screen.
	+ ? - Shows /nation commands.
	+ list
		- by name {page #} - order alpabetically.
		- by resident {page #} - order by nation with most residents across all towns.
		- by balance {page #} - order by nation with the highest nation bank balance.
		- by towns {page #} - order by nation with the most towns.
		- by townblocks {page #} - order nations by how many townblocks their towns have collectively claimed.
		- by online {page #} - order by how many players are online at that moment.
		- by open {page #} - ordered by open first, number of residents second.
		- by public {page #} - order by public first, number of residents second.
		- by founded {page #} - order by founded date, oldest first.
	+ 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.
	+ baltop {nationname} - Opens a book displaying the richest players in a nation.
	+ bankhistory {#} - Opens a book GUI with # number of transactions listed, showing the nation bank history.
	+ deposit {$} {townname} - King command to add money to the bank of a town who is in the nation.
	+ new
		- {nationname} - Mayor command to create a nation.
	+ 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.
	+ invite - Show a list of invites sent.
		- help - Show a list of invites sent.
		- sent - Show a list of invites sent.
		- {town} - Invites a town to a nation.
	+ ally - Show a list of nation alliance invites sent.
		- add {nation} .. {nation} - Add a nation to your nation's ally list.
		- remove {nation} .. {nation} - Removes a nation from your nation's ally list.
		- accept {nationname} - Accepts an invitation to ally from another nation.
		- deny {nationname} - Denies an invitation to ally from another nation.
		- sent - Show a list of nation alliance invites sent.
		- received - Show a list of nation alliance invites received.
	+ 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.
	+ say {msg} - Broadcast a message to online nation members.
	+ set
		- king {resident} - King command to change the king of the nation.
		- capital {town} - Sets the capitol and king of the nation.
		- 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 /nation status screen.
		- taxes {$} - Sets nationtax applied to the towns within the nation.
		- name {name} - Sets the nation's name.
		- spawn - Sets the nation spawn point.
		- spawncost - Sets the cost of public spawns to that nation's spawn point. No effect on members of the nation or nation-allies
		- 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.
		- mapcolor {color} - Sets the colour seen on the dynmap-towny webpage.
	+ toggle
		- neutral - Sets whether your nation will pay daily to be neutral during towny war.
		- open - Sets the nation to be open, so that any town can join without an invite.
	+ join {nation}
		- Used by a town mayor to join an open nation.
	+ merge {nationname}
		- Requests the given nation to merge into your nation.
		- Can only be used by the nation king, and requires the king of the other nation to be online to accept the merger.
		- The soon-to-be-ex-king will receive a confirmation message asking if they will accept the dissolution of their nation.
		- If accepted the towns of the nation transfer to the remaining nation. The nation's bank money is also transferred.
	+ ranklist {nationname} - Displays residents and their ranks, optional nationname to view another nation's rank list.
	+ townlist (nation)
		- (nation) is optional, to show townlist of a nation you aren't a part of.
		- lists all towns in a nation.
	+ allylist (nation)
		- (nation) is optional, to show allylist of a nation you aren't a part of.
		- lists all allies of a nation.
	+ enemylist (nation)
		- (nation) is optional, to show enemylist of a nation you aren't a part of.
		- lists all enemies of a nation.

### Chest Locks

* Just **place a chest**/double chest and **put a sign on one of its sides**, with **[Protect] on the 1st line** (configurable), it will instantly protect the chest, making the text on the sign colorful and pretty to see, with your name in one of its lines. This costs **2 Player Points per lock.** After that only you can access the chest, in any kind of environment.