Towns and Nations

Town and Nation commands for proper use in Wasteslam.

The current season of Wasteslam uses the plug-in towny for player grouping and land claims. This plug-in commands and use can seem quite complicated despite its simplicity but it is crucial that a mayor or king understand the full range of the plug-in to best protect and provide for their town. With this in mind a good deal of the commands and proper use of the plug-in will be provided here although for a full and comprehensive list of the plug-in it is suggested that the plug-in source be referenced (https://github.com/TownyAdvanced/Towny/wiki/Towny-Commands).

Town Summary:
Land can be claimed under a town defined region. Towns are started and expand by chunks. Each chunk, called plots, have the ability to have their permissions(perm) adjusted individually or as groups. perms are divided into 4 types which can be change individually: residents, allies, nation, outsiders. Towns have a defined max size based on resident count. As a town gains more residents it can claim more chunks. All town commands begin with /t

Roles:
Players in a town can be given roles that provide more capabilities within the town. Currently their are 4 roles within a town that can be used in Wasteslam: mayor, assitant, sheriff, and helper. Residents may be given a role even if they are not online by using /t rank add (resident\_name). Helpers can add new players to the town and that’s it. Sheriffs may place residents in jail and are the only residents excluding the mayor that may interact with the jail plot. Assistants have access to all plots and perm commands as well as are able to give the helper rank and add/remove players. The only way to get the mayor rank is to start a town or to have the current mayor give you the rank using /t set mayor (resident). The mayor is the only one that can interact with all plots and adjust all perms as well as withdraw from the town bank.

Titles:
The mayor of a town or a leader of a nation can give anyone in their town or nation a title that is custom and can be as long as about 12 characters. Titles can be set using /t or /n set title (resident) (title).

Creating and Expanding:
To start a new town the desired location must be stood in and the command /t new (town\_name) is used where town\_name is the desired town name. Towns cost 16 dollars to create (in-game-currency) and begin as a single chunk. Additional chunks can be added to the town by using /t claim on adjacent chunks for the price of 8$. Before money can be used to buy additional plots for the town or do other things money must first be deposited into the town bank using /t deposit (amount). All residents may deposit money into the banks but only the mayor may withdraw money using /t withdraw (amount). Additional note, town names can be changed after creation using /t set name (new\_name) by the mayor but it’s advised that the bank be emptied before hand as it may delete the bank amount when the name is changed as was mentioned by other users of the plug-in online.

Traveling to Towns:
After a town is established residents of that town can teleport to the towns spawn instantly (provided they haven’t teleported recently) using the command /t spawn. Additionally if a town is set to public any player can do the same using the command /t spawn (town\_name). A town spawn is set by default where the player that started the town was standing when the town was created. This chunk is the home plot and the spot is the town spawn. This spot and chunk can be changed to another in the town using the command /t set spawn and /t set home respectively. The town spawn can only be in the home plot.

Plots:
The chunks(plots) within a town may be defined for what they are, have perms adjusted as needed and sold to players for their personal use. The owner of a plot defines the perms for that plot, by default the mayor controls all plots but plots can be sold to residents so they have perm control there separate from others in the the town except the mayor and assistants. This means residents can have their items and builds safe within a town if they own a plot and don’t make it open to everyone. A plot is put up for sale by the owner or assistant using /plot forsale (price), all plot commands start with /plot. Plots can have a set role and perms are preset based on the role of that plot. Two important ones include the jail and the embassy. A plot can be defined with a role using /plot set (role). A jail plot must be defined and a jail stall (using /plot set jail) for residents or enemies to be put in there. The sherif and mayor are able to place residents into And out of jail cells using the /t toggle jail (jail\_number (optional)) (resident\_name) and anyone can put an enemy nation resident player into jail by killing them in the town. Embassy plots are used as a way for other town residents to by a plot in the town as any other plot can only be bought by residents of that town. Plots can also be grouped using the command /plot group (group\_name) for the plot they are using the command in. When doing anything with a plot using the prefix /plot group in a grouped plot the command will apply to all plots with the same group name as the plot that the command being used in has.

Perms:
Perms are how you control what happens in your plot and by who. Permissions for towns and or plots in a town are performed by who they are applying to and what they are referring to. Town perms have 4 people they can apply to: town residents(residents,r), nation residents(nation,n), ally residents(ally,a), and everyone else (outsider,o). Plot perm command have these with the exception of town residents which is replaced with (friend,f). All perms are split into 4 different subject: build, destroy, switch, item-use. Plot perms can be seen using the command /plot perm where it can be seen as shown:
Perm: Build = rnao Destroy = rnao
Perm: Switch = rnao Item = rnao
Where rnao shows which type/subject of perm are allowed. When one group is not provided that perm the spot would be just a dash as. In this example only residents and allies are allows to build and only residents and nation are allowed to destroy so the first line would show as follows:
Perm: Build = r-a- Destroy = rn—-
Setting this with a command could include setting all perms off for this plot first using /plot set perm off so the perm display would show as:
Perm: Build = —--- Destroy = —--- Showing that none one except the plot owner can break or place here. Then the command /plot set perm resident on making it so the residents of the town can use all perms in this plot adding r to each display and then using both /plot set perm ally build on and then /plot set perm nation destroy on so the allies can build only and the nation can only break in this plot. They perm types build and destroy refer to adding and removing blocks of any kind to or from a plot. The other two are switch and item. Switch refer to adjusting block states like switching levers, opening doors or even accessing chests and item involves the use of items in the plot like pearls, water buckets, leads, or splash potions. Their are also three other perms that can be adjusted but refer to events that can happen, explosions, fire spread, pvp, and mob spawning. These three are toggled on or off instead of set using /plot toggle (event). Explosions enabled will allow for explosions to break blocks in the plot. Fire spread would allow fire to spread within the plot but will not change anything as the server has this turned off as a game rule so can’t occur. Pvp toggles whether pvp can be done in that plot. Mob spawning refers to the ability for hostile mobs to both spawn in or enter the plot, by default all town plots are disabled for mob spawning so no hostile mobs will spawn in the town and any that enter will shortly despawn. It’s important to note that events can not cross over differing plots in general, so even if two plots allow explosions the effect of one cannot enter another. Also growing a tree on the edge of a plot with differing owners will prevent the leaves or logs from growing in that other plot as well as pistons and redstone signals will not enter an owner plot. So be aware of town plots and who owns what. Also important to know that when a plot chances ownership the perms are set to default.

Nations:
Nations are a way for towns to ban together and provide perms to only those In a that nation. Nations can also be allied with other nations which provide a way to group larger bodies of players. Nations are created using /n new (name) once the creator owns a town. To add an ally type /n ally add (nation) to another nation. Enemies can be assigned by the leader using /n enemy add (nation).