Towny

General plugin guide.

Towny

Postby lionbandgeek92 » Mon Jan 09, 2012 8:05 pm

ugh... finally a towny plugin help.... I really didn't want to do this one because of the need for previous knowledge about how towny works before even jumping into commands...
Anyway...
Towny itself is a manager for a Resident-Town-Nation hierarchy, as well as a block permission manager for a grid-like protection system. Each town has a mayor, while a nation has a king. They both have their own assistants to help run their respective people. Players can also purchase land from the town, for a daily tax set by the mayor. The player can allow his friends from out of town to build on his land when even his very own town's people can't build if he so wishes.

The bases of protection follows under how the world is seperated into chunks. For those unaware, minecraft servers are broken up into 16x16x128 sections of blocks. The 128 being the height from the bedrock floor to the clouds in the sky. The protection ignores the height and focuses on the x and z planes, this being said everyplot is protected from bedrock to skylimit. The default size for plots on this server is 8x8. So claiming townblock (a grid square) allows that section of land to follow your town's or the plot owner's permissions.

Each town can claim up to a certain amount of townblocks, a set ratio or amount configured in the setting that is relative to the amount of players taking residence in that town. Residents themselves have no limit on how many they claim, however the daily tax (when using alongside iConomy) will take a bite out of their resources. The money is tunneled to the town's bank account that only the mayor can withdraw from, except if the town belongs to a nation. Any town belonging to a nation is required to pay the nation a daily upkeep as well. Towns can claim a certain number of cells in the grid according to how many residents the town has.

Prices
Town Start: $10,000
Nation Start: $100,000
Town Tax: $500
Nation Tax: $1,000
Town Claim Regular Plots: $500
Town Claim Outpost Plots: $5,000



Note for commands:
For resident commands, the add command would auto-match online players, while add+ requires exact spelling to choose offline players.
The [] brackets are used to show variables, or what you need to fill in. The elipse ".." (or shortened elipse) 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 a single word taken from a list shown in the brackets.


Resident
/resident [resident]
Displays information on the resident specified.

/resident friend add [resident] .. [resident]
Adds a resident to your friends list (this allows other people to build/destroy on your plots).

/resident friend remove [resident] .. [resident]
Removes a resident from your friends list.

/resident set mode [mode]..[mode]
Sets a sustained mode (list of modes for this command with descriptions below)

/resident set perm [on/off]
Toggles all resident permissions on/off inside town.

/resident set perm [friend/ally/outsider] [on/off]
Toggles all resident permissions on/off for friends/ally/outsiders inside town.

/resident set perm [build/destroy/switch/itemuse] [on/off]
Toggles build/destroy/switch/itemuse permissions on/off inside town.

/resident set perm [friend/ally/outsider] [build/destroy/switch/itemuse] [on/off]
Toggles build/destroy/switch/itemuse permissions on/off for friends/ally/outsiders inside town.

Modes:
map - displays a map as you walk of your town
townchat, tc - sets chat for your town on all the time
nationchat, nc - sets chat for your nation on all the time
townclaim - claims plots from wildy for your town as you walk
reset (This turns off all modes that are active.) - resets all modes to off


Town
/town [town]
Displays information about the given town.

/town here
Displays information about the town you are standing in.

/town leave
Leaves the current town you are in.

/town list
Displays a list of towns on this server.

/town online
Displays a list of residents online in your town.

/town new [townname]
Creates a town with the given name (this will charge you the amount set for the server... see prices above).

/town new [townname] [mayor]
Creates a town with the given name and sets the mayor as the person you put in (this will charge you the amount set for the server... see prices above).

/town add [resident] .. [resident]
Invites a resident to your town.

/town kick [resident] .. [resident]
Kicks a resident from your town.

/town assistant add [resident] .. [resident]
Adds a resident in your town as an assistant mayor.

/town assistant remove [resident] .. [resident]
Removes a resident in your town from assistant position.

/town spawn
Teleports you to the town spawn for the town you are in.

/town spawn [town]
Teleports you to the town spawn for the town you put in... WARNING: this may charge you monies.

/town claim
Claims plots from wildy for your town (this requires the plots to be connected to homeblock... see prices).

/town claim outpost
Claims plots from wildy for your town (this does not require connection to be connected to homeblock... see prices).

/town unclaim
Unclaims a plot from your town and is wildy again (has to be on the edge of the town).

/town unclaim all
Unclaims all plots from your town and is wildy again.

/town withdraw [$]
Withdraws money from town bank.

/town deposit [$]
Deposits money into town bank.

/town buy bonus [amount]
Allows you to purchase more plots than you are allowed.

/town delete [town name]
Removes a town and everything inside.

/town set board [message]
Sets a message to be displayed to all residents in your town upon login.

/town set mayor [resident]
Sets a resident inside town as mayor and removes current mayor from position.

/town set homeblock
Moves homeblock for your town.

/town set spawn
Sets spawn for your town... has to be in homeblock area.

/town set name [name]
Changes the name of your town to the one you give.

/town set perm [on/off]
Toggles all permissions on/off inside town.

/town set perm [resident/ally/outsider] [on/off]
Toggles all permissions on/off for friends/ally/outsiders inside town.

/town set perm [build/destroy/switch/itemuse] [on/off]
Toggles build/destroy/switch/itemuse permissions on/off inside town.

/town set perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off]
Toggles build/destroy/switch/itemuse permissions on/off for friends/ally/outsiders inside town.

/town set perm reset
Resets all permissions inside town.

/town set taxes [$]
Sets tax for each resident in your town.

/town set plottax [$]
Sets tax for plots inside town (i.e. a person with two plots would pay this twice on top of the resident tax)

/town set plotprice [$]
Sets default sell price for plots.

/town set shopprice [$]
Sets default shop plot price.

/town set shoptax [$]
Sets tax for shop plots inside town.

/town set embassyprice [$]
Sets default embassy plot price

/town set embassytax [$]
Sets tax for embassy plots inside town.

/town toggle [explosion/fire/mobs/public/pvp/taxpercent]
Toggles explosion/fire/mobs/public/pvp/taxpercent on/off in town


Plot
/plot claim
Resident claims a plot that is forsale.

/plot unclaim
Resident unclaims a plot.

/plot [forsale/fs] [$]
Puts a plot up forsale (if amount is left blank the default plot price will be put in).

/plot [notforsale/nfs]
Takes a plot down from being forsale.

/plot set reset
Resets a plot to default (i.e. if it was a shop plot it is now a regular plot).

/plot set [shop/embassy/arena/wilds]
Sets a plot type to shop/embassy/arena/wilds.

/plot set perm [on/off]
Toggles all permissions on/off for inside a plot.

/plot set perm [resident/ally/outsider] [on/off]
Toggles all permissions on/off for friends/ally/outsiders inside a plot.

/plot set perm [build/destroy/switch/itemuse] [on/off]
Toggles build/destroy/switch/itemuse permissions on/off inside a plot.

/plot set perm [resident/ally/outsider] [build/destroy/switch/itemuse] [on/off]
Toggles build/destroy/switch/itemuse permissions on/off for friends/ally/outsiders inside a plot.

/plot set perm reset
Resets all permissions inside a plot to off.

/plot toggle fire/pvp/explosion/mob
Toggles fire/pvp/explosion/mob on/off inside a plot

/plot toggle clear
Toggles fire/pvp/explosion/mob all off if they are on inside a plot


Nation
/nation
Displays information on the nation you are in.

/nation list
Displays a list of nations on this server.

/nation online
Displays a list of players online in your nation.

/nation [nation]
Displays information on the nation you specify.

/nation leave
Leaves the nation your town is in.

/nation withdraw [$]
Withdraw money from the nations bank.

/nation deposit [$]
Deposit money into the nations bank.

/nation new [nationname]
Creates a new nation with given name (see prices).

/nation new [nationname] [capitaltown]
Creates a new nation with the given name and capital as the town specified (see prices).

/nation assistant add [resident] .. [resident]
Adds a resident as an assistant king to the nation.

/nation assistant remove [resident] .. [resident]
Removes an assistant to the nation from its position.

/nation add [town] .. [town]
Invites a town to the nation.

/nation kick [town] .. [town]
Kicks a town from the nation.

/nation delete [nation]
Removes a nation.

/nation [ally/enemy] [add/remove] [nation] .. [nation]
Adds/removes a nation to the ally/enemy list.

/nation set king [resident]
Sets a nations king as the resident provided removing the king from his current position.

/nation set captial [town]
Sets a nations capital as the town provided removing the current capital.

/nation set taxes [$]
Sets the nations taxes for each town to pay.

/nation set name [name]
Changes the name of the nation to the one specified.

/nation toggle neutral
Toggles a nation as neutral.


Towny
/towny map
Displays a map based upon your current position.

/towny prices
Displays a list of prices for towny related to our server.

/towny time
Time until next tax day.

/towny universe
Displays general info about towny on this server.



Chat Commands
/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.
Image
lionbandgeek92
 
Posts: 392
Joined: Mon Dec 12, 2011 8:29 pm

Re: Towny

Postby crazyscience » Tue Jan 10, 2012 11:20 pm

/towny map big
^^ it shows a big map

I like it though! Very thorough! Nice work!

-crazy
-crazyscience
crazyscience
 
Posts: 410
Joined: Tue Dec 06, 2011 8:49 pm

Re: Towny

Postby lionbandgeek92 » Wed Jan 11, 2012 9:56 pm

yea like i said its a big plugin and some understanding about how it works needs to happen before jumping into commands... so i tried to make it as thorough as possible :D
Image
lionbandgeek92
 
Posts: 392
Joined: Mon Dec 12, 2011 8:29 pm


Return to Plugin Help

Who is online

Users browsing this forum: No registered users and 1 guest

cron