Paper + Spigot support
Select platform via serverType. Spigot runtimes are built via BuildTools and cached.
Feature Overview
Everything needed for production-grade plugin E2E tests.
LightKeeper focuses on deterministic setup, realistic runtime behavior, and developer-friendly test APIs.
Server Runtime Provisioning
Cache-aware startup
Separates jar cache and base-server cache, minimizing repeated setup cost in CI and local loops.
Manifest-based runtime handoff
Tests consume a runtime manifest so setup and execution phases stay cleanly separated.
Configurable cleanup
Auto-delete target server directories on success using failsafe summary checks.
Test Framework API
World handles
Create worlds and read/write blocks through WorldHandle.
Player bots
Create synthetic players with fluent builders, permissions, positioning, and health settings.
Menu interaction
Open, click, drag, wait, and verify inventory menu state via MenuHandle.
AssertJ integration
World/menu/player assertions including message text checks with full AssertJ string chaining.
Provisioning Features
- World sources from folders or archives
- Plugin sources from local paths or Maven coordinates
- Optional transitive plugin resolution
- Server config overlays copied into prepared server directories
- World startup preload metadata captured in runtime manifest