PhysicsStore migration

.cargo/config.toml

@@ -1,2 +1,2 @@
 [patch.crates-io]
-rapier3d = { path = "impulse-rapier/src/main/rust/target/impulse-patched/rapier3d-0.32.0-impulse" }
+rapier3d = { path = "impulse-backends/rapier/src/main/rust/target/impulse-patched/rapier3d-0.32.0-impulse" }

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -34,11 +34,11 @@ body:
       label: Validation already run
       placeholder: "./gradlew headlessTest"
   - type: textarea
-    id: crucible-test
+    id: runtime-reproduction
     attributes:
-      label: Crucible reproduction
-      description: If this is a runtime/server bug, include the failing Crucible test or describe the test case that should be added.
-      placeholder: "Example: add a focused Crucible smoke that unloads/reloads the affected plugin after spawning the failing entity state."
+      label: Runtime reproduction
+      description: If this is a runtime/server bug, include the focused regression test or describe the manual runAllMods scenario.
+      placeholder: "Example: runAllMods, create space --backend=impulse:rapier, spawn the failing entity state, then unload/reload the affected plugin."
   - type: textarea
     id: logs
     attributes:

.github/workflows/backend-artifacts.yml

@@ -7,6 +7,66 @@ permissions:
   contents: read
 
 jobs:
+  jolt-native:
+    name: Jolt native ${{ matrix.platform }}
+    runs-on: ${{ matrix.runner }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: linux-x86_64
+            runner: ubuntu-22.04
+            resource-path: linux/x86_64
+            library: libimpulse_jolt.so
+            gradle-command: ./gradlew :impulse-backends:jolt:stageJoltNativeResource
+          - platform: linux-arm64
+            runner: ubuntu-24.04-arm
+            resource-path: linux/arm64
+            library: libimpulse_jolt.so
+            gradle-command: ./gradlew :impulse-backends:jolt:stageJoltNativeResource
+          - platform: osx-arm64
+            runner: macos-15
+            resource-path: osx/arm64
+            library: libimpulse_jolt.dylib
+            gradle-command: ./gradlew :impulse-backends:jolt:stageJoltNativeResource
+          - platform: windows-x86_64
+            runner: windows-2025
+            resource-path: windows/x86_64
+            library: impulse_jolt.dll
+            gradle-command: ./gradlew.bat :impulse-backends:jolt:stageJoltNativeResource
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Java 25
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '25'
+
+      - name: Set up Gradle cache
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Build Jolt native resource
+        shell: bash
+        run: ${{ matrix.gradle-command }}
+
+      - name: Stage Jolt native artifact
+        shell: bash
+        run: |
+          artifact_dir="jolt-native-artifact/native/${{ matrix.resource-path }}"
+          mkdir -p "$artifact_dir"
+          cp "impulse-backends/jolt/build/generated/jolt-native/native/${{ matrix.resource-path }}/${{ matrix.library }}" "$artifact_dir/"
+
+      - name: Upload Jolt native resource
+        uses: actions/upload-artifact@v4
+        with:
+          name: jolt-native-${{ matrix.platform }}
+          path: jolt-native-artifact
+          if-no-files-found: error
+
   rapier-native:
     name: Rapier native ${{ matrix.platform }}
     runs-on: ${{ matrix.runner }}
@@ -20,25 +80,25 @@ jobs:
             rust-target: x86_64-unknown-linux-gnu
             resource-path: linux/x86_64
             library: libimpulse_rapier.so
-            gradle-command: ./gradlew :impulse-rapier:stageRapierNativeResource
+            gradle-command: ./gradlew :impulse-backends:rapier:stageRapierNativeResource
           - platform: linux-arm64
             runner: ubuntu-24.04-arm
             rust-target: aarch64-unknown-linux-gnu
             resource-path: linux/arm64
             library: libimpulse_rapier.so
-            gradle-command: ./gradlew :impulse-rapier:stageRapierNativeResource
+            gradle-command: ./gradlew :impulse-backends:rapier:stageRapierNativeResource
           - platform: osx-arm64
             runner: macos-15
             rust-target: aarch64-apple-darwin
             resource-path: osx/arm64
             library: libimpulse_rapier.dylib
-            gradle-command: ./gradlew :impulse-rapier:stageRapierNativeResource
+            gradle-command: ./gradlew :impulse-backends:rapier:stageRapierNativeResource
           - platform: windows-x86_64
             runner: windows-2025
             rust-target: x86_64-pc-windows-msvc
             resource-path: windows/x86_64
             library: impulse_rapier.dll
-            gradle-command: ./gradlew.bat :impulse-rapier:stageRapierNativeResource
+            gradle-command: ./gradlew.bat :impulse-backends:rapier:stageRapierNativeResource
 
     steps:
       - name: Check out repository
@@ -69,7 +129,7 @@ jobs:
         run: |
           artifact_dir="rapier-native-artifact/native/${{ matrix.resource-path }}"
           mkdir -p "$artifact_dir"
-          cp "impulse-rapier/build/generated/rapier-native/native/${{ matrix.resource-path }}/${{ matrix.library }}" "$artifact_dir/"
+          cp "impulse-backends/rapier/build/generated/rapier-native/native/${{ matrix.resource-path }}/${{ matrix.library }}" "$artifact_dir/"
 
       - name: Upload Rapier native resource
         uses: actions/upload-artifact@v4
@@ -81,7 +141,9 @@ jobs:
   backend-jars:
     name: Backend provider jars
     runs-on: ubuntu-24.04
-    needs: rapier-native
+    needs:
+      - jolt-native
+      - rapier-native
 
     steps:
       - name: Check out repository
@@ -100,26 +162,47 @@ jobs:
         uses: actions/download-artifact@v4
         with:
           pattern: rapier-native-*
-          path: impulse-rapier/build/ci/rapier-native-downloads
+          path: impulse-backends/rapier/build/ci/rapier-native-downloads
+
+      - name: Download Jolt native resources
+        uses: actions/download-artifact@v4
+        with:
+          pattern: jolt-native-*
+          path: impulse-backends/jolt/build/ci/jolt-native-downloads
 
       - name: Normalize Rapier native resource tree
         shell: bash
         run: |
-          mkdir -p impulse-rapier/build/ci/rapier-native/native
-          for dir in impulse-rapier/build/ci/rapier-native-downloads/rapier-native-*; do
+          mkdir -p impulse-backends/rapier/build/ci/rapier-native/native
+          for dir in impulse-backends/rapier/build/ci/rapier-native-downloads/rapier-native-*; do
             if [ -d "$dir/native" ]; then
-              cp -R "$dir/native/." impulse-rapier/build/ci/rapier-native/native/
+              cp -R "$dir/native/." impulse-backends/rapier/build/ci/rapier-native/native/
             else
-              cp -R "$dir/." impulse-rapier/build/ci/rapier-native/native/
+              cp -R "$dir/." impulse-backends/rapier/build/ci/rapier-native/native/
             fi
           done
-          find impulse-rapier/build/ci/rapier-native/native -type f | sort
+          find impulse-backends/rapier/build/ci/rapier-native/native -type f | sort
+
+      - name: Normalize Jolt native resource tree
+        shell: bash
+        run: |
+          mkdir -p impulse-backends/jolt/build/ci/jolt-native/native
+          for dir in impulse-backends/jolt/build/ci/jolt-native-downloads/jolt-native-*; do
+            if [ -d "$dir/native" ]; then
+              cp -R "$dir/native/." impulse-backends/jolt/build/ci/jolt-native/native/
+            else
+              cp -R "$dir/." impulse-backends/jolt/build/ci/jolt-native/native/
+            fi
+          done
+          find impulse-backends/jolt/build/ci/jolt-native/native -type f | sort
 
       - name: Build backend provider jars
         run: >
           ./gradlew packageBackendPlatformJars
+          -PbuildJoltNative=false
+          -Pimpulse.joltNativeResourceRoot=${{ github.workspace }}/impulse-backends/jolt/build/ci/jolt-native
           -PbuildRapierNative=false
-          -Pimpulse.rapierNativeResourceRoot=${{ github.workspace }}/impulse-rapier/build/ci/rapier-native
+          -Pimpulse.rapierNativeResourceRoot=${{ github.workspace }}/impulse-backends/rapier/build/ci/rapier-native
 
       - name: Write artifact notice
         shell: bash
@@ -129,7 +212,9 @@ jobs:
 
           These backend provider jars may include third-party native binaries so Impulse can load the backend at runtime.
 
-          They are convenience packages for Impulse plugins and are not the official upstream distribution channel for those native libraries. Download standalone Bullet/Libbulletjme or Rapier binaries from their upstream projects instead.
+          They are convenience packages for Impulse plugins and are not the official upstream distribution channel for those native libraries. Download standalone Rapier binaries from its upstream project instead.
+
+          Jolt backend jars include binaries built from upstream Jolt Physics source for Impulse's native ABI.
 
           See LICENSE and licenses/ in this artifact for packaged license notices.
           EOF
@@ -141,16 +226,16 @@ jobs:
           path: |
             BACKEND_ARTIFACT_NOTICE.md
             LICENSE
-            licenses/LIBBULLETJME_LICENSE
+            licenses/JOLT_PHYSICS_LICENSE
             licenses/RAPIER_RUST_BACKEND_LICENSES
-            impulse-bullet/build/libs/impulse-bullet-*-linux-x86_64.jar
-            impulse-bullet/build/libs/impulse-bullet-*-linux-arm64.jar
-            impulse-bullet/build/libs/impulse-bullet-*-osx-arm64.jar
-            impulse-bullet/build/libs/impulse-bullet-*-windows-x86_64.jar
-            impulse-bullet/build/libs/impulse-bullet-*-universal.jar
-            impulse-rapier/build/libs/impulse-rapier-*-linux-x86_64.jar
-            impulse-rapier/build/libs/impulse-rapier-*-linux-arm64.jar
-            impulse-rapier/build/libs/impulse-rapier-*-osx-arm64.jar
-            impulse-rapier/build/libs/impulse-rapier-*-windows-x86_64.jar
-            impulse-rapier/build/libs/impulse-rapier-*-universal.jar
+            impulse-backends/jolt/build/libs/impulse-backend-jolt-*-linux-x86_64.jar
+            impulse-backends/jolt/build/libs/impulse-backend-jolt-*-linux-arm64.jar
+            impulse-backends/jolt/build/libs/impulse-backend-jolt-*-osx-arm64.jar
+            impulse-backends/jolt/build/libs/impulse-backend-jolt-*-windows-x86_64.jar
+            impulse-backends/jolt/build/libs/impulse-backend-jolt-*-universal.jar
+            impulse-backends/rapier/build/libs/impulse-backend-rapier-*-linux-x86_64.jar
+            impulse-backends/rapier/build/libs/impulse-backend-rapier-*-linux-arm64.jar
+            impulse-backends/rapier/build/libs/impulse-backend-rapier-*-osx-arm64.jar
+            impulse-backends/rapier/build/libs/impulse-backend-rapier-*-windows-x86_64.jar
+            impulse-backends/rapier/build/libs/impulse-backend-rapier-*-universal.jar
           if-no-files-found: error

CONTRIBUTING.md

@@ -16,7 +16,8 @@ Open an issue or design discussion before changing architecture, persistence, li
 backend runtime contracts, public API packages or native artifact packaging.
 
 For bug reports, include a clear reproduction path and logs. When the bug depends on Hytale server
-runtime behavior, also try to add or propose a failing Crucible test so that it can be reproduced in-game. 
+runtime behavior, also try to add or propose a focused JUnit/headless regression test, or document
+the `runAllMods` world setup and commands needed to reproduce it.
 
 ## AI-Assisted Contributions
 
@@ -67,8 +68,9 @@ Runtime/server behavior should be checked with:
 ./gradlew runAllMods
 ```
 
-When a runtime bug is fixed, prefer adding a focused Crucible test that reproduces the failing
-server behavior.
+When a runtime bug is fixed, prefer adding a focused module test that reproduces the failing
+behavior. If the bug only exists in a live Hytale server loop, document the manual `runAllMods`
+scenario used for validation.
 
 Backend-specific changes should name the backend used for validation, such as `impulse:bullet` or
-`impulse:rapier`.
+`impulse:rapier`.