玩 Minecraft 的乐趣在于创造，但维护服务器是另一回事。选核心、配插件、调 JVM、处理延迟、搞定反外挂兼容——每个环节都能让你折腾半天。更别提 Java 版和基岩版的差异了，新手光搞明白 Paper 和 Purpur 的区别就得翻一堆文档。

我把这些年踩的坑整理成了一个 Claude Code Skill：minecraft-server-ops。说白了就是让 AI 帮你干运维的活，你用嘴说，它动手。

它能干什么

服务器搭建

Paper、Purpur、Fabric、Forge、BDS、LiteLoader 都支持。告诉 AI 你的硬件配置和用途，它会推荐合适的内核并给出搭建步骤。

插件与模组管理

安装、配置、冲突排查流程都内置了。还有一份我个人验证过的插件清单——LuckPerms 管权限，WorldGuard 护地皮，GrimAC 反作弊，Spark 看性能，Geyser 让基岩版玩家也能进来。

性能调优

TPS 掉了？内存爆了？GC 日志全是红的？Skill 会根据你的服务器类型给针对性建议。比如 Paper 1.21 的 Packet-Limiter，默认值经常会误伤投影 Mod（Litematica），它知道怎么调到合理范围。

备份与恢复

3-2-1 备份策略 + 自动脚本，附带灾难恢复的完整步骤。

安全防护

离线模式防假登录、DDoS 缓解、GrimAC 防误报。尤其是 GrimAC 和 Litematica 的兼容问题——改 4 个参数轻松放置就能正常用了，这事我以前调了半天才搞明白。

故障排查

启动报错、TPS 掉到个位数、内存缓慢吃满、玩家连不上——每种情况都有排查路径。核心思路是二分法禁插件，快速定位肇事者。

RCON 远程控制

这部分花的时间最多。纯 Python 标准库写的 RCON 客户端，不用装任何第三方包，Java 版和基岩版通用。

# 看服务器状态
python scripts/mc-rcon.py status

# 交互模式，跟在后台敲命令一样
python scripts/mc-rcon.py -i

# JSON 输出，方便脚本集成
python scripts/mc-rcon.py --json online

在线玩家、TPS、广播、白名单、踢人封禁这些常用操作都封装好了。

为什么做成 Skill

写文档简单，用文档难。TPS 崩了的时候没人想翻几千字的 Wiki 找对应章节。Skill 直接听懂你说的话，按诊断流程一步步帮你排查。你在游戏里敲 /tps，它在终端里帮你分析。

安装

git clone git@github.com:xgd16/minecraft-server-ops.git ~/.claude/skills/minecraft-server-ops

装好之后在 Claude Code 里直接说需求：

  • "帮我搭一个 Paper 1.21.4 服务器，8G 内存"
  • "TPS 只有 15，帮我看看哪里拖后腿"
  • "GrimAC 怎么配才能不误报投影 Mod"
  • "每天凌晨 3 点自动备份，帮我写个 cron"

项目在 GitHub 完全开源。如果你在维护 MC 服务器，或者想看看 Claude Code Skill 怎么写，欢迎来试试，遇到问题直接提 issue。