SnVanishRegion changelog

Changes

• A player whose vanishregion.toggle permission is taken away while their /vanishregion toggle bypass is on now loses the bypass at the next periodic re-check (worldguard.recheck-ticks, 1 second by default; every 20 ticks when it is 0, and also without WorldGuard). They are refreshed at once in both directions and told why (errors.toggle-revoked).
• When regions.yml holds content the plugin could not read and could not copy aside, /vanishregion create and /vanishregion delete now answer errors.region-not-saved, change nothing and fire no RegionCreateEvent or RegionDeleteEvent. Before, they reported success while nothing was saved.
• New lang keys errors.toggle-revoked and errors.region-not-saved (added to existing language files on boot).

Changes

SnVanishRegion hides players from each other inside vanish regions while everyone stays in the TAB list.

What it does

• Players inside the same vanish region do not see each other's bodies, armor, held items, animations or movement. They stay fully visible to and from players outside.
• Every player always stays in the TAB list.
• A vanish region is an internal cuboid made from a WorldEdit selection or the selection wand, or any WorldGuard region that carries the vanish-region flag.
• vanish.cross-region lets players standing in any two vanish regions hide from each other.
• /vanishregion toggle gives a personal bypass: see everyone and be seen by everyone.
• EssentialsX vanish changes are observed, so un-vanishing re-shows the player correctly.
• Public developer API: SnVanishRegionAPI (API version 1.0.0) with region, bypass and visibility queries, plus RegionCreateEvent, RegionDeleteEvent, BypassToggleEvent and VisibilityRefreshEvent.
• One jar for Paper 1.20.4 up to every 1.21.x and 26.x.

Requirements

• Java 21 or newer, Paper 1.20.4 or newer.
• SnLib.jar (1.41.0 or newer) in plugins/. The plugin generates its own config and lang files on first boot.
• A bundle license key in plugins/.Sn-License/license.yml.
• WorldGuard, WorldEdit and EssentialsX are optional.

Known limitations

• Sounds made by a hidden player stay audible.
• Block-break cracks and the pickup animation of a hidden player are visible.
• A region name hand-edited into regions.yml is not validated: it is echoed raw in delete and list messages, and a name with a space cannot be deleted by command.
• A save refused because the aside copy of an unreadable regions.yml could not be made reports success to the command sender; the console shows the warning.
• A regions.yml that holds only comments is treated as unreadable.
• The license gate may block the main thread for up to about 34 seconds at startup when the license backend is slow.
• The bypass is /vanishregion toggle only; there is no permission-based bypass.
• On a Paper build with a packet class newer than the verified ones, vanish stays active and may briefly show players through it.
• When the NMS layer cannot resolve on a server version, vanish stays inactive and the plugin logs one warning.