AnarchySpawn

Core Features & Architecture (English)

• Zero-Lag Async Pre-Cache Pool:

  • Introduced the LocationCachePool multi-threaded coordinate pre-calculation engine, actively maintaining a configurable pool of verified safe spawn locations to guarantee 0ms instant respawn upon player death, eliminating main thread tick lag spikes caused by chunk loading;
  • Features scheduled async refilling, instant asynchronous top-off upon cache consumption, and /as cache manual refill command, with automated purge of stale coordinates exceeding the configured maximum cache age;
  • Integrated graceful fallback dispatching to the configured world fallback location (fallback-location) under cache starvation or burst concurrent joins.

• Equal-Area Annular Distribution:

  • Replaced naive linear polar coordinate distribution with an equal-area probability density algorithm: $r = \sqrt{u \cdot (R_{max}^2 - R_{min}^2) + R_{min}^2}$;
  • Guarantees uniform spatial distribution density across inner and outer ring boundaries, preventing players from clustering tightly around the center origin.

• Holistic 3D Safety Validation:

  • Built the comprehensive SafetyValidator engine to strictly filter out lava, flowing water, fire, soul fire, cacti, sweet berry bushes, powder snow, wither roses, campfires, pressure plates, tripwires, and deadly hazard blocks;
  • Fully adapted for modern 1.20.4+ / 1.21+ trial structure mechanics, safely detecting and blocking spawns on Trial Spawners (TRIAL_SPAWNER), Vaults (VAULT), Sculk Sensors, and Sculk Shriekers;
  • Automatically filters blacklisted ocean and void biomes, and skips pitch-black deep subterranean caverns in Overworld dimensions to prevent inescapable cave traps.

• Spawn-Trap Prevention & Anti-Spawnkill:

  • Provides override-bed and override-anchor configuration toggles to override vanilla bed and respawn anchor mechanics, preventing crystal bed-trapping and continuous spawn-kill cycles;
  • Supports permission anarchyspawn.bypass to allow privileged staff members to preserve their vanilla bed spawn points.

• PDC Persistent Spawn History:

  • Utilizes Bukkit's native PersistentDataContainer (PDC) to track per-world spawn history directly within player entity NBT data, eliminating external database dependencies, connection leaks, and IO bottlenecks.

---

Localization & Notification System (English)

• Separated Server & Client Locales:

  • Completely decoupled server-language (used for server console logs and command outputs) from client-default-language (used as fallback for unmatched players) within config.yml;
  • Automatically detects individual player Minecraft client locales (player.getLocale()), bundled with out-of-the-box support for Simplified Chinese (zh_CN), Traditional Chinese (zh_TW), and English (en_US);
  • Implemented hierarchical graceful fallback (Target Locale $\rightarrow$ Client Default Locale $\rightarrow$ Server Locale), completely eliminating missing key errors when new configuration nodes are added.

• Configurable Client & Server Notifications:

  • Added a dedicated notifications configuration block in config.yml, providing independent toggles for client chat announcements (chat), location report cards (location-card), spawn protection messages (protection), and fallback warnings (fallback-warning);
  • Added independent server console logging toggles (console-log-first-join and console-log-respawn) to allow operators to enable or completely silence console coordinates logging;
  • Optimized console de-duplication: prevented in-game administrator monitor broadcasts ([Respawn-Monitor]) from polluting the server console alongside standard logs ([Respawn]), and ensured console logs strictly resolve {biome} and {direction} using the configured server-language.

• Multi-Line Location Report Cards:

  • Extended MessageManager with native YAML List (List<String>) multi-line parsing, supporting {prefix} placeholder placement to preserve elegant bordered message aesthetics;
  • Added spawn.first-join-location-info and spawn.respawn-location-info report cards across all language bundles;
  • Built-in localized biome dictionaries (biomes) and 8-cardinal direction dictionaries (directions), fully supporting {exact_x}, {exact_y}, {exact_z}, {biome}, {direction}, and {distance} placeholders.

---

Compatibility & Protection (English)

• Minecraft 1.16.5 to 26.2+ Cross-Version Architecture:

  • Engineered the PaperCompatibility reflection layer to automatically leverage Paper / Purpur native asynchronous chunk loading (getChunkAtAsync) and async teleportation (teleportAsync), with seamless synchronous fallback on Spigot / CraftBukkit;
  • Reflectively handles World.getMinHeight() across modern negative world limits (-64 to 320) and legacy Minecraft 1.16.5 heights (0 to 256);
  • Implemented an internal potion effect alias lookup table (EFFECT_ALIASES) to ensure backward compatibility with legacy 1.16 ~ 1.20 potion effect names.

• Audiovisual & Anti-Instakill Protection:

  • Configurable invulnerability duration (Invulnerable & NoDamageTicks) upon teleportation, complete with customizable protection start and expiration messages;
  • Configurable post-teleport potion effects (Resistance, Slow Falling, Fire Resistance, Saturation) to prevent instant fall damage or mob ambush;
  • Full audiovisual feedback support including arrival sound effects, particle clouds (Portal, etc.), centered on-screen Title / Subtitle, and hotbar Actionbar alerts.

---

Integrations & Commands (English)

• PlaceholderAPI Integration:

  • Registered the %anarchyspawn% expansion identifier, providing placeholders for player spawn status (%anarchyspawn_spawned%, %anarchyspawn_spawned_<world>%);
  • Exposes cached pool sizing (%anarchyspawn_total_cached%, %anarchyspawn_cache_size_<world>%) and world radius bounds (%anarchyspawn_min_radius_<world>%, %anarchyspawn_max_radius_<world>%).

• Administrative CLI & Tab Completion:

  • Comprehensive command suite with auto-completion: /as reload (hot reload config and locales), /as tp (randomly teleport target player), /as setcenter (dynamically update center origin), /as info (inspect world statuses & cache pools), /as test (benchmark location search latency), and /as cache (force-refill location cache pools).