1. Maven Prepare Phase
lightkeeper:prepare-server resolves platform build metadata, server binaries, and agent artifact.
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: manifest and protocol contractslightkeeper-agent-paper: in-server command execution and data collectionlightkeeper-framework-junit: user-facing handles, extension lifecycle, assertionslightkeeper-nms-parent: version-specific internals for low-level behaviorlightkeeper-maven-plugin-test: full integration test matrix for supported platforms