
HuskTowns 3.1.2
A simple and elegant proxy-compatible Towny-style protection plugin
1.5.1
Aug 11, 2021
HuskTowns 1.5.1 - Hotfix
This hotfix update fixes a single but important issue with the previous version. It's important that you update!
• Fixed it not being possible to properly disband a town
All you need to do is drag and drop the new version with HuskTowns 1.5 to update. Apologies for the inconvenience. If you're updating from HuskTowns 1.4 please check the changelog and information for the previous release.
• Fixed it not being possible to properly disband a town
All you need to do is drag and drop the new version with HuskTowns 1.5 to update. Apologies for the inconvenience. If you're updating from HuskTowns 1.4 please check the changelog and information for the previous release.
1.5
Aug 8, 2021
HuskTowns 1.5 - Town flags, settings menu & much more!
HuskTowns 1.5 introduces the brand new town flags system to HuskTowns, a new town settings interface and makes a myriad of tweaks and improvements!
• Added /town settings to allow you to easily change settings for your town
• Added the new town flags system!
- Let you define rules for what can happen inside town claims
- There are 8 flags to set:
▫ Explosion Damage - Whether explosions can break stuff (e.g TNT, End Crystals, Creepers, Withers)
▫ Fire Damage - Whether fire can destroy stuff
▫ Mob Griefing - Whether mobs can grief stuff (e.g Enderman)
▫ Monster Spawning - Whether monsters can spawn
▫ Public Build Access - Whether members of the public can build in the claim
▫ Public Container Access - Whether members of the public can open containers in the claim (e.g Chests, Hoppers, Furnaces etc)
▫ Public Interact Access - Whether members of the public can interact in the claim (e.g Doors, levers, buttons, etc)
▫ PvP - Whether players can engage in combat in the claim
- Can be set for all three types of claims (regular, farms & plots)
- Players can easily set these with the interface on the new /town settings menu
- Flags can also be set in configuration for outside of claims, unclaimable worlds & admin claims. The defaults for towns can also be set.
- Each flag also has a permission node attatched to it (allowed by default) so if you don't want players changing flags in their towns you can prevent it.
- Or, can be set with the /town flag command
• Added the ability for mayors to unclaim all of their town claims at once with /unclaim all
• You can now view some statistics about HuskTowns on your network or server with /husktowns stats
• You can now reload the system caches with /husktowns status reload (Only do this if you need to as it takes some time and features will be disabled while stuff processes).
• Sneaking (holding SHIFT) while right clicking with the claim inspection tool will now highlight the borders of all nearby chunks
• The claim list's appearance has been improved
• General refactoring and performance enhancements, particularly to pulling information from the database
• Timestamps for things like claims and town founding information now show the time as well as the date
• Improvements to the reliability of the caching system cross-server
• Bump some dependencies (VaultAPI, HuskHomes)
• Made improvements to the way in which TAB completion is handled
• /town help is now more helpful, displaying a new dedicated list of the subcommands for /town
• Added debug command /town verbose [chat_message_type] to view action-vs-flag checks being performed in your world (use action_bar as the chat message type to avoid being spammed on busy servers!)
• API: Fixed an issue where fetching the members of a town through the cache would not work properly
• This also fixes some TAB completion issues
Config and upgrade notes (Important!)
If you are updating from a previous version of HuskTowns, please note that the old explosion settings and pvp settings (minus the friendly fire option, which has been moved to general options) have been removed as these are now handled with town flags - the ability to set the explosion setting based on surface level is no longer available - sorry about that.
I recommend regeneration the config file for this release AFTER YOU HAVE UPDATED (not before - otherwise it might not upgrade you correctly) to clean it up, though it's not required - you should just be able to drag+drop.
• Added /town settings to allow you to easily change settings for your town
• Added the new town flags system!
- Let you define rules for what can happen inside town claims
- There are 8 flags to set:
▫ Explosion Damage - Whether explosions can break stuff (e.g TNT, End Crystals, Creepers, Withers)
▫ Fire Damage - Whether fire can destroy stuff
▫ Mob Griefing - Whether mobs can grief stuff (e.g Enderman)
▫ Monster Spawning - Whether monsters can spawn
▫ Public Build Access - Whether members of the public can build in the claim
▫ Public Container Access - Whether members of the public can open containers in the claim (e.g Chests, Hoppers, Furnaces etc)
▫ Public Interact Access - Whether members of the public can interact in the claim (e.g Doors, levers, buttons, etc)
▫ PvP - Whether players can engage in combat in the claim
- Can be set for all three types of claims (regular, farms & plots)
- Players can easily set these with the interface on the new /town settings menu
- Flags can also be set in configuration for outside of claims, unclaimable worlds & admin claims. The defaults for towns can also be set.
- Each flag also has a permission node attatched to it (allowed by default) so if you don't want players changing flags in their towns you can prevent it.
- Or, can be set with the /town flag command
• Added the ability for mayors to unclaim all of their town claims at once with /unclaim all
• You can now view some statistics about HuskTowns on your network or server with /husktowns stats
• You can now reload the system caches with /husktowns status reload (Only do this if you need to as it takes some time and features will be disabled while stuff processes).
• Sneaking (holding SHIFT) while right clicking with the claim inspection tool will now highlight the borders of all nearby chunks
• The claim list's appearance has been improved
• General refactoring and performance enhancements, particularly to pulling information from the database
• Timestamps for things like claims and town founding information now show the time as well as the date
• Improvements to the reliability of the caching system cross-server
• Bump some dependencies (VaultAPI, HuskHomes)
• Made improvements to the way in which TAB completion is handled
• /town help is now more helpful, displaying a new dedicated list of the subcommands for /town
• Added debug command /town verbose [chat_message_type] to view action-vs-flag checks being performed in your world (use action_bar as the chat message type to avoid being spammed on busy servers!)
• API: Fixed an issue where fetching the members of a town through the cache would not work properly
• This also fixes some TAB completion issues
Config and upgrade notes (Important!)
If you are updating from a previous version of HuskTowns, please note that the old explosion settings and pvp settings (minus the friendly fire option, which has been moved to general options) have been removed as these are now handled with town flags - the ability to set the explosion setting based on surface level is no longer available - sorry about that.
I recommend regeneration the config file for this release AFTER YOU HAVE UPDATED (not before - otherwise it might not upgrade you correctly) to clean it up, though it's not required - you should just be able to drag+drop.
1.4.2
Jul 26, 2021
HuskTowns 1.4.2 - Town bios & public spawns
HuskTowns 1.4.2 introduces the ability for towns to make their spawn public (/town publicspawn) as well as short descriptions (bios) for towns (/town bio)!
HuskTowns 1.4.2 changelog
• You can now make your town spawn public!
- Anyone can teleport to public town spawns with /town spawn
- To toggle the privacy of your town spawn, use /town publicspawn - they're private by default
- Restricted to trusted citizens and mayors
• Added town bios
- Players can give their town a bio with the /town bio command.
- You can view a town's bio on it's /town info page.
- Restricted to trusted citizens and mayors
• Added two new economy settings to let you charge for changing the town bio and making your town spawn public
• Added more permission nodes to let you fine-tune what features of /town players can use:
- husktowns.command.town.bio
- husktowns.command.town.greeting
- husktowns.command.town.farewell
- husktowns.command.town.spawn.set
- husktowns.command.town.spawn
- husktowns.command.town.spawn.privacy
- husktowns.command.town.leave
- husktowns.command.town.deposit
• /town setwarp and /town warp now work as aliases for /town setspawn and /town spawn
• You can now sort towns in the town list by wealth (which is effectively the same as by level)
• Fixed admin towns not properly respecting the admin town name in the plugin config
• Fixed it being possible to apply negative and zero-value town bonuses.
• Fixed renaming a town causing issues with farewell messages in the cache
• A myriad of under-the-hood optimisations and improvements
• Renamed Town Messages cache to Town Data cache (it now stores town bios and towns with public spawns)
• API: Added new methods for getting a town's bio as well as its greeting & farewell messages
• API: Added new methods for getting a list of all town names and a list of all town names with public spawns set
HuskTowns 1.4.2 changelog
• You can now make your town spawn public!
- Anyone can teleport to public town spawns with /town spawn
- To toggle the privacy of your town spawn, use /town publicspawn - they're private by default
- Restricted to trusted citizens and mayors
• Added town bios
- Players can give their town a bio with the /town bio command.
- You can view a town's bio on it's /town info page.
- Restricted to trusted citizens and mayors
• Added two new economy settings to let you charge for changing the town bio and making your town spawn public
• Added more permission nodes to let you fine-tune what features of /town players can use:
- husktowns.command.town.bio
- husktowns.command.town.greeting
- husktowns.command.town.farewell
- husktowns.command.town.spawn.set
- husktowns.command.town.spawn
- husktowns.command.town.spawn.privacy
- husktowns.command.town.leave
- husktowns.command.town.deposit
• /town setwarp and /town warp now work as aliases for /town setspawn and /town spawn
• You can now sort towns in the town list by wealth (which is effectively the same as by level)
• Fixed admin towns not properly respecting the admin town name in the plugin config
• Fixed it being possible to apply negative and zero-value town bonuses.
• Fixed renaming a town causing issues with farewell messages in the cache
• A myriad of under-the-hood optimisations and improvements
• Renamed Town Messages cache to Town Data cache (it now stores town bios and towns with public spawns)
• API: Added new methods for getting a town's bio as well as its greeting & farewell messages
• API: Added new methods for getting a list of all town names and a list of all town names with public spawns set
1.4.1
Jul 23, 2021
HuskTowns 1.4.1 - Bug fixes
Hello! This update fixes a few important bugs and makes a couple of optimizations to player access level checking.
• Fixed an API error where checking if a player could build in an unclaimed plot would cause a NPE
• Fixed creepers being able to break item frames, armor stands and harm friendly mobs where they shouldn't be able to
• Added a config option to let outsiders build in town farms (restoring behavior of 1.3.x); allow_public_access_to_farm_chunks
• The /husktowns status menu will now display how many items are loaded in each cache
• Optimized the way in which player access levels are checked internally
• Fixed an API error where checking if a player could build in an unclaimed plot would cause a NPE
• Fixed creepers being able to break item frames, armor stands and harm friendly mobs where they shouldn't be able to
• Added a config option to let outsiders build in town farms (restoring behavior of 1.3.x); allow_public_access_to_farm_chunks
• The /husktowns status menu will now display how many items are loaded in each cache
• Optimized the way in which player access levels are checked internally
1.4
Jul 20, 2021
HuskTowns 1.4 - Plot system overhaul, claim using /map & more
HuskTowns 1.4 introduces the ability to add multiple members to plots in towns, including players who are not in your town. It also introduces the ability to view information about claims with /claim info, and claim chunks using the town /map as well as Pl3xMap map integration support.
Changes in HuskTowns 1.4
• Added the ability to add/remove multiple members to a town plot chunk.
- This can be done by the plot owner or trusted citizens/the mayor of the town via the /plot trust and /plot untrust command
- You can view information about the plot you are in with /plot info
• Added the ability to view information about the claim you are standing in with /claim info
- Clicking on claims in the /claimlist page will also bring this up.
• Added the ability to claim chunks using the /map
- Claiming a chunk this way will bring the map up again so that you can claim efficiently
• Added support for showing claims on Pl3xMap. Set the map integration type to 'pl3xmap' to enable this.
• Added a config option to change the size of the in-game /map
- The new option is town_map_square_radius and can be found under general_options.
• Fixed it being possible to still set and edit homes in claims that you do not have access to even with the option with HuskHomes (Please update HuskHomes to v2.7+ as well)
• Fixed issues with town bonuses not caching correctly cross-server
• Fixed ravagers being able to ravage leaves and crops in claims
• Fixed a myriad of issues with locales. You should regenerate your messages file. Alternatively, you can replace these locales with updated ones from the Messages page on the HuskTowns wiki.
- regular_chunk_claimed_by
- farm_chunk_claimed_by
- assigned_plot_chunk_claimed_by
- unassigned_plot_chunk_claimed_by
- claim_success
- admin_claim_success
Changes in HuskTowns 1.4
• Added the ability to add/remove multiple members to a town plot chunk.
- This can be done by the plot owner or trusted citizens/the mayor of the town via the /plot trust and /plot untrust command
- You can view information about the plot you are in with /plot info
• Added the ability to view information about the claim you are standing in with /claim info
- Clicking on claims in the /claimlist page will also bring this up.
• Added the ability to claim chunks using the /map
- Claiming a chunk this way will bring the map up again so that you can claim efficiently
• Added support for showing claims on Pl3xMap. Set the map integration type to 'pl3xmap' to enable this.
• Added a config option to change the size of the in-game /map
- The new option is town_map_square_radius and can be found under general_options.
• Fixed it being possible to still set and edit homes in claims that you do not have access to even with the option with HuskHomes (Please update HuskHomes to v2.7+ as well)
• Fixed issues with town bonuses not caching correctly cross-server
• Fixed ravagers being able to ravage leaves and crops in claims
• Fixed a myriad of issues with locales. You should regenerate your messages file. Alternatively, you can replace these locales with updated ones from the Messages page on the HuskTowns wiki.
- regular_chunk_claimed_by
- farm_chunk_claimed_by
- assigned_plot_chunk_claimed_by
- unassigned_plot_chunk_claimed_by
- claim_success
- admin_claim_success
1.3.1
Jul 8, 2021
HuskTowns 1.3.1 - Massive bug fixing update
This update of HuskTowns fixes a number of bugs. Please ensure you also update your version of the HuskTowns Placeholder API expansion.
• Added config option to fallback to database if the caches fail
• Overhauled cache initialisation system
• Added /husktowns status to view the status of cache initialisation
• Fixed a myriad of caching synchronisation issues
• Fixed leaving a town not correctly propagating across caches cross-server
• Fixed wither skulls being able to deal damage in claims regardless of explosion rule
• Fixed players being able to place and pick up water and lava buckets inside of claims regardless of build permissions
• Fixed town chat not being properly sent cross server
• Fixed town invitations being spammed when sent cross server
• Added API method for adding a town bonus
Please regenerate your language file for this release!
• Added config option to fallback to database if the caches fail
• Overhauled cache initialisation system
• Added /husktowns status to view the status of cache initialisation
• Fixed a myriad of caching synchronisation issues
• Fixed leaving a town not correctly propagating across caches cross-server
• Fixed wither skulls being able to deal damage in claims regardless of explosion rule
• Fixed players being able to place and pick up water and lava buckets inside of claims regardless of build permissions
• Fixed town chat not being properly sent cross server
• Fixed town invitations being spammed when sent cross server
• Added API method for adding a town bonus
Please regenerate your language file for this release!
1.3
Jun 16, 2021
HuskTowns 1.3 - /admintown, /ignoreclaims & Java 16
Hello! This release adds the /townadmin command which reorganizes and improves some of the commands for server administrators as well as the /ignoreclaims ability for admins to bypass claim restrictions, alongside a few other tweaks and feature requests. Note that this version of HuskTowns requires Java 16.
• HuskTowns now **requires Java 16**
• The HuskHomes integration now requires HuskHomes v2.6.1
• Fixed Dynmap integration not working
• Added the ability to toggle /townchat
• Added an admin-spy permission access for town chat (husktowns.town_chat_spy)
• Fixed town chat and welcome/farewell messages respecting minedown advanced formatting when they should not
• Added /townadmin command
- This provides another way to make and remove admin claims as well as...
- View a list of admin claims
- Manage town bonuses
- Autoclaim (claim-as-you-walk) Admin claims
- Ignore claims (see below)
• Added /ignoreclaims command that lets administrators toggle between respecting and ignoring claims
• Added a permission (husktowns.administrator.unclaim_any) that allows administrators to unclaim any claim in the world irrespective of whether they have access to it.
• The permission to build in an admin claim is now independent of the parent husktowns.administrator permission (now husktowns.administrator.admin_claim_access)
• HuskTowns now **requires Java 16**
• The HuskHomes integration now requires HuskHomes v2.6.1
• Fixed Dynmap integration not working
• Added the ability to toggle /townchat
• Added an admin-spy permission access for town chat (husktowns.town_chat_spy)
• Fixed town chat and welcome/farewell messages respecting minedown advanced formatting when they should not
• Added /townadmin command
- This provides another way to make and remove admin claims as well as...
- View a list of admin claims
- Manage town bonuses
- Autoclaim (claim-as-you-walk) Admin claims
- Ignore claims (see below)
• Added /ignoreclaims command that lets administrators toggle between respecting and ignoring claims
• Added a permission (husktowns.administrator.unclaim_any) that allows administrators to unclaim any claim in the world irrespective of whether they have access to it.
• The permission to build in an admin claim is now independent of the parent husktowns.administrator permission (now husktowns.administrator.admin_claim_access)
1.2.6
Jun 11, 2021
HuskTowns 1.2.6 - Minecraft 1.17 & Better Town Bonuses
HuskTowns 1.2.6 updates the plugin to Java 16, ensures support for Minecraft 1.17, fixes some incompatibilities with other protection plugins and makes /townbonus work with players and towns.
• The plugin now requires Java 16.
• /townbonus now accepts both towns and players who are members of towns as valid arguments.
• Teleportation now uses PaperLib for asynchronous handling
• If the SQL JDBC library is not present it will now be downloaded at runtime. This should fix some occurrences of the library going missing when upgrading to Java 16.
This should be a simple drag+drop replacement. Enjoy!
• The plugin now requires Java 16.
• /townbonus now accepts both towns and players who are members of towns as valid arguments.
• Teleportation now uses PaperLib for asynchronous handling
• If the SQL JDBC library is not present it will now be downloaded at runtime. This should fix some occurrences of the library going missing when upgrading to Java 16.
This should be a simple drag+drop replacement. Enjoy!
1.2.5
May 25, 2021
HuskTowns 1.2.5
This release makes a small number of tweaks and fixes and improves the API for developers.
• Fixed it being possible to deposit negative money into your town, causing various issues when coffers were negative.
• Fixed it being possible to open containers in other towns' claims
• You can now fight hostile monsters in other towns' claims. This can be disabled through a new config option
• Expanded the HuskTowns API to make way for PlaceholderAPI support via an extension
• Fixed it being possible to deposit negative money into your town, causing various issues when coffers were negative.
• Fixed it being possible to open containers in other towns' claims
• You can now fight hostile monsters in other towns' claims. This can be disabled through a new config option
• Expanded the HuskTowns API to make way for PlaceholderAPI support via an extension
1.2.4
May 24, 2021
HuskTowns 1.2.4
• Added BlueMap support to HuskTowns! You can now display your claims on the beautiful BlueMap plugin with a config option.
• Welcome and farewell messages now display a prefix before them (customization in the language file) to prevent sneaky players from spoofing important server messages.
• Minor text fixes and performance improvements.
• Welcome and farewell messages now display a prefix before them (customization in the language file) to prevent sneaky players from spoofing important server messages.
• Minor text fixes and performance improvements.
1.2.3
May 23, 2021
HuskTowns 1.2.3
This update provides fixes for a few outstanding issues and an improvement to the command list.
• Fixed an issue with the SQLite database system in which the default for is_teleporting wasn't being set properly
• Fixed an issue with the Dynmap integration where it wasn't being updated live when a town was renamed or disbanded, or when a claim was removed
• The command list help menu by default will no longer show commands with you do not have permission to use (configurable)
• Added an option to hide the /husktowns command from the command list
• Fixed an issue with the SQLite database system in which the default for is_teleporting wasn't being set properly
• Fixed an issue with the Dynmap integration where it wasn't being updated live when a town was renamed or disbanded, or when a claim was removed
• The command list help menu by default will no longer show commands with you do not have permission to use (configurable)
• Added an option to hide the /husktowns command from the command list
1.2.2
May 23, 2021
HuskTowns 1.2.2
This update fixes a number of important bugs, including a critical bug that may compromise town data.
• Fixed town renaming and updating the farewell/greeting message updating all towns rather than the player's town in the database causing.
• Optimized the caching of claim data to improve performance on servers with thousands amounts of claims.
• Adjusted the caching system for player, welcome message and bonus data.
• Improved the layout of the town list
• Fixed town renaming and updating the farewell/greeting message updating all towns rather than the player's town in the database causing.
• Optimized the caching of claim data to improve performance on servers with thousands amounts of claims.
• Adjusted the caching system for player, welcome message and bonus data.
• Improved the layout of the town list
1.2.1
May 22, 2021
HuskTowns 1.2.1
This update fixes serious performance degradation that occurred in previous versions of the plugin when handling large amounts of claims and makes tweaks to the database format of your server.
This update will not attempt to update the database format. If you're running HuskTowns on versions 1.0 through 1.2 and need to migrate your database please contact me for support.
This update will not attempt to update the database format. If you're running HuskTowns on versions 1.0 through 1.2 and need to migrate your database please contact me for support.
1.2
May 17, 2021
HuskTowns 1.2 - Town bonuses
This release of HuskTowns adds Town Bonuses - a new feature that lets server admins give towns more claims and member slots through the /townbonus command (which also is executable by console).
This means you could sell additional claims or member slots through a server store, or give them out as a reward for a town winning a competition, for instance.
• Added Town Bonuses and the /townbonus command, requires the husktowns.administrator permission
• Added the ability to add, clear and view town bonuses to a town.
• Changed the husktowns.administrator permission to be true by default for server operators (which allows console to execute the townbonus command)
• The timestamp of a town's founding will now display in the town list
• Fixed the /town command's tab completion not working after the first argument
• /town list will now tab complete where it didn't before.
This means you could sell additional claims or member slots through a server store, or give them out as a reward for a town winning a competition, for instance.
• Added Town Bonuses and the /townbonus command, requires the husktowns.administrator permission
• Added the ability to add, clear and view town bonuses to a town.
• Changed the husktowns.administrator permission to be true by default for server operators (which allows console to execute the townbonus command)
• The timestamp of a town's founding will now display in the town list
• Fixed the /town command's tab completion not working after the first argument
• /town list will now tab complete where it didn't before.
1.1
May 16, 2021
HuskTowns 1.1
This update adds town chat - letting town members communicate, cross-server, through the /townchat (/tc) command.
• Added town chat command - /townchat (alias: /tc, /town chat) as well as corresponding permission
• Added option to disable town chat command
• Added a few more strings to the language file to support town chat
• Added an Italian (it-it) localisation courtesy of Villag3r_.
• Adjusted formatting of commands in language file lines.
• Added town chat command - /townchat (alias: /tc, /town chat) as well as corresponding permission
• Added option to disable town chat command
• Added a few more strings to the language file to support town chat
• Added an Italian (it-it) localisation courtesy of Villag3r_.
• Adjusted formatting of commands in language file lines.
1.0.1
May 14, 2021
HuskTowns 1.0.1
• Update checker now logs to console on startup if there's an update
• Fixed a minor issue related to disambiguating between other plugins with similar commands
• Fixed a minor issue related to disambiguating between other plugins with similar commands