Skip to content
Towny Advanced Minecraft plugin for Bukkit/Spigot.
Java
Branch: master
Clone or download
LlmDl 0.95.2.2:
  - Switch API to 1.15-R0.1-SNAPSHOT.
    - For the time being this is working on 1.14.* and 1.15 servers.
Latest commit 745cd9c Dec 11, 2019

README.md

Towny Advanced - Developed by LlmDl


I took over from ElgarL after MC 1.8 was released. Past developers have included: Shadeness, FuzzieWuzzie, ElgarL. With help coming from other developers from time to time including dumptruckman, ole8pie, SwearWord, gravypod, andrewyunt and more.

Towny is one of the oldest still-in-development plugins for Minecraft. It was created by Shadeness for the now-defunct server platform called hMod.

It is the second-oldest land protection plugin to become popular for Minecraft, having been beaten by WorldGuard by just a couple months. Go check out some of the features Towny has and see why it's still popular for yourself.


Current Recommended Versions

Minecraft Version Towny Version
MC 1.15.* Use the below Release for 1.14.* or the above Latest Pre-Release.
MC 1.14.* 0.95.2.0
MC 1.13.2 0.95.1.0 for 1.13.2
MC 1.12.2 0.93.1.0 for 1.12.2
MC 1.11.2 0.93.1.0 for 1.11.2
MC 1.10.2 0.93.1.0 for 1.10.2
MC 1.9.4 0.93.1.0 for 1.9.4
MC 1.8.9 0.93.1.0a for 1.8.9
MC 1.7.10 0.92.0.0 for 1.7.10
MC 1.6.4 0.88.0.0 for 1.6.4
MC 1.5.2 0.88.0.0 for 1.5.2
MC 1.2.5 0.82.0.0

Staying up to date

Now that all Release builds and Development builds are being made available here on github's Releases tab I am recommending that server admins "watch" Towny on github. Just click the watch button in the upper right and select "Releases Only".

Alternatively, if you watch the resource on Spigot you will be notified on that website when a new build is out.


Connect/Support

The documentation found on the Towny Wiki is updated every time a Release version of Towny is put out. If you are using a development build it is expected that you have read the changelog for any important changes since the previous Release build.

Some important pages to look over:

Here on github's Issue Tracker you can file bug reports, feature requests, or just ask general questions.

Average time to resolve an issue Percentage of issues still open

If you still need help, join us in our IRC channel #towny on the Esper.net network, or on the Discord server, where you can find cutting edge updates and discussion on the development of the plugin.

If you want to support the developer consider becoming a Sponsor.


Contributing

If you'd like to contribute to the Towny code, see the Contributing.md.


Licensing

Towny is licensed under the Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported (CC BY-NC-ND 3.0) License

We don't object to you making your own forks and builds but we do object to people being selfish, which is why we specify No Derivative Works. If you want to modify the code to add some nice feature the least you can do is ask and submit a pull request to allow everyone to benefit from it.


Building

If you would like to build from a specific branch yourself, you can do so with either Apache Ant or Apache Maven, depending on the age of the branch.

For building, open your terminal / command prompt and navigate to the Towny Directory (either extracted, or cloned).

  • Maven

    • Run mvn clean package to generate the plugin in the target directory, within the Towny folder.
    • Developers may use the following after setting up their github token as shown here.
  <repositories>
    <repository>
      <id>github-Towny</id>
      <url>https://maven.pkg.github.com/TownyAdvanced/Towny</url>
    </repository>   
  </repositories>
  <dependencies>                    
    <dependency>
      <groupId>com.palmergames.bukkit.towny</groupId>
      <artifactId>Towny</artifactId>
      <version>0.95.1.0</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>  
  • Ant (Deprecated)

    • For older branches using the Ant build system, the main command to use would be: ant clean jar. This command will exit the Towny directory, creating a lib folder alongside it. A Towny.jar file will be generated and placed within there.
    • Note: As Ant is being deprecated, older branches may eventually not be able to be built against without modification of the build.xml file. We leave no guarantee that the file repo providing the dependencies will stay up.
You can’t perform that action at this time.