Changelog – Version 0.9.0

This update introduces our new Stonecutter multi-version development setup. This allows us to work on Minecraft 1.20.1 and 1.21.1 at the same time, supporting both Forge and Fabric. We also added new tools, improved performance with JNI caching, and completely rebuilt how we save and sync physics data.

Gameplay & Features

• New Weld Tool: Added a tool that lets you weld different physics bodies together so they stick.
• Physics Gun Fixes: Fixed the physics gun so it doesn't grab kinematic and static (non-moving) bodies.
• Removed Vehicles: We removed the old vehicle system and built-in drivable bodies for now.

Collision & Physics Changes

• New Collision Shape System: Implemented VxCollisionShape to handle shape definitions and sync them properly.
• Debug Rendering: Added modular debug lines to render collision shapes, making it much easier to see physics boundaries in-game.
• Direct NIO Memory: Changed physics body data containers to use direct NIO buffers. This makes reading and writing physics data faster.
• ID-Driven Behaviors: Rebuilt the physics behavior system to use simple IDs. We also changed sync behaviors to use clean, declarative callbacks.
• Activation State: Bodies now properly save and sync whether they are active or resting. Fixed an issue where some bodies were forced to be dynamic.

Performance & Sync

• Faster JNI Bridge: Optimized how we get AABBs on the client using Jolt shapes. We did this by batching JNI calls.
• Shape Caching: Added shape caching inside the JNI bridge. This fixes stuttering and lag when rendering or creating compound shapes.
• Smarter Persistence (TLV System): Built a high-performance persistence system using a custom schema (TLV format). It cleanly saves chunk data, behavior bits, and ignores collisions between specific pairs of bodies.
• Better Velocity Sync: Moved angular velocity (angVel) tracking to the main container and sync it directly to the client with a state packet.
• Rendering Optimization: Cached BoxColor values to speed up rendering loops.

Stonecutter Multi-Version Development

• Multi-Version Workspace: We now use Stonecutter to develop for both 1.20.1 and 1.21.1 simultaneously.
• Loader & Version Support: Fully set up Stonecutter branches to compile and export for both Forge and Fabric.
• Development Setup: Separated development run directories for each version and cleaned up IDE run configurations.

Bug Fixes & Code Cleanup

• Crash Fix: Fixed a dangerous race condition when removing bodies that caused a double-destruction crash.
• Null Shape Sync: Resolved a bug where null shapes would sometimes try to sync, causing errors.
• Event Library Update: Rewrote and restructured the internal vx-events library to make it cleaner and easier to maintain.
• Constraint Search: Added a method in VxConstraintManager to quickly find constraints using their UUID.

Build & CI (Development)

• Gradle Update: Upgraded Gradle to 9.4.1 and added the Foojay toolchain resolver.
• Smarter Workflows: Made GitHub Actions fully dynamic. Workflows now automatically build, test, and package artifacts for all target versions.
• Nightly Builds: Set up automatic Maven snapshot publishing for nightly workflows.
• Dependency Cleanups: Used modLocalRuntime to keep testing mods out of published files.

Changelog – Version 0.9.0

This update introduces our new Stonecutter multi-version development setup. This allows us to work on Minecraft 1.20.1 and 1.21.1 at the same time, supporting both Forge and Fabric. We also added new tools, improved performance with JNI caching, and completely rebuilt how we save and sync physics data.

Gameplay & Features

• New Weld Tool: Added a tool that lets you weld different physics bodies together so they stick.
• Physics Gun Fixes: Fixed the physics gun so it doesn't grab kinematic and static (non-moving) bodies.
• Removed Vehicles: We removed the old vehicle system and built-in drivable bodies for now.

Collision & Physics Changes

• New Collision Shape System: Implemented VxCollisionShape to handle shape definitions and sync them properly.
• Debug Rendering: Added modular debug lines to render collision shapes, making it much easier to see physics boundaries in-game.
• Direct NIO Memory: Changed physics body data containers to use direct NIO buffers. This makes reading and writing physics data faster.
• ID-Driven Behaviors: Rebuilt the physics behavior system to use simple IDs. We also changed sync behaviors to use clean, declarative callbacks.
• Activation State: Bodies now properly save and sync whether they are active or resting. Fixed an issue where some bodies were forced to be dynamic.

Performance & Sync

• Faster JNI Bridge: Optimized how we get AABBs on the client using Jolt shapes. We did this by batching JNI calls.
• Shape Caching: Added shape caching inside the JNI bridge. This fixes stuttering and lag when rendering or creating compound shapes.
• Smarter Persistence (TLV System): Built a high-performance persistence system using a custom schema (TLV format). It cleanly saves chunk data, behavior bits, and ignores collisions between specific pairs of bodies.
• Better Velocity Sync: Moved angular velocity (angVel) tracking to the main container and sync it directly to the client with a state packet.
• Rendering Optimization: Cached BoxColor values to speed up rendering loops.

Stonecutter Multi-Version Development

• Multi-Version Workspace: We now use Stonecutter to develop for both 1.20.1 and 1.21.1 simultaneously.
• Loader & Version Support: Fully set up Stonecutter branches to compile and export for both Forge and Fabric.
• Development Setup: Separated development run directories for each version and cleaned up IDE run configurations.

Bug Fixes & Code Cleanup

• Crash Fix: Fixed a dangerous race condition when removing bodies that caused a double-destruction crash.
• Null Shape Sync: Resolved a bug where null shapes would sometimes try to sync, causing errors.
• Event Library Update: Rewrote and restructured the internal vx-events library to make it cleaner and easier to maintain.
• Constraint Search: Added a method in VxConstraintManager to quickly find constraints using their UUID.

Build & CI (Development)

• Gradle Update: Upgraded Gradle to 9.4.1 and added the Foojay toolchain resolver.
• Smarter Workflows: Made GitHub Actions fully dynamic. Workflows now automatically build, test, and package artifacts for all target versions.
• Nightly Builds: Set up automatic Maven snapshot publishing for nightly workflows.
• Dependency Cleanups: Used modLocalRuntime to keep testing mods out of published files.

Changelog – Version 0.9.0

This update introduces our new Stonecutter multi-version development setup. This allows us to work on Minecraft 1.20.1 and 1.21.1 at the same time, supporting both Forge and Fabric. We also added new tools, improved performance with JNI caching, and completely rebuilt how we save and sync physics data.

Gameplay & Features

• New Weld Tool: Added a tool that lets you weld different physics bodies together so they stick.
• Physics Gun Fixes: Fixed the physics gun so it doesn't grab kinematic and static (non-moving) bodies.
• Removed Vehicles: We removed the old vehicle system and built-in drivable bodies for now.

Collision & Physics Changes

• New Collision Shape System: Implemented VxCollisionShape to handle shape definitions and sync them properly.
• Debug Rendering: Added modular debug lines to render collision shapes, making it much easier to see physics boundaries in-game.
• Direct NIO Memory: Changed physics body data containers to use direct NIO buffers. This makes reading and writing physics data faster.
• ID-Driven Behaviors: Rebuilt the physics behavior system to use simple IDs. We also changed sync behaviors to use clean, declarative callbacks.
• Activation State: Bodies now properly save and sync whether they are active or resting. Fixed an issue where some bodies were forced to be dynamic.

Performance & Sync

• Faster JNI Bridge: Optimized how we get AABBs on the client using Jolt shapes. We did this by batching JNI calls.
• Shape Caching: Added shape caching inside the JNI bridge. This fixes stuttering and lag when rendering or creating compound shapes.
• Smarter Persistence (TLV System): Built a high-performance persistence system using a custom schema (TLV format). It cleanly saves chunk data, behavior bits, and ignores collisions between specific pairs of bodies.
• Better Velocity Sync: Moved angular velocity (angVel) tracking to the main container and sync it directly to the client with a state packet.
• Rendering Optimization: Cached BoxColor values to speed up rendering loops.

Stonecutter Multi-Version Development

• Multi-Version Workspace: We now use Stonecutter to develop for both 1.20.1 and 1.21.1 simultaneously.
• Loader & Version Support: Fully set up Stonecutter branches to compile and export for both Forge and Fabric.
• Development Setup: Separated development run directories for each version and cleaned up IDE run configurations.

Bug Fixes & Code Cleanup

• Crash Fix: Fixed a dangerous race condition when removing bodies that caused a double-destruction crash.
• Null Shape Sync: Resolved a bug where null shapes would sometimes try to sync, causing errors.
• Event Library Update: Rewrote and restructured the internal vx-events library to make it cleaner and easier to maintain.
• Constraint Search: Added a method in VxConstraintManager to quickly find constraints using their UUID.

Build & CI (Development)

• Gradle Update: Upgraded Gradle to 9.4.1 and added the Foojay toolchain resolver.
• Smarter Workflows: Made GitHub Actions fully dynamic. Workflows now automatically build, test, and package artifacts for all target versions.
• Nightly Builds: Set up automatic Maven snapshot publishing for nightly workflows.
• Dependency Cleanups: Used modLocalRuntime to keep testing mods out of published files.

Changelog – Version 0.9.0

This update introduces our new Stonecutter multi-version development setup. This allows us to work on Minecraft 1.20.1 and 1.21.1 at the same time, supporting both Forge and Fabric. We also added new tools, improved performance with JNI caching, and completely rebuilt how we save and sync physics data.

Gameplay & Features

• New Weld Tool: Added a tool that lets you weld different physics bodies together so they stick.
• Physics Gun Fixes: Fixed the physics gun so it doesn't grab kinematic and static (non-moving) bodies.
• Removed Vehicles: We removed the old vehicle system and built-in drivable bodies for now.

Collision & Physics Changes

• New Collision Shape System: Implemented VxCollisionShape to handle shape definitions and sync them properly.
• Debug Rendering: Added modular debug lines to render collision shapes, making it much easier to see physics boundaries in-game.
• Direct NIO Memory: Changed physics body data containers to use direct NIO buffers. This makes reading and writing physics data faster.
• ID-Driven Behaviors: Rebuilt the physics behavior system to use simple IDs. We also changed sync behaviors to use clean, declarative callbacks.
• Activation State: Bodies now properly save and sync whether they are active or resting. Fixed an issue where some bodies were forced to be dynamic.

Performance & Sync

• Faster JNI Bridge: Optimized how we get AABBs on the client using Jolt shapes. We did this by batching JNI calls.
• Shape Caching: Added shape caching inside the JNI bridge. This fixes stuttering and lag when rendering or creating compound shapes.
• Smarter Persistence (TLV System): Built a high-performance persistence system using a custom schema (TLV format). It cleanly saves chunk data, behavior bits, and ignores collisions between specific pairs of bodies.
• Better Velocity Sync: Moved angular velocity (angVel) tracking to the main container and sync it directly to the client with a state packet.
• Rendering Optimization: Cached BoxColor values to speed up rendering loops.

Stonecutter Multi-Version Development

• Multi-Version Workspace: We now use Stonecutter to develop for both 1.20.1 and 1.21.1 simultaneously.
• Loader & Version Support: Fully set up Stonecutter branches to compile and export for both Forge and Fabric.
• Development Setup: Separated development run directories for each version and cleaned up IDE run configurations.

Bug Fixes & Code Cleanup

• Crash Fix: Fixed a dangerous race condition when removing bodies that caused a double-destruction crash.
• Null Shape Sync: Resolved a bug where null shapes would sometimes try to sync, causing errors.
• Event Library Update: Rewrote and restructured the internal vx-events library to make it cleaner and easier to maintain.
• Constraint Search: Added a method in VxConstraintManager to quickly find constraints using their UUID.

Build & CI (Development)

• Gradle Update: Upgraded Gradle to 9.4.1 and added the Foojay toolchain resolver.
• Smarter Workflows: Made GitHub Actions fully dynamic. Workflows now automatically build, test, and package artifacts for all target versions.
• Nightly Builds: Set up automatic Maven snapshot publishing for nightly workflows.
• Dependency Cleanups: Used modLocalRuntime to keep testing mods out of published files.

Changelog - Version 0.8.0

Native Migration: Terrain and Contact Systems

• Native C++ Port: Migrated the core terrain tracking and state management from Java to native C++ to achieve higher simulation fidelity and performance.
  • Native Greedy Meshing: Ported terrain generation to a native C++ greedy meshing implementation for faster collision shape creation.
  • Native Contact Architecture: Refactored the physics contact system into a modular dispatcher-based architecture in C++ with specialized handlers.
  • Native State Synchronization: Offloaded full physics state synchronization to a specialized JNI bridge to reduce Java-side overhead.
• Custom Terrain Collision Shapes: Replaced standard box-based terrain collision with a custom native shape system.
  • TerrainVoxelShape: Implemented a custom shape to support non-solid blocks (like glass and torches) and filter out internal face collisions.
  • Internal Edge Removal: Enabled enhanced internal edge removal for all bodies to prevent physics objects from catching on block boundaries.

Terrain Interactions and Mechanics

• Physics-Driven Interactions: Implemented dynamic interactions for doors, trapdoors, and fence gates that respond realistically to physical forces.
• Impact Effects: Added mass-proportional localized audio and particle effects triggered by physical terrain impacts.
• Dynamic Block Destruction: Implemented physics-based terrain impact reactions, including block destruction and material-based transformations.
• Per-Material Configuration: Introduced data-driven interaction thresholds and vanilla block weights for realistic physics simulation.
• Interaction Refinement: Increased door and trapdoor interaction thresholds and refined physical weight distribution for better stability.

Infrastructure and Dependencies

• Custom Jolt-JNI Fork: Transitioned to an internal vx-jolt-jni fork (v4.3.1-SNAPSHOT) to enable specialized native features, IDE source support, and optimized library naming.
• Modular Library Management: Implemented an explicit registry system and modularized native loader logic into a dedicated vx-native module.
• Automated JNI Generation: Implemented automatic JNI header generation to streamline the interface between the Java and C++ layers.
• Global Configuration: Centralized "magic" physics thresholds into a unified native GlobalConfig struct.

Performance and Networking

• Asynchronous Packet Dispatch: Moved packet dispatching off the server main thread to eliminate tick-wait latency.
• Adaptive Interpolation: Replaced fixed interpolation delays with an adaptive system based on measured packet intervals.
• Optimized Terrain Shapes: Utilized a data-oriented Y-axis sweep-and-prune algorithm to optimize terrain shape generation.
• Lock-Free Networking: Implemented lock-free network synchronization and broadcast-safe payload management.
• Concurrency Improvements: Optimized contact listener concurrency and terrain material caching to reduce thread contention.

Fixes and Refactors

• Shutdown Deadlocks: Resolved critical world shutdown deadlocks in the physics and terrain systems.
• Memory Safety: Fixed IllegalReferenceCountException by refactoring VxRawPayload to use byte arrays.
• Simulation Stability: Decoupled the Jolt lifecycle into VxPhysicsSimulation and resolved physics body tracking initialization issues.

Build and CI

• Reusable Pipelines: Refactored CI workflows into reusable pipelines with automated GitHub release publishing.
• Automated GameTests: Integrated NeoForge and Fabric GameTests into the CI pipeline to verify physics behavior before releases.
• Maven Integration: Implemented a generic Maven publishing system for artifact management.

Documentation

• Technical README: Fully rewritten README focusing on the technical architecture and native JNI implementation.
• API Documentation: Completed comprehensive Javadoc.

Changelog - Version 0.8.0

Native Migration: Terrain and Contact Systems

• Native C++ Port: Migrated the core terrain tracking and state management from Java to native C++ to achieve higher simulation fidelity and performance.
  • Native Greedy Meshing: Ported terrain generation to a native C++ greedy meshing implementation for faster collision shape creation.
  • Native Contact Architecture: Refactored the physics contact system into a modular dispatcher-based architecture in C++ with specialized handlers.
  • Native State Synchronization: Offloaded full physics state synchronization to a specialized JNI bridge to reduce Java-side overhead.
• Custom Terrain Collision Shapes: Replaced standard box-based terrain collision with a custom native shape system.
  • TerrainVoxelShape: Implemented a custom shape to support non-solid blocks (like glass and torches) and filter out internal face collisions.
  • Internal Edge Removal: Enabled enhanced internal edge removal for all bodies to prevent physics objects from catching on block boundaries.

Terrain Interactions and Mechanics

• Physics-Driven Interactions: Implemented dynamic interactions for doors, trapdoors, and fence gates that respond realistically to physical forces.
• Impact Effects: Added mass-proportional localized audio and particle effects triggered by physical terrain impacts.
• Dynamic Block Destruction: Implemented physics-based terrain impact reactions, including block destruction and material-based transformations.
• Per-Material Configuration: Introduced data-driven interaction thresholds and vanilla block weights for realistic physics simulation.
• Interaction Refinement: Increased door and trapdoor interaction thresholds and refined physical weight distribution for better stability.

Infrastructure and Dependencies

• Custom Jolt-JNI Fork: Transitioned to an internal vx-jolt-jni fork (v4.3.1-SNAPSHOT) to enable specialized native features, IDE source support, and optimized library naming.
• Modular Library Management: Implemented an explicit registry system and modularized native loader logic into a dedicated vx-native module.
• Automated JNI Generation: Implemented automatic JNI header generation to streamline the interface between the Java and C++ layers.
• Global Configuration: Centralized "magic" physics thresholds into a unified native GlobalConfig struct.

Performance and Networking

• Asynchronous Packet Dispatch: Moved packet dispatching off the server main thread to eliminate tick-wait latency.
• Adaptive Interpolation: Replaced fixed interpolation delays with an adaptive system based on measured packet intervals.
• Optimized Terrain Shapes: Utilized a data-oriented Y-axis sweep-and-prune algorithm to optimize terrain shape generation.
• Lock-Free Networking: Implemented lock-free network synchronization and broadcast-safe payload management.
• Concurrency Improvements: Optimized contact listener concurrency and terrain material caching to reduce thread contention.

Fixes and Refactors

• Shutdown Deadlocks: Resolved critical world shutdown deadlocks in the physics and terrain systems.
• Memory Safety: Fixed IllegalReferenceCountException by refactoring VxRawPayload to use byte arrays.
• Simulation Stability: Decoupled the Jolt lifecycle into VxPhysicsSimulation and resolved physics body tracking initialization issues.

Build and CI

• Reusable Pipelines: Refactored CI workflows into reusable pipelines with automated GitHub release publishing.
• Automated GameTests: Integrated NeoForge and Fabric GameTests into the CI pipeline to verify physics behavior before releases.
• Maven Integration: Implemented a generic Maven publishing system for artifact management.

Documentation

• Technical README: Fully rewritten README focusing on the technical architecture and native JNI implementation.
• API Documentation: Completed comprehensive Javadoc.

Changelog – Version 0.7.1

Features

• Body Protection: Added VxNoKillBehavior to protect specific physics bodies from administrative removal commands.

Fixes

• Multi-Player Sync & Memory Safety: Resolved an issue where network synchronization was restricted to a single player and fixed a buffer double-release bug through lock-free, broadcast-safe payload management.

Refactors

• API Consolidation: Unified internal body retrieval logic to remove redundant methods and streamline the client manager.

Build

• Dependency Update: Upgraded Jolt-JNI to version 4.0.1 and adapted to the latest API changes.

Changelog – Version 0.7.1

Features

• Body Protection: Added VxNoKillBehavior to protect specific physics bodies from administrative removal commands.

Fixes

• Multi-Player Sync & Memory Safety: Resolved an issue where network synchronization was restricted to a single player and fixed a buffer double-release bug through lock-free, broadcast-safe payload management.

Refactors

• API Consolidation: Unified internal body retrieval logic to remove redundant methods and streamline the client manager.

Build

• Dependency Update: Upgraded Jolt-JNI to version 4.0.1 and adapted to the latest API changes.