Entity Detective

Entity Detective

Entity Detective — серверный мод на Fabric, созданный для одной задачи: быстро находить лаги, связанные с сущностями. Одна команда покажет, какие типы сущностей съедают больше всего MSPT, где незаметно накапливаются ленивые мобы и где постоянные существа никогда не исчезнут — сразу по всем загруженным измерениям, без клиентского мода. Работает в одиночной игре без включения читов.

Что он умеет

• Поиск горячих точек — Запусти 20-тиковую выборку по всем измерениям и получи топ-5 самых дорогих типов сущностей по MSPT, без всяких аргументов — быстрый первый проход, когда не знаешь, где искать.
• Обнаружение ленивых мобов — Находит мобов, застрявших в чанках, где нет игрока в радиусе 128 блоков — именно тот порог, который Minecraft использует для проверки исчезновения — там, где сервер никогда не уберёт их сам.
• Обнаружение постоянных мобов — Находит мобов с именными бирками, держателей предметов, животных на поводке и пассажиров транспорта, которые никогда не исчезнут, даже когда тикают.
• Профилирование MSPT — Измеряет, сколько миллисекунд за тик потребляет любой тип сущностей, или профилирует все типы сразу с сортировкой по затратам, или просто осматривает все сущности в заданном диапазоне чанков.
• Обнаружение чанк-лоадеров — Нагрузка на сервер часто вызвана чанк-лоадерами. Найди их быстро. Показывает все активные портальные чанк-лоадеры (пары OW ↔ Nether) и камеры стазиса из эндер-жемчуга по всем измерениям.
• Аудит тикающих блочных сущностей — Используй --ticking-only, чтобы найти, какие блочные сущности на большой ферме действительно тикали за окно наблюдения, и --debug, чтобы увидеть количество тиков по позициям вместо суммарного MSPT.
• Профилирование игрока (nark) — Измеряет стоимость MSPT всех типов сущностей в диапазоне 21×21 чанк вокруг любого игрока в сети, чтобы найти дорогие сущности рядом с ним.

Удобные функции

• Сводки по измерениям — Все типы сущностей с сортировкой по количеству, по одному блоку на измерение, сразу по overworld, nether и end.
• Кликабельные ссылки телепортации — Каждый заголовок чанка и строка отдельной сущности кликабельны в чате и вставляют `/tp x y z` прямо к центру чанка или точному месту сущности.
• Живой лимит мобов — Проверка текущего и максимального количества сущностей по категориям с цветовой индикацией заполнения, чтобы сразу видеть давление на лимит мобов.
• Псевдоним команды — Доступна и как /entitydetective, и как /ed.

Структура команд

/entitydetective
├── mob <category>
│   │   category: monster | creature | ambient | axolotls | water_creature | water_ambient
│   │   (без аргументов)    — Сводка по количеству типов на измерение
│   │   --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
│   │   (без аргументов)    — Сводка всех типов сущностей по количеству, на измерение
│   │   --lazy-only         — Таблица количества типов, непостоянные сущности в ленивых чанках
│   │   --persistent        — Таблица количества типов, только постоянные сущности
│   │   --world <dim>       — Ограничить конкретным измерением
│   │   --detail            — Развернуть в список сущностей по чанкам с кликабельными ссылками /tp
│   ├── --range <chunks>    — Мгновенная перепись всех типов сущностей в диапазоне (0 = один чанк; без окна тиков)
│   ├── locate <type>       — Найти любой тип сущностей (автодополнение из живого мира, поиск по подстроке)
│   │       --lazy-only, --world <dim>, --range <chunks>, --detail
│   │       --ticking-only  (только блочные сущности) — фильтр по позициям, которые действительно тикали
│   ├── profile <type> [ticks]
│   │       Измеряет стоимость MSPT за окно тиков (по умолчанию 100 тиков / 5 с; максимум 6 000 тиков / 5 мин)
│   │       --world <dim>, --range <chunks>
│   │       --debug         (только блочные сущности) — количество тиков по позициям вместо суммарного MSPT
│   └── profile all [ticks]
│           Профилирует все типы сущностей одновременно, с сортировкой по стоимости MSPT по убыванию
│           (без аргументов): все измерения | --world <dim>: одно измерение | --range <chunks>: локально
│
└── item
    │   (без аргументов)    — Сводка выпавших предметов на измерение, с цветовой индикацией по серьёзности
    │   --lazy-only         — Таблица количества типов, только ленивые чанки
    │   --world <dim>       — Ограничить конкретным измерением
    │   --range <chunks>    — Ограничить квадратом чанков вокруг твоей позиции
    │   --detail            — Развернуть в список предметов по чанкам с кликабельными ссылками /tp
    └── locate <item_id>
            Находит чанки с конкретным типом предмета (автодополнение, поиск по подстроке)
            --lazy-only, --world <dim>, --range <chunks>, --detail

chunks                      — Обнаруживает активные чанк-лоадеры по всем измерениям
    ├── loaders             — Только портальные лоадеры (пары строк OW ↔ Nether)
    └── stasis              — Только камеры стазиса из эндер-жемчуга
        Координаты кликабельны для /tp, когда ты в соответствующем измерении

hotspot                     — Сканирование топ-5 горячих точек сущностей (20-тиковая выборка, все измерения)

nark <player>               — Профилирует все типы сущностей в диапазоне 21×21 чанк вокруг игрока в сети

`--detail` всегда должен быть последним флагом. `--range` и `--world` взаимоисключающие. Используй `/ed` как сокращённый алиас для `/entitydetective`.

---

### Почему ленивые и постоянные мобы важны

> **Ленивые мобы** — это непостоянные мобы в чанках, где нет игрока в радиусе 128 блоков — именно тот порог, который использует логика исчезновения Minecraft. Поскольку эти чанки никогда не тикают сущности, обычная проверка на исчезновение не срабатывает. Мобы накапливаются там бесконечно. Используй `--lazy-only`, чтобы получить таблицу с количеством по типам того, что накапливается, затем добавь `--detail` для сгруппированных по чанкам кликабельных ссылок `/tp` для телепорта прямо к проблеме.

> **Постоянные мобы** помечены игровым движком как никогда не исчезающие, даже в полностью тикающих чанках. Это включает мобов с именными бирками, любого моба, поднявшего выпавший предмет с земли, животных на поводке и мобов, едущих на транспорте. Поскольку они никогда не исчезают, они накапливаются со временем и увеличивают стоимость тиков сервера. Используй `--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

*Владелец мира в одиночной игре имеет полный доступ без включения читов. На серверах требуется уровень оператора 2 или нода LuckPerms `entitydetective.command`.*  
[Releases](https://github.com/netcrafts/Entity-Detective/releases) · [Source](https://github.com/netcrafts/Entity-Detective) · [License: MIT](https://github.com/netcrafts/Entity-Detective/blob/main/LICENSE)