0.97.1.0 for MC 1.14.* & 1.15.* & 1.16.*

[LlmDl]

Towny Advanced 0.97.1.0

Release contains:

Towny 0.97.1.0
TownyChat 0.89

Welcome to Towny 0.97.1.0.
Towny 0.97.1.0 is the second release in the 0.97.*.* series. It includes the support for MC 1.17.*, the Jail overhaul meant to be a part of 0.97.0.0, as well as plot and town Trusting and other features.
We also have a couple of critical bug fixes: if you are using any of these versions of Minecraft: 1.14.*/1.15.*/1.16.*/1.17.*, you should update to this version of Towny as soon as possible.
If you're upgrading from 0.96.2.0, 0.96.3.0, 0.96.4.0, 0.96.5.0, 0.96.6.0, 0.96.7.0 or 0.97.0.0 there are 0 REQUIRED changes. 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

➕ Added:

• Update to add compatibility for MC 1.17, courtesy of Warriorrrr and LlmDL with PR 1.17 #5001.

  • Revert on unclaim feature will probably not like servers using the World Height data pack.
  • Config and world files will update their lists of blocks-ignored-from-regeneration automatically.

• Jail Overhaul Project:

  • New Jail Object and JailUtil.
    • Jails are stored in the database in the towny\data\jails\ folder.
    • Towns no longer stores a list of jailspawns.
    • Old town jailspawns will be converted into new Jail objects on first load.
      • Jailed residents will not keep their jailed status, getting a clean slate to start from.
    • Jailing and unjailing code is much better than it used to be.
    • The jailing system is very much the same still, but there are many new nice things.
  • Add Jail Book.
    • The book is given to players when they are jailed.
    • It explains to the jailed player what they can do to get out of jail, based on how jails have been configured on the server.
    • Closes Suggestion: Easier Jail info #4686.
  • Jail plots can now have more than one "cell" or spawn location.
    • SpawnPoints particles are used to show the jail cell spawns.
    • Cells are added/removed using /plot jailcell add|remove
    • Closes Suggestion: Jail cells per jail plot #3106.
  • The jailed message now includes who ran the jail command.
    • Closes Suggestion: Player sent to jail message. #4096.
  • Jail plots can now have PVP disabled in them (configurable.)
    • Closes Suggestion: Jail - Non-PvP Zones #4659.
  • Chorus Fruit are now lumped in with the Ender Pearl in a new config option for whether teleport items can be used by jailed players.
    • Closes Suggestion: jail_allows_ender_pearls setting should also allow chorus fruit #4903.
  • Add optional logout protection for newly-jailed players.
    • Newly jailed players that logout before they are teleported to jail will be killed, when the feature is activated.
    • The player is warned of this to prevent surprises.
    • Similar to combat-logging plugins.
  • Add new-player jail-immunity.
    • Players who first joined the server cannot be jailed for their first hour of playtime (configurable.)
  • Add Town PrimaryJail.
    • The PrimaryJail is the default jail for a town.
    • It is used when the /t jail NAME command is used (with no jail/cell/hours specified.)
    • It is used when outlaw and enemies are jailed by being killed.
    • PrimaryJail is set using /t set primaryjail.
  • New Commands:
    • /plot jailcell add - Adds a jail cell to a jail plot, where the player is stood.
    • /plot jailcell remove - Removes a jail cell from a jail plot, where the player is stood.
    • /town jail list - Shows jail number, name, coord, cellcount and which jail is the primary jail.
    • /town jail {name} - Jails the given player for 1 hour, must be a resident of your own town.
    • /town jail {name} {hours} - Jails the given player for the given hours.
    • /town jail {name} {hours} {jail} - Jails the given player for the given hours, in the given jail plot (which is a number.)
    • /town jail {name} {hours} {jail} {cell} - Jails the given player for the given hours, in the given jail plot and jail cell (which are both numbers.)
    • /town unjail {name} - Unjails someone in your town's jail.
    • /town set primaryjail - Sets your town's primary jail.
  • Removed Command: /town toggle jail
  • New Config Options:
    • jail.outlaw_jail_hours
      • Default: 5
      • How many hours an attacking outlaw will be jailed for.
    • jail.do_jail_plots_deny_pvp
      • Default: false
      • When true, jail plots will prevent any PVP from occuring. Applies to jailed residents only.
    • jail.prevent_newly_jailed_players_logging_out
      • Default: false
      • When true, Towny will prevent a person who has been jailed by their mayor/town from logging out if they do log out they will be killed first, ensuring they respawn in the jail.
    • jail.new_player_immunity
      • Default: 1h
      • How long do new players have to be on the server before they can be jailed?
    • jail.jail_allows_teleport_items
      • Default: false
      • If true jailed players can use items that teleport, ie: Ender Pearls & Chorus Fruit, but are still barred from using other methods of teleporting.
      • Closes Suggestion: jail_allows_ender_pearls setting should also allow chorus fruit #4903

• Plot Group Overhaul

  • Adds ability to transfer a townblock from one group to another using /plot group add NAME.
    • Closes Suggestion: Make a PlotGroup's plot easier to move to a different PlotGroup. #5050.
  • Removes the plotgroups.txt file.
  • All files in the plotgroups folder will be loaded.
  • Plot Groups now keep a uniform perm line.
  • PlotGroups which are for sale will show a $ symbol on the ascii and hud maps.
  • PlotGroups now have their own hovertext when viewed in the /towny map.
  • Fix empty plotgroups not being deleted.
  • Rewrite of the SQL saving/loading for plotgroups is done as well.
    • Fixes delete code which would never work.
    • Removes a redundant SQLSource method loadJail(Jail).
  • Properly PlotGroup.setResident(Resident) where it was not.

• Alter non-player vs non-player combat:

  • In the wilderness it is allowed.
  • If it is a tamed wolf, and the owner is online, and the owner can destroy in the plot where the defender non-player is, and the non-player is a protected entity, the wolf murdering other non-players is allowed.
  • Closes Axolotls / Wolves cannot damage fish or enemies at all when Towny is present on 1.17 server #5059.

• Hibernated Residents

  • Residents that are deleted by Towny will become hibernated residents.
  • Towny will remember their true registered date if the player ever rejoins the server.
  • Closes Suggestion: Option to keep basic resident data forever #5135.

• Townyperms.yml now receives automatic updates (like the config and world files.)

  • This was last thing which sometimes required admin intervention.
  • Enjoy even more drag-and-drop Towny updates.

• Add comparator type: Founded.

  • Compare nations and towns by who were founded the earliest. (ie: /t list by founded)
  • Closes Suggestion: ComparatorType "BY_FOUNDED". Sort towns by founded time. #5110.

• Add upkeep costs for Towns to toggle and remain neutral.

  • Similar to nation peaceful costs.
  • Closes Suggestion: Add peaceful tax to towns #5003.

• Parse hex colours in resident titles in the status screens.

  • Closes Suggestion: Format titles to appear colored in ./t when passing an RGB value for title.  #4977.

• Improve message shown to towns which are invited to a nation.

  • Closes Suggestion: Different messages for Town and Nation invites. #4998.

• Allow ruined towns to be made public.

  • Closes Suggestion: Ability to automatically set 'Ruined' towns to 'public' #4959.

• Change max-hours for Town Ruins from 1000 to 8760 (one year.)

  • Closes Suggestion: Allow Town Ruins to persist indefinitely. #4970.

• Add ability to teleport newly-outlawed players who are within the town's borders.

  • Closes Suggestion: Teleport outlaws away (when it is set in the config) right after getting outlawed #4944.

• Add ability to limit how far away an outpost can be made from a town's existing claims.

  • Closes Suggestion: Add an outpost range limit #3065.

• Adds limits to how often and how far a town can move their homeblock.

  • Closes Suggestion: Homeblock Movement Limitations requring distance. #4957.

• Add WildernessMapEvent awareness to the /towny map hud.

  • Other plugins like TownyCamps, TownyHistories now appear on the /towny map hud.

• Allow for plots to be claimed by clicking the $ on the ascii map.

  • Closes Suggestion: Finding forsale plots in all towns. #4020.

• Add ability for a nomad to be prompted to a join a town when they /plot claim, if the town is open and the townblock is not an embassy plot.

  • Closes Suggestion: Let player join town when doing /plot claim #4019.

• Added /ta townyperms command.

  • Edit the townyperms file from in game.

• Protect weatherable blocks from having their oxidation scraped off with an axe.

  • Considered a destroy test.

• Towns can now set their mapcolor, like nations do using /t set mapcolor.

  • Requires Dynmap-Towny 0.86.

• Replace player.sendMessage() with TownyMessaging.sendMessage().

• Improve /town claim auto, works again but doesn't always claim everything it could in one use.

• Town and Nation lists are now cached, able to be updated after 10 minutes.

• Add candles to the bypass for flint & steel.

• Protect candles from being placed on cakes.

• Switch over to using new cancelling for PojectileHitEvents.

• Give Glowing Item Frames the same protections we give to the differently-abled Item Frames.

• Allow ruined towns' residents to be able to use /town spawn.

• Creates a cache of sorts for the wilderness coords on the Towny ASCII map.

• Remove a ton of possible NotRegisteredExceptions that could be thrown using methods added since 0.97.0.0.

• Townyperms.yml now saves itself on load in order to build the comments on new installs.

• Update onPlayerLogin task to not use methods which can throw NREs.

• Add Trusted to TownBlocks and Towns, PermOverrides to TownBlocks, courtesy of Warriorrrr with PR Add trust and per-player permissions. #5058.

  • Use /town trust add|remove NAME or /plot trust add|remove NAME to give people full build/destroy/switch/itemuse permissions in the given town or plot.
  • Use /plot perm add|remove NAME to add a player to a plot's permission overrides.
  • Use /plot perm GUI to open the plot permission editor.
    • Hover over the player's head who you've added to the plot to see their BDSI settings.
    • Click their head to edit the individual build/destroy/switch/itemuse settings.
  • PlotGroups also have the same ability to have trusted|permission overrides applied to players for the entire plotgroup.
    • Use the same /plot group trust|perm commands.
  • New Commands:
    • /town trust add|remove NAME
    • /plot trust add|remove NAME
    • /plot perm add|remove NAME
    • /plot perm gui
    • /plot group trust add|remove NAME
    • /plot group perm add|remove NAME
    • /plot group perm gui

• Version checker, courtesy of Warriorrrr with PR New version checker #5016.

  • Automatically checks for updates on startup, and notifies players with the update notifications permission node when logging in (if enabled).
  • Servers can choose to be notified of Release versions.
  • If a server is using a pre-release version, and they have the checker enabled, they will be notified of new pre-releases (ignoring the release-versions-only option.)
  • Presents a download link.

• Add LuckPerms Contexts, courtesy of Warriorrrr with PR Add luckperms contexts #4966.

  • Adds towny contexts to LuckPerms. At the moment this is very similar to our townyperms.yml, but the difference is that these can be used together with other contexts (per world permissions for example).
  • Includes Resident, Mayor, King, InsideTown, InsideOwnTown, InsideOwnPlot.

• Add Command Addon API, courtesy of Warriorrrr with PR Add command addon API #4886.

  • Adds a new command addon API, that allows plugin developers to add their own sub commands to Towny's existing commands.

• Add config option for limiting ally amounts, courtesy of Warriorrrr with PR Add config option for limiting ally amounts #5082.

  • Closes Suggestion: Optional Nation Ally Cap. #5064.

• Add /ta plot claimedat command for getting exact claimedat time, courtesy of Warriorrrr with PR Add /ta command for getting exact claimedat time #4911.

• Automatically clean up unused NPC residents, courtesy of Warriorrrr with PR Automatically clean up unused NPC residents #4972.

• Map HUD, courtesy of Warriorrrr with PR Map HUD #4996.

• Send a warning if /tw toggle is used when usingtowny is false, courtesy of Warriorrrr with PR Send a warning if /tw toggle is used when usingtowny is false. #5040.

• Add a tutorial book for the plot perm GUI, courtesy of Warriorrrr with PR Add a tutorial book for the plot perm GUI #5103.

• Prevent zombies breaking doors in claimed areas, courtesy of Warriorrrr with PR Prevent zombies breaking doors in claimed areas. #5107.

• Print yaml exception message if a file breaks formatting, courtesy of Warriorrrr with PR Print yaml exception message if a file breaks formatting #5113.

• Replace all sysouts, courtesy of Warriorrrr with PR Replace all sysouts #5126

• Remove Integrated FlagWar, courtesy of TheFlagCourier with PR Remove Integrated FlagWar (Admins: use the add-on going forward) #5081.
  • Completes the separation of FlagWar into a standalone .jar available here: https://github.com/TownyAdvanced/FlagWar
  • This new jar has already had a couple new features added which were not available in Towny's version of FlagWar.
  • There could be some bugs still in the standalone version so if you see something, say something.
    • Bugs can be reported on the issue tracker: https://github.com/TownyAdvanced/FlagWar/issues
• bStats to 2.2.1 (was 1.x), Shade it; make isSpigot() private, rename it. Courtesy of TheFlagCourier with PR bStats to 2.2.1 (was 1.x), Shade it; make isSpigot() private, rename it. #4934.
• Expand checkPlugin() and /towny universe output, courtesy of TheFlagCourier with PR Errata: Expand checkPlugin() and /towny universe output #5129.

• Added New town map-colour event, courtesy of Goosius with PR Added New town map-colour event #5172.

• Add commands from being ran by outsiders, courtesy of EuGNosii with PR Block commands from being ran by outsiders #4953.
  • Closes Suggestion: Ability to set commands that are only blocked in other towns, not in the wild or in your town. #4951.
• Replace deprecated methods on TownyLogger, courtesy of EuGNosii with PR Replace deprecated methods on TownyLogger #4933.
• Improve safe mode messages in-game, courtesy of EuGNosii with PR Improve safe mode messages in-game #5013.
• Update "Updating Language Files" section of Contributing.md, courtesy of EuGNosii with PR Update "Updating Language Files" #5188.

• Add missing color code translations to resident surnames, courtesy of illumeleet with PR add missing color code translations #5120.
  • Translates colour codes used in surnames the same way we already did resident titles.
  • Shows colouring properly in /nation|town set title|surname command feedback when coloured titles/surnames are set.
• Add town&nation rank luckperms contexts, courtesy of illumeleet with PR Add town&nation rank luckperms contexts #5102.
• Add minimum allowed amounts used in depositing and withdrawing from town and nation banks, courtesy of illumeleet with PR Add minimum allowed amounts used in depositing and withdrawing from town and nation banks. #5112.

• Add a block whitelist to wilderness explosion regeneration, courtesy of NigelTicknor with PR Add a block whitelist to wilderness explosion regeneration #5091. (First-Time Contributor!)
  • World files have: PlotManagementWildRegenBlockWhitelist="";
  • Config contains the default which will be applied to new worlds only: new_world_settings.plot_management.wild_revert_on_explosion_block_whitelist
  • When these are empty the whitelist is not used, and instead the older way is done: everything reverts except the plotManagementIgnoreIds list.
  • When the list is not empty, only the blocks in the list will regenerate.
  • Pull Request also fixed a couple bugs that were spotted in testing.

• Remove "/t list"`s root permission granting access to all listing options, courtesy of 0xBit-MC with PR Remove "/t list"`s root permission granting access to all listing options. #5099.
  • towny.command.town.list used to have the childnode towny.command.town.list.*.
  • Now it only has towny.command.town.list.resident, making it possible to allow the usage of the /t list command, without giving out all of the nodes.

• Include tb_prefix in column drop check, courtesy of Parsonswy with PR Include tb_prefix in column drop check (Closes #4935) #4952 (First-Time Contributor!)
  • For the mysql servers that could never get the old columns dropped, this will fix that, and prevent the massive error logs that resulted from it.
  • Closes [Some?] Database Migrations Failing to run [0.96.1.0 -> 0.97.0.0] #4935.

• Add ability to prevent outlaws from teleporting or using certain commands while in a town, courtesy of drewdorris with PR Add ability to prevent outlaws from teleporting or using certain commands while in a town #5012 (First-Time Contributor!)

• Implemented basic configuration format for audit history, courtesy of Glare with PR Implemented basic configuration format for audit history #5095.

---

➕ Automatic Config Edits (4)

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

• Your config and world files' revert-on-unclaim block ignore will have the following added automatically to add 1.17 compatibility.
  • ,DEEPSLATE_IRON_ORE,DEEPSLATE_GOLD_ORE,DEEPSLATE_COAL_ORE,DEEPSLATE_REDSTONE_ORE,DEEPSLATE_DIAMOND_ORE,DEEPSLATE_EMERALD_ORE,DEEPSLATE_LAPIS_ORE,RAW_IRON_BLOCK,RAW_GOLD_ORE
• Your townyperms.yml will have:
  • towny.command.town.reclaim added to the town default rank.
  • towny.command.plot.trust added to the nomad rank.
  • towny.command.plot.group.* added to the nomad rank.

---

✨ Command Changes (31)

✨ New Commands (30)

✨ New Commands:

• From the Jail Overhaul:

  • /plot jailcell add - Adds a jail cell to a jail plot, where the player is stood.
  • /plot jailcell remove - Removes a jail cell from a jail plot, where the player is stood.
  • /town jail list - Shows jail number, name, coord, cellcount and which jail is the primary jail.
  • /town jail {name} - Jails the given player for 1 hour, must be a resident of your own town.
  • /town jail {name} {hours} - Jails the given player for the given hours.
  • /town jail {name} {hours} {jail} - Jails the given player for the given hours, in the given jail plot (which is a number.)
  • /town jail {name} {hours} {jail} {cell} - Jails the given player for the given hours, in the given jail plot and jail cell (which are both numbers.)
  • /town unjail {name} - Unjails someone in your town's jail.
  • /town set primaryjail - Sets your town's primary jail.

• From the Trust/Plot Override update:

  • /town trust add|remove NAME
  • /plot trust add|remove NAME
  • /plot perm add|remove NAME
  • /plot perm gui
  • /plot group trust add|remove NAME
  • /plot group perm add|remove NAME
  • /plot group perm gui

• /ta townyperms grouplist : Lists all of the groups in the townyperms.yml.

• /ta townyperms group [groupname] : lists the nodes held by a group.

• /ta townyperms group [groupname] addperm|removeperm [node] : adds or removes a node to/from a group.

• /ta townyperms townrank addrank|removerank [rank] : adds or removes a town rank.

• /ta townyperms nationrank addrank|removerank [rank] : adds or removes a nation rank.

• /ta plot claimedat - Shows when the plot was claimed.

• /towny map hud - Activates the map in the player's scoreboard.

• /tw toggle unclaimblockdelete {on|off} - Turns on/off the delete-blocks-on-unclaim feature in the world.

• /nation list by founded

• /town list by founded - Lists towns in the order they were founded.

• /town purge {days}

  • Kicks residents from the town who have been inactive for the given number of days.
  • NPCs and mayors are exempt.

• /town plotgrouplist (townname) (page) - Lists a town's plotgroups with forsale and price indicated.

• /town set mapcolor {color} - Sets a town's mapcolor seen in the dynmap.

• /plot group delete - Deletes a plot group entirely, requested in Suggestion: Make a PlotGroup's plot easier to move to a different PlotGroup. #5050.

---

❌ Removed Commands (1)

❌ Removed Commands:

• /town toggle jail

---

---

📕 Config Changes (26)

📕 New Config Options (25)

📕 New Config Options:

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

• jail.outlaw_jail_hours

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

• jail.do_jail_plots_deny_pvp

  • Default: false
  • When true, jail plots will prevent any PVP from occuring. Applies to jailed residents only.

• jail.prevent_newly_jailed_players_logging_out

  • Default: false
  • When true, Towny will prevent a person who has been jailed by their mayor/town from logging out if they do log out they will be killed first, ensuring they respawn in the jail.

• jail.new_player_immunity

  • Default: 1h
  • How long do new players have to be on the server before they can be jailed?

• jail.jail_allows_teleport_items

  • Default: false
  • If true jailed players can use items that teleport, ie: Ender Pearls & Chorus Fruit, but are still barred from using other methods of teleporting.
  • Closes Suggestion: jail_allows_ender_pearls setting should also allow chorus fruit #4903

• town.max_distance_for_outpost_from_town_plot

  • Default: 0
  • Set to 0 to disable. When above 0 an outpost may only be claimed within the given number of townblocks from a townblock owned by the town.
  • Setting this to any value above 0 will stop outposts being made off-world from the town's homeworld.
  • Do not set lower than min_distance_for_outpost_from_plot above.

• town_ruining.town_ruins.ruins_become_public

  • Default: false
  • If this is true, when a town becomes a ruin they also receive public status, meaning anyone can use /t spawn NAME to teleport to that town.

• global_town_settings.allow_outlaws_to_teleport_out_of_town

  • Default: true
  • Prevents outlawed users teleport commands while located in a town they're outlawed in.

• global_town_settings.allow_outlaws_use_teleport_items

  • Default: true
  • If false, outlawed players in towns cannot use items that teleport the player, ie: Ender Pearls & Chorus Fruit.
  • Setting this to false requires allow_outlaws_to_teleport_out_of_town to also be false.

• global_town_settings.outlaw_blacklisted_commands

  • Default: somecommandhere,othercommandhere
  • Commands outlawed users can't use while inside that town.

• global_town_settings.outlaw_teleport_away_on_becoming_outlawed

  • Default: false
  • If set to true, when a player is made into an outlaw using /t outlaw add NAME, and that new outlaw is within the town's borders, the new outlaw will be teleported away using the outlaw_teleport_warmup.

• global_town_settings.town_command_blacklisting.own_town_and_wilderness_limited_commands

  • Default: sethome,home
  • This allows the usage of blacklisted commands only in the player's town and the wilderness (essentially blocking commands from being ran by tourists/visitors.)
  • Players with the towny.globally_welcome permission node are not going to be limited by this list.
  • Commands have to be on town_command_blacklisting.town_blacklisted_commands, else this is not going to be checked.

• global_town_settings.homeblock_movement_cooldown_hours

  • Default: 0
  • When set above 0, the amount of hours a town must wait after setting their homeblock, in order to move it again.

• global_town_settings.homeblock_movement_distance_limit

  • Default: 0
  • When set above 0, the furthest number of townblocks a homeblock can be moved by.
  • Example: setting it to 3 would mean the player can only move their homeblock over by 3 townblocks at a time.
  • Useful when used with the above homeblock_movement_cooldown_hours setting.

• plugin.interfacing.luckperms_contexts

  • Default: true
  • If enabled, Towny contexts will be available in LuckPerms.

• plugin.update_notifications.alerts

  • Default: true
  • If enabled, players with the towny.admin.updatealerts permission will receive an update notification upon logging in.

• plugin.update_notifications.major_only

  • Default: true
  • If enabled, only full releases will trigger notifications if you are running a full release, unless you're using a pre-release version.

• global_nation_settings.max_allies

  • Default: -1
  • The maximum amount of allies that a nation can have, set to -1 to have no limit.

• bank_history.book

  • {time}\n\n{type} of {amount} {to-from} {name}\n\nReason: {reason}\n\nBalance: {amount}
  • This allows you to modify the style displayed via bankhistory commands.

• new_world_settings.plot_management.wild_revert_on_explosion_block_whitelist

  • Default: ''
  • New worlds will use the list to populate their PlotManagementWildRegenBlockWhitelist lists.

• economy.price_town_neutrality

  • Default: 25.0
  • The daily upkeep to remain neutral, paid by the Town bank. If unable to pay, neutral/peaceful status is lost.

• economy.banks.town_min_deposit

  • default: 0
  • Minimum amount of money players are allowed to deposit in town bank at a time.

• economy.banks.town_min_withdraw

  • default: 0
  • Minimum amount of money players are allowed to withdraw from town bank at a time.

• economy.banks.nation_min_deposit

  • default: 0
  • Minimum amount of money players are allowed to deposit in nation bank at a time.

• economy.banks.nation_min_withdraw

  • default: 0
  • Minimum amount of money players are allowed to withdraw from nation bank at a time.

---

❌ Removed Config Options (1)

❌ Removed Config Options:

• jail.outlaw_jail_days

---

---

🔑 Permission Node Changes (22)

🔑 New Permission Nodes (21)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• towny.command.plot.trust
• towny.command.plot.group.*
  • Which adds the following child nodes:
  • towny.command.plot.group.trust
  • towny.command.plot.group.perm
• towny.command.plot.jailcell
• towny.command.town.purge
• towny.command.plot.group.delete
• towny.command.town.plotgrouplist
• Child nodes of towny.command.plot.perm:
  • towny.command.plot.perm.*
  • towny.command.plot.perm.gui
  • towny.command.plot.perm.add
  • towny.command.plot.perm.remove
• towny.command.town.jail
• towny.command.town.jail.list
• towny.command.town.unjail
• towny.command.town.set.primaryjail
• towny.command.town.trust
• towny.command.town.list.founded
• towny.command.town.set.mapcolor.
• towny.command.nation.list.founded
• towny.command.townyadmin.townyperms
• towny.admin.updatealerts

---

❌ Removed Permission Nodes (1)

❌ Removed Permission Nodes:

• towny.command.town.toggle.jail

---

---

💻 API Changes (17)

💻 API:

• Add TownyAPI.getResidentOrNull(TownBlock).
  • Gets the resident who owns the townblock or null if unowned.
  • Best used after TownBlock.hasResident();
• Add TownyAPI.getTownOrNull(TownBlock).
  • Gets the town who owns the townblock or null if wilderness.
  • Best used after TownBlock.hasTown();
• Add WorldCoord.getTownOrNull().
  • Gets the town at that WorldCoord or null if it is in the wilderness.
  • Best used after WorldCoord.hasTownBlock();
• Add TownyAPI.getResident(Player) and TownyAPI.getTownyWorld(World).
• Add some new getOrNull methods, courtesy of Warriorrrr with PR Add some new getOrNull methods #5114.
  • Nation.getSpawnOrNull()
  • Town.getHomeBlockOrNull()
  • Resident.getNation()
  • Resident.getNationOrNull()
• TownyDispenserDamageEntityEvent a TownyDamageEvent.
• WildernessMapEvent
  • Event which allows third-party plugins to change what is show on the ASCII map, in the wilderness.
• DisplayedNationsListSortEvent added courtesy of Goosius with PR SW-310: Added event for custom ordering of displayed nations list #5084.
  • Allows for a plugin to alter how nations are listed on /n list.
• TeleportOutlawEvent.
  • Allows for a plugin to cancel an outlaw being teleported out of a town.
  • Closes Suggestion: Add cancellable event to outlaw teleportation. #5109.
• Add Town.getSpawnOrNull().
• New event added: TownMapColourLocalCalculationEvent ... for recalculation of the local town colour by plugins
• Existing Event renamed: TownMapColourNationalCalculationEvent ... for recalculation of the national town colour by plugins
• Added TownBlock#getTownBlockOwner
  • Returns a TownBlockOwner object, either the resident who personally owns the townblock, or the town if there's no resident.

---

🔧 Fixed

🔧 Fixed:

• Fix long town/nation names being able to break the TownyFormatter/ChatTools.
  • Closes Town name too long #4942.
• Fix towns that already have a nation being able to be sent nation invites.
  • Closes Nation invite towns that are already in a nation #4963.
• Shade in slf4j, fixing ClassNotFoundException: org.slf4j.LoggerFactory
  • Closes Updated towny not loading + econ issue previous build #4950.
• Fix nations not losing their spawn point.
  • Closes Nation spawn remains after being unclaimed #4961.
• Fix SQL resident loading new jail properties hitting NPEs
  • Closes NPE on startup com.palmergames.bukkit.towny.object.Resident.setJailCell(Resident.java:131) #4990.
• Fix wilderness entity explosions' reverting being mucked with by the EventWar.
  • Closes During and after a war event wilderness regeneration is not working #5014.
• Fix ChunkNotifications not correctly handling not-for-sale plotgroups.
  • Closes Plot group action bar not showing correctly #5069.
• Prevent commas being used in plot group names.
  • Closes Server random safemode after restart #5049.
• Fix missing message feedback for /ta nation [nation] set commands.
  • Closes ta nation NAME set mapcolor COLOR has no output #5144.
• Prevent adding a townblock to a plot group if it doesn't match the groups' townblock type.
  • Closes Adding arena to plot group lacking PvP and then removing from plotgroup yields arena with no PvP, and Towny prevents re-enabling it #5141.
• Fix /ta town NAME set spawn not working when the spawn isn't already set.
  • Closes /ta town NAME set spawn fails if town has no existing spawnpoint #5150.
• Fix banners not regenerating properly when exploded.
  • Closes Regen bug with banners #5178.
• Fix /n set king declaring that the capital has too many residents.
• Fix no feedback when using a /plot command in the wilderness.
• Fix regression: null message shown from /t spawn and /n spawn when used from the wilderness.
• Fix sheep being protected from shearing in the wilderness.
• Fix tree/mushroom structure growth on plot borders not being tested correctly.
• Fix Bonemeal usage not working.
• Fix nations not paying peaceful upkeep if their nation upkeep was 0.
• Fix towny.bypass_death_costs node not working in all situations.
• Fix ExceptionInInitializerError preventing Towny from starting up.
• Fix loading residents who have friended themselves.
• Fix Warzone Listener Able to Query null PlayerCache.
• Fix force-explosion world setting not forcing explosions in towns.
• Fix /tw toggle plotcleardelete toggling the wrong feature.
• Fix Tamed Wolfs being attackable where PVP is off.
• Fix SQL code loading new Jails.
• Fix footer of the /town jail list output.
• Fix ChunkNotifications creating an error when a forsale plot is entered into where the economy is not active.
• Fix placeholders starting with %townyadvanced_player_ not working.
• Fix /town claim throwing Index 0 out of bounds for length 0 error.
• Fix new townyperms ConfigMigrator using key where it should use value.
• Fix /ta nation [nation] rank command being able to give nation ranks to a non-nation-having-resident.
• Fix players who've had their town removed not resetting their playercache.
• Fix removing a null jail.
• Fix missing townless tab complete on /ta purge command.
• Fix SpawnLocation particles skipping particles.
• Fix pagination footer for /t plotgrouplist and /t jail list.
• Fix renamed towns not following the capitalization rule.
• Fix SQL saving residents trying to find a jail column and failing.
• Fix list page footers missing a space in their click commands.
• Fix mayors being unable to evict townless players who own embassy plots in the mayors land.

• Fix tamed dogs not being hittable inside towns, courtesy of Warriorrrr with PR Fix tamed dogs not being hittable inside towns. #4955.
  • Closes Other player's dogs are not killable in claimed area with PVP enabled #4954.
• Fix addon api exception in the towny command, courtesy of Warriorrrr with PR Fix addon api exception in the towny command #4967.
  • Closes CommandException error while using TownyCommandAddonAPI #4965.
• Fix command always being null, courtesy of Warriorrrr with PR Fix command always being null #4974.
  • Closes Message after running added subcommand #4971.
• Fix a NoSuchMethodError that can occur on 1.15, courtesy of Warriorrrr with PR Fix a NoSuchMethodError that can occur on 1.15 #5030.
  • Closes 1.15 Entity Interaction Console Error #5029.
• Fix canBlockMove always allowing wilderness, courtesy of Warriorrrr with PR Fix canBlockMove always allowing wilderness #5105.
  • Closes Sticky Pistons pull blocks from claimed areas #5104.
• Fix NPE when a town ruins, courtesy of Warriorrrr with PR Fix NPE when a town ruins #5119.
  • Closes NPE thrown at the Towny new day due to interaction between plot groups and ruining  #5118.
• Validate /plot group fs input, courtesy of Warriorrrr with PR Validate /plot group fs input #4968.
  • Closes Input Validation /plot group fs  #4960.
• Handle dispenser damage correctly, courtesy of Warriorrrr with PR Handle dispenser damage correctly #5039.
  • Finishes some ancient TODOs that meant Dispensers weren't really tested against PVP.
• Allow moving of blocks between wilderness plot borders, courtesy of Warriorrrr with PR Allow moving of blocks between wilderness plot borders #5128.
  • Closes Pistons can't pull blocks across chunks in Wilderness #5127.
• Fix potential console spam from adventure, courtesy of Warriorrrr with PR Fix potential console spam from adventure #4939.
• Fix a few tab completion issues with the addon API, courtesy of Warriorrrr with PR Fix a few tab completion issues with the addon API #4943.
• Fix players res friending themselves or NPCs, courtesy of Warriorrrr with PR Fix players res friending themselves or NPCs #5017.
• Remove unneeded permission check, courtesy of Warriorrrr with PR Remove unneeded permission check #5111.
• Move permissions check down in onPlayerMove, courtesy of Warriorrrr with PR Move permissions check down in onPlayerMove #5176.

• Fix /town unclaim throwing Index out of bounds error, courtesy of Silverwolfg11 with PR Fix index out of bounds for /t unclaim. #5088.
• Fix some fall-throughs in PlotCommand, courtesy of silverwolfg11 with PR Fix some fall-throughs in PlotCommand #5131

• Fix building w/o github-actions maven profile; Ensure JVM 8 compatiblity with JDK9+, courtesy of FlagCourier with PR Fix building w/o github-actions maven profile; Ensure JVM 8 compatiblity with JDK9+ #5019.

• Fix german.yml, courtesy of relkai with PR Update german.yml #4924.

• Fix typos in the readme, courtesy of fredster33 with PR Fix typos #5179. (First-Time Contributor!)

---

🌏 Language Updates

🌏 Language Updates:

• Language files bumped to 0.117.
• Update es-419, courtesy of EuGNosii with PRs Translate es-419 #4964, Translate es-419 strings (0.107) #4983, es-419.yml update #5042, es-419 translation update #5101,
• Update zh-TW.yml, courtesy of shou692199 with PR Update zh-TW.yml #4992.
• Update Spanish file and fix typo in English file, courtesy of ElMoha943 with PRs Update lang files #5070, Update spanish.yml #5108.
• Language files moved into resources/lang subfolder inside the jar.
• Rename language files to proper country-coded names.
  • Your existing language file will be renamed.
• New Translations:
  • Indonesian courtesy of pobab.
  • Dutch courtesy of Warrior & pesie.
  • Romanian courtesy of DevinMart.
  • Turkish courtesy of Sanic.

---

👽 Placeholder Updates (3)

👽 Placeholder Updates:

• Make applicable placeholders available when a player is offline, courtesy of BlakeStevenson with PR Make applicable placeholders available when a player is offline #4962.
  • All except for player_plot_* and player_location_* placeholders should function for offline players.
• %townyadvanced_player_location_plot_owner_name%
  • Displays the name of the resident who owns the plot, or blank if no one personally owns it.
  • Closes Suggestion: Add a plot owner name placeholder #4916.
• %townyadvanced_town_map_color_hex%
  • Returns the colour set by the town.

---

💬 TownyChat Changes

💬 TownyChat Changes:

• Update min. Towny to 0.97.0.0 and remove NotRegisteredException catches.
• Add support for EssentialsDiscord, courtesy of JRoy with PR Add support for EssentialsDiscord TownyChat#33.

---

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.
MrLogano	Momshroom	Cobrex1	KarlOfDuty
scatterspell	gerardvanschip	DrprofLuigi	Tobza
SmallSansSerif	TheNylox	diontimmer	trevor1097
benevolent2012	bretomart	HunSolos	0xBit-MC
specs1396	treeDerevo	Scottlander100	ItsSynchro
Advanced-Kind-MC	MidnightSugar	Microhazard	mhiaxo
TheFlagCourier	PigioGigio	PestoNotPasta	catsaretheend
galacticwarrior9	cigaming	GreenArrowlol	KeNickGong
honnisha	MilesBHuff	pebblehost	and 2 private sponsors.
If you want to support the developer consider becoming a sponsor. (It's just like Patreon but 100% goes to the developer.) Plus there are 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.97.1.0 for MC 1.14.* & 1.15.* & 1.16.*.