BlueMap 插件
BlueMap 提供 3D Web 地图展示服务器世界，通常无需手动指令即可自动渲染更新地图，但也提供了一系列管理指令：
-
/bluemap– 显示 BlueMap 渲染状态。- 参数: 无。
- 示例: 执行
/bluemap可返回类似“BlueMap 当前渲染队列任务: 2 (进行中)”的状态信息。 - 返回信息: BlueMap 当前的渲染状态，包括正在渲染的任务数等。
- 权限:
bluemap.status（默认仅OP/管理员可用）。
-
/bluemap version– 查看 BlueMap 版本信息。- 参数: 无。
- 示例:
/bluemap version将显示 BlueMap 插件版本以及系统信息等。 - 返回信息: BlueMap 当前版本号及相关系统信息。
- 权限:
bluemap.version。
-
/bluemap help– 获取 BlueMap 帮助链接。- 参数: 无。
- 示例: 输入
/bluemap help会返回插件帮助文档和支持链接（Wiki、Discord等）。 - 返回信息: BlueMap 官方文档地址和支持渠道信息。
- 权限:
bluemap.help。
-
/bluemap reload [light]– 重载 BlueMap 配置。- 参数: 可选的 “
light” 参数。如加上light则执行“轻度重载”（不重新加载资源包/模组数据，速度更快）。不加参数则完全重载所有资源、配置和Web服务器。 - 示例:
/bluemap reload light将快速重载除资源外的配置；/bluemap reload则完全重载插件配置。 - 返回信息: 重载成功或失败的信息。例如“BlueMap 配置已重载”。
- 权限:
bluemap.reload（完全重载），bluemap.reload.light（轻度重载）。
- 参数: 可选的 “
-
/bluemap maps– 列出所有已加载地图。- 参数: 无。
- 示例:
/bluemap maps列出当前 BlueMap 加载的所有世界地图名称和ID。 - 返回信息: 地图列表（每张地图的ID和名称）。
- 权限:
bluemap.maps。
-
/bluemap storages– 列出所有存储容器。- 参数: 无。
- 示例:
/bluemap storages显示BlueMap配置的所有地图存储（如本地文件存储、SQL存储等）。 - 返回信息: 存储列表及各存储中地图数量等信息。
- 权限:
bluemap.storages。
-
/bluemap storages <存储名>– 查看指定存储中的地图。- 参数:
<存储名>– BlueMap 的存储容器名称。 - 示例:
/bluemap storages database显示名为“database”的存储中包含的所有地图列表。 - 返回信息: 指定存储下的地图名称列表。
- 权限:
bluemap.storages。
- 参数:
-
/bluemap storages <存储名> delete <地图ID>– 删除指定存储中的某张地图数据（危险操作）。- 参数:
<存储名>为存储容器；<地图ID>为要删除的地图标识。 - 示例:
/bluemap storages database delete world删除数据库存储中ID为“world”的地图数据。 - 返回信息: 成功则提示地图数据已删除。如果地图正在加载则会提示需改用
/bluemap purge命令。 - 权限:
bluemap.storages.delete（删除地图数据需要管理权限）。
- 参数:
-
/bluemap stop– 暂停所有地图渲染。- 参数: 无。
- 示例: 执行
/bluemap stop暂停BlueMap当前的所有地图渲染任务。即使重启服务器暂停状态仍保持。 - 返回信息: “渲染已暂停”等确认消息。
- 权限:
bluemap.stop。
-
/bluemap start– 恢复渲染（继续被暂停的渲染）。- 参数: 无。
- 示例: 执行
/bluemap start恢复此前通过/bluemap stop暂停的渲染进程。 - 返回信息: “渲染已恢复”确认消息。
- 权限:
bluemap.start。
-
/bluemap freeze <地图ID>– 冻结指定地图的更新。- 参数:
<地图ID>– 要冻结更新的地图标识。 - 示例:
/bluemap freeze world_nether将暂停 Nether 地图的自动更新（此状态在服务器重启后仍保持）。 - 返回信息: 确认指定地图已冻结，不再更新。
- 权限:
bluemap.freeze。
- 参数:
-
/bluemap unfreeze <地图ID>– 解除冻结，恢复指定地图的更新。- 参数:
<地图ID>– 要恢复更新的地图标识。 - 示例:
/bluemap unfreeze world_nether恢复 Nether 地图的正常更新渲染。 - 返回信息: 指定地图已解除冻结并继续更新的提示。
- 权限:
bluemap.unfreeze。
- 参数:
-
/bluemap purge <地图ID>– 清除并重新渲染地图。- 参数:
<地图ID>– 要清除的地图标识。 - 示例:
/bluemap purge world将删除ID为“world”的地图所有已渲染数据。之后BlueMap会在地图未冻结的情况下重新开始渲染该地图。 - 返回信息: 确认地图数据已清除的消息。清除后若地图未冻结将重新渲染。
- 权限:
bluemap.purge。
- 参数:
-
/bluemap update [地图ID] [x z] [半径]– 手动触发更新渲染。- 参数: 可选参数：
[地图ID]指定地图，[x z]坐标指定中心位置(默认为执行者位置)，[半径]方块半径范围(默认为全图)。 - 示例:
/bluemap update world 100 64 100 50将在 world 地图中以坐标(100,64,100)为中心、50方块半径内强制更新渲染区域。若不提供参数则更新整个地图已变动的区块。 - 返回信息: 将选区放入渲染队列的提示。BlueMap 通常会自动检测世界变化并更新，本命令主要用于特殊情况手动更新。
- 权限:
bluemap.update。
- 参数: 可选参数：
-
/bluemap fix-edges [地图ID] [x z] [半径]– 重新渲染地图边缘。- 参数: 同
/bluemap update，可选指定地图、中心坐标和半径。不提供则默认当前地图全图边缘。 - 示例:
/bluemap fix-edges world强制重新渲染 world 地图所有边界区域的方块，即使这些区块没有更改。 - 返回信息: 已添加边缘重渲染任务的提示。该命令用于在更改地图边界限制后修复视觉问题。
- 权限:
bluemap.update（同更新命令）。
- 参数: 同
-
/bluemap force-update [地图ID] [x z] [半径]– 强制渲染整个区域。- 参数: 同
/bluemap update，可选指定范围。不提供则默认为整个地图。与普通update不同，此命令会**无视“无更改”**强制渲染所有区块。 - 示例:
/bluemap force-update world将无视变化状态，强制重新渲染 world 地图的全部区块。 - 返回信息: 已添加强制更新任务的提示。通常BlueMap能可靠检测变化，本命令一般仅用于测试或特殊需要。
- 权限:
bluemap.update。
- 参数: 同
-
/bluemap tasks– 查看渲染任务队列。- 参数: 无。
- 示例:
/bluemap tasks列出当前等待或进行中的渲染任务列表及其引用ID。 - 返回信息: 当前渲染线程正在处理的任务队列详情。
- 权限:
bluemap.tasks。
-
/bluemap tasks cancel <任务ID>– 取消指定渲染任务。- 参数:
<任务ID>– 要取消的任务引用ID（可通过/bluemap tasks查看）。 - 示例:
/bluemap tasks cancel 5取消队列中ID为5的渲染任务。 - 返回信息: 任务已取消的确认。如果任务不存在或已完成会有相应提示。建议优先使用地图冻结而非逐任务取消。
- 权限:
bluemap.tasks.cancel。
- 参数:
-
/bluemap troubleshoot [地图ID] [x z]– 疑难排查。- 参数: 可选
地图ID指定地图；可选x z指定坐标（默认为执行者所在位置）。 - 示例:
/bluemap troubleshoot world 150 60将检测 world 地图中坐标(150,60)附近潜在的问题并给出建议。若不提供参数则检查脚下位置所属地图。 - 返回信息: BlueMap 检测到的潜在问题列表以及修复建议。
- 权限:
bluemap.troubleshoot。
- 参数: 可选
-
/bluemap debug world [地图ID] [x y z]– 调试：世界信息。- 参数: 可选
地图ID，可选坐标x y z（默认为当前玩家位置）。 - 示例:
/bluemap debug world在当前地图当前坐标输出调试信息，如所属区块、地形高度等。如果指定坐标则输出该处的世界数据详情。 - 返回信息: 有关该世界在指定坐标处的一些调试数据（例如区块信息、生物群系等）。
- 权限:
bluemap.debug.world。
- 参数: 可选
-
/bluemap debug map [地图ID] [x z]– 调试：地图瓦片信息。- 参数: 可选
地图ID，可选平面坐标x z（默认当前位置对应的地图瓦片）。 - 示例:
/bluemap debug map world_nether 10 5输出 Nether 地图瓦片(10,5)的调试信息，如瓦片文件路径、渲染状态等。 - 返回信息: 该地图瓦片的渲染调试数据。
- 权限:
bluemap.debug.map。
- 参数: 可选
-
/bluemap debug dump– 生成调试转储文件。- 参数: 无。
- 示例:
/bluemap debug dump将在服务器./bluemap/dump.json路径生成一个包含大量 BlueMap 当前状态信息的JSON文件。 - 返回信息: 通常在控制台确认已创建 dump 文件。该文件可用于开发者分析 BlueMap 状态。
- 权限:
bluemap.debug.dump。
提示: BlueMap的大部分渲染工作会自动进行，通常不需要频繁使用以上命令。请谨慎使用删除、清除类命令，并确保有相应的备份。
CatSeedLogin 插件
CatSeedLogin（猫种子登录）是一个玩家注册/登录管理插件，提供了玩家注册、登录、更改密码以及管理员管理账户等功能。插件指令分为玩家指令和管理员指令：
玩家注册/登录指令:
-
/login <密码>或/l <密码>– 登录账户。- 参数:
<密码>为玩家账户密码。 - 示例: 玩家进入服务器后输入
/login 123456使用密码“123456”登录。 - 返回信息: 成功则提示“登录成功”，失败则返回“密码错误，请重试”等错误信息。
- 权限: 所有玩家（未登录时可用）。插件默认仅允许登录指令被未登录玩家执行。
- 参数:
-
/register <密码> <重复密码>或/reg <密码> <重复密码>– 注册账户密码。- 参数:
<密码>设置新账户密码；<重复密码>再次输入相同密码确认。 - 示例: 新玩家首次加入时输入
/register abc123 abc123注册密码为“abc123”的账户。 - 返回信息: 注册成功将提示“注册成功，请登录”，如果两次密码输入不一致或密码不符合要求则会给出相应提示（如“密码不匹配”）。
- 权限: 所有新玩家可用（未注册状态下）。
- 参数:
-
/changepassword <旧密码> <新密码> <重复新密码>或/changepw <旧密码> <新密码> <重复新密码>– 修改密码。- 参数:
<旧密码>当前账户密码；<新密码>新设置的密码；<重复新密码>再次输入新密码确认。 - 示例:
/changepw oldPass123 newPass456 newPass456将账户密码从oldPass123修改为newPass456。 - 返回信息: 成功则提示密码修改成功，之后需要使用新密码登录；失败则可能是旧密码不正确或新密码两次输入不一致。
- 权限: 登录状态下的玩家。
- 参数:
-
/bindemail set <邮箱>或/bdmail set <邮箱>– 绑定邮箱。- 参数:
<邮箱>要绑定的电子邮箱地址。 - 示例:
/bindemail set player@example.com将您的游戏账户绑定到邮箱player@example.com。随后插件会发送验证码邮件用于验证。 - 返回信息: 提示绑定验证码已发送至该邮箱。玩家需使用
/bindemail verify命令完成验证。 - 权限: 登录状态玩家可用。
- 参数:
-
/bindemail verify <验证码>或/bdmail verify <验证码>– 验证邮箱。- 参数:
<验证码>收到的邮箱验证码。 - 示例:
/bindemail verify 123456使用邮箱收到的六位验证码123456完成邮箱绑定。 - 返回信息: 验证成功会提示邮箱绑定完成；若验证码错误或过期则提示验证失败。
- 权限: 已执行过
/bindemail set且收到验证码的玩家。
- 参数:
-
/resetpassword forget或/repw forget– 申请重置密码。- 参数: 固定关键字
forget。 - 示例:
/resetpassword forget当玩家忘记密码时使用，插件将向已绑定的邮箱发送重置密码的验证码。 - 返回信息: 如果玩家已绑定邮箱，则提示重置验证码已发送；若未绑定邮箱则会提示无法执行此操作。
- 权限: 未登录且已绑定邮箱的玩家。
- 参数: 固定关键字
-
/bindemail re <验证码> <新密码>或/bdmail re <验证码> <新密码>– 使用邮箱验证码重置密码。- 参数:
<验证码>邮箱收到的重置验证码；<新密码>要设置的新密码。 - 示例:
/bdmail re 654321 newPassword使用邮箱验证码654321将账户密码重置为newPassword。 - 返回信息: 成功则提示密码已重置，接下来可使用新密码登录；若验证码错误无效则提示操作失败。
- 权限: 玩家在收到重置验证码后可用。
- 参数:
管理员管理指令（需 OP 或授权权限 catseedlogin.command.catseedlogin 才可使用）:
CatSeedLogin 所有管理类命令均以主命令/catseedlogin开头，帮助服务器管理员进行登录系统的规则设置与账户管理：
-
/catseedlogin commandWhiteListAdd <指令>– 添加登录前允许执行的指令。- 参数:
<指令>要加入白名单的指令（支持正则表达式）。 - 示例:
/catseedlogin commandWhiteListAdd /help将允许未登录玩家使用/help命令。支持使用正则如/(?i)tpa(\z| .*)添加所有形式的/tpa请求命令。 - 返回信息: 确认指定指令已加入白名单。未登录玩家在登录前可执行被白名单允许的部分命令。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin commandWhiteListDel <指令>– 删除登录前指令白名单。- 参数:
<指令>要从白名单移除的指令（需与添加时使用的匹配模式相同）。 - 示例:
/catseedlogin commandWhiteListDel /help将取消未登录状态下/help指令的使用权。 - 返回信息: 指定指令已从白名单移除的提示。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin commandWhiteListInfo– 查看当前登录前白名单指令。- 参数: 无。
- 示例: 执行
/catseedlogin commandWhiteListInfo可列出所有允许未登录玩家使用的指令列表及匹配规则。 - 返回信息: 白名单指令的完整列表信息。
- 权限: 管理员权限。
-
/catseedlogin setIpRegCountLimit <数量>– 设置同一IP最大注册账户数（默认2）。- 参数:
<数量>限制的账户数上限。 - 示例:
/catseedlogin setIpRegCountLimit 1限制同一IP地址最多只能注册1个账户。 - 返回信息: 新的IP注册数量限制已生效的提示。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin setIpCountLimit <数量>– 设置同一IP允许同时在线的账户数（默认2）。- 参数:
<数量>同IP最大同时在线数。 - 示例:
/catseedlogin setIpCountLimit 3允许同IP最多3个账号同时在线。 - 返回信息: 配置已更新的提示。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin setIdLength <最短> <最长>– 设置游戏名长度限制。- 参数:
<最短>最短长度；<最长>最长长度。默认最短2，最长15。 - 示例:
/catseedlogin setIdLength 3 12将玩家用户名限制为3～12个字符之间。 - 返回信息: 已更新ID长度限制设置。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin setReenterInterval <间隔>– 设置退出后重进的最小间隔时间（单位: ticks）。- 参数:
<间隔>以tick为单位的间隔（20tick=1秒）。默认60tick（3秒）。设置小于20则基本等于不限制。 - 示例:
/catseedlogin setReenterInterval 120设置玩家下线后必须等待至少6秒(120 ticks)才能重新进入服务器。 - 返回信息: 已更新该间隔设置的确认。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin setSpawnLocation– 设置登录地点。- 参数: 无（执行该命令的玩家当前站立位置将作为新的登录出生点）。
- 示例: 管理员站在希望的新玩家出生的坐标处执行
/catseedlogin setSpawnLocation，插件将该位置记为登录时的传送点。 - 返回信息: 提示已成功设置新的登录地点坐标。
- 权限: 管理员权限。
-
/catseedlogin setAutoKick <秒数>– 设置自动踢出未登录玩家的等待时间。- 参数:
<秒数>未登录超时时间（默认120秒）。设为小于1则关闭此功能。 - 示例:
/catseedlogin setAutoKick 60则玩家进入游戏后60秒内不登录将被自动踢出。 - 返回信息: 自动踢出时间已更改的确认。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin limitChineseID– 切换限制中文用户名开关。- 参数: 无（执行即切换开启/关闭）。默认开启（限制中文ID）。
- 示例:
/catseedlogin limitChineseID如果目前限制开启则执行后关闭，反之开启。 - 返回信息: 提示已切换“限制中文游戏名”的状态（开或关）。
- 权限: 管理员权限。
-
/catseedlogin beforeLoginNoDamage– 切换未登录前无伤害保护。- 参数: 无。默认开启（未登录前不受伤害）。
- 示例: 执行
/catseedlogin beforeLoginNoDamage切换设定（若原本开启则关闭，使未登录玩家可能受到伤害）。 - 返回信息: 提示已切换“登录前无伤害”设定状态。
- 权限: 管理员权限。
-
/catseedlogin afterLoginBack– 切换登录后返回下线位置。- 参数: 无。默认开启（登录成功后玩家传送回其下线时的位置）。关闭则登录后仍留在出生点。
- 示例:
/catseedlogin afterLoginBack切换此设定。 - 返回信息: 提示“登录后返回原位置”功能已开启或关闭。
- 权限: 管理员权限。
-
/catseedlogin canTpSpawnLocation– 切换强制登录地点传送。- 参数: 无。默认开启（未登录前强制处于设定的Spawn登录地点）。关闭后玩家下线重进不会被强制传送至Spawn（不建议关闭）。
- 示例:
/catseedlogin canTpSpawnLocation切换此设定开关。 - 返回信息: 更新“登录前强制传送到登录点”设定状态的提示。
- 权限: 管理员权限。
-
/catseedlogin deathStateQuitRecordLocation– 切换死亡状态退出记录位置。- 参数: 无。默认开启（玩家死亡界面下线将记录死亡位置并在登录后回到该处）。
- 示例:
/catseedlogin deathStateQuitRecordLocation切换此功能的开关。 - 返回信息: 确认该功能已开启或关闭。
- 权限: 管理员权限。
-
/catseedlogin delPlayer <玩家名>– 强制删除玩家账户。- 参数:
<玩家名>要删除账户的玩家用户名。 - 示例:
/catseedlogin delPlayer Steve将从登录插件数据中删除玩家“Steve”的账户记录（包括密码等），该玩家需重新注册。 - 返回信息: 成功删除则提示账户已删除。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin setPwd <玩家名> <新密码>– 强制重设玩家密码。- 参数:
<玩家名>目标玩家；<新密码>为其设置的新密码。 - 示例:
/catseedlogin setPwd Alex newpass123将玩家Alex的密码重置为“newpass123”。 - 返回信息: 确认密码已更改，该玩家下次需使用新密码登录。
- 权限: 管理员权限。
- 参数:
-
/catseedlogin reload– 重载插件配置文件。- 参数: 无。执行后插件将重新加载settings.yml等配置以及语言文件等。
- 示例:
/catseedlogin reload应用对配置文件所做的修改（如修改了欢迎消息或超时时间等配置）。 - 返回信息: 插件配置已重新加载成功的提示。如果文件有错误则会在控制台报告。
- 权限: 管理员权限。
权限说明: catseedlogin.command.catseedlogin 是上述所有/catseedlogin ...管理命令的总权限节点，服务器管理员通常赋予自己或权限组该节点以使用所有管理指令。
CMILib 插件
CMILib（CMI Library）是由 Zrips 提供的公共插件库，本身并非面向玩家的功能插件，而是为其它插件（如 CMI、Jobs、Residence 等）提供统一的命令框架、消息格式、API等支持。因此 CMILib 插件本身提供的指令非常有限。
/cmil reload– 重载 CMILib 配置。- 作用: 重新加载CMILib的配置文件和本地化语言文件。当您修改了CMILib的配置（如消息格式、自动更新设置等）后，可使用此命令使更改生效。
- 参数: 无。
- 示例:
/cmil reload重载CMILib配置，使新语言翻译即时生效。 - 返回信息: 控制台或执行者会收到 “CMILib 配置已重载” 等提示。
- 权限: 一般仅管理员(OP)使用。执行此命令需要有管理权限。
说明: 除了上面的/cmil reload之外，CMILib几乎没有其他需要手动执行的指令。它主要在后台运行，供其他插件调用。如果使用了Zrips系列的插件，确保CMILib保持最新版本即可。
CoreProtect 插件
CoreProtect 是功能强大的方块/行为日志记录和回滚插件，允许管理员查询方块破坏、放置、物品交易等历史记录，并支持回滚或还原破坏行为。CoreProtect 主命令前缀为 /co。主要指令包括：
-
/co help– 显示 CoreProtect 指令帮助列表。- 参数: 无。
- 示例: 玩家在游戏中输入
/co help将在聊天中分页显示CoreProtect可用命令及简要说明。 - 返回信息: 命令帮助列表（默认为第1页，可通过附加页码浏览后续指令列表）。
- 权限:
coreprotect系列权限默认给予OP。普通用户一般无权使用除非特别赋予。
-
/co inspect或/co i– 切换检查器模式。- 作用: 开启“检查器”后，玩家左键点击方块或实体，可查看该位置最近的破坏/放置历史记录，再次执行命令则关闭检查模式。
- 参数: 无。
- 示例: 管理员执行
/co i后，敲击一个被破坏的箱子，会在聊天中显示谁在何时破坏/打开了该箱子等信息。再次/co i可退出检查模式。 - 返回信息: 开启时提示“Inspector enabled”（检查器已启用），关闭时提示“Inspector disabled”。
- 权限:
coreprotect.inspect或OP。
-
/co lookup <参数>或/co l <参数>– 查询日志记录。- 作用: 根据提供的过滤参数，查询匹配的方块/实体交互日志。几乎所有参数都是可选的，不指定则查询全部日志。支持分页显示结果。
- 参数: 常用过滤参数如下：
u:<玩家名>指定执行操作的玩家（支持多个，以逗号分隔，如u:Notch,Steve）。也可用特殊值，如u:#tnt表示由TNT爆炸导致的变化。t:<时间>时间范围，例如t:5h表示过去5小时内；也可组合t:2d3h或范围t:1h-2h。默认为无限制（所有时间）。r:<半径>查询半径（以执行者当前位置为中心的方块范围）；或r:#world指定整个世界；r:#global全服务器；也可r:#we使用WorldEdit选区。默认不限定范围。a:<动作>限定动作类型，如a:block（方块放置/破坏），a:+block仅放置，a:-block仅破坏。支持的动作详见下文。i:<包含>限定涉及的方块/物品/实体，如i:chest只查箱子；支持多个以逗号隔开。e:<排除>排除特定方块/物品/实体，如e:stone排除石头相关记录。#<标签>使用特殊“哈希标签”执行附加操作（如#preview预览回滚，#count仅计数结果行数等，见后文）。
- 示例:
/co lookup u:Steve t:1d r:20 i:diamond_ore– 查询20格半径内过去1天中玩家Steve挖掘钻石矿石的记录。/co l t:12h a:chat u:Alex– 查询Alex过去12小时内发送的聊天消息记录。
- 返回信息: 符合查询条件的日志条目列表，默认一次显示10行，包括时间戳、坐标、玩家和动作详情等。如果结果超过一页，会提示使用
/co lookup <页码>翻页。例如 “Page 1/3”。- 例：
#1 [15:30:22] Steve removed STONE at 123,64,456表示Steve于15:30:22破坏了石头，坐标(123,64,456)。 - 可使用
/co lookup <页码>翻页，例如/co l 2显示第二页；或/co l 1:15每页15行显示第一页。
- 例：
- 权限:
coreprotect.lookup（通常OP默认拥有）。
动作参数说明:
a:参数可筛选具体的行为类型，例如：a:block– 方块放置/破坏（所有方块交互）。a:+block– 方块放置操作。a:-block– 方块破坏操作。a:container– 容器交互（物品存入/取出箱子等）。a:+container– 向容器放入物品。a:-container– 取出容器物品。a:inventory– 玩家物品栏增减（拾取或丢弃）。a:item– 物品掉落/拾起等。a:kill– 生物被杀死事件。a:chat– 聊天消息。a:command– 指令执行记录。- 等等。通过
/co help可查看全部动作筛选项。
哈希标签: 在
lookup参数末尾加上一些特殊标签可更改查询模式：#preview– 进入预览模式，将查询结果作为回滚预览应用在世界中（不会真正改变，只对自己可见，供确认效果）。#count– 仅计数符合条件的条目数，不列出详细清单。#verbose– 详细模式，在回滚/还原过程中显示更多细节信息。#silent– 静默模式，回滚/还原过程仅显示最少的信息。
-
/co rollback <参数>或/co rb <参数>– 回滚指定时间范围内的更改。- 作用: 将选定范围内在指定时间段发生的玩家操作逆向撤销（如将被破坏的方块恢复、移除放置的方块等），用于恢复破坏。
- 参数: 参数格式与
/co lookup基本相同（u:,t:,r:,a:,i:,e:等），用于限定要回滚的内容范围。**通常至少需要指定时间(t:)**以免影响过大范围。 - 示例:
/co rollback u:Griefer t:2h r:100 #preview– 预览回滚Griefer玩家过去2小时内在半径100范围造成的所有破坏。/co rb u:Steve t:1d a:-block– 回滚Steve在过去1天内破坏的所有方块（即恢复这些方块）。/co rb t:10m r:global– 回滚全服过去10分钟内的所有玩家行为（慎用，大范围回滚）。
- 返回信息: 若未使用
#preview，执行后将实际更改世界并提示如“Rollback complete (42 blocks modified)”表示完成回滚以及改变的方块数。如果有#preview标签，则进入预览模式，只对执行者显示回滚效果，并提示使用/co confirm确认或/co cancel取消预览。 - 权限:
coreprotect.rollback（只有具有该权限的管理员可执行回滚操作）。
-
/co restore <参数>或/co rs <参数>– 还原指定时间范围的更改。- 作用: 与回滚相反，“还原”用于撤销已经执行过的回滚或者重做玩家的行为。例如在误回滚后使用restore按原记录重放玩家操作，或用于恢复某玩家被撤销的动作。参数格式与
rollback相同。 - 参数: 同
/co rollback使用相同的筛选参数。请确保筛选条件与之前回滚操作一致，以正确还原。 - 示例:
/co restore u:Griefer t:2h r:100– 将前例中Griefer过去2小时内的破坏重新破坏回去（即撤销前面的回滚，相当于再破坏一次那些方块）。/co rs u:Steve t:1d a:-block– 重新移除Steve过去1天内破坏的方块（如果之前曾被回滚恢复，现在再移除一次，相当于还原他破坏的结果）。
- 返回信息: 执行后，提示类似“Restore complete (42 blocks modified)”，表示已按日志重做指定操作，数字为改变的方块数。如果使用
#preview则会有预览提示。 - 权限:
coreprotect.restore（默认OP）。
- 作用: 与回滚相反，“还原”用于撤销已经执行过的回滚或者重做玩家的行为。例如在误回滚后使用restore按原记录重放玩家操作，或用于恢复某玩家被撤销的动作。参数格式与
-
/co purge <参数>– 清理旧数据。- 作用: 删除CoreProtect数据库中较旧的日志记录，以节省存储空间。注意：一旦Purge删除数据，将无法再查询或恢复被删除时期的记录。
- 参数:
t:<时间>– 必需，指定清理多旧以前的数据。例如t:30d表示删除30天之前的所有数据，仅保留最近30天。r:<世界名>– 可选，仅清理指定世界的数据（CoreProtect 1.19+版本支持）。格式如r:#world_nether。如不指定则清理所有世界数据。i:<包含>– 可选，仅清理指定类型方块的数据（CoreProtect 1.23+支持）。如i:stone,dirt则只清除石头和泥土的旧记录。#optimize– 特殊标签（2.15+ MySQL下可用）：在清理完成后优化数据库表以回收空间（SQLite自动优化无需此选项）。
- 示例:
/co purge t:30d– 删除超过30天的所有日志，只保留最近30天的数据。(在游戏内执行时，出于安全限制，只能清除30天以上数据；控制台执行可低至24小时)。/co purge t:7d r:#world_nether– 清除Nether世界超过7天的记录，不影响其他世界的数据。/co purge t:90d i:stone,dirt #optimize– 清除超过90天的石头和泥土交互记录，并优化数据库表以回收空间。
- 返回信息: 确认成功删除旧数据的条目数，例如“Purged 15000 entries older than 30d”。如果使用
#optimize，MySQL下会显著延长执行时间但最终释放存储空间。 - 权限:
coreprotect.purge（仅限服务器管理使用，操作具有破坏性需谨慎）。
-
/co reload– 重载 CoreProtect 配置。- 作用: 重新加载config.yml等配置文件，使更改即时生效。通常包括刷新数据库设置、语言设置等。
- 示例:
/co reload在修改CoreProtect配置（如数据库连接信息）后执行，以应用修改。 - 返回信息: “Configuration reloaded.” 配置重载成功的提示。若配置有误将出现错误警告。
- 权限:
coreprotect.reload（默认OP）。
-
/co status– 查看插件状态。- 作用: 显示CoreProtect当前运行状态和版本信息等。
- 示例:
/co status - 返回信息: 插件版本、数据库类型及连接状态、日志总量、Consumer（日志记录处理队列）的实时状态（例如处理速率、队列长度）等。
- 权限:
coreprotect.status。
-
/co consumer– 切换日志写入队列处理。- 作用: 仅限控制台使用的命令。可暂停或恢复CoreProtect后台记录日志的Consumer队列。如需暂停日志写入以保障数据库完整性或维护时使用。
- 参数: 控制台环境下输入
/co consumer会在暂停与继续之间切换。 - 示例: 在控制台执行
co consumer暂停Consumer，再次执行恢复。 - 返回信息: 控制台显示“Consumer paused”或“Consumer resumed”。
- 权限: 控制台专用（游戏内无此权限）。
附加说明:
-
分页与行数: 若
/co lookup返回结果超过一页，可用/co lookup <页码>查看特定页，例如/co l 2。也可通过<页码>:<每页行数>设置分页行数，如/co l 1:10将每页显示10条日志（默认每页10条）。 -
预览模式: 使用回滚/还原指令时加上
#preview不会立刻改变世界，而是在自己客户端预览效果。此时聊天会提示输入/co confirm确认执行或/co cancel取消预览。 -
示例回滚用法:
**/co rollback Notch t:1h**– 回滚Notch玩家过去1小时内的所有操作（默认半径为10格以内）。**/co rollback u:Notch t:1h r:#global e:stone,dirt**– 全服范围回滚Notch过去1小时的操作，但排除石头和泥土。**/co rollback u:Notch t:5m a:inventory**– 回滚Notch过去5分钟内的背包物品变化（如还原取出/放入背包的物品）。
CoreProtect 的查询和回滚功能非常强大，建议管理员在实际操作前使用#preview预览，以确保筛选条件正确无误再执行。所有CoreProtect指令默认需要OP权限或赋予相应的coreprotect权限节点给用户组方可使用。
CustomCrops 插件
CustomCrops 是一款高度可定制的作物种植插件，引入季节、更高级的农耕机制（洒水器、肥料等）并支持 ItemsAdder 等自定义物品插件。以下是 CustomCrops 主要指令：
-
/customcrops setseason <世界> <季节>– 设置世界季节。- 作用: 手动更改指定世界当前的季节。季节名称根据插件配置，一般有 Spring（春）, Summer（夏）, Autumn/Fall（秋）, Winter（冬）等。
- 参数:
<世界>目标世界名称；<季节>要设置的季节名称。 - 示例:
/customcrops setseason world_nether Summer将Nether世界的季节强制设为夏季。 - 返回信息: 成功则广播或提示季节已更改为指定值（如果配置了季节变化公告，玩家可能会看到季节变化的提示）。
- 权限:
customcrops.admin（管理员权限）。
-
/customcrops reload– 重载 CustomCrops 配置。- 作用: 重新加载插件的配置文件、作物定义等。当您修改了CustomCrops的配置（例如季节周期、作物属性）后使用此命令应用更改。
- 参数: 无。
- 示例:
/customcrops reload在后台重新加载所有配置与数据包。 - 返回信息: 控制台和执行者将收到配置重载完成的提示；如有错误会报告。
- 权限:
customcrops.admin。
-
/customcrops simulate <世界> <持续时间>– 模拟洒水等周期性效果。- 作用: 手动模拟一次指定世界中洒水器等随时间运行的效果。
- 参数:
<世界>目标世界；<持续时间>以秒或tick为单位的模拟时长（具体格式参考插件文档）。 - 示例:
/customcrops simulate world 120模拟world世界中洒水器运作120秒的效果，用于测试农田灌溉情况。 - 返回信息: 通常仅在控制台确认模拟完成。玩家端不会有明显输出。
- 权限:
customcrops.admin。
-
/customcrops grow– 强制生长作物（仅在新版本中提供）。- 作用: 手动触发所有作物立即生长一阶段，无需水或时间等待。
- 参数: 无 或某些版本可能支持细分（如仅强制生长当前区块作物等）。
- 示例:
/customcrops grow将迫使所有自定义作物进行一次增长周期（测试用途）。 - 返回信息: 如果成功，将提示作物已强制生长；否则无反馈或错误消息。
- 权限:
customcrops.admin。
(注: CustomCrops 的部分功能可能通过配置自动运行，上述模拟/强制命令主要用于管理员测试或特殊情况下调整。普通玩家没有相关指令，种植、施肥等过程均通过游戏内物品交互完成。)
EClean 插件
EClean 是一个实体/掉落物清理插件，支持定时清理地面物品、怪物以及垃圾桶功能等。EClean 主命令为 /eclean（缩写/ecl）。主要指令如下：
-
/eclean reload– 重载插件。- 作用: 重新加载EClean的配置文件。如更改了清理时间间隔、提示消息等配置后可使用此命令应用更改。
- 参数: 无。
- 示例:
/eclean reload重载EClean配置。重载后，原先计划的定时清理任务会重新开始计时。 - 返回信息: 聊天提示“EClean 已重载”，并重新计划下次清理时间。
- 权限:
eclean.admin（管理员权限，允许使用所有EClean管理指令）。
-
/eclean clean– 立即执行一次全局清理。- 作用: 立刻清理全服所有符合清理条件的掉落物和实体。不会显示事先的倒计时提示（慎用，可能让玩家措手不及）。
- 参数: 无。
- 示例:
/eclean clean立即清理服务器中的所有掉落物和符合条件的生物实体。 - 返回信息: 将直接输出清理结果，例如“清理完成: 掉落物 X 个, 实体 Y 个”。
- 权限:
eclean.admin。
-
/eclean clean entity– 立即清理所有实体。- 作用: 不等待计时，立刻清理全服所有符合条件的生物/实体（不包括掉落物）。
- 参数: 无。
- 示例:
/eclean clean entity立即清除多余的动物、怪物等实体，但保留地上的物品。 - 返回信息: 提示已清理的实体数量。
- 权限:
eclean.admin。
-
/eclean clean entity <世界名>– 清理指定世界的实体。- 作用: 仅清理所指定世界中的实体。
- 参数:
<世界名>目标世界名称。 - 示例:
/eclean clean entity world_nether清理Nether中的多余实体。 - 返回信息: 提示该世界被清理的实体数量。
- 权限:
eclean.admin。
-
/eclean clean drop– 立即清理所有掉落物。- 作用: 立刻清除全服地面上的所有物品掉落，不影响生物实体。
- 参数: 无。
- 示例:
/eclean clean drop清理全服务器的掉落物。 - 返回信息: 清理完成并汇报清理的掉落物数量。
- 权限:
eclean.admin。
-
/eclean clean drop <世界名>– 清理指定世界的掉落物。- 作用: 仅清理目标世界中的掉落物品。
- 参数:
<世界名>目标世界。 - 示例:
/eclean clean drop world_the_end清除末地中的所有掉落物。 - 返回信息: 报告该世界清理的掉落物数量。
- 权限:
eclean.admin。
-
/eclean clean chunk– 立即执行一次密集区块实体清理。- 作用: 检测全服各区块实体密度，清理超过配置阈值的区块内多余实体（“怪物堆积”情况）。
- 参数: 无。
- 示例:
/eclean clean chunk扫描所有区块，移除那些单区块内过于集中的实体，以降低服务器压力。 - 返回信息: 提示已清理的“密集实体”数量。
- 权限:
eclean.admin。
-
/eclean clean chunk <世界名>– 清理指定世界的密集区块实体。- 作用: 只针对某个世界进行密集实体检测和清理。
- 参数:
<世界名>目标世界。 - 示例:
/eclean clean chunk world仅扫描主世界，清除其中超出上限的区块实体。 - 返回信息: 报告该世界清理了多少密集实体。
- 权限:
eclean.admin。
-
/eclean entity <实体名>– 统计当前世界每区块中特定实体数量。- 作用: 列出当前世界每个区块内指定类型实体的数量，便于管理员发现哪里实体过多。
- 参数:
<实体名>要统计的实体类型英文名称（支持模糊，如Zombie或Pig等）。 - 示例:
/eclean entity Creeper列出当前世界每个区块的苦力怕数量统计。 - 返回信息: 打开一个界面或在聊天中分页显示每个区块的统计结果。较大的数字标明实体聚集热点。
- 权限:
eclean.admin。
-
/eclean entity <实体名> <世界名>– 统计指定世界中特定实体。- 作用: 与上类似，但目标世界可指定而非当前世界。
- 参数:
<实体名>实体类型；<世界名>世界。 - 示例:
/eclean entity Villager world统计主世界每区块村民数量。 - 返回信息: 与无世界参数时类似，只是针对目标世界输出结果。
- 权限:
eclean.admin。
-
/eclean entity <实体名> <世界名> <数量阈值>– 统计并过滤低密度结果。- 作用: 除统计外，还可隐藏掉数量不超过指定阈值的区块，以聚焦高密度区域。
- 参数:
<实体名>；<世界名>；<数量阈值>只显示超过该数量的区块。 - 示例:
/eclean entity Sheep world 5仅显示主世界里每个拥有>5只羊的区块（少于等于5的不显示）。 - 返回信息: 列表将过滤掉低于阈值的区块，使管理员更容易发现异常密集区块。
- 权限:
eclean.admin。
-
/eclean stats– 统计当前世界实体概况。- 作用: 统计当前世界的实体总数及平均每区块数量，以及活跃区块等信息，还包括当前世界已加载区块总数等。
- 参数: 无。
- 示例:
/eclean stats获取自己所在世界（如world）的实体数量、区块数量和平均实体密度等信息。 - 返回信息: 例如“当前世界已加载生物: 300，掉落物: 50，已加载区块: 1024，平均每区块生物: 0.29”等简报。
- 权限:
eclean.admin。
-
/eclean stats <世界名>– 统计指定世界实体和区块。- 作用: 与上类似，但可指定世界。
- 参数:
<世界名>目标世界。 - 示例:
/eclean stats world_the_end获取末地的实体和区块统计信息。 - 返回信息: 与
/eclean stats无参的输出格式类似，但针对指定世界。 - 权限:
eclean.admin。
-
/eclean trash– 打开服务器垃圾桶。- 作用: 为执行者打开垃圾桶GUI（虚拟容器），可以将不需要的物品放入其中。垃圾桶内物品在预设时间后会被插件自动清除。
- 参数: 无。
- 示例: 玩家输入
/eclean trash打开一个特殊的界面，可以拖入想丢弃的物品；关闭界面后这些物品会暂存垃圾桶并倒计时清除。 - 返回信息: 无文字输出，直接打开一个容器界面（标题通常为“Trash”或配置指定名称）。
- 权限: 普通玩家使用垃圾桶功能需权限
eclean.trash（可配置给予所有玩家）。
-
/eclean show– 查看密集实体统计GUI。- 作用: 打开一个图形界面（GUI），显示当前监测到的密集区块信息。通常用于在定时清理前让管理员快速了解哪里会被视作密集。
- 参数: 无。
- 示例: 管理员执行
/eclean show打开GUI列表，按区块列出最近一次密集检测的高密度实体区块。可能以红、黄、绿等颜色区分严重程度。 - 返回信息: 无直接聊天输出，显示GUI界面。
- 权限:
eclean.admin。
权限要求:
eclean.admin– 授予使用上述所有清理和统计管理指令的权限，通常仅给管理员/OP。eclean.trash– 允许玩家使用/eclean trash垃圾桶指令（若不赋予，普通玩家无法打开垃圾桶界面）。
提示: EClean 插件会通过配置自动周期性清理掉落物和实体。管理员可在配置中设置清理间隔（CleanItemInterval 等）和清理前提醒。如果启用了提醒，玩家将在聊天中看到诸如“还有 60 秒将清理掉落物！”的广播。使用命令执行即时清理时则不会有提前提醒，所以请谨慎使用，以免玩家措手不及。
Econoblocks 插件
Econoblocks 是一款奖励挖矿的经济插件，可让玩家在采集方块时获得金钱、物品、药水效果等奖励，并支持倍率系统等。其主要指令包括：
普通玩家指令:
-
/econoblocks– 查看插件帮助菜单。- 作用: 显示Econoblocks的基本信息和可用指令列表。
- 参数: 无。
- 示例: 玩家输入
/econoblocks将收到该插件的简要说明和可用指令提示，如如何查看个人信息等。 - 返回信息: Econoblocks 插件的帮助指南。例如提示使用
/econoblocks toggle来开关收益提示等。 - 权限: 所有玩家可用（无特殊权限要求）。
-
/econoblocks toggle– 切换挖矿收益消息显示。- 作用: 玩家个人可用此命令来开启或关闭自己收到的挖矿收益聊天提示。如果不想每次挖矿都看到金钱收益提示，可关闭。再次执行则重新开启。
- 参数: 无。
- 示例: 玩家执行
/econoblocks toggle，如果原本每次挖矿都会提示“+10 金币”，关闭后将不再看到这些提示。但收益仍然获得，只是静默了消息。 - 返回信息: 切换后会提示“挖矿收益提示已关闭”或“已开启”。
- 权限:
econoblocks.toggle（默认所有玩家已启用该权限）。
管理员指令:
-
/econoblocks profile <玩家名>– 查看玩家倍率配置。- 作用: 检查某玩家当前被应用的收益倍率组或个人倍率。Econoblocks支持为特定权限组或玩家设置挖矿金钱倍数，此命令可查看其详情。
- 参数:
<玩家名>目标玩家。 - 示例:
/econoblocks profile Alex列出玩家Alex当前拥有的所有自定义倍率（如特定方块的倍率、世界倍率、手持工具倍率等）。 - 返回信息: 包括玩家各类别倍率值。例如：“Block Multiplier: 1.2x, World Multiplier: 1.0x, Tool Multiplier: 0.8x”等。
- 权限:
econoblocks.profile或econoblocks.admin。
-
/econoblocks check <block|custom> <名称>– 检查方块或自定义掉落配置。- 作用: 查看某方块或某自定义方块的掉落奖励设定详情。插件允许配置各方块掉落何种奖励及几率，本命令便于管理员查询。
- 参数:
<block|custom>指定要查询普通方块还是CustomCrops/ItemsAdder等自定义方块；<名称>方块名称或自定义方块ID。 - 示例:
/econoblocks check block diamond_ore将显示钻石矿石的掉落奖励配置（比如挖掘钻石矿给予多少钱，或额外掉落物品概率等）。 - 返回信息: 详细的掉落配置，包括该方块对应的掉落表内容，如金钱奖励范围、物品掉落及几率、药水效果奖励等。
- 权限:
econoblocks.check或econoblocks.admin。
-
/econoblocks multiplier add <玩家名> <类型> <名称> <倍率>– 为玩家添加自定义倍率。- 作用: 给某玩家设置一个额外的收益倍率。例如可以给VIP玩家对某种方块2倍奖励，或对某世界增加倍率。这些自定义倍率将与默认倍率叠加。
- 参数:
<玩家名>目标玩家；<类型>倍率类型，可为block（方块）、tool（工具）、world（世界）、custom_block（自定义方块）、custom_tool（自定义工具）；<名称>指定具体的方块名、工具名或世界名等；<倍率>浮点数形式的倍率值（1.0为100%）。 - 示例:
/econoblocks multiplier add Steve block diamond_ore 2.0为玩家Steve设置对钻石矿石的金钱奖励倍率2倍。Steve挖钻石矿将获得双倍金钱奖励。 - 返回信息: 聊天提示已成功为该玩家添加倍率项。例如“Steve 的 diamond_ore 倍率已设为 2.0”。
- 权限:
econoblocks.multiplier或econoblocks.admin。
-
/econoblocks multiplier remove <玩家名> <类型> <名称>– 移除玩家自定义倍率。- 作用: 取消之前通过
/econoblocks multiplier add给玩家设置的特定倍率。 - 参数:
<玩家名>目标玩家；<类型>和<名称>对应要移除的倍率类型和对象。 - 示例:
/econoblocks multiplier remove Steve block diamond_ore移除前例中Steve针对钻石矿石的倍率，让其恢复默认倍率。 - 返回信息: 提示该玩家相应倍率已移除。如“Steve 的 diamond_ore 自定义倍率已移除”。
- 权限:
econoblocks.multiplier或econoblocks.admin。
- 作用: 取消之前通过
-
/econoblocks reload– 重载 Econoblocks 插件。- 作用: 重新加载配置文件，包括方块掉落表、倍率设置等。更改配置后应执行此命令。
- 参数: 无。
- 示例:
/econoblocks reload重载Econoblocks所有配置，使修改的奖励或倍率设置生效。 - 返回信息: 控制台和执行者都会收到插件重载完成的提示。
- 权限:
econoblocks.reload或econoblocks.admin。
权限说明:
econoblocks.admin– 管理权限，拥有该权限者可使用Econoblocks全部管理指令（相当于拥有profile,check,multiplier,reload等子权限）。- 其他子权限如
econoblocks.toggle,econoblocks.profile等可分别赋予需要的角色。 econoblocks.group.<组名>– 将玩家归入预设的倍率组（在配置中定义不同组的倍率组合）。直接赋予某玩家对应组权限可应用整组倍率。
提示: Econoblocks 可与 Vault、PlayerPoints 等经济系统联动。玩家在挖掘方块获得货币时，通常会在聊天显示如“你挖到 10 金币!”的提示，可通过/econoblocks toggle自行关闭提示但不影响收益。插件还提供了多种掉落类型（例如直接掉落物品、给予药水效果、执行命令等），管理员可在配置中详设。请注意合理配置每种方块的奖励以保持经济平衡。
Essentials 插件
Essentials（或 EssentialsX）是常用的服务器基础功能插件，提供了非常多的基础指令（超过100条），涵盖玩家通讯、传送、家和出生点、经济、管理等各方面。下面按功能分类列出常用指令及用法：
通用 & 信息指令
/help [页码]– 帮助菜单。显示服务器可用命令列表（由插件整合输出）。/help 2翻到第二页。(Essentials会接管默认/help，使其包含所有Essentials指令说明)。/list– 查看在线玩家列表。列出当前在线玩家及分组（隐藏玩家需特殊权限才能见）。/mail send <玩家> <内容>– 发送站内信。给不在线的玩家发送邮件，TA下次上线可用/mail read查看。/mail read– 读取邮件。查看收到的站内信列表。/mail clear– 清除所有已读邮件。/motd– 查看每日公告（Message of the Day）。显示服务器 MOTD 信息（通常在配置文件 motd.txt 中定义）。/rules– 查看服务器规则。显示规则列表（配置于 rules.txt）。/ping– 查看延迟。返回你与服务器的延迟毫秒值。/afk– 设置暂离状态。标记自己为AFK（Away From Keyboard），通常会广播“<玩家> is now AFK”。移动或聊天会自动取消AFK状态。/back– 返回上一个位置。在死亡或传送后使用，回到死亡地点或传送前的位置。玩家死亡后若具备essentials.back.ondeath权限可用此命令找回尸体。/backpack– 打开额外背包（如果启用）。EssentialsX支持通过essentials.backpack权限给予玩家一个虚拟背包，可用此命令访问。
私信 & 社交指令
/msg <玩家> <消息>或/tell,/whisper– 私聊。给指定玩家发送私聊消息。/r <消息>– 回复最后收到的私聊。快捷向刚才私信你的人回复信息。/ignore <玩家>– 屏蔽玩家消息。将某玩家加入你的忽略列表，其私聊和公共聊天对你不可见。/unignore <玩家>– 取消忽略。将玩家从忽略列表移除。/nick <昵称>– 设置昵称（需要权限）。允许玩家设置彩色昵称显示名，如/nick &aSteve将名字改为绿色的Steve。/realname <昵称>– 查询昵称对应玩家。如果不知道某彩色昵称玩家的真实ID，可用此命令。
传送类指令
/spawn– 前往服务器主出生点。将玩家传送至主世界的设定Spawn点。/setspawn– 设置全服出生点（管理）。将当前所在位置设置为新的/spawn位置（需要OP或essentials.setspawn权限）。/home [家名]– 回家。传送到自己设定的家(home)位置。支持多Home时需指定名字；不指定则默认主home。/sethome [家名]– 设置家。将当前地点保存为一个home点。默认玩家只能设置1个家（可在配置调整或通过权限组扩展essentials.sethome.multiple）。若允许多home，可给每个home命名。/delhome [家名]– 删除家。移除一个home点。/homes– 列出所有家。显示自己设定的全部home名称及坐标。/warp <地标>– 前往公共传送点。传送到管理员预设的Warp点（公共地标）。/warps– 列出所有Warp。显示可用的公共Warp列表。/setwarp <名称>– 创建公共Warp（管理）。将当前位置设为一个新的warp。可通过-p参数设为付费warp，或-r设为权限warp。/delwarp <名称>– 删除Warp（管理）。移除指定名称的公共warp点。/tpa <玩家>– 请求传送到他人。向目标玩家发送请求，待对方同意后自动将自己传送到对方身边。/tpahere <玩家>– 请求将他人传送到你这里。向目标玩家发出请求把对方传送到自己位置，需要对方接受。/tpaccept– 接受传送请求。同意最近收到的一个传送请求（无论tpa或tpahere），执行后双方完成传送。/tpdeny– 拒绝传送请求。拒绝并取消该次请求。/tptoggle– 切换传送请求开关。关闭后将拒绝所有传送请求(tpa)，再次开启才可接受请求。/tp <玩家1> <玩家2>– 传送玩家（管理员）。将玩家1直接传送到玩家2所在地。/tphere <玩家>– 召唤玩家（管理员）。将指定玩家直接传送到自己位置。/tpall– 全员传送（管理员）。将服务器所有玩家传送到自己当前位置。/world <世界>– 快速切换世界。传送到指定世界的默认出生点（需要配置MultiVerse等支持）。Essentials自带的此命令需启用多世界。
时间和天气指令
/time <day|night|<数值>>– 设置服务器时间（管理员）。例如/time day将世界时间调至白天6:00，/time 18000设置时间到指定tick（18000为午夜）。需essentials.time./weather <sun|rain|storm>– 更改天气（管理员）。如/weather rain使当前世界下雨，/weather sun放晴。/ptime <玩家> <day|night|reset>– 设置个人客户端时间。允许给予玩家本地的时间效果，不影响服务器时间。例如玩家可用/ptime night让自己客户端变夜晚（需权限essentials.time）。/ptime reset恢复同步服务器。/pweather <sun|rain|storm|reset>– 设置个人客户端天气。类似ptime，对自己设置本地天气。
经济和物品指令
-
/balance或/bal,/money– 查询余额。显示自己当前拥有的经济余额金额。 -
/bal <玩家>– 查询他人余额（需权限essentials.balance.others）。 -
/pay <玩家> <金额>– 转账。将指定金额货币支付给目标玩家。如果自己余额不足会提示失败。 -
/baltop [页]– 富豪榜。列出全服余额最高的玩家排行榜，默认每页10人。 -
/eco give <玩家> <金额>,/eco take <玩家> <金额>– 发放/扣除货币（管理员）。直接增加或减少某玩家账户上的货币。 -
/eco set <玩家> <金额>– 设置玩家余额（管理员）。将玩家的余额设为指定值。 -
/worth <物品>– 查看物品价值。查询手持物品或指定物品的出售价值（需Essentials内置定价表支持）。 -
/sell <手持物品数量/all>– 出售物品。将手中物品按照预设价格卖给服务器。例如/sell hand卖出当前手持物品，/sell all卖出背包中所有可出售物品。收益将加入余额。 -
/buy <物品ID> [数量]– 购买物品（如果启用服务器商店）。Essentials可配置交易签或命令商店，/buy命令按配置价格从服务器购买物品。一般默认未启用，需要配置商品清单和权限。 -
/item <物品ID> [数量]– 获取物品（管理员）。快速从空中获取指定物品到自己背包，相当于/give。 -
/give <玩家> <物品ID> [数量]– 给予物品（管理员）。将指定物品直接发送到目标玩家背包。支持minecraft:前缀或Essentials自带简称。 -
/i <物品ID> [数量]–/item命令的简写。 -
/more– 增加手持物品至满 stack。将手中物品数量叠加到其最大堆叠上限（管理员或需权限）。 -
/repair [hand|all]– 修复物品。修复手持物品耐久，/repair all修复身上所有装备（需要essentials.repair权限，普通玩家通常有essentials.repair用于付费修理或次数限制）。 -
/enchant <附魔名> [等级]– 附魔手持物品。给当前持有物品添加指定附魔，需管理员或使用权限essentials.enchant。 -
/potioneffect <效果> <时间> <强度>– 施加药水效果（管理员）。给自己添加指定药水效果，也可/effect。
其他实用指令
/fly– 飞行模式。切换自身飞行能力开关（需要权限essentials.fly，通常给予VIP或管理员）。/speed <等级>– 调整行走/飞行速度。0-10范围，普通行走默认1，飞行默认1。需essentials.speed权限。/speed 5显著加快速度。/god– 无敌模式。开启后玩家不会受到任何伤害，再次执行关闭。需essentials.god权限。/heal [玩家]– 治愈。立即治满自身或指定玩家的生命值和饥饿（并消除负面效果）。/feed只恢复饥饿值。需要essentials.heal或essentials.heal.others权限。/feed [玩家]– 填饱肚子。恢复饥饿值到满。（权限essentials.feed）。/workbench或/wb– 虚拟工作台。打开一个3x3工作台GUI，无需实际工作台方块。权限essentials.workbench。/enderchest或/ec– 虚拟末影箱。打开自己的末影箱界面。/enderchest <玩家>可查看他人末影箱（管理员权限）。/hat– 戴帽子。将手持物品戴在头上作为头盔（需要essentials.hat，通常给予玩家娱乐）。/sethome <名称>,/home <名称>– 家的设置与使用（见上文传送类）。/setwarp <名称>,/warp <名称>– Warp点设置与使用（见传送类）。/compass– 指南针方向。输出你面朝的方向（北东南西）和角度。/depth– 当前深度。显示你当前所在的高度层（如地表高度，海拔等）。/suicide– 自杀。令自己死亡（可能用于重置状态等）。
管理员专用/管理类指令
/kick <玩家> [原因]– 踢出玩家。将某玩家踢下线，可附加原因广播给服务器。/ban <玩家> [原因]– 封禁玩家。将玩家永久封禁，原因会记录和告知。/tempban <玩家> <时间> [原因]– 临时封禁。如/tempban Notch 3d 违反规定封禁Notch 3天。支持时间格式：s秒,m分钟,h小时,d天,w周。/unban <玩家>– 解封。解除对某玩家的封禁（包括临时封禁提前解除）。/mute <玩家> [时间]– 禁言。阻止玩家发送聊天消息，可附加持续时间。/unmute <玩家>– 取消禁言。/jail <玩家> <牢房名> [时间]– 监禁。将玩家传送至预设的Jail区域并限制其活动，可设置释放时间。/unjail <玩家>– 释放被监禁玩家。/op <玩家>//deop <玩家>– 赋予或移除服务器管理员(Operator)状态。/broadcast <消息>或/bc– 广播公告。以醒目的格式向全服广播一条消息（通常为[Broadcast]前缀加彩色）。/setspawn– 设置主世界spawn点（见前文）。/spawnmob <类型> [数量]– 召唤生物。生成指定类型生物若干只在当前位置。需essentials.spawnmob权限。/vanish– 隐身模式。让自己对普通玩家不可见（需要EssentialsAntiBuild或EssentialsX附加功能支持，权限essentials.vanish）。/gm <模式>或/gamemode <模式>– 切换游戏模式。Essentials会简化/gamemode命令，如/gm 1切换创造，/gm 0生存。需essentials.gamemode权限。/speed <数字>– 前述改变移动/飞行速度命令，管理员亦常用来快速飞行巡查。/whois <玩家>或/essentials <玩家>– 玩家信息。查询玩家的IP地址、最后在线、权限组等详细信息。/invsee <玩家>– 检查玩家背包。打开目标玩家的主物品栏视图（若有修改权限则可拿取物品，否则默认为仅查看）。/kill <玩家>– 杀死玩家。使目标玩家立即死亡。/setspawn [world]– 设定当前所在位置为某世界的spawn点。单世界服只需/setspawn。多世界环境下可/setspawn <world>指定。
Essentials 权限: Essentials指令的权限控制非常细致。常见权限节点如：
essentials.home,essentials.sethome（设置/使用家），essentials.warp,essentials.warp.list（使用warp及查看列表），essentials.tpa,essentials.tpaccept（传送请求），essentials.pay,essentials.balance（经济），essentials.fly,essentials.heal,essentials.feed,essentials.repair等对应各种实用功能。
默认情况下，很多基础命令对所有玩家开放（如/sethome,/spawn,/balance等），管理命令只对OP开放。可以通过权限插件（LuckPerms等）按需赋予或剥夺Essentials权限节点以定制玩家可用指令集。
备注: Essentials 插件功能极其丰富，上述仅列出常用部分指令。Essentials配置文件可调整大量选项，如是否允许/nick彩色昵称、/home数量限制、经济初始金额等。建议服务器管理员查看Essentials的Wiki或帮助文档获取完整指令和权限列表并根据需要配置。Essentials各子模块（Chat、Spawn、Protect等）也提供针对性功能，这里主要涵盖Essentials-Core的指令。
GSit 插件
GSit 是一个增加玩家姿势动作的插件，允许玩家坐下、躺下、匍匐、旋转等动作，还支持玩家相互叠坐（骑乘）。插件默认大部分动作所有玩家都可使用，部分功能需要权限控制。主要指令如下：
-
/sit– 坐下。- 作用: 让角色在原地坐下。如果对某些可坐的方块（如楼梯）右键，也能坐下，但
/sit命令强制在任意方块处坐下。 - 参数: 无。
- 示例: 玩家站着输入
/sit，角色将直接在原地坐下（呈现出坐姿态势）。再次使用/sit或移动即可站起。 - 返回信息: 无特别文本提示，玩家模型会改变姿势为坐。
- 权限:
GSit.Sit（默认所有玩家可用）。
- 作用: 让角色在原地坐下。如果对某些可坐的方块（如楼梯）右键，也能坐下，但
-
/lay– 躺下。- 作用: 使角色平躺在地面上，就像在床上睡觉的姿势，但可在任意地点使用。
- 参数: 无。
- 示例: 输入
/lay，角色将躺倒在地（仰卧姿势）。可用于角色装死或休息的情景。再次执行或挪动恢复站立。 - 权限:
GSit.Lay（默认开放给所有玩家）。
-
/bellyflop– 趴下（俯卧）。- 作用: 让角色俯卧在地，类似匍匐但不会移动。
- 参数: 无。
- 示例:
/bellyflop后角色会面朝下趴在地上。这常用于角色扮演倒地等场景。 - 权限:
GSit.Bellyflop（默认所有玩家可用）。
-
/crawl– 匍匐前进。- 作用: 让角色进入匍匐姿势，可以贴地移动（类似1.14+游泳状态在地上）。适用于钻1格高通道。
- 参数: 无。
- 示例: 玩家执行
/crawl后，角色以游泳的姿态在地面爬行，可通过方向键移动穿过一格高空间。再次/crawl或站立取消。 - 权限:
GSit.Crawl（默认所有玩家可用）。
-
/spin– 旋转。- 作用: 角色原地旋转360度并伴有特效粒子。属于娱乐性动作。
- 参数: 无。
- 示例: 输入
/spin，你的角色会原地快速旋转一圈，同时可能伴随插件特定的粒子效果（如星星）。 - 权限:
GSit.Spin（默认所有玩家可用）。
-
/sit toggle– 切换右键坐下功能。- 作用: GSit 默认允许玩家右键可坐方块（台阶等）自动坐下。使用此命令可开关右键坐功能。关闭后玩家右键方块将不会坐下，只有通过
/sit命令才能坐。 - 参数: 无。
- 示例:
/sit toggle如果玩家觉得右键误坐尴尬，可以执行此命令禁用自己右键坐下功能；再次执行重新启用。 - 返回信息: 提示“坐下点击 已禁用/已启用”。
- 权限:
GSit.SitToggle。
- 作用: GSit 默认允许玩家右键可坐方块（台阶等）自动坐下。使用此命令可开关右键坐功能。关闭后玩家右键方块将不会坐下，只有通过
-
/sit playertoggle– 切换被坐功能。- 作用: 控制是否允许他人右键坐在你身上。GSit 支持玩家对玩家坐肩（叠罗汉），此命令开关别人能否坐你。
- 参数: 无。
- 示例:
/sit playertoggle关闭后，其他玩家将无法右键坐在你头上或腿上；再次执行可重新允许。 - 返回信息: “玩家骑乘 已禁用/已启用”。
- 权限:
GSit.PlayerSitToggle。
-
/gsitreload或/gsitrl– 重载 GSit 配置。- 作用: 重新加载GSit的配置文件。用于在更改设置（如黑名单世界、不安全坐标开关、叠坐人数上限等）后应用新配置。
- 参数: 无。
- 示例: 管理员执行
/gsitrl重载插件，插件将读取新的config.yml设置并应用，如调整允许叠坐的玩家数量等。 - 返回信息: 控制台或执行者收到“GSit 配置已重载”。
- 权限:
GSit.Reload（仅管理员）。
无命令的功能 & 其他权限:
- 右键坐下: 除
/sit命令外，GSit允许玩家右键点击楼梯、台阶、台阶之类的方块坐下，此功能默认开启（可用/sit toggle个人关闭）。权限GSit.SitClick控制此行为。默认所有玩家可坐可点。 - 右键玩家叠坐: 玩家可右键另一个玩家肩膀来坐在其头顶（需被坐者未禁止）。权限节点
GSit.PlayerSit控制是否可执行此行为，默认启用。叠坐高度、数量可在配置调整。 - 踢下乘客: 管理员具有
GSit.Kick.Sit和GSit.Kick.Pose权限，可以强制将坐着或摆姿势的玩家复位站立。例如如果玩家卡在某姿势，可用命令/gsit kick <玩家>（注意GSit没有显式的kick子命令，但有权限可通过交互实现kick）。一般情况下无需专门指令，因为玩家移动即可自行解除。 - 世界黑名单: GSit配置可设定某些世界禁止坐/躺等（WorldBlack列表）。权限
GSit.Bypass.World可使管理员无视黑名单，在任何世界都能使用GSit动作。
GSit 插件主要用于趣味和角色扮演，不影响实际玩法。所有动作在退出服务器或死亡后都会重置为站立状态。玩家如果遇到无法自行站起的情况（极少），管理员可通过飞行碰撞或使用GSit的踢乘客权限将其复位。