0.98.4.0 for MC 1.16.* & 1.17.* & 1.18.* & 1.19.*

[LlmDl]

Towny Advanced 0.98.4.0

Release contains:

Towny 0.98.4.0
TownyChat 0.98

Welcome to Towny 0.98.4.0.
Towny 0.98.4.0 is the fifth release in the 0.98.*.* series!
This release adds support for 1.19.2, as well as full support for MiniMessage, and many other additions! This release version has been in the works for a while, and of course comes with a slew of bug fixes!
This version supports Minecraft 1.16 and newer.
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 (50)

➕ Added:

• New entering-town-placeholders:

  • When players see town/wilderness notifications for entering towns there are now new options:
    • {nationname} - Name of the nation.
    • {nationcapital} - Name of the nation capital and nation.
    • {nation_motd} - Shows the nationboard message.
    • {nation_residents} - Shows the number of residents in the nation.
    • {nation_residents_online} - Shows the number of residents online currently.
  • Closes Suggestion: Add more title/subtitle placeholders for the using_titles option #6159.

• Add unclaimEntityTypeDelete to TownyWorld.

  • Allows Towny to delete all Entities of a given type from a TownBlock when it is unclaimed by a town.
  • Closes Suggestion: Entity removal upon town unclaim/deletion #5953.

• Reflow TownyMessaging.

  • Re-directs TownyMessaging from having many end points for messages, into the sendMessage(Sender, String) method.
  • Plugins that want to cancel Towny events and prevent those events showing cancellation messages to the user should be able to do so.

• Allow for all nation spawn and town spawn types to have individual spawn cooldowns.

  • Your previous global_town_settings.spawn_cooldown_time setting will be migrated to the new settings.
  • Closes Suggestion: Different cooldowns in town spawn travel #6224.

• Make it possible to use Unicode symbols in the ASCII maps.

  • Closes Suggestion: Monospaced ASCII map #6114.

• Make unconfigurable map symbols configurable.

  • Closes Suggestion: Allow customizing all symbols on the ASCII map #6113.

• Add tab completion for setting town and nation map colours.

  • Closes Suggestion: Tab completions for /n set mapcolor and /t set mapcolor  #6188.

• Make the plot perm hud translatable.

• Add a command to manually override a town's TownLevel.

• Add some int and money validations to reduce duplication in commands.

• Simplify permission-checking code with NoPermissionException.

• Apply new font-measuring to BookFactory, fixing potential Invalid Book Tag books being made.

• Big refactor on TownCommand, making use of newer methods and making the code more readable.

• Clean up edgeblock test in TownCommand.

• Add version numbering to the database.yml.

• Adopt new Spigot Criteria Scoreboard API.

• Make plotManagementDeleteIDs operate async.

• Make NPCCleanupTask implement Runnable.

• Add protection to Chiseled Bookshelves for when they're added to the game.

• Simplify and condense permission tests, by giving NoPermissionException the ability to accept a Translatable.

• Display nation tax percentage in /towny prices when applicable.

• Allow TownBlockPVPTestEvent & WildernessPVPTestEvent to be run async.

• Adoption of MiniMessage throughout the remaining codespaces, courtesy of Warriorrrr with PR MiniMessage! #6142!
  • As of this moment, all messaging is using minimessage. All language strings can accept MiniMessage tags and,
  • Hex is available everywhere in just about any tag style you can imagine.
  • If you have previously been using hex gradients you might have to update your tags to the MiniMessage way of things.
  • This was a lot of effort on Warrior's part over a span of many pull requests:
    • Update translatable with changes from MiniMessage PR, courtesy of Warriorrrr with PR Update translatable with changes from MiniMessage PR #6078.
    • Create our own wrapper impl, courtesy of Warriorrrr with PR Create our own wrapper impl #6075.
    • Add Translator#component, courtesy of Warriorrrr with PR Add Translator#component #6088.
    • Add TownyComponents class, courtesy of Warriorrrr with PR Add TownyComponents class #6105.
    • Make the ASCII map fully use components, courtesy of Warriorrrr with PR Make the ASCII map fully use components #6103.
    • Handle bold characters in titles using pixelwidth, courtesy of Warriorrrr with PR Handle bold characters in titles using pixelwidth #6107.
    • Add component support for status screen events, courtesy of Warriorrrr with PR Add component support for status screen events #6091.
    • Add status screen changes from minimessage branch, courtesy of Warriorrrr with PR Add status screen changes from minimessage branch #6090.
    • Use FontUtil's minecraftfont constant for bookfactory, courtesy of Warriorrrr with PR Use FontUtil's minecraftfont constant for bookfactory #6133.
    • Add colors class changes from minimessage branch, courtesy of Warriorrrr with PR Add colors class changes from minimessage branch #6132.
    • Replace Component.texts with alternatives in formatter, courtesy of Warriorrrr with PR Replace Component.texts with alternatives in formatter. #6134.
    • Replace ChatColor.stripColor uses with Colors.strip, courtesy of Warriorrrr with PR Replace ChatColor.stripColor uses with Colors.strip #6143.
    • Replace ChatTools.stripColour with Colors.strip, courtesy of Warriorrrr with PR Replace ChatTools.stripColour with Colors.strip #6185.
• Add configurable plot type limits, courtesy of Warriorrrr with PR Add configurable plot type limits #6038.
  • Closes Suggestion: Plot type limits per Town. #5889.
  • If you want to limit plot types amounts per-town based on their town_level you will fill out the new section in this fashion:
    townBlockTypeLimits:
    • shop: 2
    • arena: 2
• Add Resident#getAccountOrNull, courtesy of Warriorrrr with PR Add Resident#getAccountOrNull #6006.
  • Potentially fixing an issue when Accounts are being renamed.
• Add option to disallow numbers in town/nation names, courtesy of Warriorrrr with PR Add option to disallow numbers in town/nation names #6068.
  • Closes Suggestion: Option for disabling numbers in town and nation names. #5954.
• Make it easier to debug lang file formatting errors, courtesy of Warriorrrr with PR Make it easier to debug lang file formatting errors #6066.
  • Closes Conversion = 'to' #6036.
• Add null check to teleport listener, courtesy of Warriorrrr with PR Add null check to teleport listener #6077.
  • Closes Error Towny #6072.
• Add bamboo raft to boats item list, courtesy of Warriorrrr with PR Add bamboo raft to boats item list #6253.
• Specify .github/workflows/ directory for CI/CD label, courtesy of Warriorrrr with PR Specify .github/workflows/ directory for CI/CD label #6265.
• Make UpdateCheckerTask implement runnable, courtesy of Warriorrrr with PR Make UpdateCheckerTask implement runnable #6270.
• Use getPlayerExact in more places, courtesy of Warriorrrr with PR Use getPlayerExact in more places #6273.

• Jail Overhaul courtesy of Kali and LlmDL with PR Various Improvements to Jail Functionality #6031.
  • Includes the ability for mayors to set bail amounts.
    • Admins can limit the upper limit on bail costs.
  • Includes the optional ability for admins to set a jail-upkeep.
    • Towns can be made to pay an initial fee to jail someone.
    • Towns can be made to pay hourly to house prisoners.
  • Includes the ability to limit how many players can be jailed in one town.
    • There is also a configurable system that decides when happens when a town has reached their jailed-residents limit.
  • Includes the ability to give or not give the jail book received by newly jailed players.

• Auto-supress event message if empty, courtesy of GNosii with PR Auto-supress event message if empty #6028.

• Add admin town command upkeep toggle, courtesy of Gamer153 with PR Add admin town command upkeep toggle #6052. (First-Time Contributor!)

• Added Nation tax percent, courtesy of PainOchoco with PR Nation tax percent #6262.
  • It is possible for nations to use /n toggle taxpercent, and tax their towns a percent of the town bank, instead of a flat rate.
  • This prevents towns being kicked for non-payment, as the amount just shrinks as the town gets poorer.
• Added unformatted town/nation balance placeholders, courtesy of PainOchoco with PR Added unformatted town/nation balance placeholders #6263.
• Added max residents per nation, courtesy of PainOchoco with PR Added max residents per nation #6264.

---

➕ Automatic Config Edits (3)

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

• ,OAK_CHEST_BOAT will be added to your protections.switch_ids list.
  • This will make all chest boats require switching perms to open/enter.
  • New configs will have OAK_CHEST_BOAT included in the switch_ids list.
• previous notification setting will be migrated to the new home: notification.notifications_appear_as
• your config's town_level sections will have an empty townBlockTypeLimits: added.

---

✨ Command Changes (15)

✨ New Commands (14)

✨ New Commands:

• /ta town TOWNNAME settownlevel [#|unset]

  • Manually overrides a town's townlevel to a number, 1 through x, where x is the last townlevel.
  • unset subcommand removes the manual override and returns a town to using the normal townlevel based on resident count.

• /ta town TOWNNAME giveboughtblocks [#|unset]

  • Command that lets the admin modify the number of purchased townblocks a town has.
  • unset subcommand removes all purchased townblocks from the town.
  • Use negative numbers to take purchased townblocks from the town.
  • Closes Suggestion: Let bought townblocks be edited via command #6034.

• /ta town NAME toggle upkeep

  • Toggles upkeep on or off for the given town.

• /ta town TOWNNAME toggle forcedisablepvp

  • Changes a town's forcedisabledpvp setting, which can make a town have PVP off while the world is forcepvp=true.
  • Good for admin/server towns.

• /ta town new TOWNNAME npc

  • Creates a new town with an NPC mayor, allowing admins to make a new town without having to leave their own.

• /ta resetbanks [amount].

  • Resets all town and nation banks to the given amount.

• /t withdraw all - remove all money from the town bank.

• /t deposit all - deposit all your money into the town bank.

• /n withdraw all - remove all money from the nation bank.

• /n deposit all - deposit all your money into the nation bank.

• /n toggle taxpercent - Toggle percentage nationtax on or off.

• /n set taxpercentcap - Sets the max amount of money which can be gotten via percent nationtax, from a town.

• /res toggle infotool

  • Allows an admin to use the clay brick tool to determine the Bukkit names/classes of blocks and entities.

• /res set mode infotool

  • Allows an admin to use the clay brick tool to determine the Bukkit names/classes of blocks and entities.

---

✨ Changed Commands (1)

✨ Changed Commands:

• /t jail.
  • If your server has bail allowed: jail.bail.is_allowing_bail, the jail command will now accept a bail amount:
  • /t jail [playername] {hours} {bail} {jail} {cell}
  • If bail is not allowed the old command is used: /t jail [playername] {hours} {jail} {cell}

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 Config Changes (37)

📕 New Config Options (36)

📕 New Config Options:

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

• economy.bankruptcy.neutrality.can_bankrupt_towns_pay_for_neutrality

  • Default: true
  • If a town is bankrupt can they still pay for neutrality?
  • Closes Suggestion: Option to disable neutrality payments for towns going bankrupt #6017.

• economy.daily_taxes.allow_negative_plot_tax",

  • Default: false
  • If enabled, if a plot tax is set to a negative amount it will result in the resident that owns it being paid by the town bank (if the town can afford it.)
  • Make it possible for plot taxes to be negative, as a way for mayors to pay residents for owning plots.
  • Closes Suggestion: Make Plot Taxes a source of revenue for players rather than revenue for the town bank. #6047.

• economy.daily_taxes.max_nation_tax_percent

  • Default: 25
  • Maximum tax percentage allowed when taxing by percentages for nations.

• economy.daily_taxes.max_nation_tax_percent_amount

  • Default: 10000
  • The maximum amount of money that can be taken from a balance when using a percent tax, this is the default for all new nations.

• new_world_settings.are_new_world_claimable

  • Default: true
  • Are new worlds claimable by default?
  • Setting this to false means that Towny will still be active but no land can be claimed by towns.

• new_world_settings.plot_management.entity_delete.enabled

  • Default: false

• new_world_settings.plot_management.entity_delete.unclaim_delete

  • Default: "ENDERCRYSTAL"
  • These entities will be deleted upon a plot being unclaimed

• ascii_map_symbols.home

  • Default: "H"
  • The character used for the home symbol.

• ascii_map_symbols.forsale

  • Default: "$"
  • The character used for plots which are forsale.

• ascii_map_symbols.wilderness

  • Default: "-"
  • The character used for plots which are unclaimed.

• plugin.day_timer.uses_java_timer

  • Default: false
  • If enabled (disabled by default), a Java Timer will be used for scheduling new days, which is more accurate than Towny's Bukkit timer task but uses an extra thread.

• filters_colour_chat.papi_relational_formatting.no_town

  • Default: &f
  • Given to players who have no town.
  • Closes Suggestion: Add a townless relational placeholder #6169.

• notification.notifications_appear_as

  • Default: "action_bar"
  • This setting controls where chunk notifications are displayed for players.
  • By default, notifications appear in the player's action bar.
  • Available options: action_bar, chat, bossbar, or none.

• notification.titles.nationname_format

  • Default: "&6Nation of %s"
  • The format used to format the {nationame} option. The name of the nation will replace %s.

• notification.titles.nationcapital_format

  • Default: "&6Entering %s, Capital City of %s"
  • The format used to format the {nationcapital} option. The name of the capital city and nation will replace the %s and %s.
  • Alternatively, you can use %t for townname and %n for nationname and show either one or both.

• jail.pow_jail_hours

  • Default: 5
  • How many hours an attacking enemy will be jailed for.

• jail.maximum_jail_hours

  • Default: 5
  • The maximum hours that a mayor can set when jailing someone, full number expected.

• jail.fee_initial_amount

  • Default: -1
  • Amount that it costs per player jailed for a town, this is withdrawn from the Town bank. Set to -1 to disable.

• jail.fee_hourly_amount

  • Default: -1
  • Amount that it costs per player jailed per hour for a town, this is withdrawn from the Town bank. Set to -1 to disable.

• jail.bail.bailmax_amount

  • Default: 100
  • Max bail cost that a mayor can set.

• jail.max_jailed_count

  • Default: -1
  • Amount of potential jailed players per town, set to -1 to disable.

• jail.max_jailed_newjail_behavior

  • Default: 0
  • Behaviour for new jail attempts if max jailed count is reached.
  • 0 = Unable to jail new players until a current prisoner is released.
  • 1 = A prisoner slot will be made by automatically releasing a prisoner based on remaining time.
  • 2 = A prisoner slot will be made by automatically releasing a prisoner based on lowest custom bail.

• jail.is_jailbook_enabled

  • Default: true
  • If false players will not be provided with a book upon being jailed.

• global_town_settings.unkickable_ranks

  • Default value: assistant
  • List of ranks (separated by a comma) that will prevent a player from being kicked from a town.

• global_town_settings.spawning_cooldowns.town_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player can use /t spawn or /res spawn.

• global_town_settings.spawning_cooldowns.outpost_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player can use /t outpost.

• global_town_settings.spawning_cooldowns.nation_member_town_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player of the same nation can use /t spawn.

• global_town_settings.spawning_cooldowns.nation_ally_town_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player in an allied nation can use /t spawn.

• global_town_settings.spawning_cooldowns.unaffiliated_town_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player who is not a member or ally of town can use /t spawn.

• global_nation_settings.spawning_cooldowns.nation_member_nation_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player of the same nation can use /n spawn.

• global_nation_settings.spawning_cooldowns.nation_ally_nation_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player allied with the nation can use /n spawn.

• global_nation_settings.spawning_cooldowns.unaffiliated_nation_spawn_cooldown_time

  • Default: 30
  • Number of seconds that must pass before a player who is not a member or ally can use /n spawn.

• global_nation_settings.max_residents_per_nation

  • Default: 0
  • If higher than 0, it will limit how many residents can join a nation. Does not affect existing nations that are already over the limit.

• nation.default_taxes.tax

  • Default: 0.0
  • Default amount of tax of a new nation. This must be lower than the economy.daily_taxes.max_nation_tax_amount setting.

• nation.default_taxes.taxpercentage

  • Default: false
  • Default status of new nation's taxpercentage. True means that the default_tax is treated as a percentage instead of a fixed amount.

• nation.default_taxes.minimumtax

  • Default: 0.0
  • A required minimum tax amount for the default_tax, will not change any nations which already have a tax set.
  • Do not forget to set the default_tax to more than 0 or new nations will still begin with a tax of zero.

---

❌ Removed Config Options (1)

❌ Removed Config Options:

• global_town_settings.spawn_cooldown_time

---

---

🔑 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 (16)

💻 API:

• Event firing overhaul:

  • Make most Cancellable Events into CancellableTownyEvents as long as they are Cancellable and have a cancel message.
  • Change code to use new BukkitTools#ifCancelledThenThrow() so we can one-line throwing events that only need to display their cancel message.
  • Add CancelledEventException which extends TownyException, making the error message return the CancellableTownyEvent#getCancelMessage.
  • Replace all event firing with BukkitTools#fireEvent(Event).
  • Some Cancellable events have had their one-off getCancellationMessage/setCancellationMessages deprecated and replaced with the uniform CancellableTownyEvent#getCancelMessage/#setCancelMessage(String).
  • Add the ability to make Confirmations with a pre-set CancellableTownyEvent which is fire before money is paid, or the onAccept() code is ran. See ConfirmationBuilder#setCancellableEvent(CancellableTownyEvent) for details.

• Add ChunkNotificationEvent

  • Cancellable event that lets other plugins alter Towny's ChunkNotifications.
  • Closes Suggestion: Add API for action bar notifications #6009.

• Add new outlaw add/remove events.

  • TownOutlawAddEvent
  • TownOutlawRemoveEvent
  • Cancellable events that are thrown when a town is modifying who is outlawed.

• Add Confirmation related events, courtesy of Warriorrrr with PR Add Confirmation related events #6182.

  • ConfirmationEvent
  • ConfirmationCancelEvent
  • ConfirmationConfirmEvent
  • ConfirmationSendEvent
    • Includes the ability "hide" the confirmation for plugin authors to replace with their own selection/display.

• Add a ConfirmationTransaction to Confirmations.

  • This enables cost-requirements to be baked-in to Confirmations.
  • Costs are passed in as a Supplier so that calculations can be made after the player accepts.

• Add WorldCoord#getCardinallyAdjacentWorldCoords

  • Returns a List of WorldCoords directly N, E, S, W from the WorldCoord.

• Add WorldCoord#hasTown(Town).

• Alter CooldownTimerTask to accept strings alongside the pre-configured enum, allowing for third-party plugins to create simple cooldowns.

• Add WorldCoord#getChunks, courtesy of Warriorrrr with PR Add WorldCoord#getChunks #6098.

• Allow removing metadata by key, courtesy of Warriorrrr with PR Allow removing metadata by key #6089.

• Add TownyAPI#getTown(Player), courtesy of Warriorrrr with PR Add TownyAPI#getTown(Player) #6166.

• Add TownyAPI#getNation(Player), courtesy of Warriorrrr with PR API: Add TownyAPI#getNation(Player) #6190.

• Add ResidentToggleModeEvent, courtesy of Warriorrrr with PR Add ResidentToggleModeEvent #6210.

• Add NewResidentEvent, courtesy of PestoNotPasta with PR Adds NewResidentEvent #6121.

• Add TOWNYADMIN_TOWN and TOWNYADMIN_NATION CommandTypes, courtesy of Lemar98 with PR API: Add TOWNYADMIN_TOWN and TOWNYADMIN_NATION CommandTypes #6179. (First-Time Contributor!)

• Add TownBlockExplosionTestEvent, courtesy of galacticwarrior9 with PR Add TownBlockExplosionTestEvent #6204.

  • Closes Suggestion: Equivalent to TownBlockPVPTestEvent for Explosions  #5970.

---

🔧 Fixed (60)

🔧 Fixed:

• Fix WorldCoord#loadChunks and #unloadChunks from being called async.

  • Closes Towny failed main thread check: ChunkMapDistance::addTicket java.lang.Throwable: null #6022.

• Fix the back button on the switch/itemuse/allowedblocks GUIs not working from the first page.

  • Closes GUI button doesn't work #6027.

• Fix messages from cancelled Nation ally adding and removal events not displaying to the command user.

  • Closes Cancellation message not sent after cancelling NationRemoveAllyEvent #6049.

• Fix using World#isRespawnAnchorWorks() which did not exist in 1.16.5 api.

  • Closes Spam Errors #6056.

• Fix many ArrayIndexOutOfBoundsExceptions in the /ta town NAME command.

  • Progress towards Internal error on /ta town <town> outpost #6120.

• Fix missing outlaws-cannot-spawn-to-towns feature that used to exist.

  • Closes Players can use /t spawn to teleport to towns they are outlawed in  #6147.

• Protect lily pads in towns from being destroyed by boats.

  • Closes Boats can break lily pads in towns #6160.

• Fix being able to set a townblock to the type it already is.

  • Closes Unremovable Jails #6183.

• Fix PlaceholderExpansion remaining registered during Towny reloads.

  • Closes Error in the plugin #6218.

• Prevent tadpoles being stolen with a bucket.

  • Closes Tadpoles can be stolen with a bucket of water #6241.

• Fix /t outpost generating a array index out of bounds.

• Add a small delay before we start the DrawSpawnPointsTask, because one server got a ConcurrentModificationException.

• Fix admins being unable to teleport out of Towns in which they are outlawed.

• Adapt to PlaceholderAPI no longer parsing colours.

• Remove old tc, nc tab completes from /res set mode.

• Fix jailcells being able to be placed where a jailcell already exists.

• Fix potential NPE in SelectionGUI.

• Fix max_distance_between_homeblocks config setting being triggered when there are no towns yet.

• Fix regression from 0.98.3.4 that resulted in some command output breaking due to Update translatable with changes from MiniMessage PR #6078.

• Capitalize the returned value of the %townyadvanced_player_plot_type% placeholder.

• Prevent towns and nations being named with only underscores.

• Fix /ta town new NAME MAYOR not being able to be run from console.

• Fix towny.command.plot.asmayorinunowned permission node not working for /plot nfs, due to area selection.

• Fix angry wolves not being attackable while in Towns when wolves are a protected entity.

• Fix potential NPE in TownyPlaceholderExpansion.

• Fix TOWNYADMIN_TOWN and TOWNYADMIN_NATION addon CommandTypes having their town and nation args removed.

• Fix MissingFormatArgumentException in PlayerEnterTownEvent usage of getCapitalSlug.

• Fix scenario where no teleport type cooldowns would be tested if the /t spawn cooldown is 0.

• Fix another scenario where cooldowns wouldn't be applied.

• Fix a couple places we didn't parse out underscores in 2 placeholders.

• Fix the rest of the places we didn't parse out underscores in wilderness names throughout Towny.

• Fix feedback on /tw set wildignore showing wrong help messages.

• Make sure all TownyWorld settings are being reset to the config's settings when /tw set usedefault is run, add confirmation.

• Fix outlaws being killed not getting sent to jail correctly.

• Fix Errors on EntityDelete calls by removing async aspect.

• Fix vehicles not being killed by lava, courtesy of Warriorrrr with PR Fix vehicles not being killed by lava #6044.
• Make townyworld's trident strike list use uuid instead of eid, courtesy of Warriorrrr with PR Make townyworld's trident strike list use uuid instead of eid #6043.
• Exclude transitive bukkit api dependency, courtesy of Warriorrrr with PR Exclude transitive bukkit api dependency #6051.
• Fix /t deposit & /n deposit running sync, courtesy of Warriorrrr with PR Fix /t deposit & /n deposit running sync #6064.
• Include the plot price in the /plot fs feedback message, courtesy of Warriorrrr with PR Include the plot price in the /plot fs feedback message #6062.
• Ensure player gets feedback message when setting a group for sale, courtesy of Warriorrrr with PR Ensure player gets feedback message when setting a group for sale #6060.
• Re-check group set cost after confirmation is accepted, courtesy of Warriorrrr with PR Re-check group set cost after confirmation is accepted #6058.
• Fix plot info command not being usable in wilderness, courtesy of Warriorrrr with PR Fix plot info command not being usable in wilderness #6104.
• Fix /towny map big kicking players in rare cases, courtesy of Warriorrrr with PR Fix /towny map big kicking players in rare cases. #6151.
• Remove instances of legacy making it into components, courtesy of Warriorrrr with PR Remove instances of legacy making it into components #6141.
• Fallback to another Vault chat implementation if an invalid one is detected, courtesy of Warriorrrr with PR Fallback to another Vault chat implementation if an invalid one is detected #6155.
• Fix new reference file creation not working, courtesy of Warriorrrr with PR Fix new reference file creation not working #6156.
• Use "town_sing" translation in TownCommand, courtesy of Warriorrrr with PR Use town sing translation in TownCommand #6167.
• Make TownyAPI#getOnlinePlayers(ResidentList) thread safe, courtesy of Warriorrrr with PR Make TownyAPI#getOnlinePlayers(ResidentList) thread safe #6165.
• Fix legacy hex code parsing not working, courtesy of Warriorrrr with PR Fix legacy hex code parsing not working #6176.
• Use translatable over direct translation in BaseCommand, courtesy of Warriorrrr with PR Use translatable over direct translation in BaseCommand #6172.
• Catch exceptions from spawn point particle spawning, courtesy of Warriorrrr with PR Catch exceptions from spawn point particle spawning #6180.
• Remove old sculk spread option, courtesy of Warriorrrr with PR Remove old sculk spread option #6189.
• Remove resident as trusted in towns/plots upon deletion, courtesy of Warriorrrr with PR Remove resident as trusted in towns/plots upon deletion #6199.
• Fix allowedMove edge case, courtesy of Warriorrrr with PR Fix allowedMove edge case #6228.
• Use toLowerCase(Locale.ROOT) in TownySettings, courtesy of Warriorrrr with PR Use toLowerCase(Locale.ROOT) in TownySettings #6227.
• Hide tax component on status screens if taxes are off, courtesy of Warriorrrr with PR Hide tax component on status screens if taxes are off. #6221.
• Deprecate leftover uuid task method, courtesy of Warriorrrr with PR Deprecate leftover uuid task method #6272.

• Stop removing title/surname when nation is deleted, courtesy of partydev with PR Stop removing title/surname when nation is deleted #6136.

• Prevent axolotls from targeting protected mobs, courtesy of Akiranya with PR Prevent axolotls from targeting protected mobs #6140. (First-Time Contributor!)

---

🌏 Language Updates (2)

🌏 Language Updates:

• Remove lang file versions, courtesy of Warriorrrr with PR Remove lang file versions #6146.
  • The changes made to Towny language system and the adoption of Crowdin support has meant the version number did not serve any purpose.
• Improve comments found in the locale files.

---

🌏 Dependency Updates (15)

🌏 Dependency Updates:

• Update platform bukkit to 4.1.2, courtesy of Warriorrrr with PR Update platform bukkit to 4.1.2 #6079.
• Update commons-text, courtesy of Warriorrrr with PR Update commons-text #6232.
• Bump Jabel to 1.0.0, courtesy of Warriorrrr with PR Bump Jabel to 1.0.0 #6259.
• Bump HikariCP from 5.0.0 to 5.0.1.
• Bump paperlib from 1.0.6 to 1.0.7.
• Bump maven-shade-plugin from 3.3.1-SNAPSHOT to 3.4.1.
• Bump maven-javadoc-plugin from 3.3.1 to 3.4.1.
• Bump annotations from 22.0.0 to 23.0.0.
• Bump placeholderapi from 2.10.9 to 2.11.2.
• Bump log4j-core from 2.17.1 to 2.19.0.
• Bump VaultAPI from 1.7 to 1.7.1.
• Bump bstats-bukkit from 2.2.1 to 3.0.0.
• Bump LuckPerms api from 5.3 to 5.4.
• Bump maven-compiler-plugin from 3.8.1 to 3.10.1.
• Bump commons-compress from 1.21 to 1.22.

---

👽 Placeholder Updates (21)

👽 Placeholder Updates:

• %townyadvanced_daily_town_per_plot_upkeep% - Shows the amount of upkeep paid per-plot by a Town.
• %townyadvanced_daily_town_overclaimed_per_plot_upkeep_penalty% - Shows the penalty paid per-plot by a Town.
• %townyadvanced_daily_town_upkeep_reduction_from_town_level% - Shows the percentage that a Town's upkeep is reduced by the TownLevel's upkeepModifier, or if the player has no Town what a 1 player town would receive.
• %townyadvanced_daily_town_upkeep_reduction_from_nation_level% - Shows the percentage that a Town's upkeep is reduced by the NationLevel's nationTownUpkeepModifier, or if the player has no Nation what a 1 player town would receive if they had a nation.
• %townyadvanced_daily_nation_per_town_upkeep% - Shows the amount of upkeep paid per-town by a Nation.
• %townyadvanced_daily_nation_upkeep_reduction_from_nation_level% - Shows the percentage that a Nation's upkeep is reduced by the NationLevel's upkeepModifier, or if the player has no Nation what a 1 player town would receive if they had a nation.
• %townyadvanced_town_merge_cost% - Shows the base cost to merge a town.
• %townyadvanced_town_merge_per_plot_percentage% - Shows the percentage of the TownBlock claim price that the merging Town will have to pay in order to do a merge.
• %townyadvanced_town_reclaim_cost% - Shows the cost to reclaim a town.
• %townyadvanced_town_reclaim_max_duration_hours% - Shows the maximum number of hours a town can be ruined before it is deleted.
• %townyadvanced_town_reclaim_min_duration_hours% - Shows the minimum number of hours a town can be ruined before it can be reclaimed.
• %townyadvanced_townblock_buy_bonus_price% - Shows the base price of buying a TownBlock using /t buy bonus.
• %townyadvanced_townblock_claim_price% - Shows the base price of claiming a TownBlocking using /t claim.
• %townyadvanced_townblock_unclaim_price% - Shows the base price of claiming a TownBlocking using /t unclaim.
• %townyadvanced_outpost_claim_price% - Shows the price of claiming an outpost using /t claim outpost.
• %townyadvanced_town_unformatted% - Shows the player's townname, if they have one.
• %townyadvanced_nation_unformatted% - Shows the player's nationname, if they have one.
• New PAPI placeholders, courtesy of PainOchoco with PR Added is_trusted placeholders #6240, closing Suggestion: Add placeholder which will return trust player in town (true or false) #6230.
  • %townyadvanced_player_town_is_trusted% - returns True or False based on whether the player is in a town, and is trusted in the town.
  • %townyadvanced_player_plot_is_trusted% - returns True or False based on whether the player is in a town, and is trusted in the plot.
• %townyadvanced_town_balance_unformatted% - Shows the town's raw cached bank balance.
• %townyadvanced_nation_balance_unformatted% - Shows the nation's raw cached bank balance.

---

💬 TownyChat Changes (10)

💬 TownyChat Changes:

• Replace % when it is found in the channel formats.
  • Closes Using a title prefix as % breaks town chat and leaks TC to general chat in earthPol #6125
• Update min. Towny version to 0.98.3.0.
• Make the alone message respect people's vanished status.
  • Closes Suggestion: Ignore hidden players when deciding to send the "alone in channel" message #6194
• Fix channel sounds being played at the sender's location, fix muting channel sounds.
• Remove built-in HexFormatter.
• Update java to 17 and adopt jabel.
• Colour channel name in the You have joined channel messages, according to the channel message colour.
  • Closes Suggestion: Colour the channel name in the switching message to the channels' message colour. #4503
• Fix hex colouring not being parsed for some tags.
• Replace TownyChatReplacerCallable with TownyChatReplacer.
  • Makes use of Functions to do what the old Callable did.
• Refactor a bunch of the plugin to get rid of old/ugly code.
  • There is a chance that some 3rd party chat plugins will break. Let me know about this asap.

---

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, and who supported me during this release of Towny.
MrLogano	Momshroom	Cobrex1	KarlOfDuty	scatterspell	TheFlagCourier
gerardvanschip	DrprofLuigi	SmallSansSerif	TheNylox	trevor1097	benevolent2012
Scottlander100	bretomart	EnvyEnfys	cigaming	KeNickGong	MilesBHuff
pebblehost	BamBamTheEggman	NoikzGaming	Kali0033	TakeoRenka	Mille12313
SkapMC	Jqnnies	Lemuridaee	ReEvadere	qckcat	roflmarv
beabuenodev	LoJoSho	benjamin1313	ThePontificate	AllieDragon	TegulaThePig
KjellWolf	Caleston	Dynamite99	TuckerAndrews3	darthpeti	Cboxhero
WillysHub	Agaloth	LaBoulangerie	Eblyss	BurgBoi	akup001
Intrabit71	finder1793	mattematti2	gladmountain	zekepari	Bloc-k
SW1D3RSK1	Peskdt	xSTORMYxSHM	Dantexde	FauultySpell	RenoldHenold
AnachroSoft	0xBitMC	LightNing002	Valerie2308	ethsmith	Wextra
Downsurge	lukemango	ethanic17	Chibby9607	RulaAshvure	Kelbbie
HerbDashwell	KaiserSergio	Ph4i1ur3	perzues69	amaxtx	Duergur
UnitedLands	Tuteee	TRLWeiss	illlliyas	tjdings	AldinaMapping
shiaki-66	papaj3	CrypticBlades	FilthyCasualOfficial	EcoSMP	RFSMassacre
Semisol	Theeno74	Darklom	serialrain	TheDelusioned	F1amire
ItzXPurpleX	MrQuackios	Luciusred	Rekar7	Waspyethan	Tomtombusiness1994
LordHenryVonHenry	MetaverseRPN	Blotcraft	krytyYT	TwDanger29	AfricaByTot0
and 16 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.98.4.0 for MC 1.16.* & 1.17.* & 1.18.* & 1.19.*.

[1nd1r4]

This version corrupted my entire Towny setup. Towny refuses to start with error:

[14:01:24] [Server thread/WARN]: [Towny] Failed to load/save 'uk-UA.yml'. java.lang.NullPointerException: Cannot invoke "java.lang.Double.doubleValue()" because the return value of "java.util.Map.get(Object)" is null at com.palmergames.bukkit.towny.object.TranslationLoader.saveReferenceFile(TranslationLoader.java:192) ~[towny-0.98.3.1.jar:?] at com.palmergames.bukkit.towny.object.TranslationLoader.loadTranslationsIntoMemory(TranslationLoader.java:133) ~[towny-0.98.3.1.jar:?] at com.palmergames.bukkit.towny.object.Translation.loadTranslationRegistry(Translation.java:46) ~[towny-0.98.3.1.jar:?] at com.palmergames.bukkit.towny.Towny.loadLocalization(Towny.java:291) ~[towny-0.98.3.1.jar:?] at com.palmergames.bukkit.towny.Towny.loadFoundation(Towny.java:247) ~[towny-0.98.3.1.jar:?] at com.palmergames.bukkit.towny.Towny.onEnable(Towny.java:156) ~[towny-0.98.3.1.jar:?] at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:264) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:370) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?] at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:542) ~[paper-api-1.19.2-R0.1-SNAPSHOT.jar:?] at org.bukkit.craftbukkit.v1_19_R1.CraftServer.enablePlugin(CraftServer.java:565) ~[paper-1.19.2.jar:git-Paper-270] at org.bukkit.craftbukkit.v1_19_R1.CraftServer.enablePlugins(CraftServer.java:479) ~[paper-1.19.2.jar:git-Paper-270] at net.minecraft.server.MinecraftServer.loadWorld0(MinecraftServer.java:636) ~[paper-1.19.2.jar:git-Paper-270] at net.minecraft.server.MinecraftServer.loadLevel(MinecraftServer.java:422) ~[paper-1.19.2.jar:git-Paper-270] at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:306) ~[paper-1.19.2.jar:git-Paper-270] at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1100) ~[paper-1.19.2.jar:git-Paper-270] at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:305) ~[paper-1.19.2.jar:git-Paper-270]

[ghost]

Your entire Towny setup isn't corrupted. Try erasing the file uk-UA.yml found in plugins/Towny/lang

[LlmDl]

File an issue ticket @1nd1r4.