tracker

THE 12 FEATURES

1. Legacy Tracking (legacy_tracking)  — ON by default
   Announces your death coordinates in chat and highlights the death point in
   the world for 5 minutes. Also tracks the items dropped on death: warns before
   they despawn and records when a mob picks one up.
   Use case: recovering your death drops.

2. Player Tracking (player_tracking)
   Type @ in chat to open a player picker; the chosen player is highlighted
   through walls for 10 minutes at any distance (requires the mod on the server
   too). Use case: finding teammates on a multiplayer server.

3. Wandering Trader Tracking (wandering_trader_tracking)
   Announces a trader’s coordinates when it spawns, highlights it for 10 minutes
   on click, and shows its despawn countdown.
   Use case: never miss a wandering trader.

4. Persistent Mob Tracking (persistent_mob_tracking)
   Finds mobs that will never despawn (named ones, ones that picked up items).
   Those keep loading chunks forever. Lists them as “#id name coordinates”;
   typing the id highlights that mob.
   Use case: cleaning up long-lived mobs.

5. Entity Lag Source Tracking (lag_source_tracking)
   Measures how much tick time each entity, chunk and block entity consumes, and
   ranks them with coordinates. Type #L <id> or /tracker lag to inspect.
   Use case: diagnosing stutter in a world or on a server.

6. Elite Mob Tracking (elite_mob_tracking)
   Scans for nearby mobs whose health far exceeds the norm for their kind
   (plugin-buffed mobs, spawner products). Announces coordinates and highlights
   for 10 minutes. Client-only; no server half required.
   Use case: spotting dangerous mobs.

7. End Gateway Tracking (end_gateway_tracking)
   Marks the nearest end gateway for 10 minutes. Searches 16 chunks (256 blocks)
   and only already-loaded chunks. Use case: exploring the End.

8. Villager POI Tracking (villager_poi_tracking)
   Draws a line from each villager to the bed and workstation it claimed.
   Use case: organising trading halls, debugging villagers that will not claim
   a workstation.

9. Zombie Aggro Tracking (zombie_aggro_tracking)
   Draws a line from every zombie-family mob to its current attack target.
   Use case: understanding aggro, debugging mob farms.

10. Dragon Aggro Tracking (dragon_aggro_tracking)
    Draws one line from the ender dragon to the player it is chasing (only the
    nearest source, so the screen stays readable).
    Use case: knowing who the dragon is targeting.

11. Custom Coordinate Tracking (custom_coord_tracking)
    Type a coordinate and it stays highlighted until you turn it off. The point
    is remembered across sessions. Supports ~ for your position and ~5 for a
    relative offset. Use case: marking a far-away destination.

12. Mob Glow (mob_glow_tracking)  — NEW in this version
    Every hostile mob within a 128-block radius gets the vanilla spectral-arrow
    outline: the real entity silhouette, visible through walls. Each mob glows
    for 2 minutes; standing inside the radius keeps everything lit, and a mob
    that walks away still finishes its remaining time.
    Hostile mobs only (zombies, skeletons, creepers, blazes, wardens, …).
    Animals, villagers and players are never lit.
    Use case: clearing mobs at night, seeing threats in caves.

12 个功能说明
================================================================================

1. 遗产追踪（legacy_tracking）  —— 默认开启
   死亡后会在聊天栏播报死亡坐标，并在世界中高亮死亡点 5 分钟。
   同时追踪死亡时掉落的物品；掉落物消失前会提醒，被怪物捡走也会记录。
   适合：找回死亡掉落。

2. 玩家追踪（player_tracking）
   在聊天栏输入 @ 打开玩家列表，选一个玩家后透视高亮他 10 分钟，
   支持任意距离（需要服务端也装了本模组）。
   适合：多人服里找队友。

3. 流浪商人追踪（wandering_trader_tracking）
   流浪商人刷出时提示坐标，可点击高亮 10 分钟，并显示它的消失倒计时。
   适合：不错过流浪商人。

4. 不消失怪物追踪（persistent_mob_tracking）
   找出那些永远不会消失的怪物（被命名过、捡过掉落物等），
   这类怪物会长期占着区块造成负担。给出 #编号 与坐标，输入编号可高亮。
   适合：清理长期留存的怪物。

5. 实体卡顿源头追踪（lag_source_tracking）
   统计每个实体、每个区块、每个方块实体消耗了多少 tick 时间，
   给出排行与坐标。输入 #L 编号或 /tracker lag 查看。
   适合：排查服务器或存档卡顿。

6. 精英怪追踪（elite_mob_tracking）
   扫描附近血量远超同类常规值的怪物（比如被插件加强的、或是刷怪笼产物），
   提示坐标，可高亮 10 分钟。纯客户端功能，不需要服务端配合。
   适合：发现强力怪物。

7. 折跃门追踪器（end_gateway_tracking）
   标出最近的末地折跃门，持续 10 分钟。
   搜索范围 16 区块（256 格），且只搜索已加载的区块。
   适合：末地探索。

8. 村民兴趣点追踪（villager_poi_tracking）
   画出村民与它认领的床、工作站点之间的连线。
   适合：整理村民交易所、排查村民不认领工作站的问题。

9. 僵尸仇恨追踪（zombie_aggro_tracking）
   从每个僵尸类怪物到它的攻击目标画一条线。
   适合：判断仇恨来源、做刷怪塔调试。

10. 末影龙仇恨追踪（dragon_aggro_tracking）
    从末影龙画一条线到它当前追击的玩家。只画最近的那一条。
    适合：打龙时判断当前目标。

11. 自定义坐标追踪（custom_coord_tracking）
    手动输入一个坐标，持续高亮该点，直到你关闭它。
    坐标会被记住，重进游戏仍在。支持 ~ 表示当前位置、~5 表示相对位置。
    适合：标记要去的远方目标。

12. 怪物透视（mob_glow_tracking）  —— 本版新增
    半径 128 格内所有敌对怪物获得「光灵箭」发光轮廓，
    效果与原版光灵箭完全一致：真实轮廓、可穿墙看见。
    每只怪物的发光持续 2 分钟；站在范围内会持续保持发光，
    走出范围后仍会亮完剩余时间。
    只对敌对生物生效（僵尸、骷髅、苦力怕、烈焰人、监守者等），
    不会点亮动物、村民和玩家。
    适合：夜晚清怪、看清地下洞穴里的威胁。

================================================================================
第三部分 · 常见问题
================================================================================

Q: 装了但模组列表里没有？
A: 版本不匹配。核对上面的表格，尤其是 NeoForge 的小版本号。

Q: 功能打开了但什么都看不到？
A: 先确认这个功能需要什么条件。比如：
   – 玩家追踪需要视野内有玩家，远距离还需要服务端也装本模组
   – 精英怪追踪需要附近真的有血量异常的怪
   – 折跃门追踪只搜索已加载区块

Q: 能不能只装在服务端，客户端不装？
A: 大部分功能需要客户端装（因为要渲染）。
   纯服务端的只有数据采集部分，玩家看不到效果。

Q: 打开设置界面时游戏会暂停吗？
A: 不会。这是刻意设计的，方便边看菜单边观察世界变化。

Q: 我的配置存在哪里？
A: config/tracker.json。删掉它会恢复默认（全部关闭）。

Q: 这个模组会不会影响服务器性能？
A: 默认全部关闭时几乎没有开销。
   打开后主要的开销是：卡顿追踪（每 5 tick 采样一次）、
   怪物透视（每 10 tick 扫描一次 128 格内的敌人）。
   两者都有节流，正常情况下可忽略。