dmg/spigot-tree-feller
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 5 Wiki Activity

test(docker): add local Spigot test server
CI / build (push) Successful in 1m18s
Details
Release / release (push) Successful in 1m56s
Details

Browse Source
This commit is contained in:
dmg
2026-08-11 17:47:26 -04:00
parent 5d1577175f
commit 2e6fdb4e5b
7 changed files with 183 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+34
View File
@@ -17,6 +17,40 @@ The approved behavior and implementation record are in the [OKF design bundle](d
The plugin JAR is written to `build/libs/`.
## Local Docker test server
Build the current plugin and start it on an isolated Spigot 26.2 server:
```bash
./scripts/start-test-server.sh
```
Connect to `localhost:25565` as `WindMagi`, which the harness configures as an operator. The server uses offline mode for local convenience and binds only to the loopback interface.
The first startup may take several minutes while the image downloads and Spigot is prepared. Override the 15-minute wait or local RCON password when needed:
```bash
TREE_FELLER_START_TIMEOUT=1200 \
TREE_FELLER_RCON_PASSWORD='local-secret' \
./scripts/start-test-server.sh
```
Common lifecycle commands:
```bash
# Follow server logs
docker compose -f compose.test.yml logs -f minecraft
# Stop while preserving the world and server configuration
docker compose -f compose.test.yml down
# Stop and permanently reset all generated local test state
docker compose -f compose.test.yml down
rm -rf .docker/minecraft
```
Re-run the start script after code changes to rebuild the JAR and recreate the test container. Generated server state remains under `.docker/minecraft/` and is ignored by Git.
## Player commands
```text