Helios Admin

HeliosAdmin is an advanced all-in-one moderation and staff utility plugin for Minecraft servers, featuring punishments, player management, homes, warps, kits, backups, audit logging, and live dashboard integration powered by HeliosCore.

Download

Helios Admin

🛡️ HeliosAdmin

*Moderation • Player Management • Homes & Warps • Kits • World Backups • Live Web Dashboard*

</div>

---

📖 Table of Contents

- ✨ Why HeliosAdmin? - 📋 Requirements - 📥 Installation - 🎮 Commands - 🔐 Permissions - 🌐 Web Dashboard - ⚙️ Configuration - 🚀 Quick-Start Examples - ❓ FAQ - 💬 Support

---

✨ Why HeliosAdmin?

> HeliosAdmin replaces one unified plugin (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 one unified plugin.

| 🛡️ 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 | |:--------------|:-----------------------------------------------------| | Latest | `1.21.x` • `26.1.x` (native & tested) | | Latest | Latest / Latest *(Spigot not officially supported)* | | Latest | `21+` | | Latest| Latest *(required dependency)* |

> ⚠️ must 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`

🛠️ Root Command

| 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 [n]` | View recent audit log entries | `heliosadmin.command.audit` |

⚖️ Moderation

| Command | Description | Permission | |:-------------------------------------------------|:-----------------------------|:------------------------------------| | `/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

| Command | Description | Permission | |:----------------------------------------------|:---------------------------|:---------------------------------| | `/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

| Command | Description | Permission | |:----------------------------------------------|:-----------------------------------------|:-----------------------------| | `/hadmin backup create <world> [label]` | Create a labelled backup | `heliosadmin.command.backup` | | `/hadmin backup list` | List all backups | `heliosadmin.command.backup` | | `/hadmin backup delete <filename>` | Delete a backup | `heliosadmin.command.backup` | | `/hadmin backup restore <filename>` | Restore a backup *(unload world first)* | `heliosadmin.command.backup` |

🏠 Player QoL Commands

| Command | Description | Permission | |:---------------------------------------|:---------------------------------|:-------------------------------| | `/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

```text heliosadmin.admin (default: op) ━ grants EVERYTHING └── heliosadmin.command.all ━ all leaf nodes below ├── heliosadmin.command.<each-command> ├── heliosadmin.home.use / heliosadmin.home.set ├── heliosadmin.warp.use / heliosadmin.warp.manage ├── heliosadmin.spawn.use / heliosadmin.command.setspawn ├── heliosadmin.tpa ├── heliosadmin.kit.use / heliosadmin.kit.manage └── heliosadmin.command.backup ```

🎁 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

📋 Click to expand example LuckPerms commands

```bash

────────────── Helper / Trial Mod ──────────────

/lp group helper permission set heliosadmin.command.kick true /lp group helper permission set heliosadmin.command.mute true /lp group helper permission set heliosadmin.command.tempmute true /lp group helper permission set heliosadmin.command.unmute true /lp group helper permission set heliosadmin.command.warn true /lp group helper permission set heliosadmin.command.warnings true /lp group helper permission set heliosadmin.command.history true /lp group helper permission set heliosadmin.command.invsee true /lp group helper permission set heliosadmin.command.ecsee true /lp group helper permission set heliosadmin.command.vanish true /lp group helper permission set heliosadmin.command.whois true /lp group helper permission set heliosadmin.command.freeze true

────────────── Moderator ──────────────

/lp group mod parent add helper /lp group mod permission set heliosadmin.command.ban true /lp group mod permission set heliosadmin.command.tempban true /lp group mod permission set heliosadmin.command.unban true /lp group mod permission set heliosadmin.command.clearwarnings true /lp group mod permission set heliosadmin.command.broadcast true

────────────── Admin (everything) ──────────────

/lp group admin permission set heliosadmin.admin true ```

---

🌐 Web Dashboard

HeliosAdmin contributes a page to the HeliosCore live dashboard. From your browser you can:

- 📡 Stream role-gated actions via SSE - 💾 role-gated actions world backups with one click - 👥 See role-gated actions 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.

---

⚙️ Configuration

Key sections in `plugins/HeliosAdmin/config.yml`:

```yaml

Storage backend (inherits from HeliosCore by default)

storage: inherit-core: true

Per-feature toggles

features: homes: true warps: true kits: true tpa: true backups: true

Cooldowns & warm-ups (in seconds)

teleport: warmup: 3 cooldown: 5 cancel-on-move: true cancel-on-damage: true

Dashboard role gating for actions

dashboard: permissions: actions: createBackup: ADMIN deleteBackup: OWNER restoreBackup: OWNER kickPlayer: STAFF banPlayer: ADMIN

Punishment formatting (MiniMessage)

messages: prefix: "<gradient:#F4A623:#FFD580>[Helios]</gradient> <white>" ban-screen: "<red>You are banned: <white><reason>" ```

> 🔄 Run `/hadmin reload` to apply changes without restarting.

---

🚀 Quick-Start Examples

```bash

━━━━━━━━━━━ First boot ━━━━━━━━━━━

/hcore setup # Initialise dashboard owner

━━━━━━━━━━━ Daily moderation ━━━━━━━━━━━

/ha ban Steve Griefing spawn /ha tempban Steve 7d X-ray /ha mute Alex 1h Spam in chat /ha warn Alex Caps abuse /ha history Alex /ha freeze Steve /ha invsee Alex

━━━━━━━━━━━ Player utilities ━━━━━━━━━━━

/sethome base /home base /warp shop /tpa Alex /kit starter

━━━━━━━━━━━ Server operations ━━━━━━━━━━━

/ha backup create world Pre-event /ha backup list /ha backup restore world_2026-05-08_14-30-00_Pre-event.zip /ha audit 25 /ha reload ```

---

❓ FAQ

Do I need HeliosCore?

Yes. HeliosCore provides storage, permissions, the dashboard, and the service registry every Helios plugin uses.

Will HeliosAdmin replace EssentialsX?

For most servers — yes. Homes, warps, kits, spawn, TPA, fly, gamemode, heal, feed, vanish, broadcast, kick, ban, mute, IP-ban — all built in.

Does it support LuckPerms / GroupManager / PEX?

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.

Where are backups stored?

`plugins/HeliosAdmin/backups/<world><date><time>[_label].zip`. Restoring requires the world be unloaded first.

Can I disable features I don't want?

Yes — toggle each module under `features:` in `config.yml`.

Is the dashboard secure?

Yes — token-authenticated, role-gated, and you can rotate the token any time with `/hcore dashboard token regenerate`.

---

💬 Support

| Channel | Link | |:---------------------|:-------------------------------------------| | 💬 Documentation | Documentation | | 🐛 Documentation | Use the Documentation tab on this resource| | 📚 Documentation | Bundled `README.md` and `CONFIG_GUIDE.md` |

---

🛡️ HeliosAdmin

Total server control, in one plugin.

*Part of the Helios Ecosystem • Built on HeliosCore*

</div>

Helios Admin

Helios Admin

🛡️ HeliosAdmin

📖 Table of Contents

✨ Why HeliosAdmin?

📋 Requirements

📥 Installation

🎮 Commands

🔐 Permissions

🌳 Hierarchy

🎁 Player Defaults (granted to everyone out of the box)

💡 Suggested LuckPerms Setup

────────────── Helper / Trial Mod ──────────────

────────────── Moderator ──────────────

────────────── Admin (everything) ──────────────

🌐 Web Dashboard

⚙️ Configuration

Storage backend (inherits from HeliosCore by default)

Per-feature toggles

Cooldowns & warm-ups (in seconds)

Dashboard role gating for actions

Punishment formatting (MiniMessage)

🚀 Quick-Start Examples

━━━━━━━━━━━ First boot ━━━━━━━━━━━

━━━━━━━━━━━ Daily moderation ━━━━━━━━━━━

━━━━━━━━━━━ Player utilities ━━━━━━━━━━━

━━━━━━━━━━━ Server operations ━━━━━━━━━━━

❓ FAQ

💬 Support

🛡️ HeliosAdmin

Gallery

Versions

Helios Admin

Helios Admin

🛡️ HeliosAdmin

📖 Table of Contents

✨ Why HeliosAdmin?

📋 Requirements

📥 Installation

🎮 Commands

🔐 Permissions

🌳 Hierarchy

🎁 Player Defaults *(granted to everyone out of the box)*

💡 Suggested LuckPerms Setup

────────────── Helper / Trial Mod ──────────────

────────────── Moderator ──────────────

────────────── Admin (everything) ──────────────

🌐 Web Dashboard

⚙️ Configuration

Storage backend (inherits from HeliosCore by default)

Per-feature toggles

Cooldowns & warm-ups (in seconds)

Dashboard role gating for actions

Punishment formatting (MiniMessage)

🚀 Quick-Start Examples

━━━━━━━━━━━ First boot ━━━━━━━━━━━

━━━━━━━━━━━ Daily moderation ━━━━━━━━━━━

━━━━━━━━━━━ Player utilities ━━━━━━━━━━━

━━━━━━━━━━━ Server operations ━━━━━━━━━━━

❓ FAQ

💬 Support

🛡️ HeliosAdmin

Gallery

Versions

🎁 Player Defaults (granted to everyone out of the box)