Blueprint Nexus

Blueprint Nexus v1.1.5 Changelog

Architecture & Stability Updates:

• Thread-Safe Registry System: Refactored the core BlueprintRegistry into a robust, thread-safe singleton instance. This eliminates potential race conditions during heavy chunk generation and ensures consistent structure data across all server threads.
• Modern API Surface: Introduced a new programmatic entry point via BlueprintNexusPlugin.getAPI().getRegistry(). This allows other modders to register, unregister, and query structures with full JavaDoc support.
• Automated Dependency Validation: Added a smart scanner that checks the manifest.json of all active structure packs. The engine now issues a proactive warning in the logs if a mod provides legacy structures without declaring a dependency on BlueprintNexus, preventing potential load-order issues.

Spawning & Generation Fixes:

• Fail-Safe Registration: Implemented a "Try-Catch-Continue" pattern for structure loading. If a specific prefab file is corrupted or a JSON is invalid, the engine will now skip the problematic file with a detailed error log instead of crashing the entire server.
• Detailed Caller Origin Tracking: The API now logs exactly which mod is performing a registration, making it easier for server administrators to debug structure-related issues.
• Lifecycle Cleanup: Improved the plugin shutdown sequence to ensure all structure data is atomically cleared from memory, preventing leaks during server reloads.

Developer Tools:

• Comprehensive Documentation: Added detailed JavaDocs to all public API methods, including parameter descriptions, return types, and exception handling.
• Example Implementation: Provided a reference ExampleStructureMod demonstrating proper integration with the new version.