AnarchySpawn

A high-performance random wilderness spawn and safe respawn engine designed for Anarchy and competitive survival Minecraft servers.

---

Supported Versions & Server Engines

Click to expand / collapse Version Compatibility Matrix

Minecraft Version	Compatibility Status	Compatibility Details
1.20.x - 26.3+	Full Support (Native)	Full support for modern height limits (-64 to 320), modern potions, trial structures, and 26.3 pale garden features (Creaking Heart, Heavy Core, Pale Oak).
1.18.x - 1.19.x	Full Support	Seamless support for caves & cliffs height limits and ancient city biome detection.
1.16.5 - 1.17.x	Full Support (Legacy)	Automatic fallback to height 0 base and legacy potion effect aliases (DAMAGE_RESISTANCE, INCREASE_DAMAGE, etc.).
1.12.2 - 1.15.x	Full Support (Legacy)	Automatic fallback from PDC to local dual-track storage (data/players.yml), legacy Material system mapping (STATIONARY_LAVA), and Classloader insulation.

Server Core / Software	Compatibility	Recommendation
Paper / Purpur	Native Async Support	Highly Recommended (utilizes asynchronous chunk loading & teleportation without TPS drops)
Folia	Native Regionized Scheduler	Fully Supported (all scheduling routed through FoliaScheduler with region-thread confinement)
Spigot / CraftBukkit	Full Synchronous Support	Fully Supported (automatically switches to scheduled sync loading fallback)
Pufferfish / Gale / Leaves	Native Async Support	Fully Supported

---

Features

• Broad Version Compatibility (1.12.2 - 26.3+): Built-in runtime reflection layer and dual-track persistence that safely adapts across legacy (1.12.2) and modern Minecraft releases without NoSuchMethod crashes.
• Surface Direct Penetration & 98%+ Search Acceleration: Directly queries surface heightmaps (getHighestBlockYAt) in Overworld terrain, dropping candidate column block checks from 250 down to 13 iterations.
• Standalone Multi-Language System & Client Locale Auto-Detection: Language files are organized in a dedicated languages/ directory (en_US.yml, zh_CN.yml, zh_TW.yml). Messages automatically adapt to each player's client language.
• First-Join Safe Drop & Per-World Control: Delays teleportation upon first join or dimension entry to safely dispatch players into configured ring wilderness zones. Each world can independently toggle first-join random spawn (first-join: true/false).
• PDC & Dual-Track Tracking: Uses PersistentDataContainer on 1.14+ and automatic file fallback on 1.12.2 - 1.13.2 to track spawn history per world without external database dependencies or memory leaks.
• Zero-Delay Respawn Cache Pool: Background async tasks pre-search and maintain a pool of safe locations (LocationCachePool) for instant respawn upon death.
• Bed & Respawn Anchor Override: Option to override vanilla beds and respawn anchors to prevent bed-trapping and spawn-kill cycles.
• Equal-Area Annular Distribution: Utilizes equal-area probability density sampling to ensure uniform player distribution across outer zones without clustering near the center.
• Dynamic Death Hotspot Avoidance: Automatically avoids recent death/PvP zones to prevent spawn camping and crystal traps, with seamless fallback.
• Holistic 3D Safety Validation: Rigorous filtering against lava, underwater, cacti, sweet berries, powdered snow, portals, bedrock roofs/voids, dangerous ocean biomes, trial structures, and world borders.
• PaperMC Async Chunk Compatibility: Native reflection support for Paper's asynchronous chunk loading with smooth fallback on Spigot, preserving 20 TPS.
• Folia Regionized Scheduler Support: Auto-detects Folia region threads with transparent fallback to classic scheduler on Paper/Spigot.
• Audiovisual & Anti-Instakill Protection: Configurable invulnerability duration, potion effects (Resistance, Slow Falling, Fire Resistance), particle effects, sounds, titles, and actionbars.
• Ecosystem Integration: Built-in soft dependency support for PlaceholderAPI and EssentialsX.

---

Installation & Usage

1. Copy the compiled AnarchySpawn-x.x.x.jar into your server's plugins/ folder.
2. Start the server; default configuration and language files will be generated in plugins/AnarchySpawn/ and plugins/AnarchySpawn/languages/.
3. Customize config.yml and language files in languages/ according to your server requirements.
4. Execute /as reload in the console or in-game to apply configuration changes on the fly.

---

Commands & Permissions

Click to expand / collapse Command List (Commands)

Command	Aliases	Permission	Default	Description
/as reload	/aspawn reload	anarchyspawn.reload	OP	Reloads configuration and language files
/as tp [player] [world]	/randspawn tp	anarchyspawn.tp	OP	Teleports a player to a safe random location in target world
/as setcenter <world> <x> <z>	/as setcenter	anarchyspawn.setcenter	OP	Dynamically updates the spawn center coordinates for a world
/as info	/as status	anarchyspawn.info	OP	Displays enabled world statuses and cache pool capacity
/as test [world]	/as benchmark	anarchyspawn.test	OP	Runs a single safe coordinate search benchmark with timing
/as cache	/as refill	anarchyspawn.cache	OP	Wakes up background async workers to refill the pre-cache pool

Click to expand / collapse Permission List (Permissions)

Permission Node	Default	Description
anarchyspawn.use	Everyone (true)	Grants access to random safe spawns on first join and death respawn
anarchyspawn.bypass	OP	Bypasses random respawn (preserves vanilla bed and respawn anchor)
anarchyspawn.admin	OP	Master administrator permission covering all subcommands
anarchyspawn.reload	OP	Allows execution of /as reload
anarchyspawn.tp	OP	Allows execution of /as tp
anarchyspawn.setcenter	OP	Allows execution of /as setcenter
anarchyspawn.info	OP	Allows execution of /as info
anarchyspawn.test	OP	Allows execution of /as test
anarchyspawn.cache	OP	Allows execution of /as cache

---

PlaceholderAPI Identifiers

Click to expand / collapse PlaceholderAPI List (Placeholders)

Placeholder	Description	Return Type / Example
%anarchyspawn_spawned%	Checks if the current player has performed their initial spawn in the current world	true / false
%anarchyspawn_cache_size_<world>%	Gets the count of currently available safe locations in the async cache pool for the specified world	Integer (e.g., 10)
%anarchyspawn_min_radius_<world>%	Gets the configured minimum inner radius for the specified world	Integer (e.g., 1000)
%anarchyspawn_max_radius_<world>%	Gets the configured maximum outer radius for the specified world	Integer (e.g., 15000)