?️ 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 构建
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧