指令

信息 (info)

world ticking_order

/info world ticking_order

显示游戏中所有维度运算的顺序

world weather

/info world weather

显示当前的世界中天气相关变量的数据，并将其整理成一份天气预报

存活时间 (lifetime)

一个追踪所有新生成生物的存活时间及生成/移除原因的记录器

该记录器主要用于测试各种刷怪塔，用于追踪从生物开始影响怪物容量上限，至移出怪物容量上限的这个过程。该记录器的生成追踪并未覆盖所有的生物生成原因

对于一个生物，除了其因各种原因被移出世界，当其首次变为不计入怪物容量上限时，例如被命名、捡起物品，也会被标记移除。如果一个生物生成时已不在怪物容量上限中，那它将不会被追踪

作为一项附加功能，该跟踪器还跟踪由方块或生物掉落的物品和经验球的存活时间。注意该追踪器并未追踪所有可能的掉落物或经验球生成，推荐先做好相关测试

给指令添加 realtime 后缀可将速率结果从基于游戏时间转换为基于现实时间

如果你需要切换对不占用怪物容量的生物的策略，可以去看看规则存活时间追踪器考虑怪物容量

tracking

/lifetime tracking [<start|stop|restart>]

控制存活时间追踪器

追踪的实体类型：

所有种类的生物 (MobEntity)。生物需占用刷怪上限才可被追踪（可将规则存活时间追踪器考虑怪物容量设置为 false 以跳过这个刷怪上限占用检查）
掉落物实体
经验球实体
载具实体，包括矿车和船（及其变种）

追踪的实体生成原因

方块掉落（仅掉落物）
繁殖
/summon 指令
从容器中掉出（仅掉落物）
被方块投出
怪物蛋等
骑手
骑手的坐骑
自然刷新
末影人放下方块（1.16+）。需要规则存活时间追踪器考虑怪物容量的值为 true
玩家上线（针对其载具）
地狱门僵尸猪人生成
袭击
史莱姆分裂
刷怪笼
被生物或方块召唤
离开载具（1.16+）。需要规则存活时间追踪器考虑怪物容量的值为 true
僵尸增援
生物掉落（仅掉落物及经验球）
生物扔出（仅掉落物）
生物转换
状态效果（如 mc1.20.5+ 的渗浆、虫蚀）
跨维度到来

注意，只有被追踪了生成的实体会被统计

追踪的实体移除原因

消失，包括立即消失、随机消失、因游戏难度的消失以及超时消失
自爆（如苦力怕）
被漏斗或漏斗矿车收集（仅掉落物）
实体合并（仅掉落物及经验球）
获取持久（persistent）标签。需要规则存活时间追踪器考虑怪物容量的值为 true
末影人捡起方块（1.16+）。需要规则存活时间追踪器考虑怪物容量的值为 true
玩家下线（针对其载具）
骑上载具（1.16+）。需要规则存活时间追踪器考虑怪物容量的值为 true
进入虚空
被玩家或生物捡起（仅掉落物及经验球）
生物转换
受伤致死
跨维度离开
其他（其余未被统计的原因）。如果有些重要的移除原因未被统计，欢迎来提相关 feature request 的 issue

存活时间的定义为：实体生成时刻与移除时刻间的经过的自然生物刷新阶段的数量，也就是刷怪时被该实体影响了怪物容量上限的游戏刻数。技术上来讲，刷怪阶段数量计数器的注入位置是世界重新计算怪物容量上限前

统计信息以数量所占比例排序

<实体类型>

/lifetime <实体类型> [<life_time|removal|spawning>]

显示指定实体类型的详细统计信息。你可以指定输出哪一部分统计信息

比如 /lifetime creeper 将详细地显示爬行者的统计信息，/lifetime creeper removal 则只详细显示爬行者的移除统计信息

filter

/lifetime filter <实体类型> set <实体选择器>
/lifetime filter <实体类型> clear

为指定实体类型设置实体筛选器。在 <实体类型> 处键入 global 以设置全局筛选器

实体需要被对应的筛选器所接受才可被存活时间追踪器进行追踪

使用 @e 类型的 Minecraft 实体选择器来输入实体筛选器，如：@e[distance=..100,nbt={Item:{id:"minecraft:oak_sapling"}}]

使用 /lifetime filter 来显示激活的实体筛选器

recorder

存活时间数据记录器：将每个实体的生成/移除流水事件写入文件，以供后续统计分析

指令	效果
`/lifetime recorder`	展示数据记录器的状态
`/lifetime recorder status`	同上
`/lifetime recorder reload`	重新加载数据记录器的配置文件
`/lifetime recorder enable`	启用数据记录器，并更新配置文件。
`/lifetime recorder disable`	禁用数据记录器，并更新配置文件。

若数据记录器已启动，下一次存活时间记录器（/lifetime tracking）开始时，将开始记录数据

在存活时间记录器停止，或数据记录器被禁用时，本次数据记录过程将被停止

备注

由于“存活时间数据记录器”功能涉及写服务端的文件，因此默认情况下只有服务器所有者才有权进行操作。若需放开权限控制，可以通过配置文件调节

配置文件路径：config/carpettisaddition/lifetime/recorder_config.json

默认配置以及解释如下：

{
  // 存活时间数据记录器启用状态
  // 可通过 `/lifetime recorder [enable|disable]` 来调整
  "enabled": false,  
  
  // 使用 `/lifetime recorder` 的控制命令所需的额外权限等级
  "requiredPermissionLevel": 4,  // 使用该命令所需的最低权限等级
  "consoleOrSinglePlayerOwnerOnly": true,  // 若为 true，则只有服务端控制台，或单人游戏房主，可使用
  
  // 数据记录输出相关配置
  "outputDirectory": "config/carpettisaddition/lifetime/records",  // 输出文件夹
  "maxOutputRecordCount": -1,       // 单个记录文件最大记录数。超出限制后本次记录将暂停
  "maxOutputFileBytes": 104857600,  // 单个记录文件最大字节数。超出限制后本次记录将暂停
  "maxTotalOutputFileCount": 500,         // 输出文件夹里记录文件的数量限制。超出后将不再触发新的记录
  "maxTotalOutputFileBytes": 1073741824,  // 输出文件夹里记录文件的总大小限制。超出后将不再触发新的记录
  
  // 数据记录相关
  "sampleRate": 1.0  // 采样率，一个 0~1 的实数
}

输出文件将命名为 rec_${yyyyMMddHHmmss}_${id}.jsonl，如 rec_20250818015654_1.jsonl。格式为 jsonl，每行一个 jsonl 代表一条记录数据

json 字段说明如下：

{
  // 服务器相关信息
  "serverTick": 704,   // MinecraftServer 的 tick 计数器
  "gameTime": 483897,  // 主世界的 game time
  
  // 事件相关信息
  "eventType": "removal",  // 事件大类。可能为 "spawning"（生成）或 "removal"（移除）
  "eventId": "death",      // 事件种类。对应着不同的生成原因 / 移除原因
  "eventPosition": [156.55, 80.0, 567.45],  // 发生事件时的实体坐标。大概率和下面的实体坐标一样
  "eventData": {  // 事件的额外数据。内部的字段取决于具体的事件种类，也可能什么都没有
    "damageSource": "player"  // 如 death 事件会有个 damageSource 字段，表示致死伤害源
  },
  
  // 实体相关信息
  "entityType": "minecraft:llama",  // 实体类型
  "entityId": 159,  // 实体 ID（网络 ID）
  "entityUuid": "9503642c-2d5f-4a27-9b91-c09853538397",  // 实体 UUID
  "entityPosition": [156.55, 80.0, 567.45],  // 实体坐标
  "entityDimension": "minecraft:overworld",  // 实体所在维度
  "entityLifetime": 190  // 实体的存活时间（gt）
}

操控世界 (manipulate)

操控世界

block

操控世界中的方块

/manipulate block <x> <y> <z> [action]

可使用规则操纵方块指令数量上限来调整可操纵的方块数上限

execute

/manipulate block <from> <to> [actions]，其中 <from> 和 <to> 均为由 <x> <y> <z> 组成的方块坐标

令目标方块（和流体）立即执行给定的游戏逻辑

指令	执行的逻辑	包含流体
`/manipulate block <from> <to> execute block_event <type> <data>`	方块事件	❌
`/manipulate block <from> <to> execute precipitation_tick`	降水刻（precipitation）	❌
`/manipulate block <from> <to> execute random_tick`	随机刻	✔️
`/manipulate block <from> <to> execute tile_tick`	计划刻	✔️

若需计划执行而非立即执行，可以去看看 /manipulate container 指令

emit

/manipulate block <from> <to> emit [what]

令目标方块立即发出给定事件，如各种更新等

指令	发出的事件
`/manipulate block <from> <to> emit block_update`	方块更新（NC）
`/manipulate block <from> <to> emit state_update`	状态更新（PP）
`/manipulate block <from> <to> emit light_update`	光照更新

chunk

操作世界中的区块

erase

擦除给定区块，将其擦除至空置域环境

危险

擦除操作无法撤回，请在操作前备份，三思而后行

会擦除的东西：

方块
实体
方块实体
方块事件
光照

不受影响的东西:

结构

指令	效果
`/manipulate chunk erase current`	擦除你所在的区块
`/manipulate chunk erase square\|chebyshev <半径>`	擦除给定半径内的所有区块（切比雪夫距离）
`/manipulate chunk erase circle\|euclidean <半径>`	擦除给定半径内的所有区块（欧几里得距离）
`/manipulate chunk erase at <区块X> <区块Z>`	擦除指定位置的区块。给定区块需已被加载

relight

重新计算给定区块的光照。这将对区块内的所有方块触发光照更新

备注

目前该指令是通过检查给定区块内所有位置的光照来实现的，执行效率并不那么高

指令	效果
`/manipulate chunk relight`	同 `/manipulate chunk relight current`
`/manipulate chunk relight current`	重新计算你所在的区块的光照
`/manipulate chunk relight square\|chebyshev <半径>`	重新计算给定半径内的所有区块的光照（切比雪夫距离）
`/manipulate chunk relight circle\|euclidean <半径>`	重新计算给定半径内的所有区块的光照（欧几里得距离）
`/manipulate chunk relight at <区块X> <区块Z>`	重新计算指定位置的区块的光照。给定区块需已被加载

container

/manipulate container

操控世界的数据结构容器，包括：

容器名	指令前缀	支持的操作
实体列表	`entity`	翻转、随机打乱
可运算的方块实体列表	`tileentity`	翻转、随机打乱、查询给定位置/总览信息
计划刻队列	`tiletick`	添加元素、移除给定位置的元素
方块事件队列	`blockevent`	添加元素、移除给定位置的元素

指令列表：

/manipulate container entity [revert|shuffle]
/manipulate container tileentity [query|revert|shuffle|statistic]
/manipulate container tiletick add <pos> <block> <delay> [<priority>]
/manipulate container tiletick remove <pos>
/manipulate container blockevent add <pos> <block> <type> <data>
/manipulate container blockevent remove <pos>

entity

操控目标实体

/manipulate entity <实体选择器> [各类操作]

指令列表：

目标实体自定义名称设置/清楚

/manipulate entity <目标> rename <名称文本>
/manipulate entity <目标> rename clear

目标实体的持久标签状态查询/修改

/manipulate entity <目标> persistent
/manipulate entity <目标> persistent set <持久标签状态>

目标实体载具逻辑控制

/manipulate entity <目标> mount <载具>
/manipulate entity <目标> dismount

目标实体速度控制。可使用 nan、inf 作为速度的取值

/manipulate entity <目标> velocity [add|set] <x> <y> <z>

网络测速

测试客户端和服务器之间的网络连接，包括下载/上传速度和平均ping值

帮助

/speedtest

显示速度测试命令的一些信息，包括：

简单的命令描述
当前最大测试大小
客户端支持状态

下载测试

/speedtest download [<size_mib>]

测试下载速度，即流量从服务器到客户端的速度

参数：

size_mib：测试的流量大小。单位：MiB。默认值：10

上传测试

/speedtest upload [<size_mib>]

测试上传速度，即流量从客户端到服务器的速度

参数：

size_mib：测试的流量大小。单位：MiB。默认值：10

ping 测试

/speedtest ping [<count>] [<interval>]

测试服务器和客户端之间的 ping 值，进行指定轮测试

服务器将向客户端发送一个 ping，然后客户端将回复一个 pong 给服务器。此轮测试的 ping 值将是服务器发送 ping 和接收 pong 之间的时间间隔

参数：

count：ping 测试轮次的数量。默认值：4
interval：两次 ping 之间的最小间隔。单位：秒。默认值：1

中止测试

/speedtest abort [<size_mib>]

中止当前正在进行的测试（下载、上传或 ping）

袭击 (raid)

列表 (list)

/raid list [<full>]

列出目前所有袭击的信息

追踪 (tracking)

/raid tracking [<start|stop|restart|realtime>]

开启一个袭击追踪器以收集并统计进行中的袭击的状态信息

射线追踪 (raycast)

/raycast block <x1> <y1> <z1> <x2> <y2> <z2> [<shapeMode>] [<fluidMode>]

使用给定的形状模式（shapeMode）以及流体模式（fluidMode），执行一次从 (x1, y1, z1) 到 (x2, y2, z2) 的方块射线追踪，然后显示射线追踪结果

参数 <shapeMode> 和 <fluidMode> 是可选的。它们的默认值见下文

形状模式（见 net.minecraft.world.RaycastContext.ShapeType）：

collider（默认值）
outline
visual（mc1.16+）
falldamage_resetting（mc1.18.2+）

流体模式（见 net.minecraft.world.RaycastContext.FluidHandling）：

none（默认值）
source_only
any
water（mc1.18.2+）

警告：两个相距过远的点之间的射线追踪可能会触发意料之外的区块加载

刷新 (refresh)

inventory

/refresh inventory: 刷新你的物品栏

/refresh inventory <players>: 刷新指定玩家的物品栏。需要权限等级 2

chunk

/refresh chunk: 同 /refresh chunk current

/refresh chunk current: 刷新你所在的区块

/refresh chunk all: 刷新视距内的所有区块

/refresh chunk inrange <chebyshevDistance>: 刷新给定切比雪夫距离内的所有区块

/refresh chunk at <chunkX> <chunkZ>: 刷新指定位置的区块

所有区块刷新操作均仅影响视距之内的区块

受到数据包压缩操作影响，区块批量刷新操作会对服务端的网络线程造成卡顿，因此该指令包含一个输入限速器来防止数据包过多地堆积

移除实体 (removeentity)

/removeentity <target>: 将选中实体直接从世界中移除

注意，对于储存型载具实体，它们不会掉落所包含的物品

该指令对玩家无效

供给计数器 (scounter)

类似 carpet 的漏斗计数器对应的 /counter 指令，该指令用于统计使用规则 hopperNoItemCost 创建的漏斗无限物品供给器所输出的物品数量

/scounter: 查看所有供给计数器的统计数据

/scounter reset: 重置所有供给计数器

/scounter <color> [realtime]: 查看指定供给计数器的统计数据，带上后缀 realtime 则基于现实时间输出速率

/scounter <color> reset: 重置指定供给计数器

睡眠 (sleep)

即时阻塞当前线程给定持续时间，可用于制造卡顿

你可以将本条指令与命令方块以及规则瞬时命令方块配合使用，以在任意你想要的时间点制造卡顿

/sleep: 显示帮助信息

/sleep <duration> (s|ms|us): 使用给定的时间单位，睡眠给定持续时间

可用的时间单位：

s: 秒，1 * 10 ^ 0s
ms: 毫秒，1 * 10 ^ -3s
us: 微秒，1 * 10 ^ -6s

经验计数器 (xcounter)

类似 carpet 的漏斗计数器对应的 /counter 指令，该指令用于展示使用规则 hopperXpCounters 创建的漏斗经验计数器的统计结果

/xcounter: 查看所有经验计数器的统计数据

/xcounter reset: 重置所有经验计数器

/xcounter <color> [realtime]: 查看指定经验计数器的统计数据，带上后缀 realtime 则基于现实时间输出速率。将按照经验球所含的经验值，以每行为一组，分组输出统计信息

/xcounter <color> reset: 重置指定经验计数器

spawn

mobcapsLocal

于 Minecraft 1.18.2+ 中可用

/spawn mobcapsLocal [<玩家>]

以类似 carpet 的 /spawn mobcaps 命令的格式显示指定玩家的局部怪物容量

若未指定玩家，则它将显示指令源的局部怪物容量

另见: mobcapslocal记录器

tick

warp status

/tick warp status

显示当前 tick warp 的状态信息，如启动者、估计剩余时间等

见 tickWarp 记录器以了解更方便地查询信息的方法

信息 (info)​

world ticking_order​

world weather​

存活时间 (lifetime)​

tracking​

<实体类型>​

filter​

recorder​

操控世界 (manipulate)​

block​

execute​

emit​

chunk​

erase​

relight​

container​

entity​

网络测速​

帮助​

下载测试​

上传测试​

ping 测试​

中止测试​

袭击 (raid)​

列表 (list)​

追踪 (tracking)​

射线追踪 (raycast)​

刷新 (refresh)​

inventory​

chunk​

移除实体 (removeentity)​

供给计数器 (scounter)​

睡眠 (sleep)​

经验计数器 (xcounter)​

spawn​

mobcapsLocal​

tick​

warp status​

信息 (info)

world ticking_order

world weather

存活时间 (lifetime)

tracking

<实体类型>

filter

recorder

操控世界 (manipulate)

block

execute

emit

chunk

erase

relight

container

entity

网络测速

帮助

下载测试

上传测试

ping 测试

中止测试

袭击 (raid)

列表 (list)

追踪 (tracking)

射线追踪 (raycast)

刷新 (refresh)

inventory

chunk

移除实体 (removeentity)

供给计数器 (scounter)

睡眠 (sleep)

经验计数器 (xcounter)

spawn

mobcapsLocal

tick

warp status