
实体侦探
一个服务端Fabric实体分析器,为玩家提供命令,以在所有维度中查找、计数、分析和定位实体
查看大图Entity Detective
Entity Detective 是一个服务端 Fabric 模组,专为一项任务而生:快速发现与实体相关的卡顿。一条命令即可告诉你哪些实体类型消耗的 MSPT 最多、懒加载生物正在何处悄悄堆积,以及哪些持久化生物永远不会消失——一次性覆盖所有已加载维度,无需客户端模组。在单人游戏中无需开启作弊即可使用。
功能
- 热点扫描 — 在所有维度上运行 20 tick 采样,返回按 MSPT 排名前 5 的最昂贵实体类型,无需任何参数——当你不知道从何查起时的快速首轮排查。
- 懒加载生物检测 — 精确定位被困在 128 格内无玩家的区块中的生物——这正是 Minecraft 用于消失检查的阈值——服务器永远不会自然清理它们
- 持久化生物检测 — 查找命名牌生物、持有物品的生物、拴绳动物和载具乘坐者,即使它们仍在 tick 也永远不会消失。
- MSPT 性能分析 — 测量任意实体类型每 tick 消耗的毫秒数,或一次性分析所有类型并按消耗排序,或仅检查可变区块范围内的每个实体
- 区块加载器检测 — 服务器负载常常由区块加载器引起。快速找到它们。列出所有维度中所有活跃的传送门区块加载器(配对的主世界 ↔ 下界)和末影珍珠静止舱。
- 方块实体 tick 审计 — 使用
--ticking-only找出大型农场中哪些方块实体在观察窗口内实际进行了 tick,使用--debug查看逐位置的 tick 次数而非聚合 MSPT。 - 玩家性能分析(
nark) — 测量任意在线玩家周围 21×21 区块范围内所有实体类型的 MSPT 消耗,以找出其位置附近的高消耗来源。
便捷功能
- 按维度汇总 — 同时查看主世界、下界和末地中每种实体类型按数量排序,每个维度一段
- 可点击传送链接 — 聊天中每个区块标题和单个实体行均可点击,直接粘贴
/tp <playername> x y z到区块中心或精确实体位置 - 实时生物上限 — 查看每类别的当前值与最大值,带颜色编码的饱和度,让您一眼看出生物上限压力
- 命令别名 — 同时可用
/entitydetective和/ed
命令结构
/entitydetective
├── mob <category>
│ │ category: monster | creature | ambient | axolotls | water_creature | water_ambient
│ │ (bare) — 按维度的类型数量汇总
│ │ --lazy-only — 类型数量表,懒加载区块中的非持久化生物
│ │ --persistent [subtype] — 类型数量表,仅持久化生物
│ │ subtype: all | name-tagged | holding-item | structure-spawn | in-vehicle | leashed | custom
│ │ --world <dim> — 限定到 overworld | nether | end
│ │ --range <chunks> — 限定到 (2N+1)×(2N+1) 区块方形范围(0 = 单个区块)
│ │ --detail — 展开为按区块分组的实体列表,带可点击 /tp 链接
│ └── cap — 实时生物上限(当前 vs 最大,颜色编码)
│
├── entity
│ │ (bare) — 所有实体类型按数量、按维度的汇总
│ │ --lazy-only — 类型数量表,懒加载区块中的非持久化实体
│ │ --persistent — 类型数量表,仅持久化实体
│ │ --world <dim> — 限定到特定维度
│ │ --detail — 展开为按区块分组的实体列表,带可点击 /tp 链接
│ ├── --range <chunks> — 范围内每种实体类型的即时普查(0 = 单个区块;无 tick 窗口)
│ ├── locate <type> — 定位任意实体类型(从实时世界标签补全,子串匹配)
│ │ --lazy-only, --world <dim>, --range <chunks>, --detail
│ │ --ticking-only (仅方块实体)— 筛选到实际进行了 tick 的位置
│ ├── profile <type> [ticks]
│ │ 在 tick 窗口内测量 MSPT 消耗(默认 100 ticks / 5 秒;最大 6 000 ticks / 5 分钟)
│ │ --world <dim>, --range <chunks>
│ │ --debug (仅方块实体)— 逐位置 tick 次数而非聚合 MSPT
│ └── profile all [ticks]
│ 同时分析所有实体类型,按 MSPT 消耗降序排列
│ (bare):所有维度 | --world <dim>:单个维度 | --range <chunks>:局部
│
└── item
│ (bare) — 按维度的掉落物汇总,按严重程度颜色编码
│ --lazy-only — 类型数量表,仅懒加载区块
│ --world <dim> — 限定到特定维度
│ --range <chunks> — 限定到你位置周围的区块方形范围
│ --detail — 展开为按区块分组的物品列表,带可点击 /tp 链接
└── locate <item_id>
查找包含特定物品类型的区块(标签补全,子串匹配)
--lazy-only, --world <dim>, --range <chunks>, --detail
chunks — 检测所有维度中活跃的区块加载器
├── loaders — 仅传送门加载器(配对的主世界 ↔ 下界行)
└── stasis — 仅末影珍珠静止舱
当你在匹配的维度中时,坐标可点击 /tp
hotspot — 前 5 实体热点扫描(20 tick 采样,所有维度)
nark <player> — 分析在线玩家周围 21×21 区块范围内所有实体类型
--detail 必须始终是最后一个标志。--range 和 --world 互斥。使用 /ed 作为 /entitydetective 的简写别名。
为什么懒加载生物和持久化生物很重要
懒加载生物 是位于 128 格内无玩家区块中的非持久化生物——这正是 Minecraft 消失逻辑使用的阈值。由于这些区块从不 tick 实体,正常的消失检查永远不会运行。生物会在那里无限积累。使用
--lazy-only获取正在堆积内容的类型数量表,然后添加--detail获得按区块分组的可点击/tp链接,直接传送到问题地点。
持久化生物 被游戏引擎标记为永不消失,即使在完全 tick 的区块中也是如此。这包括命名牌生物、任何从地上捡起掉落物品的生物、拴绳动物以及乘坐载具的生物。因为它们永不消失,会随时间积累并增加服务器的 tick 开销。使用
--persistent查看它们正在何处堆积,使用--persistent <subtype>缩小到特定原因。
示例输出
/entitydetective mob monster --lazy-only(类型数量表)
-- lazy monster [overworld]: 45 entities --
minecraft:zombie 28
minecraft:skeleton 12
minecraft:creeper 5
Total: 45 entities across 3 types
/entitydetective mob monster --lazy-only --detail(按区块分组,可点击)
-- monster [overworld] (lazy, --detail): 45 entities in 2 chunks --
Chunk (12, -4) × 31 → /tp @s 192 ~ -64
[196, 63, -61] — minecraft:zombie
[191, 64, -68] — minecraft:skeleton "Bob" (name tagged)
...
/entitydetective entity profile all --range 10
-- Base Profile: 10-chunk range (100 ticks) --
3.636mspt TOTAL ×102
1.779mspt avg: 0.040ms piglin ×44
1.188mspt avg: 0.043ms hoglin ×28
0.402mspt avg: 0.040ms strider ×10
3.636mspt TOTAL ×102
/entitydetective item(严重程度颜色编码)
-- Item Types [overworld]: 2 847 items --
2 130 items (142 entities) minecraft:cobblestone ← red
480 items ( 48 entities) minecraft:gravel ← yellow
12 items ( 4 entities) minecraft:diamond ← green
无需客户端模组 · 跨维度工作 · 兼容单人游戏 · 遵循 LuckPerms
单人世界所有者无需开启作弊即可完全访问。在服务器上,需要 op 等级 2 或 entitydetective.command LuckPerms 节点。
发布 · 源码 · 许可证:MIT
正在加载版本记录…



正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。