Current Forum Thread: Towny Advanced
- Latest Updates / Wiki
- File Bug Report / Request New Feature
- Source: Towny – TownyChat
- IRC: Esper.NET #towny (Webchat)
I am no longer the lead developer for the Towny plugin. Thanks to Fuzz for picking it up when I slipped off.
There are two forks from then on. Croxis the current lead programmer on a more experimental version that combines the features of Spout, event based API, and attempted to move the database to SQL . You can find his fork here, and the plugin download here. The old thread on the forums can be found here. Note: This fork has fallen out of development.
The other fork is done by ElgarL, called Towny Advanced. His version continues, and builds on where I left off and adds tons of new features and bugfixes. If you desire a more stable (usually) version, use his fork. The current source code can be found on GitHub here.
I’ve recently been helping ElgarL (and Llmdl) with Towny Advanced. Mostly small stuff.
What is Towny?
Towny is a plugin for a Bukkit modded Minecraft server. The plugin 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 separated into chunks. For those unaware, minecraft servers are broken up into 16x16x128 sections of blocks. The 128 being the height from the adimantium floor to the clouds in the sky. The protection ignores the height an focuses on the x and z planes. The default size for grid squares is 16×16, similar to the chunk size (no real reason). 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.
To the right you can see an example of 3 towns using the grid structure. Each cell represents 16×16 blocks (and 128 blocks high of course).