mcpField
M
minecraft-essentials-ops

minecraft-essentials-ops

github.com/jahrome907其他192103 次安装2 周前更新
代码仓库

关于 minecraft-essentials-ops

面向 Minecraft 管理员的 EssentialsX 运维技能，涵盖命令、配置、权限、经济和玩家管理。它提供平台检查、部署验证与分步变更流程，并区分服务器运维和插件开发等任务。

主要功能

  1. 01检查受支持的服务器平台
  2. 02管理经济命令与商店权限
  3. 03配置套件、传送点和家园
  4. 04按角色规划命令权限
  5. 05处理禁言、监禁与封禁
  6. 06按步骤发布配置并验证

适用场景

  1. 01为 Paper 或 Spigot 服务器部署 EssentialsX
  2. 02调整经济与玩家商店规则
  3. 03审查管理人员和玩家权限
  4. 04执行审核操作或安全配置变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jahrome907/minecraft-agent-skills --skill minecraft-essentials-ops

安装后在 Claude Code 中输入/minecraft-essentials-ops确认已加载。

附带文件references/permissions-and-rollout-checklists.md

详细介绍

Minecraft EssentialsX 运维技能

技能范围

路由边界
  • 适用场景：任务涉及 EssentialsX 命令、配置、权限、经济或管理操作。
  • 不适用场景：通用服务器部署、代理或性能架构（minecraft-server-admin）。
  • 不适用场景：编写 Java 插件代码（minecraft-plugin-dev）。
  • 不适用场景：WorldEdit 选区或建造工作流（minecraft-worldedit-ops）。

参考资料

  • 如果任务涉及权限审计、经济系统上线或管理政策变更，并且需要简洁的预检清单，请阅读 references/permissions-and-rollout-checklists.md。

模块概览与安装说明

平台要求

仅在受支持的 Paper 或 Spigot 服务器版本上使用 EssentialsX。EssentialsX 2.22.0 警告称，Folia 及其分支不受支持，并且可能导致用户数据丢失； 它也不支持 Forge、NeoForge 或 Fabric Bukkit 混合服务器。如果 当前平台属于这两类，请先停止启用或配置 EssentialsX，并确认受支持的 运行方案。本指南不建议迁移。

生产环境中常用的 EssentialsX 模块：

  • EssentialsX（核心命令和用户工具）
  • EssentialsXChat
  • EssentialsXSpawn
  • EssentialsXProtect

运维安装清单：

  1. 让 EssentialsX 版本与 Paper/Spigot API 代际匹配。
  2. 如果使用经济提供方或权限/聊天桥接，请安装 Vault。
  3. 启动服务器一次，并检查日志中的依赖项警告。
  4. 记录插件 jar 版本，以便回滚。

版本对齐规则：

  • 先在预发布环境中，将 EssentialsX 和配套插件作为经过测试的一组进行更新。
  • 确认确切的 EssentialsX 正式版或开发版支持目标 Paper 版本；不要假设适用于 26.1 的构建也支持 26.2。

Vault 和经济系统基础

经济系统架构
  • EssentialsX 可以提供经济命令和余额功能。
  • Vault 提供共享桥接，让其他插件（商店、职业、等级）能够读取/写入余额。

验证提供方链路：

  1. 服务器启动时没有 Vault 挂钩错误。
  2. 经济命令可以正常响应，且没有权限错误。
  3. 第三方插件的交易能够一致地影响余额。
核心经济命令
/bal
/baltop
/pay Alex 250
/eco give Alex 1000
/eco take Alex 100
/eco reset Alex

仅允许通过员工角色使用管理员经济命令。

商店定价和告示牌商店

如果使用 EssentialsX 告示牌和经济交互：

  1. 制定定价政策：
    • 新手级别的价格
    • 抑制通货膨胀的回收机制
    • 仅限管理员使用的物品例外
  2. 在 config.yml 中仅启用你计划支持的告示牌类型： 
    enabledSigns:
  - buy
  - sell
  3. 限制受信任组创建告示牌的权限：
    • essentials.signs.create.buy
    • essentials.signs.create.sell
  4. 仅向需要进行交易的组授予使用权限：
    • essentials.signs.use.buy
    • essentials.signs.use.sell
  5. 修改配置后，使用非 OP 玩家账号验证买卖计算是否正确。
告示牌商店格式
[Buy]
<quantity>
<item>
<price>

[Sell]
<quantity>
<item>
<price>

示例（出生点市场中的石头）：

[Buy]
32
stone
$50

[Sell]
32
stone
$20

如果需要不同的买入价和卖出价，请使用独立的 [Buy] 和 [Sell] 告示牌。 第 4 行是该告示牌的单笔交易价格。

运维防护措施：

  • 切勿向普通玩家开放不受限制的管理员商店告示牌
  • 监控余额的快速增长，以发现复制物品或漏洞利用行为

套装、传送点、家园、昵称、出生点

套装操作

典型的套装生命周期：

  1. 创建/编辑套装定义
  2. 设置冷却时间和权限
  3. 使用玩家等级账号进行测试

plugins/Essentials/kits.yml 中的套装条目：

kits:
  starter:
    delay: 86400
    items:
      - stone 64
      - oak_planks 32
      - bread 16

常用命令：

/kit
/kit starter
/createkit starter 86400
传送点和家园
/setwarp spawn
/setwarp market
/warp spawn
/sethome
/home
/delhome

通过权限和 Essentials 配置值控制限制。

昵称与重生点管理

/setspawn 和 /spawn 需要 EssentialsXSpawn 模块。请确认已安装该 jar，启动日志中没有模块加载错误，并且玩家组拥有 essentials.spawn，然后再将重生点命令失败归因于位置问题。

/nick BuilderOne
/realname BuilderOne
/setspawn
/spawn

明确昵称政策，以便开展管理并防止冒充。

权限模式

使用权限管理器（例如 LuckPerms）来构建角色层级。

建议的角色用途：

  • admin：完整的 EssentialsX 管理、管理处置和经济控制权限
  • staff：管理处置和支持命令，以及有限的经济工具
  • player：基本的家、传送点、私信和付款功能，并设有防护措施

权限示例：

groups:
  admin:
    permissions:
      - essentials.*
  staff:
    permissions:
      - essentials.kick
      - essentials.mute
      - essentials.tempban
      - essentials.togglejail
      - essentials.warp
      - essentials.msg
  player:
    permissions:
      - essentials.home
      - essentials.sethome
      - essentials.delhome
      - essentials.spawn
      - essentials.warp
      - essentials.msg
      - essentials.pay

除受信任的管理员角色外，避免授予通配符权限。

管理工作流

工作流：禁言

/mute Alex 30m Chat abuse after warning
/unmute Alex

实践建议：

  • 添加原因和时长
  • 记录针对重复违规行为的升级处理流程

故障排查：禁言未生效 → 确认 EssentialsX 核心模块已加载，执行者拥有 essentials.mute，目标玩家没有免禁言状态，并且没有其他管理或聊天插件覆盖处理结果。EssentialsXChat 用于设置聊天格式；它不是核心禁言功能的前置条件。

工作流：监禁

/setjail intake
/jail Alex intake 20m Griefing spawn edge
/unjail Alex

实践建议：

  • 明确监禁原因
  • 视情况配合回滚或修复操作
  • 仅向获准创建或移动监狱位置的角色授予 essentials.setjail；只需要监禁或释放玩家的员工使用 essentials.togglejail

故障排查：监禁无效 → 确认已使用 /setjail intake 设置监狱位置，并且玩家没有绕过权限。

工作流：临时封禁

/tempban Alex 7d Repeated harassment
/unban Alex

实践建议：

  • 根据政策层级设置时长
  • 记录证据和执行操作的员工

IP 封禁是独立功能：/banip Alex <reason> 会查找该玩家最近使用的 IP，可能影响共用该 IP 的其他玩家。使用 /unbanip <address> 并填写被封禁的准确地址，才能撤销已授权的 IP 封禁；/unban Alex 只会解除账号封禁。

故障排查：临时封禁未生效 → 检查 essentials.tempban 权限，并确认没有其他插件（如 LiteBans）产生冲突。

配置陷阱与加固说明

常见陷阱：

  • 部分更新插件后，EssentialsX、Vault 或提供程序的版本不匹配
  • 过于宽泛的通配符授权暴露了管理员经济命令
  • 家或传送点数量上限过高，导致导航功能遭滥用或命令刷屏
  • 不同员工轮班期间，聊天和昵称规则不一致

加固检查清单：

  • 编辑前保留经过测试的基准配置备份
  • 一次只更改一个政策区域（经济、家、管理处置、聊天）
  • 每次推出配置后运行员工和玩家冒烟测试
  • 维护书面的政策与命令权限对应关系

运维手册：安全推出配置

  1. 备份当前 Essentials 配置文件。
  2. 应用针对性的配置修改。
  3. 仅当插件文档明确支持对已修改部分进行实时重载时才重载。
  4. 对敏感更改，优先采用维护重启。
  5. 验证：
    • 登录流程
    • 家和传送点
    • 经济交易
    • 管理处置命令
  6. 准备好回滚包，以便立即恢复。

参考资料

评论

支持 Markdown