⚠️
操作前请务必阅读： 所有破坏性命令（如 op、stop、/co rollback、//set、/mv delete）都会影响所有玩家。下达大范围命令前，请先在群里通知，并提前 /save-all 一次。

📚 目录

📦

插件清单与版本

服务器当前装载的所有插件、用途和版本（基于 Paper 1.21.x 兼容版本）。

插件 分类 用途 版本
EssentialsX核心家、传送、经济、踢人封禁等基础玩家命令2.22.0-dev+104
EssentialsXChat核心聊天频道、前缀渲染（配合 LuckPerms）2.22.0
EssentialsXSpawn核心主城出生点、新人首次出生位置2.22.0
Vault核心经济/权限抽象层（被其他插件依赖，本身无玩家命令）—
LuckPerms核心权限组管理（群组、继承、节点）5.5.59
PlaceholderAPI核心变量解析（聊天前缀、菜单内动态信息）2.12.2
Multiverse-Core世界多世界管理（创建、传送、属性配置）5.7.2
Multiverse-Inventories世界多世界背包隔离5.3.5
Chunky世界区块预生成，减少探索卡顿1.5.3
BlueMap世界3D 网页地图（端口 8100）5.22
WorldGuard保护管理员区域规则（PVP、安全区、禁飞区）7.0.17
CoreProtect (CE)保护方块/容器全程日志，可回滚24.0
FastAsyncWorldEdit工具异步创世神，大范围建造与编辑2.15.2
WESV工具WorldEdit 选区可视化（粒子边框）2.1.10
KaMenu工具GUI 菜单、签到、商店、教程入口1.6.3
DonationTitles工具自定义称号、赞助排行与好感度称号0.3.1
AuthMe核心离线账号注册与登录保护6.0.0
Geyser + Floodgate核心跨设备/基岩版连接支持—
spark性能性能分析、TPS、热点统计1.10.173
🔑

LuckPerms 权限

LuckPerms 是服务器的权限"中枢"。所有插件的命令权限都由它分配。建议优先用网页编辑器：在控制台输入 lp editor，会生成一个临时网址，可视化拖拽即可。

建议的权限组结构

default → 新人，能用 /home /sethome /tpa 等基础命令 member → 在线满 5 小时，开放 /kit member, /nick vip → 付费/活跃玩家，/fly /hat /workbench builder → 建筑队，开放 //wand //set 等 worldedit mod → 助理管理，/ban /kick /tempban /vanish /co inspect admin → 全权管理，继承 mod + worldedit + grief + worldguard owner → 服主，* 节点

常用命令

/lp editor
打开网页编辑器（强烈推荐）。生成的链接 30 分钟内有效。
/lp creategroup <组名>
新建权限组。
/lp group <组名> permission set <节点> true|false
给某个组添加/删除权限节点。
  • /lp group vip permission set essentials.fly true
  • /lp group default permission set worldedit.* false
/lp group <组名> parent add <父组>
让某个组继承父组的所有权限。
  • /lp group admin parent add mod ← admin 继承 mod 的所有权限
/lp user <玩家> parent set <组>
把玩家加入某个组（最常用）。
  • /lp user Steve parent set vip
/lp user <玩家> permission settemp <节点> true <时长>
给玩家临时权限（活动奖励、试用 VIP 等）。
  • /lp user Steve permission settemp essentials.fly true 7d
/lp user <玩家> meta setprefix <权重> <前缀>
单独给某玩家设置聊天前缀（数字越大越靠前显示）。
  • /lp user Steve meta setprefix 100 "&6[传奇]&r "
⚙️

EssentialsX 管理命令

EssentialsX 是服务器最核心的玩家命令插件，同时提供了大量管理员命令。下面只列管理员相关的部分。

玩家管理

/ban <玩家> [原因]
永久封禁玩家。封禁前最好用 /co lookup u:玩家名 留证。
/tempban <玩家> <时长> [原因]
临时封禁。时长格式：1d、3h、30m。
  • /tempban Steve 7d 偷东西
/kick <玩家> [原因]
踢出当前会话，玩家可以重连。
/mute <玩家> [时长] [原因]
禁止玩家在公屏发言。不带时长则永久禁言。
/jail <玩家> <监狱名> [时长]
把玩家关进监狱（监狱位置先用 /setjail <名> 设置）。
/vanish
隐身。其他玩家看不见你（含管理员模式潜伏）。

游戏 / 物品

/gamemode 0|1|2|3 [玩家]
切换模式（0=生存 1=创造 2=冒险 3=旁观）。可用 /gmc /gms 等快捷别名。
/give <玩家> <物品> [数量]
给玩家发物品。支持原版 ID。
/heal [玩家] / /feed [玩家] / /repair [hand|all]
回血、回饱食度、修复手中或全部装备。
/eco give|take|set <玩家> <金额>
直接修改玩家余额（与 Vault 联动）。
/setwarp <名字> / /delwarp <名字>
在当前位置创建/删除公共传送点（玩家用 /warp 名字 前往）。
/setspawn
把当前位置设为出生点（属 EssentialsXSpawn）。
/broadcast <消息>
向全服公屏广播一条消息。
🌍

Multiverse-Core 多世界

小狼MC 当前主要世界包括：world(主世界) / world_nether(下界) / world_the_end(末地) / flatworld(平坦世界) / chuangzao(创造世界)。以 plugins/Multiverse-Core/worlds.yml 为准。

/mv create <世界名> <NORMAL|NETHER|END>
创建新世界。可加 -s <种子> 指定种子，-g BiomeBundle 指定生成器。
  • /mv create chuangzao NORMAL -t FLAT
/mv import <世界名> <NORMAL|NETHER|END>
导入服务器目录里已有的世界文件夹（比如手动复制进来的存档）。
/mv remove <世界名> / /mv delete <世界名>
remove 只是从配置移除，文件保留；delete 会真的删硬盘上的世界文件夹。
/mv tp [玩家] <世界名>
把自己（或指定玩家）传送到目标世界。
/mv modify set <属性> <值> <世界>
修改世界属性。常用：pvp、monsters、animals、gamemode、difficulty、keepspawninmemory。
  • /mv modify set pvp false world
  • /mv modify set difficulty peaceful chuangzao
/mv regen <世界>
重新生成世界。这是破坏性操作，执行前必须备份并提前通知玩家。
/mv setspawn / /mv list / /mv info <世界>
设置当前位置为该世界出生点 / 列出所有世界 / 查看某世界详情。
⏰ 世界维护建议：新建或重置世界前先 /save-all 并备份世界目录；创建完成后用 /chunky world 世界名 start 预生成，最后再更新 BlueMap 渲染。
🛡️

保护类（WorldGuard）

WorldGuard 由管理员定义全局规则区域（PVP 区、安全区、禁飞区等）。

🛡️ 当前部署的关键区域：出生点周围 200 格半径被配置为安全区（mob-spawning deny + pvp deny），服务器内公告为"新手保护圈"。对应命令示例见下方"WorldGuard" 部分。

WorldGuard（管理员区域规则）

//wand 然后 /rg define <区域名>
先用 WorldEdit 木斧选两个角，再 /rg define 创建一个 WorldGuard 区域。
  • //wand → 左/右键各点一个角 → /rg define spawn
/rg flag <区域> <标志> <值>
设置区域规则。常用标志：
  • /rg flag spawn pvp deny — 主城禁止 PVP
  • /rg flag spawn build deny — 禁止建造
  • /rg flag spawn use deny — 禁止开门、按按钮
  • /rg flag spawn mob-spawning deny — 禁止刷怪
  • /rg flag spawn invincible allow — 区域内无敌
  • /rg flag spawn fly allow — 允许飞行（搭配 EssentialsX）
  • /rg flag spawn greeting "&a欢迎来到主城" — 进入提示
  • /rg flag spawn farewell "&7再见！" — 离开提示
/rg addmember <区域> <玩家>
添加成员（可在区域内活动）。addowner 添加管理者。
/rg setpriority <区域> <数字>
设置优先级。子区域应高于父区域，数字越大优先级越高。
/rg list / /rg info <区域> / /rg remove <区域>
列出 / 查看 / 删除区域。
/rg flag __global__ <标志> <值> -w <世界>
对整个世界生效的全局标志。
  • /rg flag __global__ pvp deny -w world — 整个主世界禁 PVP
⚙️ 出生点 200 格安全区（当前配置）
以出生点为中心，半径 200 格的立方体 WorldGuard 区域，禁止刷怪 + 禁止 PVP。重现步骤：
  • //pos1 ~-200,~-100,~-200（把 X/Z 范围写成相对坐标，Y 建议覆盖全高度）
  • //pos2 ~200,~320,~200
  • /rg define spawn_safe
  • /rg flag spawn_safe mob-spawning deny — 禁止怪物刷新
  • /rg flag spawn_safe pvp deny — 禁止 PVP
  • /rg setpriority spawn_safe 5（比其它默认区域优先）
保留怪物的出生蛋 / 刷怪笼仍会生效，此标志只拦截自然刷新。
🎨

FastAsyncWorldEdit (FAWE)

FAWE 是异步版本的 WorldEdit，操作大范围地形不会卡服。建议只给 builder / admin 组开放权限，新人误用 //set bedrock 可能整片重开。

//wand
获得选区工具（默认木斧）。左键选起点，右键选终点。
//pos1 / //pos2 / //hpos1 / //hpos2
用脚下位置 / 视线指向方块作为选区两个角。
//expand <数量> [方向]
扩展选区。//expand vert 把选区上下扩到天地（清山必备）。
//set <方块>
把选区填充为指定方块。
  • //set air ← 整块清空（最常用）
  • //set 50%stone,50%dirt ← 按比例混合
//replace <旧> <新>
把选区里的某种方块替换为另一种。
  • //replace stone diamond_ore
//copy / //cut / //paste / //rotate <角度> / //flip
复制粘贴。//paste 之后用 //undo 后悔。
//schem save <名> / //schem load <名> / //schem list
保存/载入示意图（schematic）。文件保存在 plugins/FastAsyncWorldEdit/schematics/。
//undo / //redo
撤销 / 重做最近一次 WorldEdit 操作。
//cyl / //sphere / //pyramid <方块> <半径>
生成圆柱体、球体、金字塔。加 -h 表示空心。
/we limit <数量>
设置当前会话的最大改动方块数（防误操作）。
📦 WESV（WorldEdit Selection Visualizer）会在你选区周围显示发光粒子边框，所见即所得。无需配置，对建筑党非常友好。
📝

CoreProtect 行为日志

服务器上发生的所有方块、容器、聊天事件都被 CoreProtect 记录。处理纠纷时务必先查日志，再做决定。

/co inspect 或 /co i
进入检查模式。左键空气查看方块放置/破坏记录，右键容器查看物品出入记录。再次输入 /co i 退出。
/co lookup <参数>
复杂查询。常用参数：
  • u:玩家名 ← 指定玩家
  • t:7d ← 最近 7 天 / t:2h 最近 2 小时
  • r:30 ← 半径 30 格
  • a:block / a:item / a:chat / a:command / a:kill
  • b:diamond_ore ← 指定方块
  • /co lookup u:Steve t:1d a:block r:50 — 查 Steve 一天内在身边 50 格的所有方块操作
/co rollback <参数> / /co rb <参数>
回滚玩家行为。参数与 lookup 相同，必须先 lookup 确认范围，再 rollback。
  • /co rb u:破坏者 t:6h r:100 — 回滚熊孩子最近 6 小时半径 100 格的破坏
/co restore <参数>
与 rollback 相反，把"已回滚的操作"重新应用（如发现回滚错了一部分）。
/co purge t:<时长>
清理超过指定时长的旧日志（数据库会越来越大，建议每月 /co purge t:60d）。
🛟 处置流程范例：玩家 A 报告被偷 → 管理员到现场 → /co i 右键被偷的箱子 → 看见 B 在 14:32 拿走了 32 颗钻石 → 关闭 inspect → /co rb u:B t:1d a:item 回滚 B 的物品操作 → 通知双方 → 视情况封禁 B。
🗺️

BlueMap 网页地图

BlueMap 在端口 8100 上运行 HTTP Web 服务，可被反向代理（Nginx / Caddy）。配置文件位于 plugins/BlueMap/。

/bluemap
显示插件状态、版本和地图列表。
/bluemap reload
重新加载配置（修改了 core.conf、地图配置后使用）。
/bluemap freeze <地图ID>
冻结地图渲染（暂停后台渲染线程，节省 CPU）。
/bluemap fullrender <地图ID>
触发整张地图重新渲染。世界重置或大规模改造后使用，耗时根据地图大小可能几小时。
/bluemap purge <地图ID>
清空该地图的所有渲染数据（清空后通常配合 fullrender 重建）。
🌐 对外暴露建议：用 Caddy 做 HTTPS 反代到 http://127.0.0.1:8100，关闭直接 8100 公网访问。配置示例：
map.udfj.top { reverse_proxy 127.0.0.1:8100 }
⚡

Chunky 区块预生成

Chunky 在后台异步预生成区块，玩家探索时不会卡。新世界创建后必跑一次。

/chunky world <世界名>
设置目标世界（默认是当前所在世界）。
/chunky center <X> <Z>
设置预生成中心点（一般用 0 0 或主城坐标）。
/chunky radius <数字>
设置半径（单位：方块）。常见配置：主世界 5000，下界 2000，创造/平坦世界按实际范围设置。
/chunky shape <square|circle>
形状。square 配合 WorldBorder 用得多。
/chunky start / pause / continue / cancel
控制任务。continue 在重启后续传上次未完成的任务。
/chunky quiet <秒>
广播频率（默认 1 秒，建议 30 秒避免刷屏）。
🚦 建议节奏：新建世界 → /chunky world XX → center 0 0 → radius 5000 → shape square → start。预生成期间玩家可游玩，但 TPS 可能略降。
🧭

KaMenu GUI 菜单

KaMenu 用 YAML 文件定义 GUI 菜单，当前菜单文件放在 plugins/KaMenu/menus/。主菜单入口是 main.yml，玩家用 /cc 或 Shift+F 打开。

plugins/KaMenu/menus/main.yml
服务器主菜单。当前包含传送、每日签到、商店、教程和关闭按钮。
plugins/KaMenu/menus/tutorial.yml
教程菜单。提供 BlueMap 地图和玩家命令大全链接。
plugins/KaMenu/menus/shop_*.yml
商店、出售、购买、临时功能、称号相关菜单。
/papi list
查看所有可用的 PlaceholderAPI 变量（设计菜单内容时常用）。
🧪 菜单调试：修改 YAML 后重载 KaMenu 或重启服务器。常见错误是 YAML 缩进、引号缺失、动作名称写错，优先看控制台报错定位文件和行号。
🚀

性能监控（spark）

spark 是当下 Paper / Spigot 服性能分析的事实标准，能定位 TPS 下降的元凶。

/spark tps
查看最近的 TPS（5s / 10s / 1m / 5m / 15m）。低于 18 就要关注。
/spark health
一键体检：CPU、内存、TPS、MSPT 一览。
/spark profiler
启动性能分析。默认采样 30 秒，结束后自动上传到 spark.lucko.me 给一个临时网址。
/spark profiler --timeout 60 --thread *
采样 60 秒、所有线程（处理疑难杂症时使用）。
/spark gc
查看垃圾回收状况、Young/Old GC 频率与停顿时间。
/spark heapsummary
查看堆内存中各类对象的占用，定位内存泄漏。
📈 定位高占用区块的方法：/spark profiler → 让玩家正常游玩 30 秒 → 打开生成的网页 → 看 Tick > entityTick 或 worldTick 下的世界/区块占比。配合 /co lookup 查谁在那刷怪塔/红石。
🗓

日常运维节奏

每日

每周

每月

备份策略

# 推荐 cron（凌晨 4 点全量打包到 /backup） 0 4 * * * cd /opt/mc && tar czf /backup/mc-$(date +\%F).tar.gz \ --exclude='world*/region' world world_nether world_the_end plugins # region 太大，单独 rsync 0 5 * * * rsync -a /opt/mc/world/region/ /backup/region/world/
🚨

应急处置

熊孩子大范围破坏

  1. /ban 玩家名 大范围破坏 — 先封号止损。
  2. /co lookup u:玩家名 t:1d a:block — 查看破坏范围。
  3. /co rb u:玩家名 t:1d r:200 a:block — 半径 200 内回滚（按实际范围调整）。
  4. 如果涉及容器盗窃：/co rb u:玩家名 t:1d a:item。
  5. 群里通报，让被害玩家确认是否完全复原。

服务器卡顿 / TPS 暴跌

  1. /spark tps 确认 TPS。
  2. /spark profiler --timeout 60 录制 60 秒。
  3. 查看报告中的 worldTick → 哪个区块，定位元凶（一般是怪物刷新塔、红石机器、飞行物）。
  4. 必要时 /co lookup 看那块地是谁的，私聊提醒/拆除。

服务器无响应 / 崩溃

  1. SSH 上服务器，tail -200 logs/latest.log 看最后输出。
  2. 若有 Stack Trace，复制到群里 / 提 Issue。
  3. 检查内存：free -h。OOM 是常见崩溃原因。
  4. 启动脚本里 Xms / Xmx 默认 4G，玩家多 / 加载多世界时建议 6-8G。
  5. 恢复后用 /save-all、/save-on 确保保存正常。

数据回档

  1. 先 /save-off && /save-all（关闭自动保存避免覆盖）。
  2. stop 关服。
  3. 从 /backup/ 解包对应日期的存档替换 world*。
  4. 启动服务器，群里通告回档时间点。
📞 沟通原则：无论什么应急事件，先在群里发"管理员处理中，请稍候"，再动手。让玩家知道事情有人在管，比快速解决更能稳定情绪。