1. Maven Prepare Phase
lightkeeper:prepare-server resolves platform build metadata, server binaries, and agent artifact.
These guides describe the current master build. Select a release in the API Reference for released APIs.
Architecture
Provisioning pipeline + test-runtime API layers.
A quick map of how Maven, server runtime, agent, and JUnit framework components interact.
Execution flow
2. Cache Resolution
Jar/base-server caches are checked with keys that include platform/version/build, Java/OS, protocol, and agent identity.
3. Server Assembly
Worlds, plugins, and overlay files are installed into the target server work directory.
4. Runtime Manifest Emission
Manifest captures server path, jar path, UDS socket path, auth token, and preloaded world metadata.
5. Test Execution
LightkeeperExtension starts framework sessions from runtime manifest and injects ILightkeeperFramework.
6. Optional Cleanup
lightkeeper:cleanup-server reads failsafe summary and removes target server folders when configured and successful.
Module responsibilities
lightkeeper-maven-plugin: provisioning, caching, runtime manifest creation, cleanuplightkeeper-runtime-core: runtime manifests and cross-process constantslightkeeper-agent-spigot: in-server command execution and data collectionlightkeeper-framework-junit: user-facing handles, extension lifecycle, assertionslightkeeper-protocol: typed commands, responses, and shared valueslightkeeper-nms-parent: version-specific internals for low-level behaviorlightkeeper-integration-tests: full integration test matrix for supported platforms
For implementation details, read module package docs and integration tests in this repository.