实体侦探

实体侦探

一个服务端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