|
# this is just the help for puls minecraft server WHAT DOES THIS WIKI HOLDTOWNY # http://code.google.com/p/puls-server-help/wiki/plugins#Towny TownyRESIDENTS # http://code.google.com/p/puls-server-help/wiki/plugins#RESIDENTS TOWNS # http://code.google.com/p/puls-server-help/wiki/plugins#TOWNS Mayors # http://code.google.com/p/puls-server-help/wiki/plugins#Mayors NATIONS # http://code.google.com/p/puls-server-help/wiki/plugins#Nations KINGS # http://code.google.com/p/puls-server-help/wiki/plugins#Kings STARTING A TOWN # http://code.google.com/p/puls-server-help/wiki/plugins#Starting_a_Town Joining Towns # http://code.google.com/p/puls-server-help/wiki/plugins#Joining_Towns Town Blocks # http://code.google.com/p/puls-server-help/wiki/plugins#Town_Blocks PLOT TYPES # http://code.google.com/p/puls-server-help/wiki/plugins#PLOT_TYPES OUTPOSTS # http://code.google.com/p/puls-server-help/wiki/plugins#OUTPOSTS Selling Land # http://code.google.com/p/puls-server-help/wiki/plugins#Selling_Land Using the Maps # http://code.google.com/p/puls-server-help/wiki/plugins#Using_the_Maps Kings minions # http://code.google.com/p/puls-server-help/wiki/plugins#Kings_minions WAR # http://code.google.com/p/puls-server-help/wiki/plugins#WAR Attacking # http://code.google.com/p/puls-server-help/wiki/plugins#Attacking Defending # http://code.google.com/p/puls-server-help/wiki/plugins#Defending COMMANDS # http://code.google.com/p/puls-server-help/wiki/plugins#COMMANDS RESIDENTSYOU are a resident. Residents have their own command /resident which used by itself outputs a Resident Screen, displaying Money, Town, Plots owned and Friends. Residents can join towns or choose to start a town on your own. Residents who join towns can claim plots that the Mayor of the town has set for sale. When a resident owns 1 or more plots, they will see a new line on their Resident Screen, showing plots owned and a perm line showing the plot perms given on all plots that resident owns. TOWNSA town is a collection of residents (or just one resident) with one resident as the mayor. A town also has a bank which the mayor can withdraw from. A mayor can also have assistants who have the same powers as him/herself. Towns can have taxes that will be taken at the end of each day interval. Towns usually grow outwards from their home block, the townblock the mayor stood in during town creation. Townblocks need to be claimed beside other townblocks, unless the mayor claims an outpost in the wilderness. MayorsMayors run towns and with the help of their assistants, manage a town and its residents. It is not possible to run two towns unless you are also an admin. NationsA nation is a collection of towns (or just one town) with one town as the capital. The mayor of that capital is the king. A nation can join the war event, as well as ally other nations. A nation also has it's own bank. It can also tax the towns that belong to it KingsKings lead Nations and are the mayor of the capital city. Kings have the ability to set titles (prefixes) and surnames (postfixes) to the residents of the towns they have in their nation. This is done with: /nation set title {name} titlegoeshere /nation set surname {name} surnamegoeshereTyping the commands with nothing after the player's name resets the title or surname to blank. Starting a TownMayors start towns using the command /town new {townname}. The townblock they are standing in will be the home block for the town, the exact spot/position will be the spawn point for the town. More townblocks can be claimed using /town claim. These townblocks need to be directly adjacent to already claimed townblocks. Joining TownsThere are two ways to join towns, the first is by being invited by a Mayor or a Town assistant. The second it by joining an open town. Mayors and assistants can add players to their town with the command /town add {playername}. then the player there is invited either use "/accept" to accept or "/deny" to deny. Mayors can set their towns to open using /town toggle open. A player who isn't in a town already can use the command /town join {townname} to join open towns. When residents join towns they increase the number of townblocks accessible to the mayor for claiming. Town BlocksTowny provides a server admin a hands-off approach to block-protection. Block protection is broken down into plots of land, called townblocks, which by default are 16x16x128 (the full height of the world.) Townblocks are claimed by town mayors who can then sell/give individual plots to their town's residents PLOT TYPESDefault Plots These plots do not need any specific command to be designated. They are put up for sale with /plot forsale {$$}. A plot which is not of default type can be reset to a default plot with /plot set reset. Shop Plots Shop plots are designated with /plot set shop A mayor can use /town set shopprice {$$} to set how much shop plots are sold at by default. This can be overriden when a mayor puts the actual plot up for sale with /plot forsale {$$}. A mayor can also charge an additional shoptax with /town set shoptax {$$}. This tax is charged in addition to the normal plottax. Arena Plots Arena plots are designated with /plot set arena. PVP is on all the time in arena plots as well as friendly-fire damage. Town health regen is also disabled in arena plots. Embassy Plots Embassy plots are designated with /plot set embassy A mayor can use /town set embassyprice {$$} to set how much embassy plots are sold at by default. This can be overriden when a mayor puts the actual plot up for sale with /plot forsale {$$}. A mayor can also charge an additional embassytax with /town set embassytax {$$}. This tax is charged in addition to the normal plottax.An embassy plot can be bought by any player. The townblock remains owned by the host-town and a mayor from the host-towncan take the plot from the owner at any time. Embassy plots can also be changed into shop plots, allowing for larger shop towns, where many different towns' players can set up shops. Wilds Plots Wilds plots are designated with /plot set wilds A wilds plot allows residents to destroy the blocks found on the wild ignore ID list. This includes ores, trees, flowers, mushrooms and other harvestable blocks. It is useful for creating tree farms, and protecting the terrain around a town, while still allowing residents to cut trees and explore caves OUTPOSTSNormally townblocks are claimed around the home block, always connected to the town. To claim a townblock out in the wilderness, a mayor or assistant must claim an outpost. Outposts can be teleported to, mayors set the spawn point of the outpost when they claim it or using '/town set outpost'. Players teleport to the outpost using '/town outpost x' (with x being a number 1 - however many outposts the town has.) Selling LandLand is sold by Mayors to Residents that are a part of their town. Mayors have a command used in game to set the cost of all the plots in their town that are for sale "/town set plotprice {$}"This sets the cost of every plot that is on sale. If it is not set, the plots will cost $0 by default. To put a plot up for sale a mayor, while standing in the plot, type /plot forsale {optional cost} The resident would then type /plot claim while standing in the plot to buy it. Using the MapsThe map in towny displays the grid system of plots. The map can be viewed once using /towny map one time or you can set the map to show every time you move from one block to another: Use /resident set mode map to turn it on. And use /resident set mode reset to turn it off.A large version of the map can be seen using /towny map big. Kings minionsprefixes and suffixes. Kings of nations can use two commands to change the displayed chat names of their minions: /nation set title {resident} {text of prefix}Adds a prefix to the player./nation set surname {resident} {text of suffix}Adds a suffix to the player.A title/surname given to a mayor will override the MayorPrefix/MayorPostfix set in the townLevels of the config. He will still retain the colouring set on mayor names (default is light blue.) WARWhat are the requirements for war? War is only between nations. Towns not in a nation cannot go to war. How Does (Enemy) War Work? Nation A decides that Nation B sucks. The King declares them enemies. /nation enemy add NationB They residents of NationA can now attack the towns of NationB. In order to attack, residents first need to obtain some fence posts so that they can raise their flag and dub the plots of NationB as their own. The flag bearer is the player who will be placing the flag. When the plot has been won over, the plot will be claimed as part of the flagbearer’s town (so make sure they have extra plots available to claim). AttackingYou cannot attack a nation that is neutral. You cannot attack while being in a neutral nation. You can only attack the borders plots. You can only place flags on the surface. You can also not attack a nation with less than 3 players online and the town you’re attacking must have more than 1 player online. These same requirements are in place for you as well, so you must have the minimum in both cases. This is so that the target can retaliate as well as know what’s going on. Attacking a nation will cause you to become their enemies. This allows for the target to retaliate immediately without waiting for the target’s king or his assistants to come online. Towny will automatically place a block of wool for the flag, as well as a light source on top. In the sky you will notice a large beacon so that the defenders know where to go. The wool will animate from green to red as time progresses. After the wool has gone red, the attacker will have held out long enough that they win the area. =Defending=. Once an attack has started. Teleport to the town under attack. Scan the sky for the beacon and make your way to it. The flag will be on the surface. Kill your enemies and make your way to their flag. Destroy the cloth part of the flag to cancel the attack. COMMANDS/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.) topmoney {all/resident/town/nation} - Shows top money-hoarders. 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. warstats scores /plot /plot/resident- 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.{forsale/fs} - Set a plot for sale.{# (radius around current position)} - Radius of the area to unclaim.circle/rect - Set a shape.{notforsale/nfs} - Set a plot to not be for sale.{# (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.circle/rect - Set a shape.perm - Shows the perm line of the plot in which the player stands. set{# (radius around current position)} - Radius of the area to set notforsale.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. permtoggle{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.)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/town- Shows a player their resident screen. ? - Shows /res commands available. {resident} - Shows a player another player's resident screen. delete {resident} - Admin command that deletes a resident from the towny data folder's files. friendadd {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. togglemap - 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.setperm{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- 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. assistantadd {resident} .. {resident} - Mayor command to add assistants to your town. remove {resident} .. {resident} - Mayor command to remove assistants 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. buybonus {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.setboard {message} - Sets message seen by residents upon logging in. mayor {resident} - Mayor command to give mayor status to another resident. homeblock - Sets the homeblock 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. permtoggle{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.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 /nationChat Commands- 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.assistantadd {resident} .. {resident} - King command to add assistants to your nation. remove {resident} .. {resident} - King command to remove assistants from your 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. allyadd {nation} .. {nation} - Add a nation to your nation's ally list. remove {nation} .. {nation} - Removes a nation from your nation's ally list.enemyadd {nation} .. {nation} - Add a nation to your nation's enemy list. remove {nation} .. {nation} - Removes a nation from your nation's enemy list.setking {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.toggleclear - Clears the tag set for the nation.neutral - Sets whether your nation will pay daily to be neutral during towny war. /townychat reload - Reloads chatconfig.yml and channels.yml /townchat, /tcPut in from of text to speak with members of your town only, or without text afterwards to enter the channel./nationchat, /ncPut in from of text to speak with members of your nation only, or without text afterwards to enter the channel./global, /gPut in from of text to speak in globalchat, or without text afterwards to enter the channel./res set mode resetReset chat mode to default chat. |