Files
spigot-tree-feller/design/user-stories/us-010-run-local-docker-test-server.md
T
dmg 2e6fdb4e5b
CI / build (push) Successful in 1m18s
Release / release (push) Successful in 1m56s
test(docker): add local Spigot test server
2026-08-11 17:47:26 -04:00

1.7 KiB

type, title, description, status
type title description status
User Story US-010: Run a local Docker test server Provide a repeatable Docker Compose harness that builds and loads Tree Feller on an isolated Spigot 26.2 server. done

US-010: Run a local Docker test server

As a plugin developer, I want one command to run the current Tree Feller build on a local containerized server so that I can perform repeatable integration and gameplay testing.

Acceptance criteria

  • One repository script builds and verifies the plugin before starting an isolated Spigot 26.2 server through Docker Compose.
  • The current Tree Feller JAR is mounted into the server automatically whenever the container is recreated.
  • WindMagi is configured and verified as a server operator.
  • The Minecraft port binds only to 127.0.0.1:25565 by default.
  • Startup waits for server health and verifies Tree Feller through RCON.
  • Generated worlds, logs, configuration, and downloaded server artifacts are stored under .docker/minecraft/ and excluded from Git.
  • Stopping Compose preserves generated test state unless the operator explicitly deletes it.
  • Existing unrelated containers are not modified.
  • Maintainer documentation explains start, logs, stop, reset, timeout, and RCON-password controls.

Scope

This harness is for local development only. It does not define production deployment, publish an image, expose Minecraft or RCON publicly, or persist its runtime state in Git.