➕ Added:

• Add the ability to make town and nation ranks require a town or nation level.

  • The towns.ranks and nations.ranks sections support requiring their town or nation to have a minimum town_level or nation_level.
  • This means that you can lock ranks behind a town or nation's population. By adding a permission node to a rank you will set this requirement:
    • towny.town_level_requirement.4
  • Adding this to a town rank will require the Town to have a town_level of 4 or more to be able to assign that rank to their residents.
  • If the town lost population the residents with a rank beyond their town's town_level will have that rank removed from them.
  • When their town regains enough population, that rank will automatically be re-assigned to the resident.
  • When a town rank does not contain this node it will have no town_level requirement.
  • Likewise, nation ranks support an optional nation_level requirement, Ex:
    • towny.nation_level_requirement.4
  • When added to a nation rank this rank will only be granted when a nation is of level 4 or greater.
  • When a nation rank does not include this node it will not require any nation_level.
  • Closes #7681 & #7541.

• Add the ability to use k, m and b in various money commands in Towny.

  • ex: /t deposit 1k, will deposit 1000 into the town bank.
  • Closes #7759.

• Add the ability to harm outlaws, and separately make outlaws be able to always harm people in towns.

  • Closes #7733.

• Add optional -ignore subcommand to /town leave.

  • When used, the player will not have to confirm their leaving the town.

• Add per-day, per-outpost upkeep cost to /towny prices when per_outpost_cost is above 0 in the config.

  • Closes #7816.

• Allow the confirmation and invitation messages' colouring and formatting to be configurable.

  • Closes #7849.

• Allow townyadvanced_top PAPI placeholders to be handled using a null player.

  • Closes #7830.

• Add the ability to make conquered towns no longer included in a nation's plot perms.

• Allow admins to bypass the outpost limit meant to stop spawning when a town is over their outpost limit.

• Add SHORT_GRASS to the list of plants, fixing an issue with safe teleports.

• Add CARPETS to the item lists, fixing an issue with safe teleports.

• Add 1.21 potion types as detrimental, courtesy of Warrior with PR #7778.

• Add a new resident district mode and aligned tab completion for /plot district with help and codebase, courtesy of SulkyWhale with PR #7761.
• Update console town help, courtesy of SulkyWhale with PR #7803.

• Automatically add the 1.21.4 tree, flower, and moss blocks to the farm allowed blocks in existing configs, courtesy of Momshroom with PR #7750.

➕ Towny's default config and world files will have the following automatic changes made:

• "PALE_OAK_LOG,PALE_MOSS_BLOCK,PALE_MOSS_CARPET,PALE_OAK_SAPLING,PALE_HANGING_MOSS,PALE_OAK_LEAVES,CLOSED_EYEBLOSSOM,OPEN_EYEBLOSSOM," will be added to your config's farm plot's allowedBlocks section.
• ",WIND_CHARGED,WEAVING,INFESTED,OOZING" will be added to the protection.potion_types in the config.yml.

---

✨ New Commands (1)

✨ New Commands:

• /res toggle district
  • When working with districts, toggling this Mode on will make all plots you walk into a part of the last district you set.

---

✨ Changed Commands (0)

✨ Changed Commands:

• None.

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 New Config Options (6)

📕 New Config Options:

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

• global_town_settings.force_pvp_on_outlaws

  • Default: false
  • While true, outlaws can always be harmed in towns they are outlawed in.

• global_town_settings.allows_outlaws_to_always_pvp

  • Default: false
  • While true, outlaws can always harm players in towns they are outlawed in, despite the town pvp setting.

• global_nation_settings.are_conquered_towns_given_nation_plot_perms

  • Default: true
  • While true, conquered towns will be considered a member of good standing in the nation, and will be treated as normal nation members when plot perms are calculated.
  • When set to false plot permission tests will treat conquered towns' residents as not members of their nations, preventing them from using their host nation's plots while the nation's towns have nation plot perms enabled.

• invite_system.confirmation_format

  • Default: [/%s]
  • The format applied to the clickable confirmations.
  • e.g [/accept] would appear as default.

• invite_system.confirmation_yes_colour

  • Default: <green>
  • The colour used to show the accept and confirm commands.
  • Allowed colours: <black>,<dark_blue>,<dark_green>,<dark_aqua>,<dark_red>,<dark_purple>,<gold>,<gray>,<dark_gray>,<blue>,<green>,<aqua>,<red>,<light_purple>,<yellow>,<white>

• invite_system.confirmation_no_colour

  • Default: <red>
  • The colour used to show the deny and cancel commands.
  • Allowed colours: <black>,<dark_blue>,<dark_green>,<dark_aqua>,<dark_red>,<dark_purple>,<gold>,<gray>,<dark_gray>,<blue>,<green>,<aqua>,<red>,<light_purple>,<yellow>,<white>"

---

❌ Removed Config Options (0)

❌ Removed Config Options:

• None.

---

---

🔑 New Permission Nodes (1)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• towny.command.resident.toggle.district
  • Required to use /res toggle district command.

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• None.

---

---

💻 API:

• Add TownCalculateMaxTownBlocksEvent, courtesy of Warrior with PR #7857.
  • Adds an event that is fired when the max town size is calculated, allowing plugins to change/override it in a more dynamic manner.

🔧 Fixed:

• Cause outlawing and enemying to remove trust status in town, plot and trusted town lists.

  • Also prevents trust being given to outlaws, enemies in plots, towns and trusted town lists.
  • Clsoes #7818.

• Enforce the max_nation_conquered_tax on nations who might have set a value that wouldn't be able to be set any longer.

  • Closes ##7755.

• Fix edge-case scenario where towns that have grown via purchased townblocks are prevented from merging with another town.

  • Closes #7719.

• Fix the per_outpost_cost causing very large amount of upkeep on servers with town_plotbased_upkeep set to true.

  • per_outpost_cost is now added to the upkeep after the upkeep has had all of its multipliers take effect.

• Fix border titles not parsing their colour codes.

  • Closes #7797.

• Set using bottles and shears on honey-producing blocks to use an ItemUse test instead of a destroy test.

  • Closes #7804.

• Fixes the tabcompleter for TownyAddonCommands.

  • Closes #7834.

• Fix messages missing their Hovers and non-functional Clickables.

  • Closes #7852

• Read Ascii map symbols from the config on first load.

  • Closes #7875.

• Replace a couple of deprecations required when we supported MC 1.16.*.

• Fix showing spawn hovers in the nation and town list, when the config is set to prevent all spawning.

• Fix PlayerChangePlotEvent not firing when a player changes plots by entering into a vehicle.

• Fix loophole that allowed a District to become separated from other townblocks in the District.

• Fix players in Spectator Mode triggering the the outlaw-entered-town feature.

• Fix config comments for plugin.interfacing.web_map.url.

• Fixes an issue where a renamed resident cannot access their trusted plots.

• Fix outpost limit of zero being able to be bypassed via command.

• Fix adjacent district plot error message.

• Fix Town#getLevelNumber returning funny numbers on Towns. Make the code more understandable.

• Fix conquered towns not losing their conquered status when their nation is removed.

• Fix Towns reporting an incorrect Town level number.

• Fix rare instance of a plugin breaking the PlayerFishEvent.

• Fix which type of cauldron is tested for in CauldronLevelChangeEvents, allowing for the creation of brewery plots.

• Fix TownRuinUtil trying to pay town bank balances to their nation when economy is not enabled.

• Fix neutrality costs not being applied to towns who have an upkeep cost of 0.

• Fix safe teleport system not looking downwards and sending players up 20 blocks higher than it should.

• Fix the does_adding_colour_codes_require_permission_node config setting not working properly.

• Cause kicking or outlawing residents from your town to also remove any trusted status they have in your town and your town's plots.

• Fix an issue with spawn nodes missing a child node that should have been denied.

• Fix renaming plotgroups and districts allowing names which are too long.

• Fix other plugins from using CombatUtil#preventFriendlyFire in non-Towny worlds.

• Prevent NPE thrown by jail plots which have a null jail, during townblock removal.

• Fixed missing feedback message when an admin kicks a town from a nation.

• Fix TownRuinUtil choking on 0-townblock towns when determining plot permission changes.

• Fix incorrect message seen in the /plot set HelpMenu.

• Fix extra space added to the "(PVP)" slug seen when entering the wilderness.

• Fix Towny using VaultUnlockedEconomyProvider when someone is using VaultUnlocked.jar and a legacy Vault economy plugin.

• Fix throwing TownCalculateMaxTownBlocksEvent async.

• Fix resident purge messaging saying it is deleting a resident when its really just trying to remove the resident's town.

• Fix inaccurate removal message when inactive residents are only losing their town, also suppress resident-deleted-messages when more than 50 residents are removed at once.

• Re-add switch tests on left click for specified switch items.

• Fix nation plot perms not being given out for un-conquered towns when are_conquered_towns_given_nation_plot_perms is set to true.

• Don't log for cancelled pre claim events, courtesy of Warrior with PR #7793.

  • Closes #7792.

• Call ascii map static initializer before initial config load, courtesy of Warrior with PR #7808.

  • Closes #7801.

• Fix selection gui item ordering being wack, courtesy of Warrior with PR #7866.

  • /towny switches, /towny itemuse, /towny allowedblocks should maintain a sane ordering.

• Fix an NPE in the isOutlawInTown method, courtesy of Warrior with PR #7736.

• Only fire successful teleport event on successful teleport, courtesy of Warrior with PR #7749.

• Fix for resident rename weirdness, courtesy of Warrior with PR #7765.

• Correctly remove bad outpost spawns in getOutpostNames, courtesy of Warrior with PR #7820.

• Prevent silverfish from infesting blocks inside towns, courtesy of Warrior with PR #7827.

• Fix hardcoded $ currency symbol in message, courtesy of Warrior with PR #7843.

• Fix tasks/timers not being shut down before datasource, courtesy of Warrior with PR #7865.

• Fixed format for "Owner" in MapHUD, courtesy of SulkyWhale with PR #7744. (First-Time Contributor!)
• Fix ArrayIndexOutOfBoundsException in /plot district add, courtesy of SulkyWhale with PR #7760.
• Fix error when /t reslist is run from console without a town argument, courtesy of SulkyWhale with PR #7802.
• Fix splash potion not applying to mobs, courtesy of SulkyWhale with PR #7839.
  • Closes #7838.

• Use Java 21 on Jitpack, courtesy of PimvanderLoos with PR #7746. (First-Time Contributor!)

• Fix SQL database not correctly loading existing TownyWorld's settings, courtesy of jb0s with PR #7833. (First-Time Contributor!)
  • Fixes the issue where some worlds always take on the default new world settings.

🌏 Language Updates:

• None.

---

🌏 Dependency Updates:

• Bump org.jetbrains:annotations from 26.0.1 to 26.0.2.
• Bump net.kyori:adventure-text-serializer-plain from 4.18.0 to 4.19.0.
• Bump net.kyori:adventure-text-minimessage from 4.18.0 to 4.19.0.
• Update MockBukkit to 4.50.0.
• Update Adventure for 1.21.6 & 1.21.7 support, courtesy of Warrior with PR #7876.

---

👽 Placeholder Updates:

• None.

---

💬 TownyChat Changes:

• Fix speak and listen channel nodes not working.

---

➕ Added:

• Add TRIAL_SPAWNER to default list of reasons Towny won't remove mobs.
  • Works only on Paper servers.
  • This will prevent Towny from remove mobs spawned by Trial Chambers, which resulted in unearned rewards.
  • Closes #7709.
• Add ability to spam jailed players with a title message showing them how to pay their bail.

• Add config option for Closed Economy UUID, courtesy of turtledude01 with PR #7704.

➕ Towny's default config and world files will have the following automatic changes made:

• New Config Migration: ",TRIAL_SPAWNER" will be added automatically to existing configs' town_mob_removal_ignored_spawn_causes list.

---

✨ New Commands (1)

✨ New Commands:

• /plot evict forsale
  • Causes a newly evicted plot to be put back up for sale, using the town's default plot price.
  • Closes #7713.

---

✨ Changed Commands (0)

✨ Changed Commands:

• None.

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 New Config Options (2)

📕 New Config Options:

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

• jail.show_bail_command_in_title_message

  • Default: false
  • When enabled, player that can pay their bail will see a title message telling them how to pay their bail.

• economy.closed_economy.server_account_uuid

  • Default: a73f39b0-1b7c-2930-b4a3-ce101812d926
  • The UUID of the account that all money that normally disappears goes into.

---

❌ Removed Config Options (0)

❌ Removed Config Options:

• None.

---

---

🔑 New Permission Nodes (0)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• None.

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• None.

---

---

💻 API:

• None.

🔧 Fixed:

• Fix map hud missing lines 13 and 9.
  • Closes #7699.
• Remove methods deprecated during the 0.99.. release cycle, in time for the beginning of the 0.101.. release cycle.
• Fix legacy economy provider check on admin logging in also running on servers with the economy aspect of Towny disabled.
• Fix worlds not being saved after using /tw set usedefault.
• Remove ability for /tw set wild being able to set a world to the default settings when no arguments are supplied.
• Fix /plot evict command throwing ArrayIndexOutOfBoundsException.

• Re-fix max health attribute, courtesy of Warrior with PR #7678.
  • Closes #7687.
• Make the npc prefix check less strict and more precise, courtesy of Warrior with PR #7688.

• Fix error message shown when using /plot group toggle taxed, courtesy of Alienn-Know with PR #7598. (First-Time Contributor!)

🌏 Language Updates:

• None.

---

🌏 Dependency Updates:

• Bump org.apache.maven.plugins:maven-surefire-plugin from 3.5.1 to 3.5.2.
• Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.10.1 to 3.11.2.
• Bump org.apache.logging.log4j:log4j-core from 2.24.1 to 2.24.3.
• Bump com.zaxxer:HikariCP from 6.0.0 to 6.2.1.
• Bump org.junit.jupiter:junit-jupiter-api from 5.11.3 to 5.11.4.
• Bump org.junit.jupiter:junit-jupiter from 5.11.3 to 5.11.4.
• Bump net.kyori:adventure-text-serializer-plain from 4.17.0 to 4.18.0.
• Bump net.kyori:adventure-text-minimessage from 4.17.0 to 4.18.0.
• Drop Java back to 17 to support 1.19.
• Update VaultUnlocked support 2.9.0.

---

👽 Placeholder Updates:

• %townyadvanced_town_formatted_with_town_minimessage_colour%
• %townyadvanced_nation_formatted_with_nation_minimessage_colour%
  • These will use the Towny config's town and nation placeholder formatting, but insert the town or nation's colour code before the town or nation name.
• %townyadvanced_towny_tag_override_with_minimessage_colour%
  • This will use the town or nation's tag if they have a tag in use.
• %townyadvanced_resident_join_date_unformatted% - returns the long value of the time in epoch milliseconds that a player joined the server.
• %townyadvanced_resident_join_date_formatted% - returns a human-readable date and time at which the player joined the server.
• %townyadvanced_player_location_town_forsale_cost%
  • Displays the cost of the town at the player's location, or "Not for sale." if it is not for sale.
  • Closes #7708.

---

💬 TownyChat Changes:

• Add the ability to choose which EventPriority TownyChat uses to modify chat.
  • Closes https://github.com/TownyAdvanced/Towny/issues/7625.
• New ChatConfig.yml Option: modify_chat.listener_priority
  • Default: normal
  • The priority used for the AsyncPlayerChatEvent listener in TownyChat. This option will decide when TownyChat listens to the Chat event thrown by Bukkit-based servers.
  • Valid settings are: lowest, low, normal, high, highest
  • Lowest is the earliest listener, allowing TownyChat to act upon chat before Low, Normal, High, and Highest priority plugins.
  • Highest will cause TownyChat to change chat after other plugins operating on lower priorities.
  • If you don't know what any of this means leave it at normal.

---

➕ Added:

• Update Resident Modes system.

  • The modes system (townclaim, map, spy) code has been updated to more robust system than just a simple list.
  • Adds the ability to assign a permission node to a mode, and when present, will require the player to have the permission node to toggle a node.
  • This permission node is not required if the mode is part of a player's default modes set via the permission plugin.
  • Additionally, the ability to clear a residents modes via command now requires a permission node.
  • All together this makes it possible for admins to set modes that players cannot remove.
  • Modes can have types, allowing for modes to be exclusive of each other, ie: you can no longer have townclaim and townunclaim modes active at the same time.

• Add new resident mode: bedspawn

  • This mode will make a player spawn at their bed instead of their town spawn.
  • Mode is added and removed using /res toggle bedspawn.
  • When no bed is owned by a player they will spawn at their town, if they have one.
  • Closes #7616.

• Add the ability to block non-allies gaining benefits from Beacons placed in towns.

  • Requires Paper to work.
  • Closes #7532.

• Add the ability to stop weapons and armour degrading in arena plots.

  • Closes #7549.

• Add a message notifying a player when their nation has pending ally invites.

  • Closes #7588.

• Add a message notifying a player of their pending town and nation invites.

  • Closes #7607.

• Add messages to residents when they pay town and plot taxes.

  • Closes #7657.

• Add the ability to charge additional upkeep per outpost controlled by a town.

  • Closes #7664.

• Add experimental option to consider conquered towns as not allies.

• Add compatibility layer for renamed Particle names.

• Add support for VaultUnlocked as an Economy Provider.

• Add support for Spigot 1.21.* and update Java to 21.

• Move plotname and district information from /plot perm hud, to /towny map hud.

• Add message to the plot forsale notification, shown when a player has no claimed townblocks, advising them how to claim a plot.

• Add prompt to shown admins urging them to update their economy from legacy to modern. Requires the player to have the towny.admin.updatealerts permission node.

• Add OfflinePlayer and UUID support to Economy backend, courtesy of Warrior with PR #7425.
  • Adds a "modern" economy implementation for Vault and Reserve back ends, while maintaining "legacy" implementations.
    • Already established servers will have their server set to legacy, while new installs will begin using the modern system right away.
  • The modern implementation makes use of Vault's OfflinePlayer methods, making Towny better suited to newer economy plugins that might not have fully implemented VaultAPI in their code.
  • Towny's Account class has been revamped with the Towny objects' UUIDs being used.
  • In cases where a server is using EssentialsX Economy, Towny will convert our non-player accounts' UUIDs into V2 UUIDs, allowing EssEco to know they do not belong to players.

• Add safe-teleport detection to spawn points, courtesy of Intybyte with PR #7530. (First-Time Contributor!)
  • New detection system scans players' teleport destinations to make sure they will not suffocate or fall.
  • Closes #7463.

➕ Towny's default config and world files will have the following automatic changes made:

• None

---

✨ New Commands (4)

✨ New Commands:

• /res toggle bedspawn
  • Turns on and off the respawn-to-bed option.
• /ta eco info [TownyObject] {name}
  • Used to see information about a resident, town, nation, or the Towny serveraccount's economy Account.
• /ta eco convert modern
  • Will convert your Towny legacy accounts into modern accounts in your Economy plugin.
• /ta eco convert {economyplugin}
  • Will convert your Towny economy accounts from your existing economy plugin, into the given economy plugin.

---

✨ Changed Commands (2)

✨ Changed Commands:

• /ta depositall has changed to /ta eco depositall
• /ta resetbanks has changed to /ta eco resetbanks

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 New Config Options (8)

📕 New Config Options:

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

• global_town_settings.prevent_item_degrading_in_arenas

  • Default: false
  • While true, weapons and armour items worn by players in Arena plots will not lose durability.

• global_town_settings.beacons_for_allies_only

  • Default: false
  • When true, a beacon placed in a town will only affect the allies of the town. This includes residents, nation residents and allied nation residents.

• global_town_settings.beacons.exclude_conquered_towns

  • Default: false
  • When true, conquered towns are not considered allies.

• global_nation_settings.are_conquered_towns_considered_allies

  • Default: true
  • While true, conquered towns will be considered a member of good standing in the nation.
  • When set to false CombatUtil#isAlly() tests will treat conquered towns and their nations as not allied.
  • Setting this to false could result in strange unforseen behaviour.

• spawning.safe_teleport

  • Default: false
  • If enabled tries to find a safe location when teleporting to a town spawn/nation spawn/outpost. This can be used to prevent players from making kill boxes at those locations.

• economy.advanced.modern

  • Default: true (on existing installs this will default to false)
  • When enabled, Towny will use UUIDs when communicating with your economy plugin.
  • Most users will never have to touch this, but for existing servers this option will automatically be set to false.
  • If this option is disabled and you wish to avoid losing data, use the /townyadmin eco convert modern command to convert.

• economy.advanced.npc_uuid_version

  • Default: -1
  • The UUID version to use for non-player accounts. This is used so that economy plugins can more easily differentiate between player and NPC accounts.
  • The default is -1, which disables modifying npc uuids.

• economy.daily_taxes.per_outpost_cost

  • Default: 0.0
  • An optional price that a town must pay for each outpost they own. This number is added to the town upkeep before any other upkeep modifiers are applied to the Town's upkeep costs.

---

❌ Removed Config Options (0)

❌ Removed Config Options:

• None.

---

---

🔑 New Permission Nodes (13)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• towny.command.townyadmin.eco.*
  • A child node of towny.command.townyadmin.*
  • Child Nodes:
    • towny.command.townyadmin.eco.depositall
    • towny.command.townyadmin.eco.resetbanks
    • towny.command.townyadmin.eco.info
    • towny.command.townyadmin.eco.convert
• towny.command.resident.set.mode.clear
• towny.command.resident.toggle.bedspawn
• towny.command.resident.toggle.bordertitles
• towny.command.resident.toggle.ignoreotherchannels
• towny.command.resident.toggle.infotool
• towny.command.resident.toggle.plotgroup
• towny.command.resident.toggle.townborder
• towny.command.resident.toggle.townunclaim

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• None.

---

---

💻 API:

• Added ResidentModesInitializeEvent with which plugins can add Resident Modes.

🔧 Fixed:

• Fix pets being abandoned in chunks that unload too fast after the player teleports away.

  • Closes #7593.

• Fix deleting objects from the SQL DB which are keyed by a UUID.

  • Closes #7592.

• Fix SERVER_ACCOUNT initializing after GLOBAL_OBSERVER

  • Closes https://github.com/TownyAdvanced/SiegeWar/issues/916

• Prevent wind charge exploits on switch blocks.

  • Closes #7648.

• Fix the proximity-to-nation test not removing too-far-away towns in every situation.

  • Closes #7668.

• Fix WorldCoord#getBoundingBox missing two edges of the WorldCoord's blocks in the resulting BoundingBox.

• Fix town_plotbased_upkeep_affected_by_town_level_modifier in the config not being respected for the nation_levels' nationTownUpkeepModifier.

• Fix /plot group tab completion.

• Refactor OnPlayerLogin task for readability.

• Fix regression from 0.100.4.2 which caused empty .tar backups to be created.

• Fix testing broken in 1.21 bump, update workflows to use java 21, add paper-api with test scope to make MockBukkit happy again.

• Fix Audience not sending messages, tests will become broken again at this point.

• Fix adventure relocation not excluding things from paper-api.

• Adapt to Attributes change.

• Fix regressions in health regen task on MC versions under 1.21.3.

• Fix plot perm hud trying to show too many lines.

• Fix another issue with the proximity-to-nation test.

• Fix a null economy not returning false in the TownyEconomyHandler.isActive() test.

• Fix explosion regeneration not able to handle sign text.

• Fix teleports that have a TeleportCause of PLUGIN not firing a onPlayerMove() when the player is Jailed or Outlawed.

• Fix default configs missing the nationCapitalBonusOutpostLimit in the nation_level.

• Shutdown saving task when making an sql dump, courtesy of Warrior with PR #7591.
• Fix safe spawn checking causing a sync chunk load, courtesy of Warrior with PR #7595.
• Re-assign permissions for previous mayor after a new mayor is set, courtesy of Warrior with PR #7600.
• Limit /plot trust remove suggestions to trusted residents, courtesy of Warrior with PR #7599.
• Don't show warmup particles for hidden/invisible players, courtesy of Warrior with PR #7611.
• Fix tab complete exception in sanctiontown, courtesy of Warrior with PR #7613.
• Fix /deny all not working, courtesy of Warrior with PR #7626.

• Fix error message shown when using /plot group toggle taxed, courtesy of Alienn-Know with PR #7598. (First-Time Contributor!)

🌏 Language Updates:

• New Language: Hungarian.

---

🌏 Dependency Updates:

• Bump org.apache.commons:commons-compress from 1.26.2 to 1.27.1.
• Bump org.apache.maven.plugins:maven-surefire-plugin from 3.3.1 to 3.5.1.
• Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.8.0 to 3.10.1.
• Bump org.apache.logging.log4j:log4j-core from 2.23.1 to 2.24.0.
• Bump org.bstats:bstats-bukkit from 3.0.2 to 3.1.0.
• Bump org.junit.jupiter:junit-jupiter from 5.10.3 to 5.11.3.
• Bump org.junit.jupiter:junit-jupiter-api from 5.10.3 to 5.11.3.
• Bump com.zaxxer:HikariCP from 5.1.0 to 6.0.0.
• Bump org.apache.logging.log4j:log4j-core from 2.24.0 to 2.24.1.
• Bump org.jetbrains:annotations from 24.1.0 to 26.0.1.
• Update spigot-api to 1.21.3.
• Update bridger for java 21 support, courtesy of Warrior with PR #7658.

---

👽 Placeholder Updates:

• Change %townyadvanced_town_unformatted% to no longer remove underscores.

---

💬 TownyChat Changes:

• Add the ability to choose which EventPriority TownyChat uses to modify chat.
  • Closes https://github.com/TownyAdvanced/Towny/issues/7625.
• New ChatConfig.yml Option: modify_chat.listener_priority
  • Default: normal
  • The priority used for the AsyncPlayerChatEvent listener in TownyChat. This option will decide when TownyChat listens to the Chat event thrown by Bukkit-based servers.
  • Valid settings are: lowest, low, normal, high, highest
  • Lowest is the earliest listener, allowing TownyChat to act upon chat before Low, Normal, High, and Highest priority plugins.
  • Highest will cause TownyChat to change chat after other plugins operating on lower priorities.
  • If you don't know what any of this means leave it at normal.

---

➕ Added:

• Add Districts to Towns and TownBlocks.

  • Districts are groupings of townblocks, owned by a town.
  • These are similar to PlotGroups but with less restrictions:
    • Districts' townblocks are not required to have the same plot permissions, plot type, owner, or name.
  • Districts currently show in the chunk notifications, map hud, and in the /towny map hover.
  • Districts will lead to future features being possible including districts appearing on Mappers.
  • Townblocks in districts are required to be adjacent to each other.
  • Closes #7479.

• Account and Transaction changes.

  • A non-insignificant change was been made under the hood which could affect plugins using Towny's various Transaction Events.
  • The end result is that classes have been re-located to a new com.palmergames.bukkit.towny.object.economy.transaction pacakge.
  • This has resulted in a more robust system:
    • Transactions are better able to represent when money moves between your server's Towny objects.
    • Transaction events are now thrown much more often, allowing plugins to track transactions more accurately.
    • Accounts now backed by an EconomyHandler (think Resident, Town, Nation,) instead of a name, which should ease the transition to using UUIDs.
    • The TownyServerAccount is now a proper EconomyHandler, reducing jank in the code that is used in the Closed Economy feature.
  • If a plugin you use has broken, the author needs only change their imports section, switching to the re-located Transaction, TransactionType classes.

• Added the ability to give Nation Capitals an additional bonus number of outposts.

  • Requires that your config has limit_outposts_using_town_and_nation_levels set to true.
  • In the nation_level sections of your config a new setting will be added: nationCapitalBonusOutpostLimit.
  • The amount set there will be added to a nation capital (in addition to the already applied nationBonusOutpostLimit amount.)
  • Closes #7447.

• Add conquered and unconquered sections to the townyperms.yml.

  • Using these sections you can give permission nodes to the players of towns which are either conquered or unconquered.
  • Closes #7536.

• Add ability to prevent conquered towns from using their nation's nation zones.

  • Conquered towns can still use their own nationzone outside of their town.
  • Closes #7507.

• Add option to make mayors pay their own town's tax, which could prevent towns from dying to upkeep.

  • Closes #7482.

• Add the ability to limit the number of capital letters used in Town and Nation names.

  • Closes 7497.

• Added the ability to prevent players joining towns until they have been on the server for a configured time.

  • Closes #7516.

• Add the ability to deny conquered towns from using /n spawn.

  • Closes #7522.

• Add the ability to prevent the nation zone surrounding a conquered town being used by the nation who conquered the town.

  • Closes #7518.

• Drop support for MC 1.16-1.18, update the readme.

• Add ignoreotherchannels to /res toggle and /res set mode tabcompleters.

• Add plot group creation/deletion events #7476, courtesy of Warrior with PR.
  • Closes #7475.
• Expose cost in successful teleport event, courtesy of Warrior with PR #7487.
  • Closes #7486.
• Raise java version to 17, courtesy of Warrior with PR #7401.
• Support custom biomes with the unwanted biomes feature, courtesy of Warrior with PR #7540.

➕ Towny's default config and world files will have the following automatic changes made:

• nationCapitalBonusOutpostLimit will be added to each nation_level section with a value of 0.

---

✨ New Commands (2)

✨ New Commands:

• /plot district

  • Subcommands:
    • create|new [name]: creates a new district with the given name.
    • add {name}: adds a townblock to the given district, if you are actively adding to a distric you do not need to continue supplying the name.
    • rename [name]: changes the name of a district.
    • remove: removes the townblock you are stood in from a district.
    • delete: deletes the district in which you are stood.

• /ta resident NAME about clear

  • Used by an admin to remove a Resident's About line.

---

✨ Changed Commands (2)

✨ Changed Commands:

• /res set mode clear - Removes all of your modes (ie: townclaim, map)
• /res set mode reset - Same behaviour as before, it will remove your nodes and then apply the default modes for your player.

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 New Config Options (6)

📕 New Config Options:

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

• economy.daily_taxes.do_mayors_pay_town_tax
  • Default: false
  • When true, a town's mayor will pay the town tax. This feature is a bit redundant because the mayor can withdraw from the bank anyways, but it might keep towns from being deleted for not paying their upkeep.
• filters_colour_chat.modify_chat.max_name_capital_letters
  • Default: -1
  • Maximum number of capital letters that can be used in Town and Nation names.
  • This count does not include the first letter of a town, and does not count capitalized letters that come after a _ character.
  • This means that a town named New_York would register 0 capitals. While McDonalds would register 1. COOLTOWN would register 7 capital letters.
• global_nation_settings.nationzone.not_for_conquered_towns
  • Default: false
  • When set to true, players which are part of a conquered town, will not have access to their nation's nationzone.
  • They will still be able to use the nation_zone outside of their own town.
• global_nation_settings.nationzone.protect_conquered_towns
  • Default: false
  • When set to true, the nation zone of a conquered town will only be usable by the conquered town's players.
  • The players belonging to the conquering nation will not be able to use the nation zone.
• resident_settings.min_time_to_join_town
  • Default: 0m
  • How long does a resident have to wait to join a town, after joining the server.
  • Set to 0m to disable. 1m = 1 minute, 1h = 1 hour, 1d = 1 day.
• spawning.nation_spawn.deny_conquered_towns_use_of_nation_spawn
  • Default: false
  • When set to true, towns conquered by their nation will not be allowed to use /n spawn.

---

❌ Removed Config Options (0)

❌ Removed Config Options:

• None.

---

---

🔑 New Permission Nodes (1)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• New Permission Node: towny.command.plot.district.*
  • Child node of towny.command.plot.*
  • Child Nodes:
    • towny.command.plot.district.add: true
    • towny.command.plot.district.remove: true
    • towny.command.plot.district.delete: true
    • towny.command.plot.district.rename: true

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• None.

---

----

💻 API:

• Add more information to the ResidentJailEvent and ResidentUnjailEvent.
• Add MaterialUtil, which includes a method to grab Materials with an item from Materials with no corresponding item.

🔧 Fixed:

• Fix new outlaws not being teleported out of the town they were outlawed in.
• Fix regex settings not refreshing when using /ta reload {config}.
• Fix PlotGroups not being able to support max and min joindays amounts like TownBlocks.
• Fix WildernessMapEvent being able to be thrown async.
• Fix town plot permissions changing not causing the town to save.
• Improve /ta town new TOWNNAME MAYORNAME, to support town names entered with spaces in them.
• Fix milking animals sometimes being able to get cancelled by the PlayerBucketFillEvent.
• Fix TownBlocks which load replacement town names save the new town name in the database.
• Make more explosive entities throw TownyExplosionDamagesEntityEvent events when they explode and damage entities.
• Fix for SQL db code related to new Districts.
• Fix potential NPE thrown when nations are deleted and the nation bank is meant to be paid to the king.
• Prevent potential NPE caused by EntityDamageEvents with no DamageCause.
• Fix loading of Districts on servers using MySQL.
• Fix regression from 0.100.3.5 that made Creepers ineffective.
• Fix possible ConcurrentModificationException when using /ta plot claim {residentname}
• Fix potential NPE thrown by PlayerMoveEvent and PlayerTeleportEvents with a null destination location.
• Fix potential NPE thrown in outpost name tab completer, caused by outposts in non-existent worlds.
• Fix SQL Databases loading towns, nations, and worlds which had not been properly registered in the TownyUniverse.
• Fix /ta newday not working.

• Fix untranslated lang key from unwanted biome claiming, courtesy of Warrior with PR #7538.
  • Closes #7537.
• Fix NPE when player without town tab completes /t outpost, courtesy of Warrior with PR #7581.
  • Closes #7580.
• Fix a bad scheduler call in take over claim code, courtesy of Warrior with PR #7466.
• Fix plot border modes on Folia, courtesy of Warrior with PR #7467.
• Handle empty towns during duplicate resident removal, courtesy of Warrior with PR #7474.
• Always fire loaded metadata event, courtesy of Warrior with PR #7531.
• Remove newday timer option, courtesy of Warrior with PR #7509.
• Fix worldcoord upper corners being in another worldcoord, courtesy of Warrior with PR #7539.
• Don't attempt to display non-items in guis, courtesy of Warrior with PR #7576.

• Fix WorldCoord#unloadChunks adding plugin chunk tickets, courtesy of galacticwarrior9 with PR #7478.
• Fix potential NPEs in PlotGroup, courtesy of galacticwarrior9 with PR #7483.

• Fix config typo, courtesy of auriasmc with PR #7498. (First-Time Contributor!)

🌏 Language Updates:

• None.

---

🌏 Dependency Updates:

• Bump org.apache.maven.plugins:maven-surefire-plugin from 3.2.5 to 3.3.1.
• Bump org.junit.jupiter:junit-jupiter from 5.10.2 to 5.10.3.
• Bump org.junit.jupiter:junit-jupiter-api from 5.10.2 to 5.10.3.
• Bump org.apache.maven.plugins:maven-jar-plugin from 3.4.1 to 3.4.2.
• Bump org.apache.maven.plugins:maven-javadoc-plugin from 3.7.0 to 3.8.0.
• Bump net.kyori:adventure-platform-bukkit from 4.3.3 to 4.3.4.

---

👽 Placeholder Updates:

• None.

---

💬 TownyChat Changes:

• Bump min Towny version to 0.100.3.0.
• Handle the rare occasion that we aren't able to alter the recipients.
• Add new setting to channels: ignoreable.
  • This settings defaults to true when it is not set on a channel in your channels.yml.
  • New channels.yml files will have their admin and mod channels containing ignoreable: false.
  • When a channel has ignoreable: false, players will not be able to ignore the channel.
  • Ignoring channels is achieved by using /res toggle ignoreotherchannels. When this mode is used you will only see the channel you are present in.
  • ie: if you are in town chat, with ignoreotherchannels active, you will not see the general, nation or local chats.
  • Closes https://github.com/TownyAdvanced/Towny/issues/6441.

---