指令

本页面包含了服务端的一些指令，以便于玩家查询。

假人指令 (/player)

/player 是来源于 Carpet Mod 提供的核心指令之一，用于在服务端生成由模组控制的假人玩家（Bot）。假人拥有独立的 UUID 和玩家数据文件，可以模拟真实玩家的几乎所有行为，包括移动、交互、战斗、合成等。

基础语法

/player <name> <action> [arguments...]

参数	说明
<name>	假人的游戏 ID。若不存在则创建假人；若已存在则控制现有假人。
<action>	要执行的动作类型（见下方动作列表）。
[arguments...]	部分动作需要的额外参数（如频率、坐标等）。

补充说明

• 示例: /player FakeGuy spawn （在玩家当前的位置生成一个名叫"FakeGuy"的假人）

假人动作 (action)

来源于假人指令 (/player) 提供的各种行为控制。

1. 生成与销毁

动作	语法	说明
spawn	/player <name> spawn [at <pos>] [facing <pitch> <yaw>] [in <dim>]	生成假人。可指定坐标、朝向和维度。不填参数则在执行者位置生成。
rejoin	/player <name> rejoin	在该假人上次退出的位置重新生成。
kill	/player <name> kill	清除指定的假人（表现为退出游戏），背包物品不会消失。
shadow	/player <playerName> shadow	生成一个假人替代玩家本体，玩家会被强行退出游戏（异地登录）。

2. 移动与视角

动作	语法	说明
move	/player <name> move <direction>	持续向指定方向移动（forward/backward/left/right）。
jump	/player <name> jump	跳跃一次。
sneak	/player <name> sneak	切换为潜行状态。
unsneak	/player <name> unsneak	取消潜行状态。
sprint	/player <name> sprint	切换为冲刺状态（需配合 move 使用）。
unsprint	/player <name> unsprint	取消冲刺状态。
look	/player <name> look <direction|at <pos>>	看向指定方向（up/down/east等）或指定坐标。
turn	/player <name> turn <rotation>	向指定方向转身（back/left/right）。

3. 交互与操作

动作	语法	说明
attack	/player <name> attack [rate]	执行左键攻击动作。
use	/player <name> use [rate]	右键使用/放置主手物品。
drop	/player <name> drop [all|mainhand|offhand]	丢弃单个物品。加 all 丢弃所有槽位各一个。
dropStack	/player <name> dropStack [all|mainhand|offhand]	丢弃整组/全部物品。
swapHands	/player <name> swapHands	交换主副手物品。
hotbar	/player <name> hotbar <slot>	切换主手至指定的快捷栏位（1~9）。
mount	/player <name> mount	骑乘附近可骑乘的实体。
dismount	/player <name> dismount	解除骑乘状态（下马）。
teleport	/player <name> teleport	将假人传送至执行者当前位置。
stop	/player <name> stop	停止一切行为动作，返回默认待机状态。

4. 背包与存储

动作	语法	说明
inventory	/player <name> inventory	打开并操作指定假人背包内物品。
enderChest	/player <name> enderChest	打开并操作假人的末影箱。

5. 动作频率控制 (rate)

关于假人执行动作频率的相关指令，涉及多个行为动作（如 attack, use, drop 等）。

频率参数	语法示例	说明
once	/player <name> attack once	仅执行一次该动作。
continuous	/player <name> attack continuous	持续执行该动作。
after	/player <name> attack after <ticks>	在设定的 tick 之后执行一次该动作。
interval	/player <name> attack interval <ticks>	每间隔设定的 tick 执行一次该动作。
perTick	/player <name> attack perTick <times>	假人在每秒内执行指定次数的动作。
randomly	/player <name> attack randomly <min> <max>	在 min 和 max tick 之间随机取值间隔执行。

常用示例

在主世界指定坐标生成假人：

/player FakeGuy spawn at 100 100 100 facing 0 -45 in minecraft:overworld

让假人每隔3秒（60 ticks）执行一次攻击：

/player FakeGuy attack interval 60

---

At在线玩家 (/@)

/@ 是来源于 Fuji Mod的，用于在聊天栏或系统中At（提及）某位在线的玩家。

基础语法

/@ <player>

参数	说明
<player>	目标在线玩家的游戏 ID。

补充说明

• 示例: /@ Steve （At名为Steve的玩家）

---

查找周围物品 (/finder)

/finder 用于在指定范围或特定容器内搜索方块、物品或村民交易。

基础语法

/finder <type> <target> [arguments...]

参数	说明
<type>	搜索类型（block、item、trade）。
<target>	搜索的目标（方块状态、物品堆叠或交易内容）。
[arguments...]	搜索范围、起点终点或特定过滤条件。

搜索动作 (type)

1. 方块与物品搜索

动作	语法	说明
block	/finder block <blockState> [<range>|from]	在指定半径或范围内搜索指定方块。
item	/finder item <itemStack> [<range>]	在指定半径内的容器搜索指定物品。
item (范围)	/finder item <itemStack> from <blockPos1> to <blockPos2>	在指定的两个坐标范围内搜索容器内的物品。
item (离线)	/finder item <itemStack> from offline_player [inventory|ender_chest] [<showUnknown>]	在离线玩家的物品栏或末影箱内搜索指定物品。

2. 交易搜索

动作	语法	说明
trade item	/finder trade item <itemStack> [<range>]	在指定范围内搜索出售指定物品的村民交易。
trade book	/finder trade enchanted_book <enchantment> [<range>]	在指定范围内搜索指定附魔书的村民交易。

常用示例

查找周围30格以内的黑曜石：

/finder block minecraft:obsidian 30

在离线玩家的末影箱中查找任意食物：

/finder item *[minecraft:food] from offline_player ender_chest

---

邮件系统 (/mail)

/mail 用于接收或者向其他玩家发送物品，实现跨时空或离线的物品转移。

基础语法

/mail <action> [arguments...]

参数	说明
<action>	邮件操作类型（发送、撤回、接收等）。
[arguments...]	目标玩家、邮件单号等参数。

邮件动作 (action)

动作	语法	说明
multiple	/mail multiple <name>	向指定玩家一次性发送多个物品（最常用）。
send	/mail send <name>	向指定玩家发送单个物品。
recall	/mail recall <id>	撤回指定单号的邮件物品。
collect	/mail collect <id>	接收指定单号的邮件物品。
list	/mail list	查询所有邮件单号（包括其他玩家的）。

常用示例

向玩家"Steve"发送多个物品：

/mail multiple Steve

---

高亮玩家坐标 (/where & /whereis)

用于查询玩家精确位置，部分指令支持配合小地图模组高亮路径点。

基础语法

/where <player>
/whereis <player>

参数	说明
<player>	需要查询位置的目标玩家 ID。

指令区别

指令	语法	说明
/where	/where <player>	获取玩家位置。当客户端安装 FUZZ 模组时可高亮路径点。
/whereis	/whereis <player>	获取玩家位置。可保存位置在 Xaero 的小地图中。

常用示例

查询玩家"Alex"的位置并尝试高亮：

/where Alex

---

玩家坐下 (/sit)

/sit 用于让玩家执行坐下动作，方便拍照或休息时使用。

基础语法

/sit

参数	说明
无	该指令无需额外参数。

补充说明

• 操作: 坐下后按下 Ctrl 键（或对应起立按键）即可站起。

---

公开自身位置 (/here)

/here 用于向服务器内聊天框发送自身当前坐标位置信息，并获得短暂的发光效果，对所有人可见。

基础语法

/here

参数	说明
无	该指令无需额外参数。

补充说明

• 效果: 执行后获得 30 秒的发光效果，方便其他玩家寻找。

---

查询当前服务器存档种子 (/seed)

/seed 用于查询服务器当前存档的世界种子信息。

基础语法

/seed

参数	说明
无	该指令无需额外参数。

---

查询玩家当前延迟 (/ping)

/ping 用于查询自身或其他玩家的网络延迟信息。

基础语法

/ping <playerName>

参数	说明
<playerName>	目标玩家的游戏 ID（若不填或填 @s 通常指代自己）。

常用示例

查询玩家"Steve"的延迟：

/ping Steve

---

控制假玩家自动化任务 (/playerAction)

/playerAction 来源于 Carpet-Org-Addition，用于控制假玩家自动化执行一些复杂的生存任务，如合成、分拣、交易等。

基础语法

/playerAction <player> <action> [arguments...]

参数	说明
<player>	目标假人的游戏 ID。
<action>	要执行的自动化动作类型。
[arguments...]	动作所需的额外参数（如配方、过滤条件等）。

自动化动作 (action)

1. 容器与物品管理

动作	语法	说明
empty	/playerAction <player> empty [<filter>]	自动清空打开的容器，可指定过滤物品。
fill	/playerAction <player> fill [<filter>] [<dropOther>]	向容器中放入指定物品，无法填充时自动关闭。
sorting	/playerAction <player> sorting <item> <this> <other>	从物品实体中分拣指定物品丢在 this 位置，其他丢在 other 位置（可拆解潜影盒）。
rename	/playerAction <player> rename <item> <name>	打开铁砧给物品重命名（需满一组以节省经验）。

2. 合成与制作

动作	语法	说明
craft	/playerAction <player> craft <type> <items...>	在物品栏或工作台合成物品（支持 inventory, crafting_table, four, gui, nine, one）。
stonecutting	/playerAction <player> stonecutting <item|gui> [button]	使用切石机制作物品，可指定配方按钮索引或打开 GUI 设置。

3. 其他交互

动作	语法	说明
trade	/playerAction <player> trade <index> [void_trade]	与村民/流浪商人交易。加 void_trade 可进行虚空交易。
fishing	/playerAction <player> fishing	让假玩家开始钓鱼。
info	/playerAction <player> info	在聊天栏显示假玩家当前动作的详细信息。
stop	/playerAction <player> stop	停止假玩家当前的动作。

常用示例

让假人"Steve"在工作台合成铁块（九个铁锭）：

/playerAction Steve craft nine minecraft:iron_ingot

让假人"Bot"使用切石机制作石砖（按钮索引5）：

/playerAction Bot stonecutting minecraft:stone 5

---

经验转移 (/xpTransfer)

/xpTransfer 用于将自己的经验转移给其他玩家，或从假玩家身上拿取经验。

基础语法

/xpTransfer <from> <to> <amount>

参数	说明
<from>	经验来源玩家/假人 ID。
<to>	经验接收玩家/假人 ID。
<amount>	转移数量（all 全部，half 一半）。

常用示例

将"hsds"所有的经验转移给"xekr"：

/xpTransfer hsds xekr all

---

玩家动作 (/playerOperate)

/playerOperate 来源于 Carpet-Igny-Addition，用于使假玩家执行特定的循环任务，如长按右键开宝库等（需 MC>=1.20.3）。

基础语法

/playerOperate <player> <action> [arguments...]

参数	说明
<player>	目标假人 ID。
<action>	执行的动作类型（如 task, pressUse, rotation 等）。
[arguments...]	动作参数。

动作列表 (action)

动作	语法	说明
task vault	/playerOperate <player> task vault [<maxCycles>] [<onlineDuration>] [<waitingDuration>]	使假玩家执行开宝库任务（循环召唤假人长按右键）。默认值: 130, 100, 21。
pressUse	/playerOperate <player> pressUse <interval> <duration> [<cycles>]	使假玩家间隔 <interval> tick 长按右键 <duration> tick，重复 <cycles> 次。
rotation	/playerOperate <player> rotation <interval> <angle>	使假玩家每隔 <interval> tick 旋转 <angle> 度。
stop	/playerOperate <player> stop	停止该玩家的任务。
pause	/playerOperate <player> pause	暂停该玩家的任务。
resume	/playerOperate <player> resume	继续该玩家的任务（已暂停）。

全局管理

动作	语法	说明
list	/playerOperate list	查看所有任务列表。
stopAll	/playerOperate stopAll	停止所有任务。
pauseAll	/playerOperate pauseAll	暂停所有任务。
resumeAll	/playerOperate resumeAll	继续所有任务。

常用示例

生成"slnc"假人并执行开宝库任务（130次循环，100刻在线，21刻等待）：

/player slnc spawn
/playerOperate slnc task vault 130 100 21

---

设置玩家姿势 (/playerPose)

/playerPose 用于设置玩家或假人的身体姿势（如躺下、游泳等）。

基础语法

/playerPose <player> set <pose>

参数	说明
<player>	目标玩家或假人 ID。
set	固定子指令，表示设置姿势。
<pose>	姿势类型（如 sleeping 躺下）。

常用示例

让玩家"Brokeyuan"设置为躺下：

/playerPose Brokeyuan set sleeping

---

高亮当前坐标方块 (/igny)

/igny 来源于 Carpet-Igny-Addition，用于在客户端高亮显示指定坐标的方块。

基础语法

/igny highlight <blockPos>

参数	说明
highlight	固定子指令。
<blockPos>	需要高亮的方块坐标（X Y Z）。

---

高亮导游位置 (/leader)

/leader 用于管理服务器内的“导游”玩家，并定时广播其坐标。

基础语法

/leader <action> [arguments...]

参数	说明
<action>	管理动作（add, remove, broadcastLeaderPos, list）。

管理动作 (action)

动作	语法	说明
add	/leader add <playerName>	添加一位导游。
remove	/leader remove <playerName>	移除一位导游。
broadcast	/leader broadcastLeaderPos <player> interval <tick>	定时广播一名导游坐标，时间设置为负数停止广播。
list	/leader list	查看导游列表。

---

查询详细信息 (/info)

/info 用于查询方块、玩家实体、服务器或当前世界的详细运行信息。

基础语法

/info <type> <target>

参数	说明
<type>	查询类型（block, entity, server, world）。
<target>	查询的具体目标或数据指标。

查询分类 (type)

分类	语法	说明
block	/info block <position>	查询具体位置方块的详细信息。
entity	/info entity <ID>	查询指定玩家/实体的详细信息（如装备）。
server	/info server <counter>	查询服务器计数器（如 server_tick_counter, entity_id_counter）。
world	/info world <data>	查询世界信息（如 ticking_order 运算顺序, weather 天气预报）。

---

查看服务器存档大小 (/getSaveSize)

/getSaveSize 用于查看服务器当前存档文件的容量大小。

基础语法

/getSaveSize

参数	说明
无	该指令无需额外参数。

---

查看服务器大致信息 (/getSystemInfo)

/getSystemInfo 用于查看服务器当前的运行情况与基础配置信息。

基础语法

/getSystemInfo

参数	说明
无	该指令无需额外参数。

---

查询服务器详细信息 (/profiler)

/profiler 用于查询服务器的详细信息，包括硬件配置与当前 tick 运行情况。

基础语法

/profiler

参数	说明
无	该指令无需额外参数。

---

修改玩家皮肤 (/skin)

/skin 用于设置、刷新或重置玩家当前的皮肤。

基础语法

/skin <action>

参数	说明
<action>	皮肤操作（clear, refresh, reset, set）。

皮肤动作 (action)

动作	语法	说明
clear	/skin clear	清除玩家当前皮肤。
refresh	/skin refresh	刷新玩家当前皮肤。
reset	/skin reset	重置玩家当前皮肤。
set	/skin set	设置玩家当前皮肤。

---

日志命令 (/log)

/log 用于订阅或取消订阅 Carpet Mod 提供的各类服务器实时日志（如 TPS、方块更新、寻路等）。

基础语法

/log <logType> [arguments...]

参数	说明
<logType>	日志类型（如 tps, packets, tnt 等）。
[arguments...]	特定日志的过滤或显示参数。

日志类型 (logType)

类型	语法	说明
counter	/log counter [color]	漏斗计数器日志，可用 color 参数指定特定颜色的羊毛。
fallingBlocks	/log fallingBlocks [brief|full]	下落方块日志。
mobcaps	/log mobcaps [dim|dynamic]	生物数量/上限日志，可指定维度。
packets	/log packets	服务器网络收发包日志。
pathfinding	/log pathfinding [2|5|10]	生物寻路日志。
projectiles	/log projectiles [brief|full]	投掷物日志。
tnt	/log tnt [brief|full]	TNT 日志。
tps	/log tps	TPS 和 MSPT 日志。

管理指令

动作	语法	说明
列出	/log	列出所有日志类型。
清空	/log clear	取消所有订阅的日志。
取消特定	/log [logType] clear	取消订阅特定类型的日志。

---

修复音符盒音高 (/fixnotepitch)

/fixnotepitch 来源于 Carpet-Igny-Addition，用于批量设置指定区域内音符盒的音高。

基础语法

/fixnotepitch <pos1> <pos2> [<pitch>]

参数	说明
<pos1>	立方体区域的第一个对角坐标。
<pos2>	立方体区域的第二个对角坐标。
[<pitch>]	可选参数，音高取值范围为 0~24，默认值为 0。

补充说明

• 示例: 将两个坐标组成的立方体区域内的音符盒音高全部设置为 12。

/fixnotepitch ~ ~ ~ ~10 ~10 ~10 12

---

清空光照队列 (/clearlightqueue)

/clearlightqueue 来源于 Carpet-Igny-Addition，用于直接清空服务端待处理的光照更新队列。

基础语法

/clearlightqueue

参数	说明
无	该指令无需额外参数。

---

自定义物品拾取过滤 (/customPlayerPickupItem)

/customPlayerPickupItem 来源于 Carpet-Igny-Addition，用于设置自定义的物品拾取过滤规则（白名单/黑名单）。

基础语法

/customPlayerPickupItem <player> <action> [arguments...]

参数	说明
<player>	目标玩家 ID。
<action>	操作类型（get, mode, items）。

过滤动作 (action)

动作	语法	说明
get	/customPlayerPickupItem <player> get	查看目标玩家当前的拾取自定义物品。
mode	/customPlayerPickupItem <player> mode <mode>	设置拾取模式：disable (禁用过滤), whitelist (白名单), blacklist (黑名单)。
items	/customPlayerPickupItem <player> items <add|remove|clear> [<item>]	物品列表管理，添加、移除或清空过滤物品。

---

自定义物品最大堆叠数量 (/customItemMaxStackSize)

/customItemMaxStackSize 来源于 Carpet-Igny-Addition，用于修改指定物品在游戏中的最大堆叠数量上限。

基础语法

/customItemMaxStackSize <action> [arguments...]

参数	说明
<action>	操作类型（set, remove, clear, list）。

堆叠动作 (action)

动作	语法	说明
set	/customItemMaxStackSize set <item> <count>	设置指定物品的最大堆叠上限（count 范围 1~99）。
remove	/customItemMaxStackSize remove <item>	移除指定物品的自定义堆叠设置。
clear	/customItemMaxStackSize clear	清空所有已设置的自定义物品堆叠规则。
list	/customItemMaxStackSize list	列出当前所有已生效的自定义堆叠设置。

补充说明

• 提示: 鼠标指针悬浮在物品名称上可查看其完整物品 ID。

以下是按照您提供的固定格式和例子，为您整理的 Concerto Mod 相关指令板块文档：

协奏曲/一起听 (/concerto)

/concerto（可使用别名 /music）是 Concerto Mod 提供的客户端核心指令，用于控制本地的音乐播放、缓存、下载及歌单管理等功能。

基础语法

/concerto <action>

参数	说明
<action>	要执行的操作类型（见下方动作列表）。

1. 播放与缓存控制

动作	语法	说明
pause	/concerto pause	暂停播放。
start	/concerto start	开始播放。
stop	/concerto stop	停止播放。
clear	/concerto clear	停止播放并清空当前播放列表。
reload	/concerto reload	重新加载配置及歌单数据。
restart	/concerto restart	重新启动播放器核心（用于修复卡死）。
save	/concerto save	缓存当前歌曲（仅限支持缓存的音源，如网易云音乐等）。
like	/concerto like	收藏当前歌曲（仅限网易云音乐）。
dislike	/concerto dislike	取消收藏当前歌曲（仅限网易云音乐）。

2. 下载与数据管理

动作	语法	说明
download-current	/concerto download-current	将当前歌曲及相关歌词下载至本地 Concerto 文件夹。
download-all	/concerto download-all	下载当前播放队列中的所有歌曲及歌词。
export-as-playlist	/concerto export-as-playlist	导出当前缓存队列为服务端所需的预设歌单 JSON 格式。
clean-cache	/concerto clean-cache	清理客户端 Concerto/cache 目录下的所有缓存及验证文件（含 cookie）。

补充说明

• 示例: /music download-current （使用别名下载当前播放的歌曲及歌词到本地）
• 示例: /concerto clean-cache （清理本地可能损坏的缓存文件及 cookie）

---

音乐室指令 (/musicroom)

/musicroom 用于管理多人联机环境下的音乐室（需服务端安装 Concerto），实现同步听歌、房间管理及公共点播等功能。

基础语法

/musicroom <action> [arguments...]

参数	说明
<action>	房间管理或点播动作。
[arguments...]	部分动作需要的额外参数（如 UUID、玩家名等）。

1. 房间管理

动作	语法	说明
create	/musicroom create	创建并加入专属音乐室，成功后将自动复制对应的 UUID（受服务端权限要求限制）。
join	/musicroom join [UUID]	加入对应 UUID 编号的音乐室。
quit	/musicroom quit	退出当前的音乐室或点播大厅。
remove	/musicroom remove	解散当前音乐室。
members	/musicroom members	查看所在音乐室的成员列表。
op	/musicroom op [玩家]	赋予或撤销指定玩家的管理切歌权限（仅限房间创建者）。

2. 公共点播队列 (Agent)

动作	语法	说明
agent join	/musicroom agent join	加入服务器公共点播队列系统。
agent quit	/musicroom agent quit	退出服务器公共点播队列系统。
agent add	/musicroom agent add	将当前播放的音乐推送至服务器公共点播队列。
agent vote	/musicroom agent vote [true|false]	发起集体切歌投票 / 对当前进行的切歌投票投出赞成或反对。

补充说明

• 示例: /musicroom join xxx （加入 UUID 为 xxx 的音乐室）
• 示例: /musicroom agent vote true （同意当前的切歌投票）

---

P2P 音乐分享指令 (/sharemusic)

/sharemusic 用于客户端间网络直连分享正在播放的音乐。

基础语法

/sharemusic <action> [arguments...]

参数	说明
<action>	分享或处理邀请的动作。
[arguments...]	目标玩家、UUID 或页码等参数。

分享动作 (action)

动作	语法	说明
to	/sharemusic to [玩家|@a]	将播放内容分享给指定玩家。如服务端未安装模组，命令将回退至原版消息通道尝试推送。仅限白名单平台音源。
accept	/sharemusic accept [UUID]	接受指定的音乐分享请求。
reject	/sharemusic reject [UUID|all]	拒绝指定的音乐分享（后接 UUID 或输入 all 拒绝全部请求）。
list	/sharemusic list [页码]	查看待处理的音乐分享邀请列表。

补充说明

• 示例: /sharemusic to Steve （将当前正在播放的音乐分享给玩家 Steve）
• 示例: /sharemusic reject all （拒绝所有待处理的音乐分享邀请）

---

服务端管理指令 (/concerto-server)

/concerto-server 仅限管理员使用，用于管理全服的音乐广播、审核、缓存及公共点播队列。

基础语法

/concerto-server <action> [arguments...]

参数	说明
<action>	服务端管理动作。
[arguments...]	审核 ID、页码等额外参数。

1. 审核与配置管理

动作	语法	说明
audit	/concerto-server audit [UUID]	同意全服广播分享的音乐审核请求。
reject	/concerto-server reject [UUID|all]	拒绝全服广播分享的音乐审核请求（后接 all 拒绝全部等待请求）。
audit list	/concerto-server audit list [页码]	列出当前等待服务端管理员审核的广播歌曲队列。
reload	/concerto-server reload	重新加载服务端配置。
reload-cookie	/concerto-server reload-cookie	重新加载各个平台的 cookie 文件。
fetch-radios	/concerto-server fetch-radios	将服务端的预设歌单同步至本地（普通用户亦可用）。
clean-cache	/concerto-server clean-cache	清理服务端缓存数据及缓存的 cookie 信息。

2. 全局点播控制 (Agent)

动作	语法	说明
agent reset	/concerto-server agent reset	彻底重置公共点播队列。
agent cut	/concerto-server agent cut	强制全服音乐点播跳过当前歌曲。
agent stop	/concerto-server agent stop	停止音乐点播模式。
agent start	/concerto-server agent start	重新启动点播模式。

补充说明

• 示例: /concerto-server audit xxx （同意 UUID 为 xxx 的全服广播音乐审核请求）
• 示例: /concerto-server agent cut （管理员强制切歌，跳过当前全服点播的歌曲）