Changelog – Version 0.7.0

Features

• Composition-Based Architecture: Transitioned to a data-oriented composition design, replacing the old lifecycle listener system with a flexible behavior-based architecture.
• Advanced Buoyancy System: Overhauled buoyancy physics featuring fast PalettedContainer access, smooth fluid interpolation, sloped surface normals, and area-scaled forces.
• Complex Body Persistence: Implemented full persistence support for ragdolls, chains, and vehicles, ensuring complex physics structures survive world reloads.
• Dynamic Physics Layers: Introduced runtime-configurable physics layers with support for ghost box testing and custom collision filtering.
• Global Collision Registry: Added a centralized registry to prevent ID conflicts between various physics entities and behaviors.
• Namespace-Aware Identifiers: Implemented decentralized behavior IDs with namespace support to ensure compatibility with third-party mods.
• Persistent Client Tools: Added client-side persistence for tool configurations, including a UI reset button for default settings.
• Explicit Motion Types: Introduced explicit motion type management and ensured correct allocation for motion-related properties.
• NetSync Filtering: Implemented advanced network synchronization filtering within the unified VxTickBehavior to optimize bandwidth.
• Physics Events: Added the prePhysicsTick event to allow external systems to hook into the simulation loop before physics calculations occur.

Fixes

• Linux Physics Stability: Resolved long-standing instability and crashes on Linux by re-implementing batch body locking, enabled by the upgrade to Jolt-JNI 3.10.0.
• Constraint Duplication: Prevented the instantiation of duplicate physics constraints when loading chunks.
• Client-Side Extrapolation: Eliminated "jitter" and extrapolation errors by forcing state synchronization for all active physics bodies.
• NeoForge Compatibility: Fixed a registration crash on NeoForge by splitting the network channel into directional payloads.
• World Geometry Fix: Resolved issues with bodies falling through the world floor by using the level's base Y instead of a hardcoded value (closes #36).
• Concurrency & Shutdown: Hardened VxChunkBasedStorage and the IOProcessor against race conditions during concurrent server shutdowns.
• Body Persistence Hardening: Resolved IndexOutOfBoundsException during /vxkill commands and improved overall stability of the body data store.
• Buoyancy Stabilization: Stabilized buoyancy for small physics bodies by implementing normal capping for fluid forces.

Performance

• Batch Body Locking: Significantly reduced GC pressure and improved native performance by switching back to batch locking for physics updates.
• Zero-Allocation Networking: Implemented zero-allocation packet serialization and multiplexing using direct Netty buffers to eliminate heap churn.
• Memory Optimization: Eliminated terrain coordinate allocations by utilizing bit-packed long primitives for spatial indexing.
• JNI Overhead Reduction: Minimized JNI call overhead in VxPhysicsIntersector by using reusable static filters and optimized intersection logic.
• Efficient State Extraction: Optimized the extraction of physics states from the native simulation via the new BatchBodyInterface.
• Network Dispatcher Pooling: Implemented pooling for the network dispatcher to eliminate allocation stutter during high-frequency updates.
• Debug Charts: Optimized the performance debug chart with vertex batching for more efficient rendering.

Refactors

• Centralized Tick System: Unified all Java-side tick callbacks into a single VxTickBehavior for consistent execution order.
• Raycasting Overhaul: Completely rewritten VxRaycaster utility with cached Jolt filters and full decoupling from Minecraft classes.
• Project Reorganization: Major cleanup of the core package hierarchy, moving Behaviors, Managers, and Renderers into specialized sub-system packages.
• Hardcoded Defaults: Removed the dynamic VxPhysicsConfig system in favor of hardcoded constants to ensure simulation determinism across all environments.
• Fluid Drag Balancing: Rebalanced fluid drag coefficients for more realistic momentum preservation and interaction.
• Atomic Operations: Implemented atomic container swapping for thread-safe resizing of internal physics stores.
• Cleanups: Removed obsolete VxBodyLifecycleListener and isGameStateDirty arrays; standardized Quaternionfc usage in conversions.

Build & Dependencies

• Jolt-JNI Upgrade: Updated Jolt-JNI to version 3.10.0 (including intermediate update to 3.9.0 and 3.7.0).
• Nightly Builds: Added a new automated CI workflow for nightly development builds.
• Build Pipeline: Optimized build paths for NeoForge and relocated development shadow jars to intermediate directories.

Documentation

• Behavior API: Added exhaustive Javadoc to all behavior fields and methods to support add-on development.
• Standardization: Completed and standardized Javadoc for VxServerBodyManager and VxClientBodyManager.
• README Rewrite: Fully rewrote the project README to reflect the new architecture and capabilities.
• Correction: Fixed various inconsistent and duplicate Javadoc entries across the physics engine core.