GnustellaCore

GnustellaCore is the foundation plugin for the gnustella-lab ecosystem. It gives server administrators a small, auditable Paper plugin that provides ecosystem identity, health diagnostics, and a shared service registry for future lab plugins.

The plugin is intentionally minimal. It does not add gameplay mechanics, store player data, contact remote services, run telemetry, or require external runtime dependencies. Its job is to give future gnustella-lab plugins a stable place to announce themselves and expose health information.

## Features

• `/gnustella about` shows ecosystem and plugin version information.
• `/gnustella plugins` lists registered gnustella-lab plugins.
• `/gnustella status` reports registered health checks.
• `/gnustella reload` reloads the plugin configuration.
• `LabRegistry` lets future lab plugins register descriptors and health checks through Bukkit services.
• `LabRegistryReadyEvent` lets plugins react when the ecosystem registry is available.

## Compatibility

• Built for Paper API `26. 1. 2`.
• Requires Java 25.
• Folia, Bukkit, and Spigot compatibility are not claimed yet.

## Installation

1. Stop your Paper server. 2. Place the GnustellaCore JAR in the `plugins/` directory. 3. Start the server. 4. Optionally edit `plugins/GnustellaCore/config.yml`. 5. Run `/gnustella status`.

## Permissions

• `gnustella.core.command`: Allows use of the base `/gnustella` command. Defaults to everyone.
• `gnustella.core.status`: Allows viewing health diagnostics. Defaults to operators.
• `gnustella.core.reload`: Allows reloading configuration. Defaults to operators.

GnustellaCore does not include telemetry and does not make remote network calls.