0.99.1.0 for MC 1.16.* & 1.17.* & 1.18.* & 1.19.*

[LlmDl]

Towny Advanced 0.99.1.0

Release contains:

Towny 0.99.1.0
TownyChat 0.106

Welcome to Towny 0.99.1.0.
Towny 0.99.1.0 is the second release in the 0.99.*.* series!
0.99.1.0 supports all versions of Minecraft 1.16 and newer.
This version adds support for Folia, fixes a critical bug, and adds new features and fixes more bugs.
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 (25)

➕ Added:

• Add option for overclaimed towns to have their land stolen from them.

  • When enabled a Town which has claimed too much land, ie: TownBlocks 120/100, will be vulnerable to having some of their land stolen.
  • Stealing land is done by using /t takeoverclaim.
    • This command must be used at the edge of a town, which is adjacent to your town.
    • It comes with a customizable cost.
    • It does not allow an overclaimed Town to be cut into two separate parts.
    • Important: Towns can only have land stolen from them until they are no longer overclaimed!
    • Important: There is an option to prevent stealing land too close to a Town's HomeBlock!
    • Important: It is recommended to only enable this setting when outposts are disabled and min_adjacent_blocks is set to 2 or 3!
  • TownBlocks that can be stolen will have a [TakeoverClaim Available] added to their ChunkNotification.
  • Mayors will also see warnings:
    • on login while being overclaimed,
    • when they approach their claim limit while claiming land,
    • and when they lose a resident that would put them at risk of being overclaimed.
  • Closes Suggestion: Ability to over claim #6564.

• Add rank priority and rank prefix to town and nation ranks.

  • The Town and Nation ranks in the townyperms.yml can now be assigned two permission nodes:
    • towny.rankpriority.#
    • towny.rankprefix.
  • Ex: Assistant rank can be given:
    • towny.rankpriority.100
    • towny.rankprefix.&a&r
  • and the Sheriff rank can be given:
    • towny.rankpriority.500
    • towny.rankprefix.&b&r
  • A player that has both the sheriff and assistant rank will show the assistant prefix using the below PAPI placeholder.
  • Closes Suggestion: Town ranks in chat #4658.

• Added the ability to change the colours used in the help menus in Towny.

  • You may override the following language strings in the global lang file: help_menu_command, help_menu_subcommand, help_menu_explanation, help_menu_requirement.
  • Closes Suggestion: Add ability to edit command color code in "/towny?" and similar commands. #6633.

• Add admin setting for towns: forcemobs

  • Used to force mobs on in a town, done using the /t town TOWNNAME toggle forcemobs command.
  • Closes Suggestion: Allow toggle of forcing all mobs spawns per-town  #6659.

• Add adjacent claims feature support to the /t unclaim command.

  • Players will no longer be able to unclaim land if any of their adjacent townblocks will not have the required number of adjacent claims.
  • Closes Suggestion: Add unclaiming support to anti snake claiming #6644.

• Add configurable symbol for the maps to showcase Outpost plots.

  • Closes Suggestion: Show outpost chunks on /towny map hud #6595.

• Add /invite deny all, so a player can deny all of their received invites.

  • Closes Suggestion: Allow players to see and clear all the town invites they've received #6606.

• Add config option that would prompt a resident who joins a town, to spawn to that town.

  • Closes Suggestion: Automatically teleport new residents to /t spawn #6619.

• Add config option to have ruined towns pay any remaining money to their nation bank.

  • Closes Suggestion: Ruined town deposits to Nation #6612.

• Add new options to allow trusted and allied residents to use commands in towns which are normally blocked by non-residents.

  • Closes Suggestion: Add a setting to the "denied commands" section in the config #6639.

• Add config option to set the duration of the Title and Subtitle messages shown when entering/leaving towns.

  • Closes Suggestion: Custom sendTitle stay time #6662.

• Newly blacklisted town and nation names: all, help.

• Add nations that enemy your nation to the /n enemylist output.

• Update sql schema class to be more modern with much cleaner code, in prep for the transition to a UUID-keyed database.

• Add protection to turtle eggs, players are required to pass a destroy test in order to break them via jumping.

• Allow subcommands to be blocked using the blocked-commands config sections, courtesy of Warrior with PR Allow subcommands to be blocked #6680.
  • Closes Suggestion: Command blocking function for sub-commands with a main command #6642.
  • Blocking a root command i.e. /town will block any town subcommands, blocking a subcommand will not block the root command or any other sub commands.
• Add Folia Support, courtesy of Warrior with PR Folia Support #6611.
  • An absolutely astounding achievement accomplished by Warrior, everybody clap.
• Add a migration for adding an old town level, courtesy of Warriorrrr with PR Add a migration for adding an old town level #6618.
  • Servers that still use Towny 0.95.1.0 (and potentially older) can now update as easily as drag-and-drop.
• Make campfire water bottle protection a bit better, courtesy of Warriorrrr with PR Make campfire water bottle protection a bit better #6632.
• Add moving piston to block ignore list, courtesy of Warrior with PR Add moving piston to block ignore list #6656.
• Add Folia to bstats server type chart, courtesy of Warrior with PR Add Folia to bstats server type chart #6654.
• Support spigot's tnt prime event, courtesy of Warrior with PR Support spigot's tnt prime event #6653.
• Add new perm node for inviting multiple residents, courtesy of Warrior with PR Add new perm node for inviting multiple residents #6668.
• Add some more tests, courtesy of Warrior with PR Add some more tests #6676.
• Skip javadoc generation by default, courtesy of Warrior with PR Skip javadoc generation by default #6675.

---

➕ Automatic Config Edits (1)

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

• MOVING_PISTON will be to the new_world_settings.plot_management.revert_on_unclaim.block_ignore config entry, and the corresponding world file setting.

---

✨ Command Changes (4)

✨ New Commands (4)

✨ New Commands:

• /invite deny all
  • Denies all of a players received town invites.
• /town takeoverclaim
  • Used to a mayor to take over land from an overclaimed town, when allowed in the config.
  • Towns are considered overclaimed if their townblocks are more than they are allowed, ie: TownBlocks 120/100.
• /ta town TOWNNAME toggle conquered
  • Removes the conquered status of a town.
• /ta town TOWNNAME toggle forcemobs.
  • Forces mobs on for the specified town.

---

✨ Changed Commands (0)

✨ Changed Commands:

• None.

---

❌ Removed Commands (0)

❌ Removed Commands:

• None.

---

---

📕 Config Changes (13)

📕 New Config Options (12)

📕 New Config Options:

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

• ascii_map_symbols.outpost

  • Default: O
  • The character used for the outpost symbol.

• town.overclaiming.being_overclaimed_allows_other_towns_to_steal_land

  • Default: false
  • A feature that allows towns which have too many townblocks claimed (overclaimed) ie: 120/100 TownBlocks,
    to have their land stolen by other towns which are not overclaimed. Using this incentivises Towns to keep
    their residents from leaving, and will mean that mayors will be more careful about which land they choose
    to claim.
    Overclaiming does not allow a town to be split into two separate parts, requiring the Town that is stealing
    land to work from the outside inwards.
    It is highly recommended to only use this on servers where outposts are disabled, and requiring
    a number of adjacent claims over 1 is enabled. Towns take land using /t takeoverclaim.

• town.overclaiming.overclaiming_prevented_by_homeblock_radius

  • Default: true
  • While true, overclaiming is stopped by the min_distance_from_town_homeblock setting below.
  • This prevents a town from having townblocks stolen surrounding their homeblocks.

• economy.takeoverclaim.price

  • Default: 100.0
  • The price to use /t takeoverclaim, when it has been enabled in the config
    at town.being_overclaimed_allows_other_towns_to_steal_land

• economy.town_set_mapcolour_cost

  • Default: 0
  • The cost of setting a town's mapcolour.

• economy.nation_set_mapcolour_cost

  • Default: 0
  • The cost of setting a nation's mapcolour.

• global_town_settings.are_new_residents_prompted_to_town_spawn

  • Default: false
  • When a resident joins a town, should they be prompted to use spawn to the town?
  • This requires them to not already be standing in the town, and also to be able to use /t spawn and whatever costs may be associated with it.

• global_town_settings.town_command_blacklisting.own_town_and_wilderness_limited_commands_allow_trusted_residents

  • Default: true
  • When set to true, trusted residents (residents that are trusted by a town directly, as well as residents that are members of a town that is trusted,) will be able to use commands that only town residents could use.

• global_town_settings.town_command_blacklisting.own_town_and_wilderness_limited_commands_allow_allies

  • Default: false
  • When set to true, residents which are allies of the town (which could be nation members as well as allied nations' members) will be able to use commands that only town residents could use.

• town_ruining.town_ruins.town_bank_is_sent_to_nation

  • Default: false
  • If this is true, when a town becomes a ruin, and they are a member of a nation, any money in the town bank will be deposited to the nation bank.

• notification.owner_shows_verbose_name

  • Default: true
  • When true, a plot notification that has a plot owner's name will use the verbose name, ie: town/nation titles or prefixes set via the town/nation levels.
  • When false, only their name will appear.

• notification.titles.duration",

  • Default: 70
  • The duration (in ticks) that the Title and Subtitle messages will appear for.
  • The default duration for minecraft is 70 ticks, which equates to 3.5 seconds.

---

❌ Removed Config Options (1)

❌ Removed Config Options:

• notification.owner_shows_nation_title

---

---

🔑 Permission Node Changes (2)

🔑 New Permission Nodes (2)

🔑 New Permission Nodes:

No change required in townyperms.yml.

• towny.command.town.takeoverclaim
  • Child Node of towny.command.town.*
  • No adjustments need to be made to the townyperms.yml.
• towny.command.town.invite.add.multiple
  • Child node of towny.command.town.invite.add, given by default with no change required to your townyperms.yml file.
  • When set to false, mayors/assistants will not be able to send out more than one town invite at a time, preventing spamming townless players.

---

❌ Removed Permission Nodes (0)

❌ Removed Permission Nodes:

• None.

---

----

💻 API Changes (4)

💻 API:

• Add town-changing-mayor events.

  • Alters the TownMayorChangeEvent to include a getCommandSender.
  • Add TownMayorChangedEvent which is not cancellable, alerts plugins of any change in mayor.
  • Add TownMayorChosenBySuccessionEvent which allows a plugin to determine who will become mayor when Towny automatically chooses a mayor.
  • Closes Suggestion: Event called when Towny appoints a new mayor for a town  #6607.

• Add Towny#isTownyVersionSupported(String)

  • Returns true if Towny is of equal or newer version, used by other plugins to determine if the Towny version is good.

• Add some more readable convenience methods to Version, courtesy of Warrior with PR Add some more readable convenience methods to Version #6670.

• Allow Spawn Events to be Un-Cancelled, courtesy of Goosius1 with PR Allow Spawn Events to be Un-Cancelled #6663.

---

🔧 Fixed (29)

🔧 Fixed:

• Fix missing feedback messages when towns that cannot join your nation are being invited.
  • Closes Nothing is returned when invited to a nation #6614.
• Prevent creatures from using switches more reliably.
  • Closes Villagers and MCPets can switch with pressure plates. #6640.
• Fix potential NPE thrown when players log off before their spawn warmup is over, when TeleportCause.PLUGIN is used.
  • Closes Jail teleportation issue #6643.
• Fix /n enemy add/remove sometimes showing "none of those names were valid" despite working.
• Prevent 0 dollar amounts being withdrawn/deposited from town and nation banks.
• Only show cost confirmation for setting map color when the cost is above 0.
• Fix incorrect balances shown in the bankhistory books.
• Fix distance test for merging towns.
• Fix edge case scenario where the nation-requires-proximity feature could be bypassed.
• Fix world settings being wiped on load, which affected some servers using MySQL.
• Fix errant underscores in the message displayed when a town joins a nation.

• Fix NPE when finding a new mayor, courtesy of Warriorrrr with PR Fix NPE when finding a new mayor #6616.

  • Closes Towny throws NPE when use /t merge #6615.

• Fix legacy format subtitle out of bounds, courtesy of Warriorrrr with PR Fix legacy format subtitle out of bounds #6630.

  • Closes Error in outputting the nation information #6629.

• Fix hex gradients with minimessage not working, courtesy of Warrior with PR Fix hex gradients with minimessage not working #6674.

  • Closes Minimessage gradient format is not working #6291.

• Display mayor as none if town has no mayor, courtesy of Warriorrrr with PR Display mayor as none if town has no mayor #6631.

• Remove first arg for nation transaction method, courtesy of Warrior with PR Remove first arg for nation transaction method #6669.

• Setup jabel for the provider modules, courtesy of Warrior with PR Setup jabel for the provider modules #6682.

• Delete redundant submodule gitignores, courtesy of Warrior with PR Delete redundant submodule gitignores #6679.

• Set source encoding utf-8 for all modules, courtesy of Warrior with PR Set source encoding utf-8 for all modules #6678.

• Fix trie insertion order weirdness, courtesy of Warrior with PR Fix trie insertion order weirdness #6677.

• Refactor the main class a bit, courtesy of Warrior with PR Refactor the main class a bit #6684.

• Use a proper key for the cooldowns map, courtesy of Warrior with PR Use a proper key for the cooldowns map #6694.

• Remove teleport related fields from Resident, courtesy of Warrior with PR Remove teleport related fields from Resident #6695.

• Fix previously async timers tasks being sync, courtesy of Warrior with PR Fix previously async timers tasks being sync #6696.

• Fix login npe regression, courtesy of Warrior with PR Fix login npe regression #6688.

• Fix another NPE caused by listener registration change, courtesy of Warrior with PR Fix another NPE caused by listener registration change #6698.

• Marginally faster town or null, courtesy of Warrior with PR Marginally faster town or null #6701.

• Cleanup Resources not using modern Try, courtesy of jimender2 with PR Cleanup Resources in Error #6649. (First-Time Contributor!)

• Fallback to Plot Group name when Plot has no name, courtesy of GabrielTK with PR Fallback to Plot Group name when Plot has no name #6704. (First-Time Contributor!)
  • Closes Suggestion: Plot Group Names should affect Placeholders #6703.

---

🌏 Language Updates (0)

🌏 Language Updates:

• None.

---

🌏 Dependency Updates (6)

🌏 Dependency Updates:

• Bump adventure-text-minimessage from 4.13.0 to 4.13.1.
• Bump adventure-text-serializer-plain from 4.13.0 to 4.13.1.
• Bump junit-jupiter from 5.9.2 to 5.9.3.
• Bump junit-jupiter-api from 5.9.2 to 5.9.3.
• Bump maven-source-plugin from 3.2.1 to 3.3.0.
• Bump maven-surefire-plugin from 2.22.2 to 3.1.0.

---

👽 Placeholder Updates (2)

👽 Placeholder Updates:

• %townyadvanced_resident_primary_rank% - Displays a prefix associated with a player's highest-priority nation or town rank.
• %townyadvanced_resident_primary_rank_spaced% - Displays a resident's primary rank with a space afterwards.

---

💬 TownyChat Changes (6)

💬 TownyChat Changes:

• Update EssentialsX maven details.
• Translate spy message colour codes.
  • Closes Suggestion: enable chatcolors in Towny Spy #6634
• Add Folia support, courtesy of Warrior with PR town spawn not abiding by the tp cooldown #46.
• Add focusable option to channels in the channels.yml.
  • By default channels are focusable and adding focusable: true has no effect.
  • Adding focusable: false will prevent players making their primary channel, ie using /tc with no message.
  • Closes Suggestion: TownyChat channel toggling #6650
• Add new chat slug: {primaryresidentrank}
  • When a resident has a primary rank with a prefix this will display their prefix with a space added to the end.
  • Primary ranks and their prefixes are set in the townyperms.yml like so:
    • towny.rankpriority.#
    • towny.rankprefix.<somewordshere>
• Fix version check, courtesy of Warrior with PR Suggestion: Giving Kings the ability to assign suffix titles to their nation's members. #48.

---

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, and who supported me during this pre-release of Towny.
MrLogano	Momshroom	Cobrex1	TheFlagCourier	DrprofLuigi	SmallSansSerif
TheNylox	pebblehost	NoikzGaming	ThePontificate	AllieDragon	TegulaThePig
darthpeti	Eblyss	akup001	Valerie2308	Kelbbie	tjdings
AldinaMapping	CrypticBlades	EcoSMP	Semisol	Theeno74	ItzXPurpleX
Luciusred	Rekar7	AfricaByTot0	Noxillio	notzune	real-vgi
Lambsy	guillermodiazkiernans	ItzPear	DeltaOrion	Tobza	vyvin
keijodputt	Vena-Cava	ArmonicPvP	NeumimTo	o-zzer	Dracathio
Peskdt	Merlin6019	vette-daniel	AncientSM	JunkieCraft	CalebGitBritannia
Hikitsune-Red	DoctorChosen	Dynamite99	ItsSynchro	EpicSpeed	SuperRedstoneYT
Jayoakson	tyhppp233	MrLogano	Tuaniwan	CorruptedGreed	ProjectGuinness
Deathrayne225	EBatuzay	Khargot	Mineprank	ReEvadere	trevor1097
MetaverseRP	CorruptVD	GabrielTK	bretomart	Polo-lulu	Folas1337
GundalfWasTaken	qwlke	MayorMike	Draedixe	gageeet	wizard1233
Th35p1k3	j0g32	Wextra	Microweb4	tskopen	PainOchoco
Bloc-k	Radiation-pi	Aviside	bradyyykennyy	xSTORMYxSHM	StevenSharker
Manul-Newton	Polo-lulu	Ashparty	jsuarezl	royblue12	mikslendov
BeepSterr	nhannon9	ItzMeKarlix	tapok233	tomhmagic	WyattPereira
and 30 private sponsors.
If you want to support the developer, become a sponsor. (It's just like Patreon but instead 100% of your support goes to the developer.) Plus there are Sponsor Plugins!

Important Links
Frequently Asked Questions	How Towny Works	Towny Install Guide	Towny Update Guide
Other Towny Plugins	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.99.1.0 for MC 1.16.* & 1.17.* & 1.18.* & 1.19.*.