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.

Privacy

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