Helios Admin

插件

· 作者 Helios-Nine

HeliosAdmin 是一款功能强大的 Minecraft 服务器综合管理与员工工具插件,提供处罚、玩家管理、家园、传送点、套装、备份、审计日志等功能,并支持通过 HeliosCore 实现的实时仪表板集成。

0 本站下载 0 关注 更新于 6 个月前

最新 1.0.0 · 26.1.2 · Bukkit / BungeeCord

一键开服(送7天)

?️ HeliosAdmin

管理 • 玩家管理 • 家园与传送点 • 工具箱 • 世界备份 • 实时 Web 控制面板


? 目录


✨ 为什么选择 HeliosAdmin?

HeliosAdmin 将 5–6 个独立的插件(核心功能、封禁系统、家园/传送点、工具箱、备份)合并为 一个统一的插件,并通过 HeliosCore 与其他所有 Helios 插件共享数据、权限、审计日志和存储。

?️ 管理 ? 玩家工具 ? 生活质量 (QoL) ? 服务器运维
封禁、禁言、IP 封禁 冻结、治疗、喂食、飞行、神模式 家园、传送点、出生点 实时 Web 控制面板
临时封禁 & 临时禁言 游戏模式、隐身、加速 TPA / 传送到我 世界备份 + 恢复
警告 & 历史记录 查看物品栏、经济余额、拉取、前往 工具箱 审计日志流式传输
处罚审计日志 Whois、广播、踢出 自定义冷却时间 热重载

✅ EssentialsX 的直接替代品 • 兼容 LuckPerms • 原生支持 Adventure / MiniMessage


? 前置要求

要求 版本
Minecraft 1.21.x • 26.1.x (原生支持 & 已测试)
服务端 Paper / Purpur (Spigot 官方不支持)
Java 21+
HeliosCore 最新版 (必需的依赖项)

⚠️ 必须安装 HeliosCore。 没有它,HeliosAdmin 将无法启动。首次安装 HeliosCore 后,你 必须 运行 /hcore setup 才能启用 HeliosAdmin 的控制面板功能。


? 安装

1. 将 HeliosCore-x.y.z.jar     →  plugins/
2. 将 HeliosAdmin-x.y.z.jar    →  plugins/
3. 启动服务器(数据文件夹和配置文件自动生成)
4. 运行  /hcore setup             (初始化控制面板管理员 — 必需)
5. 根据需要编辑 plugins/HeliosAdmin/config.yml
6. 运行  /hadmin reload
7. (可选)配置你的权限插件 — 参见下方的权限部分

就是这样。所有指令和权限节点都会自动注册。


? 指令

别名: /hadmin • /ha • /nadmin • /na • /heliosadmin • /ninezadmin

?️ 根指令
指令 描述 权限
/hadmin guide 打开库存指令浏览器 heliosadmin.command.guide
/hadmin menu 打开管理员 GUI 菜单 heliosadmin.command.menu
/hadmin reload 重载 Helios Admin 配置及存储 heliosadmin.command.reload
/hadmin storage 查看 / 测试后端存储 heliosadmin.command.storage
/hadmin audit [n] 查看最近的审计日志条目 heliosadmin.command.audit
⚖️ 管理
指令 描述 权限
/hadmin ban <player> [reason] 永久封禁 heliosadmin.command.ban
/hadmin tempban <player> <duration> [reason] 临时封禁 heliosadmin.command.tempban
/hadmin unban <player> 移除活跃封禁 heliosadmin.command.unban
/hadmin ipban <player|ip> [reason] 封禁玩家的 IP heliosadmin.command.ipban
/hadmin ipunban <ip> 移除 IP 封禁 heliosadmin.command.ipunban
/hadmin mute <player> [reason] 永久禁言 heliosadmin.command.mute
/hadmin tempmute <player> <duration> [reason] 临时禁言 heliosadmin.command.tempmute
/hadmin unmute <player> 移除活跃禁言 heliosadmin.command.unmute
/hadmin warn <player> <reason> 发出警告 heliosadmin.command.warn
/hadmin warnings <player> 查看警告 heliosadmin.command.warnings
/hadmin clearwarnings <player> 清除所有警告 heliosadmin.command.clearwarnings
/hadmin history <player> 完整的处罚历史 heliosadmin.command.history
/hadmin kick <player> [reason] 踢出玩家 heliosadmin.command.kick
? 玩家管理
命令 描述 权限
/hadmin freeze <玩家> 冻结 / 解冻 heliosadmin.command.freeze
/hadmin heal [player] 恢复满生命值 heliosadmin.command.heal
/hadmin feed [player] 恢复饥饿值 heliosadmin.command.feed

| /hadmin fly [player] | 切换飞行状态 | heliosadmin.command.fly | | /hadmin god [player] | 切换伤害免疫 | heliosadmin.command.god | | /hadmin gamemode <mode> [player] | 更改游戏模式 | heliosadmin.command.gamemode | | /hadmin speed <walk\|fly> <0–10> [player] | 调整速度 | heliosadmin.command.speed | | /hadmin invsee <player> | 查看其他玩家的物品栏 | heliosadmin.command.invsee |

| /hadmin ecsee <玩家> | 打开他人的末影箱 | heliosadmin.command.ecsee |

| /hadmin bring <player> | 将你传送至目标玩家 | heliosadmin.command.bring | | /hadmin goto <player> | 传送到某位玩家 | heliosadmin.command.goto | | /hadmin vanish [player] | 切换隐身状态 | heliosadmin.command.vanish |

| /hadmin whois <player> | 玩家详细信息 | heliosadmin.command.whois | | /hadmin broadcast <message> | 全服公告 | heliosadmin.command.broadcast |

? 世界备份
命令 描述 权限
/hadmin backup create <world> [label] 创建带标签的备份 heliosadmin.command.backup
/hadmin backup list 列出所有备份 heliosadmin.command.backup
/hadmin backup delete <filename> 删除一个备份 heliosadmin.command.backup
/hadmin backup restore <filename> 还原一个备份 (请先卸载世界) heliosadmin.command.backup
? 玩家便利性命令
命令 描述 权限
/sethome [name] 将当前位置保存为家 heliosadmin.home.set

| /home [name] | 传送至已保存的家园 | heliosadmin.home.use | | /delhome <name> | 删除一个家园 | heliosadmin.home.set | | /homes | 列出你的已保存家园 | heliosadmin.home.use |

| /setwarp <name> | 创建/更新服务器传送点 | heliosadmin.warp.manage | | /warp <name> | 传送到传送点 | heliosadmin.warp.use | | /delwarp <name> | 删除传送点 | heliosadmin.warp.manage | | /warps | 列出服务器传送点列表 | heliosadmin.warp.use | | /setspawn | 设置服务器出生点 | heliosadmin.command.setspawn | | /spawn | 传送到服务器出生点 | heliosadmin.spawn.use |

| /tpa <player> | 请求传送至某玩家 | heliosadmin.tpa | | /tpahere <player> | 请求某玩家传送至你 | heliosadmin.tpa | | /tpaccept | 接受待处理的请求 | heliosadmin.tpa |

| /tpdeny | 拒绝待处理的请求 | heliosadmin.tpa | | /kit [name] | 领取套装 | heliosadmin.kit.use | | /hadmin kit <create\|delete\|edit> | 管理套装 | heliosadmin.kit.manage |

| /kitlist | 查看可用的套件 | heliosadmin.kit.use |


? 权限系统

HeliosAdmin 使用清晰、分层级的权限树,可直接集成到 LuckPerms、GroupManager、PermissionsEx 或原版 OP 系统中。

? 层级结构

heliosadmin.admin                 (默认: op)  ━ 授予所有权限
└── heliosadmin.command.all                       ━ 其下所有叶子节点
    ├── heliosadmin.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


### ? 玩家默认权限 *(开箱即对所有人授予)*

- ✅ `heliosadmin.home.use` • `heliosadmin.home.set`
- ✅ `heliosadmin.warp.use`
- ✅ `heliosadmin.spawn.use`
- ✅ `heliosadmin.tpa`
- ✅ `heliosadmin.kit.use`

> 其余选项默认设为 `false` —— 仅工作人员可选择加入。

### ? LuckPerms 推荐配置

<details>
<summary><b>? 点击展开 LuckPerms 命令示例</b></summary>

```bash
# ────────────── 助手 / 试用模组 ──────────────
/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

# ────────────── 版主 ──────────────
/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

# ────────────── 管理员(全部权限) ──────────────
/lp group admin permission set heliosadmin.admin true

? Web 仪表盘

HeliosAdmin 为 HeliosCore 实时仪表盘 贡献了一个页面。通过浏览器,你可以:

  • ? 通过 SSE 流式传输 实时审计日志
  • ? 一键创建、列出、删除和恢复 世界备份
  • ? 查看 服务器实时状态 和玩家数量
  • ? 访问 角色受限的操作(OWNER / ADMIN / STAFF),在 config.yml 中配置

? 首次设置: 运行 /hcore setup 以创建仪表盘所有者账户。如果尚未完成此操作,仪表盘将显示彩色提示。


⚙️ 配置

plugins/HeliosAdmin/config.yml 中的关键部分:

# 存储后端(默认继承自 HeliosCore)
storage:
  inherit-core: true

# 功能开关
features:
  homes: true
  warps: true
  kits: true
  tpa: true
  backups: true

# 冷却时间与预热时间(秒)
teleport:
  warmup: 3
  cooldown: 5
  cancel-on-move: true
  cancel-on-damage: true

# 仪表盘操作的角色限制
dashboard:
  permissions:
    actions:
      createBackup: ADMIN
      deleteBackup: OWNER
      restoreBackup: OWNER
      kickPlayer: STAFF
      banPlayer: ADMIN

# 惩罚格式化(MiniMessage)
messages:
  prefix: "<gradient:#F4A623:#FFD580>[Helios]</gradient> <white>"
  ban-screen: "<red>You are banned: <white><reason>"

? 运行 /hadmin reload 以应用更改而无需重启。


? 快速入门示例

# ━━━━━━━━━━━ 首次启动 ━━━━━━━━━━━
/hcore setup                                  # 初始化仪表盘所有者

# ━━━━━━━━━━━ 日常管理 ━━━━━━━━━━━
/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

# ━━━━━━━━━━━ 玩家工具 ━━━━━━━━━━━
/sethome base
/home base
/warp shop
/tpa Alex
/kit starter

# ━━━━━━━━━━━ 服务器操作 ━━━━━━━━━━━
/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

❓ 常见问题

我需要 HeliosCore 吗?

是的。HeliosCore 提供存储、权限、仪表盘和服务注册表,每个 Helios 插件都依赖它。

HeliosAdmin 会取代 EssentialsX 吗?

对于大多数服务器——是的。家园、传送点、套装、出生点、TPA、飞行、游戏模式、治疗、喂食、隐身、广播、踢出、封禁、静音、IP 封禁——全部内置。

支持 LuckPerms / GroupManager / PEX 吗?

支持。每个权限节点都在 plugin.yml 中注册,并通过 HeliosCore 的 PermissionService 进行通告,因此它们会自动出现在你的权限插件的标签补全和管理界面中。

备份存储在哪里?

plugins/HeliosAdmin/backups/<world>_<date>_<time>[_label].zip。恢复前需要先卸载世界。

我可以禁用不需要的功能吗?

可以——在 config.yml 下的 features: 中切换各个模块。

仪表盘安全吗?

是的——基于令牌认证,角色受限,并且你可以随时使用 /hcore dashboard token regenerate 轮换令牌。


? 支持

渠道 链接
? Discord
? 问题追踪器 使用此资源页面上的 Discussion 选项卡
? 文档 捆绑的 README.md 和 CONFIG_GUIDE.md

?️ HeliosAdmin

在一个插件中掌控整个服务器。

Helios 生态系统的一部分 • 基于 HeliosCore 构建

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源