SpyCore

[1.1.1] - 2026-09-05

Fixed

- Teleport Dimension Bounce / Infinite Toggle: Fixed bug where repeatedly executing /spy world tp <world> ping-ponged the player between Overworld and Nether. Teleportation now strictly validates that destination coordinates match the requested target world. - Per-World Location Memory: Updated PlayerManager#trackLocation to store last player positions keyed by specific world alias rather than world group base name, preventing linked Nether/End coordinates from overwriting Overworld locations. - Hardcoded Gamemode Removal: Removed hardcoded setGameMode(SURVIVAL) in /spy world tp and /spy tp, preserving the player's active gamemode (Creative, Spectator, Adventure) across teleports. - Cross-Group Inventory Load Guard: Restricted onWorldChange inventory reloading to actual cross-group transitions, preventing in-memory player state from being overwritten when traveling between linked dimensions in the same set.

Changelog - SpyCore

[1.1.0] - 2026-09-04

Added

- Native Target Operators: Expanded tab completion to suggest @s and @e for /spy world tp. - Root Command Alias: Added /spy tp [target] <world> directly matching plugin.yml's spy.tp permission node. - Automated Hibernation Scheduler: Activated a recurring 60-second world hibernation checker in the plugin lifecycle so inactive worlds automatically unload.

Fixed

- Player Death Inventory Loss: Fixed critical bug in onPlayerRespawn where a dead player's empty inventory was saved to disk, permanently wiping saved world items. - Target Operator Name Collision: Resolved command ambiguity where /spy world tp <world> failed if an online player's name matched a world alias. - PVP Projectile Bypass: Fixed projectile damage (arrows, tridents, splash potions) ignoring pvp: false in WorldSettingsListener. - Spawn Point Hijacking: Removed erroneous check that reset world spawns whenever a player landed from altitudes Y >= 249. - Coordinate ClassCastException: Fixed ClassCastException in PlayerProfile when reading whole-number coordinates from YAML files. - Metadata Path Corruption: Replaced fragile dot replacement with structured tokens to prevent dotted world names from being mangled. - Event Handler Registration: Added explicit HandlerList declarations to SpyWorldCreateEvent, SpyWorldLoadEvent, and SpyWorldUnloadEvent. - Thread-Safe Async Inventory Serialization: Cloned ItemStack[] arrays synchronously on the main thread before dispatching to async file I/O.

Changed & Performance

- Java 21/25 Build Stability: Eliminated fragile annotation processing dependencies in favor of standard native Java getters and setters. - Clean Packaging: Configured maven-shade-plugin with clean packaging to prevent dependency-reduced-pom.xml clutter, and pruned unused dependencies.

Changelog - SpyCore

[1.0.9] - 2026-02-20

Changed

- Inventory Conflict Resolution: Disabled SpyCore's internal inventory management automatically when SpyInventories is detected. This prevents race conditions and data corruption during world transitions.

Changelog - SpyCore

[1.0.8] - 2026-02-14

Added

- PlaceholderAPI Expansion: Integrated internal PAPI expansion for core features. - World Alias Placeholders: Added %spycore_world_alias% to show clean world names (aliases) instead of nested paths. - World Ignoring System: Added ignored-worlds and ignored-suffixes to config.yml. This allows the VFS and hibernation systems to bypass specific worlds (e.g., lobby, hub) or worlds matching certain patterns. - Improved Hibernation Logic: Enhanced the auto-sleep cycle to strictly respect the new ignore lists, preventing accidental hibernation of critical infrastructure worlds. - Enhanced VFS Cleaning: Automated removal of uid.dat during world cloning/importing to resolve UUID conflict errors permanently.

Fixed

- Redundant Expansion Cleanup: Removed redundant expansion code that caused circular dependencies and build failures.

Changed

- Refactored internal world loading sequence for better stability under high concurrency. - Optimized metadata storage to reduce memory footprint on long-running instances.

Changelog - SpyCore

All notable changes to the SpyCore project will be documented in this file.

[1.0.7] - 2026-02-12

Added

- Advanced World Management: Implemented "Read-Only" style template cloning for temporary match worlds. - No-Save Flag: Temporary worlds now default to AutoSave=false and KeepSpawnInMemory=false to reduce Disk I/O and memory usage. - Auto-Cleanup: Enhanced shutdown sequence to automatically unload and delete temporary match worlds (temp_match_ container). - VFS Error Resilience: Added disk-based fallback for worlds missing from configuration, resolving "VFS: World load failed" errors. - World Aliasing: Added support for world aliases to maintain consistent references across different match instances.

Changelog - SpyCore

All notable changes to the SpyCore project will be documented in this file.

[1.0.6] - 2026-02-11

Fixed

- Resolved syntax errors in SpyCommand.java regarding duplicate case "load" statements. - Fixed a type mismatch where List<String> was incorrectly being converted to boolean in the command handler. - Verified and added missing imports in SpyCommand.java for improved stability. - Optimized tab completion logic for /spy load and /spy world tp commands.

Changed

- Improved argument length validation in onTabComplete to prevent potential NullPointerExceptions. - Refactored SpyCommand to strictly follow Bukkit CommandExecutor and TabCompleter contracts.

Changelog

Added

[1.0.5] - 2026-02-06

Added

- Full Isolation: Extended isolation to include Advancements, Death messages, Join/Quit messages. These are now only visible to players within the same set of linked worlds. - Command Enhancement: Improved /spy world tp tab completion to be context-aware (only showing relevant files/folders). - Safety: Added checks to prevent creating/cloning worlds if a folder with the same name already exists physically, even if not registered. - Player Reach: Implemented forced reach distance attributes (Entity: 3.0, Block: 4.5) on player join to ensure consistent PvP/Interaction behavior across versions.

Changelog A Major Update!

Added

[1.0.4] - 2026-02-04

Added

- Hibernation System: Added a robust hibernation system to optimize server resources by unloading unused worlds. - Hibernation Whitelist: Introduced a whitelist configuration to prevent critical worlds from entering sleep mode. - World Creation: Added support for seeds in /spy create (supports numeric seed or 'random' keyword). - Global Uniqueness: Enforced strict global name uniqueness for worlds to prevent conflicts across containers. - Command Validation: Hardened /spy world tp to strictly validate container paths and prevent loading containers as worlds.

Changed

- Default Configuration: Hibernation is now disabled by default to ensure stability and prevent unexpected world unloading on new installations. - World Management: Standardized world alias mapping and improved path resolution for nested world containers. - Respawn Logic: Improved respawn handling to better support plugins with custom game logic (like SpyHunts) by respecting their event priorities. - Chat & Tab Isolation: Enhanced isolation logic to ensure players in different game instances (sets of worlds) cannot see each other's chat or tab list entries.

Fixed

- Thread Safety: Resolved a critical deadlock issue in runSync by ensuring strict main-thread execution for synchronous tasks.

Changelog

[1.0.3] - 2026-01-27

Added

- Enhanced spawn safety checks in WorldManager. - Excluded harmful blocks from safe spawn locations: - Lava and Water - Powder Snow - Magma Blocks - Pointed Dripstone - Cactus and Sweet Berry Bushes - Fire and Soul Fire - Wither Roses

SpyCore Changelog - v1.0.2

Improvements

- Small quality update for [SpyBedWars](https://modrinth.com/plugin/spybedwars).

SpyCore Changelog - v1.0.1

Bug Fixes

- Teleport Messaging: Fixed the /spy world tp command showing the internal file path instead of the user-friendly world alias. - VFS Pathing: Improved internal path resolution for containerized worlds. - Safe Arrival: Refined the safe location algorithm to prevent players from spawning in walls when teleporting to hibernated worlds.

Improvements

- World Aliasing: Improved consistency between internal world names and user-facing aliases. - Performance: Optimized the world hibernation checker to reduce CPU overhead on servers with many inactive worlds.

Compatibility

- Fully compatible with PaperMC 1.21.11.

SpyCore v1.0.0 Changelog

Initial release of SpyCore, the backbone of the SpyPlugin ecosystem.

New Features

- Containerized World Management: Introduced a revolutionary way to organize worlds into subfolders (containers). - World Aliasing: Added support for custom world names regardless of their file path. - Dynamic Loading/Unloading: Implemented a smart world lifecycle manager to save server resources. - Hibernation System: Worlds now automatically hibernate after periods of inactivity and wake up on demand. - Template System: Initial support for creating worlds from pre-defined templates. - Service API: Comprehensive API for developers to hook into world management, holograms, and data services. - Safe Location Finder: Advanced algorithm to find the nearest safe spot for player teleports.

Technical Details

- Built for PaperMC and Spigot. - Fully compatible with Minecraft 1.21.11. - Integrated with ProtocolLib for advanced packet handling.