Helios Core

# ☀️ HeliosCore

Service Registry • Unified Storage • Live Web Dashboard • License Validation • Shared API

!(https://img.shields.io/badge/Helios-Ecosystem-F4A623?style=for-the-badge) !(https://img.shields.io/badge/Paper-1. 21.x_%7C_26. 1.x-blue?style=for-the-badge) !(https://img.shields.io/badge/Java-21-orange?style=for-the-badge) !(https://img.shields.io/badge/License-Premium-red?style=for-the-badge)

## 📖 Table of Contents

• [✨ Why HeliosCore?](#-why-helioscore)
• [📋 Requirements](#-requirements)
• [📥 Installation](#-installation)
• [🎮 Commands](#-commands)
• [🔐 Permissions](#-permissions)
• [🌐 Web Dashboard](#-web-dashboard)
• [⚙️ Configuration](#️-configuration)
• [🔌 Developer API](#-developer-api)
• [🚀 Quick-Start Examples](#-quick-start-examples)
• [❓ FAQ](#-faq)
• [💬 Support](#-support)

## ✨ Why HeliosCore?

> HeliosCore is required by every Helios plugin (HeliosAdmin, HeliosEconomy, HeliosChat, HeliosTab, NinezJobs, NinezSkills, NinezMarket, NinezGUI, NinezLogs, …). > Instead of every plugin re-implementing storage, permissions, messaging, and dashboards, HeliosCore provides them once — so your whole suite shares a single source of truth.

| 🧠 Service Registry | 💾 Unified Storage | 🔐 PermissionService | |:---|:---|:---| | Clean cross-plugin APIs | Yaml / SQLite / MySQL / MariaDB | Runtime registration with descriptions | | `CoreServices.require(...)` | Shared by every Helios plugin | LuckPerms / GroupManager friendly |

| 📜 AuditService | 🌐 Web Dashboard | 🪪 Licensing (WIP) | |:---|:---|:---| | Append-only audit log | HTTP + SSE host with token auth | One license check gates the suite | | Used by every plugin | Pluggable contributors | Soft-fails in offline grace mode |

> 🚧 Licensing is a work in progress. The License Server, key issuance, and runtime validation pipeline are still being finalized. HeliosCore currently runs in permanent offline grace mode — install and use the suite normally; the licensing layer will activate transparently in a future release.

✅ Adventure / MiniMessage native • PlaceholderAPI bridge • Vault adapter • bStats metrics

## 📋 Requirements

| Requirement | Version | |:-----------------|:-----------------------------------------------------| | Minecraft | `1. 21.x` • `26. 1.x` (native & tested) | | Server | Paper / Purpur (Spigot not officially supported) | | Java | `21+` | | Soft-depends | Vault • PlaceholderAPI • LuckPerms (all optional) |

> 🔌 HeliosCore loads before all Helios plugins automatically (`loadbefore` directive).

## 📥 Installation

```text 1. Drop HeliosCore-x.y.z.jar → plugins/ 2. Start the server (config & data folder auto-generate) 3. Run /hcore setup (creates one-time dashboard owner link — REQUIRED) 4. Open the link printed in console → set username + password in your browser 5. (Optional) Edit plugins/HeliosCore/config.yml for storage, dashboard, license 6. Run /hcore reload 7. Install other Helios plugins — they register into HeliosCore automatically ```

> ⚠️ `/hcore setup` is required. Until you run it and complete owner setup, the dashboard refuses logins.

## 🎮 Commands

> Aliases: `/hcore` • `/helioscore` • `/ncore` • `/ninezcore`

| Command | Description | Permission | |:-----------------------|:--------------------------------------------------------|:---------------------------------| | `/hcore` | Show plugin status & loaded services | — | | `/hcore about` | Framework information & version | `helioscore.command.about` | | `/hcore reload` | Reload framework configs and database settings | `helioscore.command.reload` | | `/hcore services` | List loaded services and their owning plugins | `helioscore.command.services` | | `/hcore database` | Inspect / test the configured database backend | `helioscore.command.database` | | `/hcore dashboard` | View dashboard status and access URL | `helioscore.command.dashboard` | | `/hcore doctor` | Run diagnostic health checks on the entire ecosystem | `helioscore.command.doctor` | | `/hcore update` | Check & apply ecosystem plugin updates | `helioscore.command.update` | | `/hcore setup` | Generate a one-time setup link for the dashboard owner | `helioscore.command.setup` | | `/hcore register` | Generate a one-time registration link for staff users | `helioscore.command.register` |

## 🔐 Permissions

HeliosCore uses a clean, hierarchical permission tree that drops strai