➕ Added:

• Add option to make a town's town_level determined by their townblock count, instead of resident count.
  • Closes #7947.
• Add ability to set max town and nation board lengths.
• Add unformatted upkeep PAPI placeholders.
  • Closes #7943.

• Target Paper instead of spigot, courtesy of Warrior with PR #7885.
  • Towny will now require Paper or one of its derivatives.
  • Towny will not start if your server uses Spigot or Craftbukkit.
  • Some plugins will not work until they are updated to no longer use the now-removed com.palmergames.adventure package.
    • Before you update Towny look at whether you use TownyResources, TownyFlight, other Towny add-on plugins, Sponsor plugins created by LlmDl.
    • If you are using these plugins do not update your Towny to 0.101.2.5 immediately.
• Add support for new 1.21.9 blocks, courtesy of Warrior with PR #7913.
  • Adds support for copper golems being protected from waxing/scraping.
  • Adds support for new chests and shelves being treated as switches.
• Log removed blocks with coreprotect, courtesy of Warrior with PR #7898.
• Add build information to the version command, courtesy of Warrior with PR #7914.
• Add town & nation upkeep & neutrality payment events, courtesy of Alienn-Know & Warrior with PR #7888.
• Use a property for junit versions, courtesy of Warrior with PR #7926.
• Add /res friend list online subcommand, courtesy of Warrior with PR #7928.
• Add LuckPerms permissions source, courtesy of Warrior with PR #7933.
• Hide scores in scoreboard huds, courtesy of Warrior with PR #7886.
• Replace MethodHandles with method calls where possible, courtesy of Warrior with PR #7887.
• Improve SQL db startup speed by querying existing tables, courtesy of Warrior with PR #7972.
• Add an sql database migrator, courtesy of Warrior with PR #7968.
• Format resident last online with relative time, courtesy of Warrior with PR #7986.

• Add renaming Towny ranks, courtesy of SulkyWhale with PR #7884.
• Add tab completions for /plot group toggle, courtesy of SulkyWhale with PR #7897.
• Add new constructor for ListDataField, courtesy of SulkyWhale with PR #7937.
• Add saving of hasActiveWar for towns and nations, courtesy of SulkyWhale with PR #8002.

• Add config option for non-public towns to show map link, courtesy of GoodrichDev with PR #7873.
  • Allows non-public towns to display a clickable map link in the town status screens, making it easier for players and admins to locate towns on the web map, even if the towns are private.
  • Closes #7872.
• Add Town forSaleTime for use in API, courtesy of GoodrichDev #7908. - Closes #7907.

• Add option to make safe teleport stop spawning when no safe position is found, courtesy of RyanoDino with PR #7964.
• Add setting for default peaceful nation to create, courtesy of RyanoDino with PR #8000.
  • Closes #7970.

• Add world toggle for jailing, courtesy of squeaky2137 with PR #7863.
  • Closes #7817.

• Add permission validation for town allylist & enemylist commands, courtesy of Lemar98 with PR #7899.

• Add PAPI Placeholders for unformatted tags for town and nation along with any overrides, courtesy of OoLunar with PR #7917.

• Add prior location to SuccessfulTownyTeleportEvent, courtesy of flyncodes with PR #7984.

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

• ",COPPER_CHEST,COPPER_GOLEM_STATUE,SHELVES" will be added to the config.yml's switch_ids.

---

✨ New Commands (8)

✨ New Commands:

• /ta eco depositalltowns [amount]
  • Deposits money to all towns.
• /ta eco depositallnations [amount]
  • Deposits money to all nations.
• /ta townyperms townrank renamerank [oldrankname] [newrankname]
  • Renames a town rank to a new name.
• /ta townyperms nationrank renamerank [oldrankname] [newrankname]
  • Renames a nation rank to a new name.
• /tw toggle jailing
  • Turns jailing on/off in the world.
• /res toggle ignoresinvites.
  • Allows players to automatically ignore town invites, useful for server staff.
• /t list by forsale
  • Lists towns with a preference for towns which are currently forsale using /t forsale.
• /res friend list online
  • Shows you a list of online friends.

---

✨ Changed Commands (0)

✨ Changed Commands:

• None.

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 New Config Options (5)

📕 New Config Options:

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

• plugin.interfacing.web_map.non_public_towns_show_map_link
  • Default: false
  • When true, non-public towns will show a link to their map location in the town status screen.
• new_world_settings.plot_management.jailing_enabled
  • Default: true
  • Sets the default setting for newly detected worlds.
• global_town_settings.town_level_is_determined_by_townblock_count_instead_of_resident_count
  • Default: false
  • When set to true, the town's TownLevel is determined by the number of townblocks the town owns, instead of the number of residents.
  • This setting will have no effect when town_block_ratio is set to 0.
• global_town_settings.max_board_length
  • Default: 170
  • The maximum number of characters that the town (and nation,) board messages can be.
• nation.default_neutral
  • Default: true
  • Default neutral status of the nation (are new nations neutral by default?)

---

❌ Removed Config Options (0)

❌ Removed Config Options:

• None.

---

---

🔑 New Permission Nodes (7)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• towny.command.townyadmin.eco.depositalltowns
  • Child Node of towny.command.townyadmin.eco.*.
• towny.command.townyadmin.eco.depositallnations
  • Child Node of towny.command.townyadmin.eco.*.
• towny.command.townyworld.toggle.jailing
• towny.command.town.allylist
  • Add this to the nomad section of the townyperms.yml file if you would like.
• towny.command.town.enemylist
  • Add this to the nomad section of the townyperms.yml file if you would like.
• towny.command.resident.toggle.ignoreinvites
  • Child node of towny.command.resident.toggle.*, no changes to townyperms.yml required.
• towny.command.town.list.forsale
  • Child node of towny.command.town.list.*, no changes to townyperms.yml required.

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• None.

---

---

💻 API:

• New API Events:
  • NationNeutralCostPaidEvent
  • TownNeutralCostPaidEvent

🔧 Fixed:

• Allow the TownPreUnclaimEvent to no longer be fired when a town is being deleted, allowing Districts to get properly deleted when their town will no longer exist.
  • Closes #7889.
• Fix districts becoming un-unclaimable.
  • Closes #7921.
• Fix unneeded msg_invalid_name exception message from /n ally.
  • Closes #8006.
• Idiot-proof the webmap URL.
• Fix Overclaimed Upkeep Penalty not being charged to towns which don't pay any upkeep.
• Fix /ta nation NAME set capital command not making sure the town in question is part of a nation or in the nation at all.
• Fix mountable entities having their saddles sheared, copper golems having their items dropped.

• Suppress outlaw warning for spectators, courtesy of Warrior with PR #7919.
  • Closes #7918.
• Replace AtomicReference usages in the task scheduler, courtesy of Warrior with PR #7906.
  • Closes #7903.
• Fix getting lingering potion effects on legacy versions, courtesy of Warrior with PR #7997.
  • Closes #7996.
• Fix getting respawn location <1.21.5, courtesy of Warrior with PR #7998.
  • Closes #7995.
• Clear resident gui pages on logout, courtesy of Warrior with PR #7896.
• Precompute mob removal classes to entity types, courtesy of Warrior with PR #7894.
• Always read global.yml for overrides, courtesy of Warrior with PR #7877.
• Fix language dash -> underscore normalization NPE, courtesy of Warrior with PR #7929.
• Merge the build and test actions back into one, courtesy of Warrior with PR #7930.
• Fix the paper startup check, courtesy of Warrior with PR #7954.
• Fix offline player reflection for 1.21.9, courtesy of Warrior with PR #7973.
• Replace trivial streams in Town & mark as unmodifiable, courtesy of Warrior with PR #7946.
• Sort /t list by forsale by for sale price, courtesy of Warrior with PR #7951.
• Use mediumtext datatype for metadata in mysql, courtesy of Warrior with PR #7967.
• Update BookFactory to use components, courtesy of Warrior with PR #7980.
• Deprecate legacy color constants in our Colors class, courtesy of Warrior with PR #7981.
• Allow getting TownyException error message as component, courtesy of Warrior with PR #7983.
• Testperm for checkperm, courtesy of Warrior with PR #7987.
• Delete received nation ally requests if sender deletes itself, courtesy of Warrior with PR #7988.
• Revert change to potion protection handling, courtesy of Warrior with PR #7990.
• Improve lingering potion protection, courtesy of Warrior with PR #7991.
• Replace pre 1.19 entity/block keys with constants, courtesy of Warrior with PR #7992.
• Update inventory system to use components & PDC, courtesy of Warrior with PR #7982.
• Fix the changelog reader thinking the limit has been reached, courtesy of Warrior with PR #7994.
• Fix literal translatables attempting to translate, courtesy of Warrior with PR #7999.

• Fix formatting for listing resident modes, courtesy of SulkyWhale with PR #7952.
• Improve method for preventing saturation loss in towns, courtesy of SulkyWhale with PR #7958.
• Remove duplicate events and update existing events to allow value changes via the API, courtesy of SulkyWhale with PR #7966.

• Send the eco prefix with rename calls to VaultUnlocked, courtesy of creatorfromhell with PR #7878.

• Fix plotpreclaim cancel message, courtesy of ZapolyarnyDev with PR #7924.
  • Closes #7868.

• Stop using Properties to load object files, preserve raw metadata for #7925, courtesy of GoodrichDev with PR #7935.
  • Closes #7925.

🌏 Language Updates:

• Macedonian added to lang files..

---

🌏 Dependency Updates:

• None.

---

👽 Placeholder Updates:

• %townyadvanced_town_tag_unformatted% - The town tag without any formatting from the Towny config.yml.
• %townyadvanced_town_tag_override_unformatted% - The town tag (or town name if no tag is set,) without any formatting from the Towny config.yml.
• %townyadvanced_nation_tag_unformatted% - The nation tag without any formatting from the Towny config.yml.
• %townyadvanced_nation_tag_override_unformatted% - The nation tag (or nation name if no tag is set,) without any formatting from the Towny config.yml.
• %townyadvanced_daily_town_upkeep_unformatted% - An unformatted town upkeep amount.
• %townyadvanced_daily_nation_upkeep_unformatted% - An unformatted nation upkeep amount.

---

💬 TownyChat Changes:

• None.

---