Helios Admin

<div align="center"> # 🛡️ HeliosAdmin *Moderation • Player Management • Homes & Warps • Kits • World Backups • Live Web Dashboard* !(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) </div> --- ## 📖 Table of Contents - (#-why-heliosadmin) - (#-requirements) - (#-installation) - (#-commands) - (#-permissions) - (#-web-dashboard) - (#️-configuration) - (#-quick-start-examples) - (#-faq) - (#-support) --- ## ✨ Why HeliosAdmin? > HeliosAdmin replaces **5–6 separate plugins** (essentials, ban systems, homes/warps, kits, backups) with **one unified plugin** that shares data, permissions, audit logs, and storage with every other Helios plugin via (#). | 🛡️ Moderation | 🧰 Player Tools | 🏠 QoL | 💾 Server Ops | |:---|:---|:---|:---| | Bans, mutes, IP bans | Freeze, heal, feed, fly, god | Homes, warps, spawn | Live web dashboard | | Tempbans & tempmutes | Gamemode, vanish, speed | TPA / TPAHere | World backups + restore | | Warnings & history | Invsee, ecsee, bring, goto | Kits | Audit log streaming | | Punishment audit log | Whois, broadcast, kick | Customisable cooldowns | Hot reload | ✅ Drop-in replacement for EssentialsX • LuckPerms-ready • Adventure / MiniMessage native --- ## 📋 Requirements | Requirement | Version | |:--------------|:-----------------------------------------------------| | **Minecraft** | `1.21.x` • `26.1.x` (native & tested) | | **Server** | **Paper** / **Purpur** *(Spigot not officially supported)* | | **Java** | `21+` | | **HeliosCore**| **Latest** *(required dependency)* | > ⚠️ **HeliosCore is required.** HeliosAdmin will not start without it. After installing HeliosCore for the first time, you **must** run `/hcore setup` before HeliosAdmin's dashboard features will work. --- ## 📥 Installation ```text 1. Drop HeliosCore-x.y.z.jar → plugins/ 2. Drop HeliosAdmin-x.y.z.jar → plugins/ 3. Start the server (data folders & configs auto-generate) 4. Run /hcore setup (initialise dashboard owner — REQUIRED) 5. Edit plugins/HeliosAdmin/config.yml to taste 6. Run /hadmin reload 7. (Optional) Configure your permission plugin — see Permissions below ``` That's it. Every command and permission node is registered automatically. --- ## 🎮 Commands > **Aliases:** `/hadmin` • `/ha` • `/nadmin` • `/na` • `/heliosadmin` • `/ninezadmin` <details open> <summary><b>🛠️ Root Command</b></summary> | Command | Description | Permission | |:-----------------------|:-------------------------------------|:------------------------------| | `/hadmin guide` | Open the inventory command browser | `heliosadmin.command.guide` | | `/hadmin menu` | Open the admin GUI menu | `heliosadmin.command.menu` | | `/hadmin reload` | Reload Helios Admin config & storage | `heliosadmin.command.reload` | | `/hadmin storage` | View / test the storage backend | `heliosadmin.command.storage` | | `/hadmin audit ` | View recent audit log entries | `heliosadmin.command.audit` | </details> <details open> <summary><b>⚖️ Moderation</b></summary> | Command | Description | Permission | |:-------------------------------------------------|:-----------------------------|:------------------------------------| | `/hadmin ban <player> ` | Permanently ban | `heliosadmin.command.ban` | | `/hadmin tempban <player> <duration> ` | Temporarily ban | `heliosadmin.command.tempban` | | `/hadmin unban <player>` | Remove an active ban | `heliosadmin.command.unban` | | `/hadmin ipban <player\|ip> ` | Ban a player's IP | `heliosadmin.command.ipban` | | `/hadmin ipunban <ip>` | Remove an IP ban | `heliosadmin.command.ipunban` | | `/hadmin mute <player> ` | Permanently mute | `heliosadmin.command.mute` | | `/hadmin tempmute <player> <duration> ` | Temporarily mute | `heliosadmin.command.tempmute` | | `/hadmin unmute <player>` | Remove an active mute | `heliosadmin.command.unmute` | | `/hadmin warn <player> <reason>` | Is