⚠️
操作前请务必阅读： 所有破坏性命令（如 op、stop、/co rollback、//set、/plugman unload）都会影响所有玩家。下达大范围命令前，请先在群里通知，并提前 /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.42
PlaceholderAPI核心变量解析（聊天前缀、菜单内动态信息）2.12.2
Multiverse-Core世界多世界管理（创建、传送、属性配置）5.6.1
Chunky世界区块预生成，减少探索卡顿1.4.10
BlueMap世界3D 网页地图（端口 8100）5.16
GriefPrevention保护金铲圈地，玩家自助保护建筑最新
WorldGuard保护管理员区域规则（PVP、安全区、禁飞区）最新
BentoBox世界空岛玩法框架（运行各种 Skyblock/OneBlock 子模式）3.14.1
AOneBlock世界BentoBox 子模式：一格方块从虚空起步1.23.0
CoreProtect (CE)保护方块/容器全程日志，可回滚23.1
FastAsyncWorldEdit工具异步创世神，大范围建造与编辑2.15.1-1300
WESV工具WorldEdit 选区可视化（粒子边框）2.1.9
DeluxeMenus工具GUI 菜单（依赖 PlaceholderAPI）1.14.1
spark性能性能分析、TPS、热点统计1.10.172
PlugManX性能插件热重载/卸载（不需要重启）3.0.3
🔑

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(末地) / world_resource(资源世界，定期重置) / AOneBlock 等空岛世界（由 BentoBox 自动管理，无需手工导入到 Multiverse）。

/mv create <世界名> <NORMAL|NETHER|END>
创建新世界。可加 -s <种子> 指定种子，-g BiomeBundle 指定生成器。
  • /mv create world_resource NORMAL -s 1234567
/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 hard world_resource
/mv regen <世界>
重新生成世界（资源世界周更必备）。建议加 -s 重新随机种子。
/mv setspawn / /mv list / /mv info <世界>
设置当前位置为该世界出生点 / 列出所有世界 / 查看某世界详情。
⏰ 资源世界周更建议：每周一凌晨 4 点（用 EssentialsX /broadcast 提前 24 小时通知），先 /save-all → /mv remove world_resource → /mv create world_resource NORMAL → 再用 /chunky world world_resource start 预生成 5000 半径。
🛡️

保护类（GriefPrevention / WorldGuard）

两个保护插件分工：GriefPrevention 给玩家在主世界自助圈地，WorldGuard 由管理员定义全局规则区域（PVP 区、安全区、禁飞区等）。空岛玩法的保护由 BentoBox 自身处理，参见下面"空岛"分区。

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

GriefPrevention（玩家圈地）

/adminclaims
切换为管理员圈地模式。在此模式下圈出的地是"管理员领地"，所有管理员都能编辑。
/abandonallclaims <玩家>
放弃某玩家的所有圈地（清退离服/违规玩家的领地）。
/deleteclaim
删除当前位置的圈地（强制）。
/adjustbonusclaimblocks <玩家> <数量>
奖励/扣除玩家的圈地额度（活动奖励常用）。
/restorenature
手持金铲，把选区还原为自然地形（清除被破坏的乱坑）。

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（比其它默认区域优先）
保留怪物的出生蛋 / 刷怪笼仍会生效，此标志只拦截自然刷新。
🏝️

BentoBox + AOneBlock 空岛

BentoBox 3.14.1 是空岛玩法的核心框架，AOneBlock 1.23.0 是它的子模式（Game Mode Addon），实现"一格方块"玩法。BentoBox 自身不带玩法，所有玩法都由 GameModeAddon 提供。

BentoBox 框架命令

/bentobox 或 /bbox
查看框架状态、版本与已加载的 Addon 列表。
/bentobox version
查看 BentoBox 与所有 Addon 的版本号（升级前必看）。
/bentobox reload
重新加载所有 Addon 配置文件（编辑 yml 后使用，但 GameModeAddon 的 schema 改动需要 /plugman reload BentoBox）。
/bentobox catalog
在线查看官方 Addon 目录（添加新玩法时用）。
/bentobox locale <语言>
切换 BentoBox 显示语言（zh-CN 简体中文）。

AOneBlock 管理命令

AOneBlock 的管理命令默认前缀是 /aob admin（玩家用 /oneblock）。如果改了配置 aoneblock.yml 中的 commands，请以服务器实际为准。

/aob admin
查看 AOneBlock 的管理子命令一览。
/aob admin tp <玩家>
传送到指定玩家的空岛（救援、检查违规建筑等）。
/aob admin delete <玩家>
删除玩家的空岛（彻底清空，不可逆）。
/aob admin reset <玩家>
重置玩家的空岛（保留账户，但岛屿恢复初始状态）。
/aob admin setspawn
把当前位置设为空岛世界的大厅出生点（玩家未创建岛时降落于此）。
/aob admin range set <玩家> <格数>
单独修改某玩家的空岛保护半径（默认 50，VIP 可加大）。
/aob admin team add <岛主> <玩家>
手动把玩家加入某岛主的队伍（处理误踢/账号纠纷）。
/aob admin reload
仅重新加载 AOneBlock 的配置（不动其他 Addon）。
/aob admin phases
查看 / 调整 OneBlock 的阶段配置（草原/海洋/下界等的方块概率与触发等级）。
📁 关键文件位置：
  • plugins/BentoBox/config.yml — 框架全局配置
  • plugins/BentoBox/addons/AOneBlock-1.23.0.jar — Addon 本体
  • plugins/BentoBox/addons/AOneBlock/config.yml — AOneBlock 配置
  • plugins/BentoBox/addons/AOneBlock/phases/ — 阶段定义（YAML，可自定义）
  • plugins/BentoBox/database/ — 玩家与岛屿数据（JSON / YAML / MySQL 可选）
⚠️ 升级 BentoBox / AOneBlock 注意：主版本号变化（如 3.x → 4.x）通常会改 schema，请先备份 BentoBox/database/ 整个目录，并在测试服跑一遍。
🎨

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，资源世界 3000。
/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 可能略降。
🧭

DeluxeMenus GUI 菜单

DeluxeMenus 用 YAML 文件定义 GUI 菜单，依赖 PlaceholderAPI。所有菜单文件放在 plugins/DeluxeMenus/gui_menus/。

/dm reload
重新加载所有菜单配置（编辑 YAML 后必须执行）。
/dm open <菜单名> [玩家]
为指定玩家打开菜单（不带玩家就给自己开）。
/dm list
列出当前已加载的所有菜单。
/papi list
查看所有可用的 PlaceholderAPI 变量（设计菜单内容时常用）。
🧪 菜单调试：把出错的菜单文件重命名为 .bak，/dm reload 后看控制台报错，再修正语法。常见错误是 YAML 缩进或 commands: 列表写法。
🚀

性能监控（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 查谁在那刷怪塔/红石。
🔧

PlugManX 插件热重载

PlugManX 让你不重启服务器就能加载/卸载/重载插件。注意：核心插件（LuckPerms、Vault、PlaceholderAPI）热重载可能造成依赖断裂，谨慎使用。

/plugman list
列出所有插件及加载状态（绿色=已加载，红色=已停用）。
/plugman load <插件名>
加载新放进 plugins/ 文件夹的插件（不需要重启）。
/plugman unload <插件名>
卸载插件（用于排查冲突或临时禁用）。
/plugman reload <插件名>
重新加载插件（修改了配置后使用，但插件本身要支持热重载）。
/plugman info <插件名>
查看插件作者、版本、依赖、命令列表。
⚠️ 升级插件正确流程：下载新 jar → /plugman unload 插件名 → 替换文件 → /plugman load 插件名 → 看控制台是否报错。若插件持有大量缓存数据（如 LuckPerms、CoreProtect），仍建议滚动重启而不是热重载。
🗓

日常运维节奏

每日

每周

每月

备份策略

# 推荐 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. 启动服务器，群里通告回档时间点。
📞 沟通原则：无论什么应急事件，先在群里发"管理员处理中，请稍候"，再动手。让玩家知道事情有人在管，比快速解决更能稳定情绪。