feat: support VirtualEntities across Spigot, Paper, and Folia

.github/workflows/maven.yml

@@ -16,7 +16,6 @@ on:
 
 jobs:
   build:
-
     runs-on: ubuntu-latest
 
     steps:
@@ -33,4 +32,59 @@ jobs:
         uses: actions/upload-artifact@v7
         with:
           name: DebugStickPro
-          path: target/*.jar
+          path: target/DebugStickPro-0.5.3.jar
+
+  runtime-test:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: paper
+            minecraft: 1.19.4
+            java: 17
+            mode: mineflayer
+          - platform: folia
+            minecraft: 1.19.4
+            java: 17
+            mode: mineflayer
+          - platform: paper
+            minecraft: '26.2'
+            java: 25
+            mode: startup
+          - platform: folia
+            minecraft: '26.2'
+            java: 25
+            mode: startup
+
+    name: ${{ matrix.platform }} ${{ matrix.minecraft }}
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up JDK ${{ matrix.java }}
+        uses: actions/setup-java@v5
+        with:
+          java-version: ${{ matrix.java }}
+          distribution: temurin
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: integration/mineflayer/package-lock.json
+      - name: Download plugin JAR
+        uses: actions/download-artifact@v8
+        with:
+          name: DebugStickPro
+          path: target
+      - name: Cache test servers
+        uses: actions/cache@v5
+        with:
+          path: ~/.cache/debugstickpro-e2e
+          key: debugstickpro-${{ matrix.platform }}-${{ matrix.minecraft }}
+      - name: Run server integration test
+        env:
+          DSP_E2E_PLATFORM: ${{ matrix.platform }}
+          DSP_E2E_VERSION: ${{ matrix.minecraft }}
+          DSP_E2E_MODE: ${{ matrix.mode }}
+        run: integration/mineflayer/run-server-e2e.sh

.gitignore

@@ -96,6 +96,7 @@ $RECYCLE.BIN/
 *.lnk
 
 target/
+node_modules/
 
 pom.xml.tag
 pom.xml.releaseBackup

README.md

@@ -7,7 +7,12 @@
 
 > **⚠️ v0.5.0+ Requirement**: This plugin now requires [PacketEvents](https://github.com/retrooper/packetevents) to function properly. Please install PacketEvents before using v0.5.0+.
 
-> Support for Paper 26.2+
+> Supports Spigot, Paper, and Folia from Minecraft 1.19.4 through 26.2. Paper is the primary platform.
+
+The compatibility matrix is exercised against both ends of the supported range.
+Mineflayer verifies commands, MiniMessage item output, and VirtualEntities display
+spawn/removal on 1.19.4; 26.2 receives startup and plugin-enable tests because
+Mineflayer does not yet support that protocol.
 ---
 ## Features:
 ### Dynamically display block data:
@@ -32,10 +37,10 @@
 - **🔧 Packet-Based Block Freezing**: Complete rewrite using PacketEvents for client-side visual effects
 - **👻 Ghost-Free Experience**: No more server-side `BARRIER` blocks - smoother and cleaner freeze operations
 - **⚡ Enhanced Performance**: Improved freeze/unfreeze logic with better cleanup and tracking
-- **🧹 Simplified Architecture**: Modernized codebase with PacketEvents and EntityLib integration
+- **🧹 Simplified Architecture**: Modernized codebase with PacketEvents and VirtualEntities integration
 
 ### **Technical Improvements**
-- **New Dependencies**: PacketEvents 2.9.4 and EntityLib integration
+- **New Dependencies**: PacketEvents 2.13.0 and VirtualEntities integration
 - **API Modernization**: Updated to use standard Bukkit enums for better compatibility  
 - **Better Physics Handling**: Enhanced BlockPhysicsEventListener for improved freeze functionality
 - **Advanced Tracking**: Sophisticated duplicate prevention and state management
@@ -107,10 +112,14 @@ Same as regular debugging stick operation:
 ## How to install:
 
 ### Requirements
-- **Java 25** or higher
-- **Paper 26.2+**
+- **Java 17-20** for legacy 1.19.4 servers, or the Java version required by your server release
+- **JDK 25** to build DebugStickPro (the published JAR targets Java 17 for the full server range)
+- **Spigot, Paper, or Folia 1.19.4-26.2** (Paper is recommended)
 - **[PacketEvents](https://github.com/retrooper/packetevents) 2.13.0+** (Required for v0.5.0+)
 
+Spigot builds are tested locally with the official BuildTools. Paper and Folia
+endpoint tests run for every pull request.
+
 ### Installation Steps
 1. Install [PacketEvents](https://github.com/retrooper/packetevents) if not already installed
 2. Download the latest version of DebugStickPro from the [release page](https://github.com/TWME-TW/DebugStickPro/releases)