✨ Why HeliosAdmin?

• ️ Moderation — bans, tempbans, mutes, IP bans, warnings, full punishment history
• Player Tools — freeze, heal, feed, fly, god, gamemode, vanish, invsee, ecsee, bring, goto, whois, broadcast, kick
• Quality-of-Life — homes, warps, spawn, TPA, kits with cooldowns and warm-ups
• Server Operations — world backups (create, list, delete, restore), audit log streaming, hot reload
• Live Web Dashboard — control the server from your browser
• Permission Plugin Ready — every node declared with descriptions and sensible defaults

✅ Drop-in replacement for EssentialsX • LuckPerms-ready • Adventure / MiniMessage native
Requirements

• Minecraft: 1.21.x + 26.1.x
• 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
That's it. Every command and permission node is registered automatically.
Commands
Aliases: /hadmin • /ha • /nadmin • /na • /heliosadmin • /ninezadmin
️ Root Command

• /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 [n] — View recent audit log entries (heliosadmin.command.audit)

⚖️ Moderation

• /hadmin ban <player> [reason] — Permanently ban (heliosadmin.command.ban)
• /hadmin tempban <player> <duration> [reason] — Temporarily ban (heliosadmin.command.tempban)
• /hadmin unban <player> — Remove an active ban (heliosadmin.command.unban)
• /hadmin ipban <player|ip> [reason] — Ban a player's IP (heliosadmin.command.ipban)
• /hadmin ipunban <ip> — Remove an IP ban (heliosadmin.command.ipunban)
• /hadmin mute <player> [reason] — Permanently mute (heliosadmin.command.mute)
• /hadmin tempmute <player> <duration> [reason] — Temporarily mute (heliosadmin.command.tempmute)
• /hadmin unmute <player> — Remove an active mute (heliosadmin.command.unmute)
• /hadmin warn <player> <reason> — Issue a warning (heliosadmin.command.warn)
• /hadmin warnings <player> — View warnings (heliosadmin.command.warnings)
• /hadmin clearwarnings <player> — Clear all warnings (heliosadmin.command.clearwarnings)
• /hadmin history <player> — Full punishment history (heliosadmin.command.history)
• /hadmin kick <player> [reason] — Kick a player (heliosadmin.command.kick)

Player Management

• /hadmin freeze <player> — Freeze / unfreeze (heliosadmin.command.freeze)
• /hadmin heal [player] — Restore full health (heliosadmin.command.heal)
• /hadmin feed [player] — Restore hunger (heliosadmin.command.feed)
• /hadmin fly [player] — Toggle flight (heliosadmin.command.fly)
• /hadmin god [player] — Toggle damage immunity (heliosadmin.command.god)
• /hadmin gamemode <mode> [player] — Change gamemode (heliosadmin.command.gamemode)
• /hadmin speed <walk|fly> <0–10> [player] — Adjust speed (heliosadmin.command.speed)
• /hadmin invsee <player> — Open another's inventory (heliosadmin.command.invsee)
• /hadmin ecsee <player> — Open another's ender chest (heliosadmin.command.ecsee)
• /hadmin bring <player> — Teleport player to you (heliosadmin.command.bring)
• /hadmin goto <player> — Teleport to a player (heliosadmin.command.goto)
• /hadmin vanish [player] — Toggle vanish (heliosadmin.command.vanish)
• /hadmin whois <player> — Detailed player info (heliosadmin.command.whois)
• /hadmin broadcast <message> — Server-wide announcement (heliosadmin.command.broadcast)

World Backups

• /hadmin backup create <world> [label] — Create a labelled backup
• /hadmin backup list — List all backups
• /hadmin backup delete <filename> — Delete a backup
• /hadmin backup restore <filename> — Restore a backup (unload world first)

All backup commands use heliosadmin.command.backup.
Player QoL Commands

• /sethome [name] — Save current location as a home (heliosadmin.home.set)
• /home [name] — Teleport to a saved home (heliosadmin.home.use)
• /delhome <name> — Delete a home (heliosadmin.home.set)
• /homes — List your saved homes (heliosadmin.home.use)
• /setwarp <name> — Create / update a server warp (heliosadmin.warp.manage)
• /warp <name> — Teleport to a warp (heliosadmin.warp.use)
• /delwarp <name> — Delete a warp (heliosadmin.warp.manage)
• /warps — List server warps (heliosadmin.warp.use)
• /setspawn — Set server spawn (heliosadmin.command.setspawn)
• /spawn — Teleport to server spawn (heliosadmin.spawn.use)
• /tpa <player> — Request to teleport to a player (heliosadmin.tpa)
• /tpahere <player> — Request a player teleport to you (heliosadmin.tpa)
• /tpaccept — Accept a pending request (heliosadmin.tpa)
• /tpdeny — Deny a pending request (heliosadmin.tpa)
• /kit [name] — Claim a kit (heliosadmin.kit.use)
• /hadmin kit <create|delete|edit> — Manage kits (heliosadmin.kit.manage)
• /kitlist — View available kits (heliosadmin.kit.use)

Permissions
HeliosAdmin uses a clean, hierarchical permission tree that drops straight into LuckPerms, GroupManager, PermissionsEx, or vanilla op.
Hierarchy
Player Defaults (granted to everyone out of the box)

• ✅ heliosadmin.home.use, heliosadmin.home.set
• ✅ heliosadmin.warp.use
• ✅ heliosadmin.spawn.use
• ✅ heliosadmin.tpa
• ✅ heliosadmin.kit.use

Everything else defaults to false — staff opt-in only.
Suggested LuckPerms Setup
Web Dashboard
HeliosAdmin contributes a page to the HeliosCore live dashboard. From your browser you can:

• Stream real-time audit logs via SSE
• Create, list, delete, and restore world backups with one click
• See live server status and player counts
• Access role-gated actions (OWNER / ADMIN / STAFF) configured in config.yml

First-time setup: run /hcore setup to create the dashboard owner account. The dashboard will display a coloured prompt if you haven't done this yet.
Licensing [Work in Progress]
The Helios License Platform is currently in development. All premium features are fully functional during the WIP period — no license key is required. License enforcement and key management will roll out in a future update; existing customers will be migrated automatically.
⚙️ Configuration
Key sections in plugins/HeliosAdmin/config.yml:
Run /hadmin reload to apply changes without restarting.
Quick-Start Examples
❓ FAQ
Q: Do I need HeliosCore?
A: Yes. HeliosCore provides storage, permissions, the dashboard, and the service registry every Helios plugin uses.
Q: Will HeliosAdmin replace EssentialsX?
A: For most servers — yes. Homes, warps, kits, spawn, TPA, fly, gamemode, heal, feed, vanish, broadcast, kick, ban, mute, IP-ban — all built in.
Q: Does it support LuckPerms / GroupManager / PEX?
A: Yes. Every permission node is registered in plugin.yml and advertised via HeliosCore's PermissionService, so they appear automatically in your permission plugin's tab-complete and admin UI.
Q: Where are backups stored?
A: plugins/HeliosAdmin/backups/<world>_<date>_<time>[_label].zip. Restoring requires the world be unloaded first.
Q: Can I disable features I don't want?
A: Yes — toggle each module under features: in config.yml.
Q: Is the dashboard secure?
A: Yes — token-authenticated, role-gated, and you can rotate the token any time with /hcore dashboard token regenerate.
Q: Do I need a license to use HeliosAdmin?
A: [Work in Progress] — The Helios License Platform is still in development. No license key is required during the WIP period; everything is fully functional.
Support

• Discord: Helios Support Server
• Issue Tracker: Use the Discussion tab on this resource