⚠️ Important: If you are upgrading from HuskTowns v1.8.2, you must follow the legacy migration upgrade guide.

HuskTowns v2.1 adds the ability to /unclaim all of a town's chunks at once, adds some new config options and QoL, makes some locale improvements, and fixes various bugs.

• Added the ability for a town to unclaim all its chunks with /town unclaim all (#192)
  • An equivalent command for administrators has also been added; /admintown unclaim <town> [all]
• Added a config option (towns.require_claim_adjacency) to require that town claims made be adjacent (#193)
• The display name of town rules is now localisable, courtesy of @WuzzyLV (#185)
• Added transaction reasons to the RedisEconomy hook, courtesy of @Emibergo02 (#187)
• Added a config option to automatically set the town spawn when the first claim is made, courtesy of @HookWoods (#191)
• Added Simplified Chinese (zh-cn) locales, courtesy of Wtq_
• Fixed an issue that prevented the town deeds menu from correctly showing the claim squares (#186)
• Fixed the version checker incorrectly reporting that a new version was available
• Fixed a NullPointerException that could occur when using the HuskHomes hook, courtesy of @Emibergo02 (#190)

To update, just drag+drop. You should regenerate your config and messages files for this release.

📋 HuskTowns is a premium plugin; binaries are not distributed on GitHub. Please purchase the resource from Spigot, Polymart or Songoda.

⚠️ Important: If you are upgrading from HuskTowns v1.8.2, you must follow the legacy migration upgrade guide.

HuskTowns 2.0 is a major rewrite of HuskTowns that brings forth massive improvements to the data loading system, redesign chat interfaces, a simplified command structure and a whole host of other quality of life changes, new features and improvements.

• The plugin has been rewritten from the ground up with a much more elegant internal code structure.
• Massively improved data load times. Town and claim data is now saved as json objects in the database, which has undergone a schema redesign.
• Redid all user interfaces and messages, bringing them in line with my other plugins.
• Redid the command syntax and permissions listings for most commands. Please check the updated commands list.
• Separated the config into multiple files to make it easier to read and edit; config.yml, levels.yml, roles.yml and rules.yml
• Added town audit logs (/town audit).
  • Whenever a change is made to a town (new members, promotions, demotions, evictions, renamed, etc...) it will be logged.
• You can now change the color of your town (/town color)
  • An interactive chat menu is also available to help you choose
• Reworked how town plots work slightly
  • Town plots no longer have an "owner"; instead, they have a group of members, some of which are "managers", who can add additional members
  • The /town plot command has been updated as a result
  • Removed the ability for members to "claim" unoccupied plots, for the time being (this will be re-implemented eventually)
• Added two new perks for leveling up a town; crop growth and mob spawner spawning rates will now increase in farm chunks as the town levels
• Added a command for an administrator to assume ownership of a town, which will force-join a town and set them as the mayor (/town takeover)
• Reworked the town bonuses system;
  • The person who applied the town bonus is no longer logged with the bonus, but rather in the town's audit log instead
  • Two additional town bonuses have been added to let administrators apply bonuses to the crop growth rate and mob spawner spawn rate boosts in farm chunks
• Added a town spawn privacy admin bypass permission node, to allow administrators to teleport to private town spawns
• Reworked the town claim list (now town "deeds") to provide a better visual overview of the number of claims made by a town
• Added additional sorting options for the town list and improved its interface.
• The plugin will now persistently save player preferences, including if they have town chat, auto-claiming and ignore-claims toggled.
• When using the /map command, the plugin will now highlight the chunk the user is standing in
• Slightly improved the way in which chunks are highlighted; particles will now always highlight slightly within the chunk borders
• More commands, such as the town list command, can now be executed through the server console
• Added brigadier syntax highlighting to commands via commodore
• Added additional sub command list ("help") menus which display the command syntax
• Added support for Plan (Player Analytics); the plugin will now provide an overview of town data on player and server pages.
• Added a new LuckPerms context provider to the hook (husktowns:town-level), which is set to the level of the player's town
• Updated support for BlueMap and Dynmap to their latest API version
• Removed the default set of shortcut commands. You can define aliases in commands.yml at your discretion to replicate these if you miss them.
• Removed the ability for towns to color format the town bio, greeting and farewell messages due to it conflicting with menu formatting
• Removed the ability to auto-claim admin chunks
• Removed two online player tracking features, for the time being (this will be re-implemented eventually):
  • Removed TAB completion for the invite command
  • Removed the Online Status of players in the town member list (now "census")
• Fixed a number of claim protection issues, including the ability for outsiders to extract honey from protected beehives, among others
• Placeholders: HuskTowns' PlaceholderAPI expansion ("HuskTownsPlaceholders") has been updated to v2.0, with a new set of placeholders.
  • If you're using this, please download the expansion update from the eCloud.
• API: Added a new Developer API@v2 with vastly expanded capabilities, including the ability to edit towns and make claims through the API
  • The new API even provides consumer methods for easily editing towns
  • HuskTowns API@v1 has been deprecated but is still implemented. Most plugins built to use the old API should still work provided they don't make calls to old internal methods.
  • Consult the API docs for more information
• API: Added three new API events: MemberJoinEvent, MemberLeaveEvent and MemberChangeRoleEvent

To update from v1.8.2, you must follow the legacy migration upgrade guide.
Enjoy!

HuskTowns v1.8.2 is a minor feature and bug fix update to address a few critical issues with v1.8.1. It is my intention that this will be the last release of the v1.x line of HuskTowns releases. Development of HuskTowns v2.x is underway. The main goals of v2.x will be to overhaul the data format to speed up cache times and pave the way for new features and better plugin interoperability.

• Added support for RedisEconomy, courtesy of @Emibergo02 (#163)
• Fixed /t invite missing its' alias and /t info having permissions missing, courtesy of @Skizzles (#141)
• Fixed an error that could occur when updating a player's role cross-server (#172)
• API: Added PlayerEnterTownEvent & PlayerLeaveTownEvent, courtesy of @Oribuin (#162)

To update, just drag+drop. I'm hoping to get development releases for v2.x out starting by the end of the new year.

HuskTowns v1.8.1 makes a number of fixes and improvements, such as fixing an issue with the shading of commons-text, adding a Traditional Chinese locale and reorganizing some packages internally.

I'm working towards a big update that will change how claims are cached in the future to make things much more optimal at scale. This release doesn't contain any of that just yet, but it does make a few incremental steps towards that release.

• HuskTowns is now compatible with HuskHomes v3's API. If you were using HuskHomes v2, you must now upgrade.
• Fixed a ClassDefNotFound error caused by improper shading of commons-text
• A number of libraries are now downloaded at runtime to save jar file size. Library shading has been tweaked as a result
• Updated the plugin information screen and update checker to use DesertWell, in line with HuskHomes v3.
• squaremap is now accepted as the identifier for SquareMap support.
  • Note that SquareMap support is deprecated and may be removed in the future in favour of Pl3xMap v2.
  • Also note that BlueMap support is still running on APIv1 (targeting older versions of BlueMap) -- v2 support is planned soon.
• Added Traditional Chinese (zh-tw) locales, courtesy of TonyPak

To update, just drag+drop.

HuskTowns 1.8 adds the ability to customize town roles and permissions, along with a slew of other minor tweaks and improvements.

• Added the ability to customize the town roles.
  • Town roles are now defined in config.yml
  • You can assign 'privileges' to each role
  • Check the plugin documentation for more information
  • The default roles and privileges are the same as in previous versions
• Updated for Minecraft 1.19
  • Properly handle dripleaf blocks in claims
• Added an option to prevent claiming chunks too close to another town (minimum_town_chunk_separation in the config file, default 0)
• Migrated configuration handling to BoostedYaml
• Optimized and adjusted how the claim viewer displays particle effects around claim borders
  • The viewer will now display particles at an incline against block edges
• Refactored the command handling system under-the-hood
• Minor updates to the plugin about menu (/husktowns about)
• Fixed people being able to push/pull stuff with pistons across claim borders
• Added Simplified Chinese (zh-cn) translation, courtesy of Ghost-chu
• Updated the Spanish (es-cl) translation
• Fixed some typos in the English (en-gb) locales
• Fixed untranslatable money_spent_notice locales (#95)
• Added an option to disable startup checls (#105)
• Added an option to use Redis over SSL (#100)
• Bumped the SquareMap dependency and fixed an incompatibility
• API: The API is no longer in a separate repository.
  • Remember, the package was changed from me.william278 to net.william278

To update, just drag & drop. Note that if you are updating from v1.6 and older, please update to v1.7 first before updating to this release. You may need to regenerate your language files.