Helios Admin

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit bungeecord paper purpur

标签： management social utility

---

? 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 HeliosCore.

?️ 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

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 [reason]` | Permanently ban | `heliosadmin.command.ban` | | `/hadmin tempban [reason]` | Temporarily ban | `heliosadmin.command.tempban` | | `/hadmin unban ` | Remove an active ban | `heliosadmin.command.unban` | | `/hadmin ipban [reason]` | Ban a player's IP | `heliosadmin.command.ipban` | | `/hadmin ipunban ` | Remove an IP ban | `heliosadmin.command.ipunban` | | `/hadmin mute [reason]` | Permanently mute | `heliosadmin.command.mute` | | `/hadmin tempmute [reason]` | Temporarily mute | `heliosadmin.command.tempmute` | | `/hadmin unmute ` | Remove an active mute | `heliosadmin.command.unmute` | | `/hadmin warn ` | Issue a warning | `heliosadmin.command.warn` | | `/hadmin warnings ` | View warnings | `heliosadmin.command.warnings` | | `/hadmin clearwarnings ` | Clear all warnings | `heliosadmin.command.clearwarnings` | | `/hadmin history ` | Full punishment history | `heliosadmin.command.history` | | `/hadmin kick [reason]` | Kick a player | `heliosadmin.command.kick` | ? Player Management | Command | Description | Permission | |:----------------------------------------------|:---------------------------|:---------------------------------| | `/hadmin freeze ` | 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 [player]` | Change gamemode | `heliosadmin.command.gamemode` | | `/hadmin speed [player]` | Adjust speed | `heliosadmin.command.speed` | | `/hadmin invsee ` | Open another's inventory | `heliosadmin.command.invsee` | | `/hadmin ecsee ` | Open another's ender chest | `heliosadmin.command.ecsee` | | `/hadmin bring ` | Teleport player to you | `heliosadmin.command.bring` | | `/hadmin goto ` | Teleport to a player | `heliosadmin.command.goto` | | `/hadmin vanish [player]` | Toggle vanish | `heliosadmin.command.vanish` | | `/hadmin whois ` | Detailed player info | `heliosadmin.command.whois` | | `/hadmin broadcast ` | Server-wide announcement | `heliosadmin.command.broadcast` | ? World Backups | Command | Description | Permission | |:----------------------------------------------|:-----------------------------------------|:-----------------------------| | `/hadmin backup create [label]` | Create a labelled backup | `heliosadmin.command.backup` | | `/hadmin backup list` | List all backups | `heliosadmin.command.backup` | | `/hadmin backup delete ` | Delete a backup | `heliosadmin.command.backup` | | `/hadmin backup restore ` | 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 ` | Delete a home | `heliosadmin.home.set` | | `/homes` | List your saved homes | `heliosadmin.home.use` | | `/setwarp ` | Create / update a server warp | `heliosadmin.warp.manage` | | `/warp ` | Teleport to a warp | `heliosadmin.warp.use` | | `/delwarp ` | 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 ` | Request to teleport to a player | `heliosadmin.tpa` | | `/tpahere ` | 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 ` | 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

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 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.

---

⚙️ Configuration

Key sections in plugins/HeliosAdmin/config.yml:

# 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

# ━━━━━━━━━━━ 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/__[_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
? Discord	Helios Support Server
? Issue Tracker	Use the Discussion tab on this resource
? Documentation	Bundled README.md and CONFIG_GUIDE.md

---