Installation - MuscariServer/Towny GitHub Wiki
Installing Towny is easy. There are usually just two things that admins miss.
- Configuring the existing worlds.
- Townyperms.yml already has 99% of the Towny permission nodes given out correctly.
Read the steps here carefully and you'll save yourself a lot of head-scratching and trouble.
Server Preparation
- Stop your server completely.
- Download either of the following:
- Latest release build from the Releases tab.
- Includes Towny.jar and TownyChat.jar.
- Latest pre-release/development build from the Releases tab.
- You can consult the Readme to see which version you should use for older Minecrafts.
- Latest release build from the Releases tab.
- Copy the contents to your Plugins folder.
- Towny.jar is required at all times
- TownyChat.jar is required if you want Towny to modify chatting:
- Adding prefixes and suffixes from your permissions plugin to chat
- Adding town, nation-related tags to chat.
- Adding general/local/town/nation/mod/admin to chat channels.
- Vault.jar or Reserve.jar (separate downloads) is required if you use an economy plugin.
- Start your server.
- Stop your server.
- Continue reading below, do not skip the Configuring Existing Worlds section of this guide.
Configuring Existing Worlds
Towny has a config section called Default New World Settings. When you started the server it took the default Default Settings and applied it to all your existing worlds. This includes the revert-on-unclaim and explosion-revert settings for each world.
By default player cannot build/break in the wilderness, if you want to enable this use /ta toggle wildernessuse
By default Towny will regenerate explosions in the wilderness, and when towns unclaim land their blocks will disappear and return to their pre-claim appearance. If you want to disable this use /ta toggle regernations
.
Configuring config.yml
- Navigate to plugins/Towny/Settings
- Open config.yml
- Carefully edit config.yml to your liking, including:
- Townblock size defaulting at 16x16 (CANNOT BE CHANGED LATER!).
- Settings for new towns and nations.
- Change the economy settings:
- If you do not use an economy plugin, set
using_economy: false
. - If you are using a UUID version of EssentialsEco, add NPC: to the beginning of Town- and Nation- in
new_world_settings
:- From this:
town: prefix: Town- nation: prefix: Nation-
- To this:
town: prefix: NPC:Town- nation: prefix: NPC:Nation-
- From this:
- If you do not use an economy plugin, set
- Save config.yml.
- Start your server. You are now ready to begin your own town.
Configuring townyperms.yml (semi-optional)
Some admins make the mistake of placing Towny permission nodes into their permission plugin. The only permission nodes you must give in your permission plugin is towny.admin.*
to your admin group(s).
The only other permission node that isn't already given out is towny.wild.*
. Giving this node will grant full build/destroy/switch/itemuse rights to players in the wilderness. You must decide if you want to give this out, and how. This is not required if you've use the /ta toggle wildernessuse
command.
- One option is to put it in the nomad section of the townyperms.yml file, which will enable all players server-wide to use the wilderness.
- The other option is to give it in your permission plugin, to whichever rank you want to use the wilderness.
- Navigate to plugins/Towny/Settings.
- Open townyperms.yml
- Carefully read over the default groups/ranks.
- Add and remove permission nodes as you see fit.
- Optionally, add your own ranks for mayors to promote (or demote) their residents to.
- Save townyperms.yml.
- Perform
/ta reload
in-game to see your changes.
Configuring channels.yml (optional)
This step is optional if you have TownyChat.jar.
- Navigate to plugins/Towny/Settings
- Open channels.yml.
- Edit channels.yml to your liking.
- Save channels.yml.
- Perform
/townychat reload
in-game to see your changes.
Configuring chatconfig.yml (optional)
This step is optional if you have TownyChat.jar.
- Navigate to plugins/Towny/Settings
- Open chatconfig.yml.
- Edit chatconfig.yml to your liking.
- Save chatconfig.yml.
- Perform
/townychat reload
in-game to see your changes.