0.97.3.0 for MC 1.14.* & 1.15.* & 1.16.* & 1.17.*

[LlmDl]

Towny Advanced 0.97.3.0

Release contains:

Towny 0.97.3.0
TownyChat 0.91

Welcome to Towny 0.97.3.0.
Towny 0.97.3.0 is the fourth release in the 0.97.*.* series. This release adds some minor features, a hefty amount of polish and as ever: important fixes you want to have on your server today.
This release also marks the removal of the last of the war code, both FlagWar and EventWar are available as separate plugins now! When you add in SiegeWar there's going to be at least one which will satisfy your server's hunger for fights.
This is a drag-and-drop update: just replace your old .jars with the new ones and Towny will take care of the rest of the update by itself.

➕ Added (31)

➕ Added:

• Add ability to override a town's NationZone, using /ta set nationzoneoverride [town] [size]
  • Closes Suggestion: Add a way to override the NationZone of a town. #4915.
• Add option to prevent a nation's capital city from being neutral.
  • Closes Suggestion: Add option that disables peacefulness for Capital towns #5360.
• Make nationzones toggle-able per town, using /t toggle nationzone.
  • Closes Suggestion: Allow mayors to toggle nation zone on or off #5340.
• Add spawn protection for players who've just died.
• Add nation's capital to the nation status screen.
• Add nation join date to a town's status screen in the nation hover section.
• Add town join date to a resident's status screen in the town hover section.
• Add nation zone size to nation and town status screens.
• Add hover to the capital on the nation status screen.
• Add protection for glow berries being harvested off cave vines, treated as a destroy test.
• Clean up TownyMessaging class.
• Blank capital prefixes and postfixes will no longer override a town's normal prefix and postfix.
• Blank king prefixes and postfixes will no longer override a mayor's normal prefix and postfix.
• Add closed_economy_enabled bstats chart.
• Update Account CachedBalances when we're get the account holding balance.
• Made invites/confirmation messages translate to player locales in more places.

• Add a size limit for the town_block_ratio option, courtesy of Warriorrrr with PR Add a size limit for the town_block_ratio option. #5326.
  • See in New Config Options section below: town.town_block_limit
• Use server provided gson instead of shading our own, courtesy of Warriorrrr with PR Use server provided gson instead of shading our own #5347.
• Tidy & rename /ta delete, courtesy of Warriorrrr with PR Tidy & rename /ta delete #5351.
• Enhance the /res list command, courtesy of Warriorrrr with PR Enhance the /res list command #5350.
• Limit the amount of changelog lines printed to 100, courtesy of Warriorrrr with PR Limit the amount of changelog lines printed to 100. #5352.
• Cache builds & fix up labeler & update to Java 17, courtesy of Warriorrrr with PR Cache builds & fix up labeler & update to Java 17 #5394.
• Make the outsiders prevent pvp toggle apply to plots, courtesy of Warriorrrr with PR Make the outsiders prevent pvp toggle apply to plots. #5455.
• Show online status for console when running /res, courtesy of Warriorrrr with PR Show online status for console when running /res. #5457.

• Improve startup logging/initialization, courtesy of Articdive & LlmDl with PR Improve logging #5299.
• Fix Citizens NPCs causing error on PlayerTeleportEvent, courtesy of Articdive with PR Fix Citizens NPCs causing error on PlayerTeleportEvent. #5319.
• Remove old Outpost checking code and references to Articdive which were not spelled correct, courtesy of Articdive with PR Remove old Outpost code and fix my names. #5324.
• Use Java NIO instead of File, courtesy of Articdive with PR Use Java NIO instead of File. #5316.

• Update Toolchain, Test multiple Java Versions, and Use SDKMAN for JitPack configuration, courtesy of TheFlagCourier with PR Update Toolchain, Test multiple Java Versions, and Use SDKMAN for JitPack configuration #5386.

• Cleanup util classes, couresty of EuGNosii with PR Cleanup util classes #5348.

• Implemented town and nation baltops, courtesy of Glare with Implemented town and nation baltops #5428.
  • Adds commands to see who is the richest players in a town or nation: /t baltop {townname} and /n baltop {nationname}.
  • Opens as a book for the player.

---

❌ Removed (4)

❌ Removed:

• Remove the GatherResidentUUIDTask.
  • Closes MojangAPI sending response 204 on accounts which still exist. #4611, Potential Edge-Case with JSON.Simple, potentially affecting MojangAPI, BukkitTools, and GatherResidentUUIDTask #5375.
• Remove one-way nation alliances.
  • This setting pre-dated the Invite system added many years ago.
  • Nations will no longer be able to ally another nation unless the other nation accepts their invite to ally.
• Remove TownBlock, TownyWorld and TownyUniverse warzone methods.
  • No longer used by FlagWar.
• Purge EventWar from Towny codebase.
  • Look for a new plugin EventWar, currently in closed-beta for Sponsors.

---

➕ Automatic Config Edits (0)

➕ Towny will automatically edit the following settings in your config and existing worlds

• None

---

✨ Command Changes (10)

✨ New Commands (7)

✨ New Commands:

• /ta set nationzoneoverride [town] [size]
  • Sets a town's nationzone override.
• /ta resident {residentname} delete
  • Deletes a resident.
• /nation baltop {nationame}
  • Opens a book displaying the richest players in a nation.
• /town baltop {townname}
  • Opens a book displaying the richest players in a town.
• /town allylist {townname}
  • Show allies of a town.
• /town enemylist {townname}
  • Show enemies of a town.
• /town toggle nationzone
  • Turns on and off the nationzone of a town (if they have one.)

---

❌ Removed Commands (3)

❌ Removed Commands:

• /ta delete {residentname}
• /towny war
• /ta toggle war

---

---

📕 Config Changes (6)

📕 New Config Options (5)

📕 New Config Options:

These new settings will be added to your config with their default settings.

• global_town_settings.respawn_protection
  • Default: 10s
  • When greater than 0s, the amount of time a player who has respawned is considered invulnerable.
  • Invulnerable players who attacker other players will lose their invulnerability.
  • Invulnerable players who teleport after respawn will also lose their invulnerability.
• global_town_settings.keep_inventory_on_death_in_arena
  • Default: false
  • If People should keep their inventories on death in an arena townblock. Is not guaranteed to work with other keep inventory plugins!
• global_nation_settings.capitals_cannot_be_neutral
  • Default: false
  • If true the capital city of nation cannot be neutral/peaceful.
• town.town_block_limit
  • Default: 0
  • The maximimum amount of townblocks a town can have, if town_block_ratio is 0 the max size will be decided by the town_levels.
  • Set to 0 to have no size limit.
• economy.daily_taxes.nation_perplot_upkeep
  • Default: false
  • Uses the total number of plots which a nation has across all of its towns to determine upkeep instead of nation_pertown_upkeep and instead of nation level (number of residents.)
  • Calculated by (price_nation_upkeep X number of plots owned by the nation's towns.)

---

❌ Removed Config Options (1)

❌ Removed Config Options:

• Entire war section has been removed.

---

---

🔑 Permission Node Changes (3)

🔑 New Permission Nodes (3)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• towny.command.townyadmin.set.nationzoneoverride
  • Child node of towny.command.townyadmin.set.*
• towny.command.town.toggle.nationzone.
  • Child node of towny.command.town.toggle.*
  • No changes required in townyperms.yml.
• towny.townless
  • Given to players who do not have a town.

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• none

---

---

💻 API Changes (31)

💻 API:

• TownToggleNationZoneEvent.
  • Cancellable event.
• DeathPriceEvents
  • NationPaysDeathPriceEvent
  • PlayerPaysDeathPriceEvent
  • TownPaysDeathPriceEvent
  • Make it possible for other plugins to manipulate the prices taken from players, towns and nations when someone dies.
• Town ally/enemy events.
  • Cancellable events thrown when towns have allies or enemies added/removed.
  • TownAddAlliedTownEvent
  • TownAddEnemiedTownEvent
  • TownRemoveAlliedTownEvent
  • TownRemoveEnemiedTownEvent
• Add ally and enemy lists to Towns.
  • Accessible via the API only. For plugins which want to make towns war against each other.
  • Closes Suggestion: Option for Towns to create alliances with other Towns, outside of a nation. #3476.
• Add Government#hasActiveWar.
  • A non-persistant Town and Nation flag, which other plugins can use to tell Towny a town or nation is considered at war.
  • Used to make various functions accomodate war, such as NationZones disabling during war, spawning only being to be used during peace/war.
• PlayerCacheGetTownBlockStatusEvent.
  • An event which allows another plugin to dictate what TownBlockStatus will be applied to a player's cache.
• TownyAPI#isPVP(Location).
  • Simple method to ask Towny if PVP is enabled at the location.
• Add ability to add translation strings apart from the LoadTranslationEvent.
• Make Confirmation commands configurable through the API.
• Made Confirmations able to take on a custom plugin prefix, so that it can be used to run non-Towny commands.
• Expand MetaDataUtil methods to include hasMeta and addNewMeta methods.
• Add TownyAPI#getTownBlock(Player).

• Add new PlotChangeOwnerEvents, courtesy of Warriorrr and LlmDl with PR API: Add PlotPreClaimEvent and PlotClaimEvent #5418.
  • PlotPreClaimEvent
  • PlotClaimEvent
  • PlotPreUnclaimEvent
  • PlotUnclaimEvent
• Add events for when a town/nation spawn is set, courtesy of Warriorrrr with PR Add events for when a town/nation spawn is set. #5432.
  • TownSetSpawnEvent
  • NationSetSpawnEvent
• Add TabCompleter support for addon commands, courtesy of Warriorrrr with PR Add TabCompleter support for addon commands. #5403.
• Add a TownBlock getter to PlotToggle events, courtesy of Warriorrrr with PR Add a TownBlock getter to PlotToggle events #5434.

• New API events courtesy of emanondev with PR TownBlockClaimCostCalculationEvent #5363. (First-Time Contributor!)
  • BonusBlockPurchaseCostCalculationEvent
    • Used to modify what towns pay when using /t buy bonus.
  • TownBlockClaimCostCalculationEvent
    • Used to modify what towns pay when using /t claim.

• New API to CombatUtil, courtesy of galacticwarrior9 with PR Add new API to CombatUtil #5446. (First-Time Contributor!)
  • CombatUtil#isAlly(Resident, Resident)
  • CombatUtil#isEnemy(Resident, Resident)

---

🔧 Fixed (58)

🔧 Fixed:

• Fix resident/town counts being shown on the status screens when "and more..." was being used on long lists.
  • Closes Re-add counts to lists on the status screens, when we've shortened a long list to include "and more..." #5331.
• Lists of TownyObjects (resident lists, town lists, nation lists) will no longer use their longer formatted names if the list is over 19.
  • Closes New /n and /t things are bad, and other UX improvements #5332.
• Fix Status Screen components' hovering bleeding over into blank spaces further along the line.
  • Closes New /n and /t things are bad, and other UX improvements #5332.
• Fix TownAddResidentEvent firing on database loads.
  • Closes TownAddResidentEvent fires on server startup and towny reload #5356.
• Fix plot groups causing an NPE when putting a town into a ruined state.
  • Closes Null pointer exception when Towny collects nation taxes #5372.
• Fix PlayerCacheUtil not choosing an Outsider TownBlockStatus.
  • Closes Town members have full permission in embassy plots if the plot is owned by a member of another town, regardless of town/plot perms #5395.
• Fix no feedback message when a town tries to purchase more bonus blocks, when they are already at max.
  • Closes No feedback given when attempting to buy bonus town blocks if you already have the maximum amount. #5354.
• Tidy up PlayerCacheUtil.
• Fix missing splitter between Nation bank and upkeep on the nation status screen.
• Change PlayerCacheUtil to once again check for a fakeplayer resident.
• Fix PlayerCacheUtil preventing plot permissions from working properly.
• Fix missing command feedback on many /tw toggle commands.
• Fix Global messages stripping their colour.
• Fix automatic renaming of invalid and duplicate town and nation names failing some of the time.
• Fix EventWar not handling the OutlawTeleportEvent.
• Fix welcome message only being seen by the newly joined player.
• Fix global messages that lost their Towny prefix.
• Fix updating reference lang files, an issue on select operating systems.
• Fix appearance of the overclaimed upkeep line in the town status screen.
• Make it so that turning Towny off in a world will shut down any active revert-on-unclaim actions.
• Make Confirmations show the correct timeout time.
• Make Cancelled confirmations only show the default cancel message when there's no onCancel runnable.
• Fix name changes charging money for names which won't pass a later test.
• Make nation's names behave according the Capitalize Names config setting which only affect towns.
• Make towns set their world when it is null, when we set the homeblock.
• Fix support for Reserve and an NPE when trying to deposit money into a town bank.
• Fix loading order of databaseconfig and config, fixing the config's database section conversion.
• Fix towny.claimed.townowned.* node not being tested for.
• Make /t reslist {townname} usable by the console.
• Make the plugin.name_blacklist apply to the town and nation titles and surnames.
• Fix ConcurrentModificationException in InviteHandler's expired invite search.
• Fix /towny command not working for console senders in the TownyCommandAddOn API.
• Fix /ta set capital, /ta set king, /ta nation NAME set commands not working properly.
• Fix nation zones generating an error if wildernessuse isn't enabled.
• Fix DeathPriceEvent missing handlers.
• Fix global messages being stripped of their colours.
• Fix deleted nations not removing sent/received invites.
• Fix automatic tag setting picking up -'s and _'s.
• Fix a nation removing an ally, and that causing the ally to remove the nation as an ally not throwing a NationRemoveAllyEvent.
• Fix NationRemoveAllyEvent constructor.
• Fix baltops not using cached balances.
• Fix Entity Listener paying attention to cancelled events, closes HangingEntity events which are cancelled are still being listened to. #5449.
• Fix /n tabcompleter missing "invite".
• Make /towny top balance run things async, which should make it easier on servers when there's no cached bank balances to work off of.

• Prevent spam if a player's locale is invalid, courtesy of Warriorrrr with PR Prevent spam if a player's locale is invalid. #5314.
• Prevent outlaws from being able to join towns, courtesy of Warriorrrr with PR Prevent outlaws from being able to join towns. #5329.
• Fix backup cleaning not working, courtesy of Warriorrrr with PR Fix backup cleaning not working #5337.
• Fix the /ta plot claimedat command, courtesy of Warriorrrr with PR Fix the /ta plot claimedat command #5361.
• Make the plot change listener more efficient, courtesy of Warriorrrr with PR Make the plot change listener more efficient #5365.
• Fix /ta reload all reloading config/lang twice, courtesy of Warriorrrr with PR Fix /ta reload all reloading config/lang twice. #5389.
• Only compile pushes for master, courtesy of Warriorrrr with PR Only compile pushes for master #5390.
• Regression: fix empty strings always being blacklisted, courtesy of Warriorrrr with PR Fix empty strings always being blacklisted #5406.
• Fix variable name in javadoc, courtesy of Warriorrrr with PR Fix variable name in javadoc #5419.
• Fix typo in /n set capital node, courtesy of Warriorrrr with PR Fix typo in /n set capital node. #5435.
• Fix exception when running /plot claim, courtesy of Warriorrrr with PR Fix exception when running /plot claim #5448.
• Fix nation spawns not being cleared when a capital changes, courtesy of Warriorrrr with PR Fix nation spawns not being cleared when a capital changes. #5456.
• Set the nation spawn to the town's spawn on creation, courtesy of Warriorrrr with PR Set the nation spawn to the town's spawn on creation. #5458.

• Parse baltops asynchronously, courtesy of Gamer153 with PR Parse baltops asynchronously #5444. (First-Time Contributor!)

---

🌏 Language Updates (6)

🌏 Language Updates:

• New languages: Japanese, Czech, Tagalog, Portuguese, Thai, Bulgarian.
  • If you'd like to help translating Towny into the available languages or add entirely new languages, we're on Crowdin!
• Language file to 0.135.

---

👽 Placeholder Updates (4)

👽 Placeholder Updates:

• %townyadvanced_town_board% - Displays a player's town's board message.
• %townyadvanced_nation_board% - Displays a player's nation's board message.
• %townyadvanced_player_location_town_board% - Displays the board message of the town where the player is stood.
• %townyadvanced_player_location_nation_board% - Displays the board message of the nation where the player is stood.

---

💬 TownyChat Changes (2)

💬 TownyChat Changes:

• Implemented sounds for channels and toggling by @darbyjack in Implemented sounds for channels and toggling TownyChat#34
• New Command: /ch soundtoggle {channelname} - Toggles the channel sound on/off for that player.

---

Towny Sponsors I want to give a big thank you to all of my sponsors: These are the people that help to make Towny's support and development as active as it is.
MrLogano	Momshroom	Cobrex1	KarlOfDuty
scatterspell	TheFlagCourier	gerardvanschip	DrprofLuigi
Tobza	SmallSansSerif	TheNylox	diontimmer
trevor1097	benevolent2012	0xBit-MC	specs1396
treeDerevo	Scottlander100	ItsSynchro	EnvyEnfys
MidnightSugar	mzyax	PestoNotPasta	catsaretheend
cigaming	KeNickGong	honnisha	MilesBHuff
pebblehost	Akiranya	BamBamTheEggman	NoikzGaming
LordHenryVonHenry	nUSAHudson	SolarCiv	Litning11
Black-Tongue	SkapMC	nickoo9043	Tauses
AaronBDesign	LeftTheNegotiator	MaluuhLive	anaxios
AguilaDB	Zectogonix	Lemuridaee	and 9 private sponsors.
If you want to support the developer, become a sponsor. (It's just like Patreon but instead 100% of your support goes to the developer.) Plus there are Sponsor Perks!

Important Links
How Towny Works	Towny Install Guide	Towny Update Guide
Complete Changelog	Default Config Files	Commands/Permissions Placeholders

⏬ Download available as a .zip file in the Assets section below:

---

This discussion was created from the release 0.97.3.0 for MC 1.14.* & 1.15.* & 1.16.* & 1.17.*.