➕ 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.

---