These guides describe the current master build. Select a release in the API Reference for released APIs.

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

Select platform via serverType. Spigot runtimes are built via BuildTools and cached.

Separates jar cache and base-server cache, minimizing repeated setup cost in CI and local loops.

Tests consume a runtime manifest so setup and execution phases stay cleanly separated.

Auto-delete target server directories on success using failsafe summary checks.

Create worlds and read/write blocks through WorldHandle.

Create synthetic players with fluent builders, permissions, positioning, and health settings.

Open, click, drag, wait, and verify inventory menu state via MenuHandle.

World/menu/player assertions including message text checks with full AssertJ string chaining.

Reach functionality through framework.server(), framework.worlds(), framework.bots(), and framework.events().

Prepare a persistent runtime once, then run tests from the IDE gutter.
Stop, start, restart, or crash a server; inspect its directory and captured server errors.
Use safe synthetic bots by default, or select full-login bots to test the real loopback login path.
Change permissions at runtime, query command completions, and inspect or click chat components.
Query blocks and entities, capture events, inspect interaction outcomes, and retry live assertions with eventually().

Menu actions wait for an open menu. Use the API Reference for available handles and assertions.