Home - TownyAdvanced/Towny GitHub Wiki

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, as well as an optional 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 basis of protection follows under how the world is separated into chunks. For those unaware, minecraft servers are broken up into 16x16x384 sections of blocks. The 384 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. The default size for grid squares is 16x16, similar to the chunk size (configurable when you start using towny). So claiming a 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 an economy plugin) will take a bite out of their resources. The money is tunnelled 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 may be required to pay the nation a daily upkeep as well.

The gods of the land (admins) have the ability to start and end wartime mode. During war, most commands are frozen in order to focus on the event. Whilst at war, block permissions are ignored and any town that is in a nation is completely unprotected to the other nations residents. Also, each cell, or townblock, is given a certain amount of health. When a non-allied player enters the townblock, the townblock's health decreases. The town's residents have to force the player's out while still attacking others. When the health reaches zero, the town loses claim over that townblock. The focus is to defeat the each town's home block where the town's people spawn from.

Why Towny?

One of Towny's strongest points is the ability for a server admin to configure Towny to their liking and then let the players make their decisions from there. There's no selection-wands, no players claiming odd-shaped regions to troll other players. Players can go it alone or they can ally into complex groupings. Players can do their own claiming, customize their protections in-game, kill, spawn, teleport, etc. all according to how the server admin has configured Towny.

Features

Towny includes a wide variety of features to offer instant enhancements to your traditional Minecraft server.

  • Allows players to own and manage land based on a pre-set grid layout.
    • Players join towns and purchase plots of land.
    • Players decide who can build, destroy, use "switchs" and use items on every plot they control.
    • Towns can join together into nations, further structuring a server into teams.
    • Towns grant protection from monsters, pvp, fire, explosions and griefing.
  • Wilderness Rules (Optional)
    • Area between towns is wilderness, with its own build permissions.
    • Limit players' interaction with the wild to just harvest-able blocks, keeping the wild pristine.
    • Roll-back tnt, creeper, wither explosions, dragon damage and endermen block-moving.
    • Block explosions and fire.
  • PVP Enhancements
    • Server with a strong PVP aspect will find Towny's grouping of players to be invaluable.
    • Prevent friendly-fire. (Optional)
    • Nations split players into larger teams.
    • Nations can declare other nations to be allies or enemies, further splitting players into even larger teams.
    • PVP can be turned on/off in wilderness, towns and worlds. (Optional)
  • Towny War!
    • Towny has 3 supporting plugins providing different types of war for servers that want it:
    • Visit the WarHub for more information.
  • Teleporting/Warping and Spawning (Optional)
    • Players can spawn to their town upon death.
    • Players can spawn to their town or a town that is within their nation/allied with their nation.
    • Use of beds can be limited to personally-owned land and players can spawn there.
  • Customized modified chat. (Optional)
    • Colours, group prefixes and suffixes, nation, town, towny titles.
    • Channels for general, local, town, nation, moderator, admin and custom channels.
    • Anti-spam feature.
  • Shop plugin support. (Optional)
    • Limit shops to special Shop Plots, enhancing realism.
  • Economy plugin interaction. (Optional)
    • Supports all economy plugins.
    • Charge money for plots, towns, nations.
    • Flexible tax system.
    • Upkeep to remove money from the economy, stopping rampant inflation.
  • All Permissions Plugins supported. (Optional)
    • GroupManager, Luckperms, etc.
  • Multiworld Support
    • Flexible settings for every world.
    • Enable/disable Towny in as many worlds as you like.