NaturesCompass

[!INFO] Git Commit: d267e91 | Updated: 2026-09-28

Nature’s Compass 是一款 1.7.10 客户端向的群系搜寻器模组。原版 Minecraft 中玩家只能靠肉眼或地图寻找群系；本 mod 提供一个手持罗盘（Nature’s Compass），右键打开 GUI 浏览所有可用群系，按名称/基础高度/高度变化/温度/降雨/BiomeDictionary tag 排序与过滤，选定后服务端异步螺旋扫描并把指针指向最近的匹配群系，FOUND 后可（若 OP 或单机作弊模式）一键传送。

mod 体量极小：

• 1 个注册物品（naturescompass:NaturesCompass）
• 5 个 Forge 网络包（搜索请求、传送请求、权限同步、可见群系回包、心跳）
• 1 个服务端 worker 调度池（基于 Forge WorldWorkerManager）
• 6 种 GUI 排序维度
• 4 态状态机（INACTIVE / SEARCHING / FOUND / NOT_FOUND）
• 0 方块、0 实体、0 维度、0 附魔、0 群系、0 结构、0 成就

物品列表

• Nature’s Compass - 手持罗盘；右键开 GUI、潜行右键取消、FOUND 后显示坐标/距离/HUD 状态

设置与系统

• Biome Search Worker - 服务端螺旋采样器，按 sampleSpace 步长向四方旋转推进
• World Worker Manager - 每 tick 给 worker 分配 50 ms 时间片的轻量调度器
• Server Tick Handler - 每服务器 tick 驱动 WorldWorkerManager
• Compass State - 4 态枚举（INACTIVE/SEARCHING/FOUND/NOT_FOUND）
• Config Handler - 所有可配置项（搜索距离/步长/采样数/黑名单/HUD 落点等）
• Overlay Side - HUD 文字落点枚举
• Render Tick Handler - 每帧 END 阶段叠加 HUD 文字
• Render Utils - HUD 绘制工具
• Sort Categories - GUI 6 种排序维度（Name/BaseHeight/HeightVariation/Temperature/Rainfall/Tags）
• Biome Utils - 群系名字美化、气候/湿度分级、tag 列表、距离/黑名单判定
• Item Utils - NBT 安全访问辅助
• Player Utils - OP 与 cheat mode 权限判断

GUI

• Gui Natures Compass - 主 GUI：搜索框、6 按钮、Found Only 过滤
• Gui Biome Info - 群系详情面板：Precipitation / Base Height / Climate / Humidity / Tags
• Gui List Biomes - 群系列表容器
• Gui List Biomes Entry - 列表项渲染与双击搜索

网络包

• Packet Compass Search - 客户端→服务端，群系搜索请求（discriminator 0）
• Packet Available Biomes Set - 服务端→客户端，仅扫描模式回包（discriminator 1）
• Packet Teleport - 客户端→服务端，传送请求（discriminator 2）
• Packet Request Sync - 客户端→服务端，请求同步传送权限（discriminator 3）
• Packet Sync - 服务端→客户端，传送权限响应（discriminator 4）

代理

• Proxies - CommonProxy / ClientProxy 注册入口