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

[LlmDl]

Towny Advanced 0.97.2.0

Release contains:

Towny 0.97.2.0
TownyChat 0.90

Welcome to Towny 0.97.2.0.
Towny 0.97.2.0 is the third release in the 0.97.*.* series. Included is a major change to how Towny handles languages and an overhaul of the Status Screens, and more.
We have of course also closed some bugs, so updating should be a priority!
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

➕ Added:

• StatusScreen overhaul!
  • StatusScreens for townblocks, residents, towns, nations and worlds have had a facelift.
  • Screens now include hoverable and clickable componenents to them.
  • Screen components will word-wrap efficiently.
  • StatusScreens are now colourable using only 12 language strings found in the towny\settings\lang\override\global.yml file.
  • You can even re-colour the title bar.
  • StatusScreenEvents now have the ability to remove components and add components.
    • API-Usage:
      • The existing StatusScreenEvents thrown by Towny will now include their getStatusScreen() method, from which the StatusScreen is accessible and modifiable.
      • ex: event.getStatusScreen().removeStatusComponent(String name); - To remove a StatusComponent from the StatusScreen.
      • ex: event.getStatusScreen().addComponentOf(String name, String text, HoverEvent hover, ClickEvent click); - To add a new StatusComponent to the StatusScreen.
      • ex: event.getStatusScreen().replaceComponent(String name, TextComponent component); - To replace an already existing component with something else.
• Create database.yml file.
  • Your Towny database settings will be migrated to a new database.yml file.
  • This allows us to be shown the config file without mysql servers having to go to the trouble of removing their passwords.
• Automatic town and nation name renaming for FlatFile database.
  • If a town or nation would be loaded with an invalid name, which would cause Towny to enter into safemode, Towny will rename that town or nation.
  • Solves for the most common sort of SafeMode in modern Towny.

• Automatic locale detection/Multi-language support, courtesy of Warriorrrr with PR Concept/translation registry #5167.
  • Your server will now display all towny messages to your players according to their client's locale, if that language is available.
    • There are currently 20 languages available, seen in the config.yml.
    • If your language is not present it can be requested and added to the crowdin website: https://crowdin.com/project/townyadvanced
  • A global.yml language file will be present to allow you to override a language string for all languages.
    • Meaning you do not have to change (for example) the towny prefix in each file, just the global.yml.
  • If you use a custom language file, your file name should match a locale (ie: en-US.yml) and it should be placed into the towny\settings\lang\override\ folder.
    • Files in the override folder will replace any lang file in towny.
  • The towny\settings\lang\reference\ folder is used only for reference purposes. Editing these files has no effect, use the overrides folder.
  • The console/logs will use the language set in your config.yml.
  • Closes Suggestion: Player selected Language. #4926.
• Add prompts for Add Player to PermissionGUI, courtesy of Warriorrrr with PR Add prompts #5248.
• Raise language level to 16 using jabel, courtesy of Warriorrrr with PR Raise language level to 16 using jabel #5259.
• Modernise /townyworld, courtesy of Warriorrrr with PR Modernise /townyworld #5292.
• Add a /ta install command, courtesy of Warriorrrr with PR Add a /ta install command #5303.

---

➕ Automatic Config Edits (1)

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

• global_town_settings.prevent_town_spawn_in will have ",outlaw" added to it.
  • Outlaws will be kept from using (and paying for) /t spawn and /n spawn much earlier than before.

---

✨ Command Changes (4)

✨ New Commands (4)

✨ New Commands:

• /ta purge [days] {townname}
  • Deletes the players from the given town, who haven't logged in in the given days.
  • Closes Suggestion: /ta purge with specific town #5125.
• /n ranklist {nationname}
  • View the ranklist of another nation.
• /t ranklist {townname}
  • View the ranklist of another town.
• /res tax {resname}
  • View the tax requirements of another resident.

---

❌ Removed Commands (0)

❌ Removed Commands:

• none

---

---

📕 Config Changes (1)

📕 New Config Options (1)

📕 New Config Options:

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

• economy.daily_taxes.town_plotbased_upkeep_maximum_amount
  • Default: 0.0
  • If set to any amount over zero, if a town's plot-based upkeep totals more than this value, the town will pay the maximum instead.

---

❌ Removed Config Options (0)

❌ Removed Config Options:

• none

---

---

🔑 Permission Node Changes (0)

🔑 New Permission Nodes (0)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• none

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• none

---

---

💻 API Changes (6)

💻 API:

• Add TownyFriendlyFireTestEvent, courtesy of LudwigHornslied with PR Add Friendly fire test event #5246.
• Add Resident#isOnline, courtesy of Warriorrrr with PR Add Resident#isOnline #5273.
• Add new MetaDataUtil, to ease getting and setting metadata on TownyObjects.
• Added TownBlockStatusScreenEvent.
  • Adds ability to add lines and components to the TownBlock status screen (seen via /plot perm|info.)
• Remove TownRuinSettings class, moving methods to TownySettings.
• Move TownRuinUtil to utils package.

---

🔧 Fixed

🔧 Fixed:

• Remove physical-player-interactions from automatically being treated as switch actions.

  • Pressure plates are already included in the switch_id list by default and should cause no issue to existing servers.
  • Closes Blocks not in switch_ids still count as switching #5140.

• Fix towns and nations being able to use the economy prefixes as town and nation names.

  • Closes Townname containig economy.town_prefix #5196.

• Fix mayors being able to jail their residents in order to get around /t spawn restrictions for enemies and outlaws.

  • Closes Avoid anti-teleport when outlaw #5216.

• Fix fishing being able to be bucketed.

  • Closes Outsiders can pickup fish in claimed land #5213.

• Fix entities not being able to be added to the EventWar explosions_ignore_list.

  • Closes Entities unable to be placed in explosions_ignore_list. #4791.

• Fix /t claim auto|rect not claiming the last townblock in the radius.

  • Closes /claim auto and /claim rect auto and /claim 1 (radius) leave a plot behind. #5224.

• Fix bankhistory books not showing correct final balance.

  • Closes Town/Nation bankhistory lacks {balance} placeholder; displays transaction amount instead of the town/nation balance #5269.

• Fix /res jail paybail command not sending confirmation when bail costs are more than 0.

  • Closes Paybail command dont work #5265.

• Fix incorrect messages being shown to towns when their peaceful status is disallowed.

  • Closes Incorrect insufficient fund to turn on peaceful status of Town #5286.

• Update list of banned names to include new /town subcommands.

• Add bypass for campfires being unable to be lit.

• Fix %townyadvanced_player_status% placeholder.

• Fix /n set capital not checking the correct number for max-residents-per-town.

• Fix DailyTimerTasks not checking if some lists are empty.

• Solve potential NPE when residents' jail cells are loaded.

• Replace deprecated mysql driver.

• Fix sending correct helpmessage to ops/admins who log in while safemode is active.

• Fix /t outlaw add command kicking the command sender from their town.

• Fix map hud being off by one townblock in some instances.

• Fix jailed residents not saving their object immediately.

• Fix saving of jailed residents in mysql.

• Fix some of the /ta town {townname} set commands being locked behind a permission test.

• Fix Axolotl thieving.

• Fix ChatTools formatTitle not handling some languages properly on startup.

• Fix missing tabcomplete for /res jail paybail.

• Fix nation merging not performing optional proximity test.

• Update maven-shade-plugin to a version which supports Java 16.

• Fix jails not loading correctly.

• Fix /tw toggle revertunclaim not stopping reverts in progress.

• Fix elements added via the StatusScreenEvents additionalLines not appearing on the status screens in some situations.

• Make (PvP), (No PvP) in the chunk notifications use the language string.

• Make the remainder of the chunk notifications messages use the players' locale.

• Update yaml parser url and fix using a translatable (which could happen before we load language.)

• Remove the ancient and often-mistaken /ta output.

• Remove the MemMgmt util.

• Fix lang file fallback, courtesy of Warriorrrr with PR Fix fallback language not being en_US #5230.
  • Custom language files that pre-date multi language support, which do not conform to a locale code (ie: en_CA, pt_BR) will not generate an NPE.
  • en_US will be loaded instead.
• Prevent chickens being spawned without permission, courtesy of Warriorrrr with PR Prevent chickens being spawned without permission #5237.
  • An egg that lands in a plot will test if the egg-thrower can item_use in that location, when eggs are in the item_use list.
  • Eggs will automatically be added to the config.yml's item_use list with this update.
• Respect the skip named option in onCreatureSpawn, courtesy of Warriorrrr with PR Respect the skip named option in onCreatureSpawn #5227.
  • Closes Villager deletion issue when converting into a zombie villager #5226, Closes Mob deletion issue when switching dimensions (nether to overworld) #5225.
• Use deprecated mysql driver if required, courtesy of Warriorrrr with PR Use deprecated driver if needed #5294.
  • Closes [Towny]: Driver error: java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver #5245.
• Fix NPE preventing null mayors from being replaced when /ta set mayor is used, courtesy of Warriorrrr with PR Fix NPE preventing null mayors from being replaced. #5235.
• Make context calculation faster, courtesy of Warriorrrr with PR Make context calculation faster #5244.
• Check if resident is friended before sending removal message, courtesy of Warriorrrr with PR Check if resident is friended before sending removal message. #5253.
• Add missing owner test, courtesy of Warriorrrr.
• Prevent empty messages from being sent, courtesy of Warriorrrr with PR Prevent empty messages from being sent #5272.
• Disable citizens compatability if citizens gets disabled, courtesy of Warriorrrr with PR Disable citizens compatability if citizens gets disabled. #5289.
• Fix plugin disabling if something is translated before fully loading translations, courtesy of Warriorrrr with PR Fix plugin disabling if something is translated before fully loading translations. #5291.
• Temporary fix for grass remaining snowy, courtesy of Warriorrrr with PR Temporary fix for grass remaining snowy #5298.
• Make github actions not build commits from the crowdin branch, courtesy of Warriorrrr with PR Make github actions not build commits from the crowdin branch #5304.

• Fix AlreadyRegisteredException when accepting two invites or more, courtesy of 0xBit-MC Fix AlreadyRegisteredException when accepting two invites or more #5254.

• Fix typos in TownyFormatter, courtesy of LudwigHornslied with PR Fix typos #5270.

---

🌏 Language Updates

🌏 Language Updates:

• New Languages added to Crowdin: Vietnamese, Japanese.
• Bump language files to 0.124.

---

👽 Placeholder Updates (6)

👽 Placeholder Updates:

• Placeholder change: %townyadvanced_player_location_pvp% now shows (No PVP) where PVP is disabled.
• New Placeholder: %townyadvanced_player_location_town_resident_count%
  • If there is a town present where the player stands, it will return the number representing the number of residents that town has.
• New Placeholder: %townyadvanced_player_location_town_mayor_name%
  • If there is a town present where the player stands, it will return the name of that town's mayor.
• New Placeholder: %townyadvanced_player_location_town_nation_name%
  • If there is a town present where the player stands, it will return the name of the nation, if the town has one.
• Allow the notification.town_names_are_verbose setting to affect the {townname} placeholder usable in the titles/substitles notifications.
• Blank king prefixes/postfixes wont override mayor prefixes in the towny_prefix/postfix placeholders.
• Fix %townyadvanced_player_status% placeholder not using the placeholder colouring settings.

---

💬 TownyChat Changes

💬 TownyChat Changes:

• Allow channeltags to make use of hex colour formatting.
• Fix default channels not being returned if TownyChat is searching for a channel of that type.
  • Closes Players get kicked into another channel type on town deletion. #4984

---

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	bretomart	HunSolos
0xBit-MC	specs1396	treeDerevo	Scottlander100
ItsSynchro	MidnightSugar	PigioGigio	PestoNotPasta
catsaretheend	cigaming	KeNickGong	honnisha
MilesBHuff	pebblehost	Akiranya	BamBamTheEggman
TakeoRenka	LordHenryVonHenry	nUSAHudson	and 7 private sponsors.
If you want to support the developer consider becoming a sponsor. (It's just like Patreon but 100% goes to the developer.) Plus there are 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.2.0 for MC 1.14.* & 1.15.* & 1.16.* & 1.17.*.