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

---