Please note, as announced on Discord, starting with this release support for Minecraft 1.16 and Java 16 has been dropped. HuskTowns now requires Java 17 / Minecraft 1.17.1 as a minimum.

HuskTowns 3.0 is a major version release that makes breaking changes to the developer API. Please make sure your plugins that depend on HuskTowns have been updated to support HuskTowns API v3 — for developers, this should be quite easy, but it is a breaking change nonetheless. A few other bug fixes and locale updates have been made for this release, requiring a locale file regeneration.

• Improved the way config files are loaded. Config validation on startup will now be more strict.
• Added Korean (ko-kr) locales, courtesy of awrwag
• Updated the Simplified Chinese (zh-cn) locales, courtesy of @jhqwqmc (#392)
• Updated the Spanish (es-es) locales, courtesy of @pipearaneda
• Fixed a bug that meant servers using a MySQL/MariaDB database that encountered a startup problem involving the loading of town data would not properly terminate plugin initialization.
• Fixed a bug where issues with the serialization of Map objects in Towns would not be correctly handled were a duplicate key to be inserted into them
• API: API v2 (and the original deprecated API v1) have been removed.
  • The way the HuskTowns API is published has been changed: APIs are now published per-platform; husktowns-bukkit and husktowns-common can now be targeted.
  • Simply update your build scripts to target the net.william278.husktowns:husktowns-bukkit artifact
  • HuskTownsAPI is no longer an abstract class; you can now retrieve an instance of the base class with HuskTownsAPI.getInstance()
  • HuskTowns now uses ClopLib
    • The built-in Operation.Type is now OperationType.
    • Operation and OperationType now live in the net.william278.husktowns.libraries.cloplib package.
    • This is the same system in use on my other plugin, HuskClaims.
  • Added API methods for getting a player's Privilege.
  • Fully documented the API (at last!).

To update from v2.6.x, just drag+drop and regenerate your locales file (messages-xx-xx). You should not need to touch your other config files unless they are very outdated (regenerate it if so!)