OpManagerRCI

插件

· 作者 Gamer100309

一个安全的 OP 管理插件,在授予临时操作员权限时保存并恢复玩家数据。

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

最新 4.1 · 26.2 · Bukkit / Paper

一键开服(送7天)

OpManager

一款安全且轻量级的 OP 管理插件,在授予临时操作员权限时保存并恢复玩家数据。

由 RedCity Industries | Gamer100309 创建


? 描述

OpManager 是一款专为服务器管理员设计的 Minecraft 插件,用于在不丢失当前游戏进度的情况下临时授予自己 OP 权限。与传统 OP 命令不同,OpManager 会在授予 OP 之前保存你的物品栏、位置、游戏模式等数据,并在你完成操作后恢复所有内容。

适用于:

  • ?️ 进行服务器维护而不丢失生存进度
  • ? 无缝切换管理员和玩家模式
  • ? 支持白名单的安全临时 OP 访问
  • ? 多种存储策略以满足不同的服务器需求

✨ 功能

核心功能

  • ? 完整数据备份:保存物品栏、护甲、副手、位置、游戏模式、经验值、生命值、饥饿度和药水效果
  • ? 一键恢复:移除 OP 时自动恢复所有数据
  • ? 返回命令:传送到保存的位置,无需移除 OP
  • ? 物品栏恢复:仅恢复物品栏,同时保持 OP 状态
  • ? 白名单系统:控制谁可以使用此插件
  • ? 多语言支持:内置英文和德文支持(易于扩展)
  • ? 灵活存储:可选择仅内存、仅磁盘或混合存储
  • ? Vanish 集成:可选的 /opoff 时自动禁用隐身

安全功能

  • ⚠️ 物品重复警告:如果在 OP 期间死亡,会提醒玩家存在物品重复的风险
  • ? 详细日志:提供详细的调试模式以进行故障排除
  • ? 自动清理:执行 /opoff 后删除临时文件
  • ?️ 数据完整性:对物品进行深度克隆,防止意外修改

? 安装

  1. 从 Releases 下载最新的 OpManager.jar
  2. 将文件放入服务器的 plugins/ 文件夹中
  3. 重启服务器
  4. 根据需要配置 plugins/OpManager/config.yml
  5. 将受信任的玩家添加到白名单中
  6. 使用 /reload 重新加载或重启服务器

? 命令

命令 描述 别名
/opon 授予 OP 并保存当前的玩家数据 /op-on, /enableop
/opoff 移除 OP 并恢复保存的玩家数据 /op-off, /disableop
/opreturnback 传送回保存的位置(保持 OP 状态) /opreturn, /opback
/opRestoreInventory 恢复保存的物品栏,不移除 OP /oprestore, /opinv

⚙️ 配置

快速设置

# 设置语言
language: en  # 或 'de' 表示德语

# 启用/禁用物品栏保存
inventory_save: true  # false = 仅保存位置和游戏模式

# 白名单保护
whitelist_enabled: true
whitelist:
  - YourUsername
  - TrustedAdmin

# 存储策略
storage_strategy: DISK_AND_MEMORY  # MEMORY_ONLY, DISK_ONLY, 或 DISK_AND_MEMORY

存储策略

策略 速度 数据丢失风险 使用场景
MEMORY_ONLY ⚡ 最快 ⚠️ 高(崩溃、重启时丢失) 仅限测试
DISK_ONLY ? 较慢 ✅ 低 频繁重启的服务器
DISK_AND_MEMORY ⚡ 快 ✅ 极低 推荐用于大多数服务器

Vanish 集成

# 警告:仅在您的隐身插件有专用“关闭”命令时启用
auto_disable_vanish: false
vanish_disable_command: "vanish off {player}"

⚠️ 重要提示:如果您的隐身插件使用的是切换命令(如 /vanish 或 /v),请将 auto_disable_vanish 设置为 false,以避免在您打算禁用隐身时意外启用它!


? 多语言支持

OpManager 开箱即用地支持多种语言:

  • ?? English (messages_en.yml)
  • ?? German (messages_de.yml)

添加自己的语言

  1. 复制 messages_en.yml 或 messages_de.yml
  2. 将其重命名为 messages_<code>.yml(例如法语为 messages_fr.yml)
  3. 翻译文件中的所有消息
  4. 在 config.yml 中设置 language: fr
  5. 重新加载插件

? 安全与权限

白名单系统

OpManager 使用基于白名单的权限系统:

whitelist_enabled: true  # 设置为 false 以允许所有玩家(不推荐!)
whitelist:
  - AdminName
  - TrustedModerator

⚠️ 安全警告:如果 whitelist_enabled: false,任何玩家都可以给自己授予 OP!

最佳实践

  1. ✅ 在生产环境中始终保持 whitelist_enabled: true
  2. ✅ 仅将受信任的管理员添加到白名单中
  3. ✅ 定期审查白名单
  4. ✅ 使用 DISK_AND_MEMORY 存储以确保数据安全

⚠️ 重要警告

物品重复风险

如果你在活动的 OP 会话期间死亡,你的物品会在死亡地点掉落。当你使用 /opoff 时,你保存的物品将被恢复。这意味着你可以捡起掉落的物品并且拥有保存的物品,从而导致物品重复!

防止重复的方法:

  1. 先使用 /opoff(恢复你保存的物品)
  2. 然后决定:忽略掉落的物品或捡起它们

如果你在一次 OP 会话期间死亡,插件会在聊天中提醒你。

隐身切换警告

如果你的隐身插件使用的是切换命令(一个命令开启/关闭),设置 auto_disable_vanish: true 可能会意外启用隐身而不是禁用它!

安全的命令(专用关闭):

  • vanish off {player} ✅
  • sv off {player} ✅

有风险命令(切换):

  • vanish {player} ❌
  • v {player} ❌

? 性能与资源占用

RAM 占用

OpManager 极其轻量级:

场景 内存占用
1 名玩家执行 /opon ~40 KB(最坏情况)
10 名玩家同时在线 ~400 KB
100 名玩家同时在线 ~4 MB

在实际使用中,由于物品栏未填满且附魔较少,大多数会话每位玩家仅使用 10-20 KB。

对比

  • OpManager(1 名玩家):40 KB
  • 一个已加载的 Minecraft 区块:~200 KB
  • 典型的 Minecraft 服务器:2-8 GB

结论:与服务器整体资源使用情况相比,OpManager 的内存占用几乎可以忽略不计。


? 故障排除

启用详细日志记录

如需获取详细的调试信息,请启用详细日志记录:

verbose_logging: true

这将显示以下方面的详细信息:

  • 数据保存/加载操作
  • 物品栏复制步骤
  • 位置恢复
  • 存储操作

常见问题

Q:我的数据没有保存!
A:检查你是否在白名单中,以及 config.yml 中是否设置了 inventory_save: true

Q:死亡后物品重复了!
A:这是预期行为。请在拾取掉落物品前始终使用 /opoff。

Q:隐身模式变成了开启而不是关闭!
A:你的隐身插件使用的是切换命令。请在 config.yml 中设置 auto_disable_vanish: false

Q:服务器崩溃后数据丢失!
A:如果使用 MEMORY_ONLY 存储,这是预期行为。请切换到 DISK_AND_MEMORY 以确保安全。


? 技术细节

保存内容

当你运行 /opon 且 inventory_save: true 时:

  • ✅ 完整物品栏(36 个槽位)
  • ✅ 护甲(4 个槽位)
  • ✅ 副手物品(1 个槽位)
  • ✅ 位置(世界、x、y、z、偏航角、俯仰角)
  • ✅ 游戏模式(生存、创造、冒险、旁观者)
  • ✅ 经验值(等级和进度)
  • ✅ 生命值
  • ✅ 饥饿值与饱和度
  • ✅ 药水效果(类型、持续时间、放大器)

当 inventory_save: false 时:

  • ✅ 位置
  • ✅ 游戏模式
  • ❌ 其他所有内容

存储位置

  • RAM:存储在 Java HashMap 中(最快,易失性)
  • 磁盘:plugins/OpManager/playerdata/<username>.yml(持久化,执行 /opoff 后自动删除)

? 示例工作流程

1. 你正在玩生存模式:/opon
   → 你的生存数据被保存
   → 你获得 OP 权限
   
2. 在创造模式下进行管理员工作
   → 建造、传送、使用 WorldEdit 等
   
3. 管理员任务完成:/opoff
   → OP 权限被移除
   → 你被传回生存模式的位置
   → 你的生存物品栏、游戏模式、经验值等将被恢复
   → 回到你离开时的确切状态继续玩生存模式!

? 贡献

欢迎贡献!你可以:

欢迎提交拉取请求! 请确保:

  1. Fork 仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 打开拉取请求

? 许可证

本项目遵循 GNU General Public License v3.0 许可证。

这意味着:

  • ✅ 你可以自由使用、修改和分发此插件
  • ✅ 你也必须在 GPL v3 下共享你的修改
  • ✅ 分发时必须提供源代码
  • ❌ 你不能在未提供源代码的情况下出售此插件

请参阅 LICENSE 文件以获取完整详情,或访问


? 支持

如有其他问题,欢迎在 GitHub 上发起讨论!


? 致谢

创建者:RedCity Industries | Gamer100309
版本:4.1
Minecraft 版本:26.2
API 版本:26.2


⭐ Star 历史

如果你觉得此插件有用,请考虑在 GitHub 上给它一颗星!


由 RedCity Industries 用 ❤️ 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源