Skip to content
Towny Advanced Minecraft plugin for Bukkit/Spigot.
Java
Branch: master
Clone or download
Latest commit 2fc3eb7 Oct 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Oct 14, 2019
legacy - Switch out deprecated war and perm hud code for undeprecated code. Sep 25, 2019
resources 0.95.0.0: Oct 14, 2019
src - PAPI Placeholder Support: Oct 13, 2019
.editorconfig Fix whitespace changes Aug 9, 2019
.gitignore - Add doc folder to .gitignore Oct 14, 2019
LICENSE.md license.md added Feb 11, 2018
README.md Update README.md Oct 15, 2019
pom.xml 0.95.0.0: Oct 14, 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.14.* 0.95.0.0
MC 1.13.2 0.95.0.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.0 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

Towny is currently in transition from our website http://palmergames.com/towny to using github for all downloads/documentation.

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".


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.

If you still need help, join us in our IRC channel #towny on the Esper.net network. If you are a server admin that wants to get cutting edge updates on the development of the plugin and want to help test things before they become public, join us in our Discord server

If you want to support the developer consider becoming a patron:


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.94.0.12</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.