Files
spigot-tree-feller/design/user-stories/us-010-run-local-docker-test-server.md
T
dmg 904faf1832
Release / release (push) Successful in 2m18s
CI / build (push) Successful in 1m21s
fix(docker): use WindMagi offline operator UUID
2026-08-11 18:25:23 -04:00

1.8 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 at operator level 4 using the deterministic offline-mode UUID 6a3b6e9f-1a2f-380c-8a75-7a7ca6392c0e.
  • 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.