SpawnerFinder

SpawnerFinder

一个客户端Minecraft模组，在HUD上显示附近的生物生成器，并通过颜色编码信息展示生成器类型、坐标和距离，帮助你高效定位地牢。

怪物

SpawnerFinder预览查看大图

SpawnerFinder

Minecraft Version Mod Version

一个客户端 Minecraft 模组，可在 HUD 中显示附近的生物刷怪笼，并通过颜色编码信息展示刷怪笼类型、坐标和距离，帮助你高效定位地牢。

[!注意] Minecraft 26.1 令人兴奋的新更新！ 🚀 我们非常激动地宣布 SpawnerFinder v2.0.0 正式发布，专为 Minecraft 26.1 打造！本次更新带来了全新的界面改版、强大的多刷怪笼分组引擎、支持模组刷怪笼的智能游戏内搜索功能，以及大规模性能优化，确保你的帧率保持在高位。请阅读下方关于新功能的更多内容！

📸 截图

SpawnerFinder 示例 SpawnerFinder HUD 显示附近生物刷怪笼及其坐标和距离

🎯 功能特性

核心功能

  • 实时刷怪笼检测 - 自动扫描你周围 160 格范围内的生物刷怪笼。
  • 颜色编码显示 - 每种生物类型都有独特的颜色，便于快速识别。
  • 距离追踪 - 以米为单位显示到每个刷怪笼的精确距离。
  • 坐标显示 - 提供精确的 X、Y、Z 坐标，方便导航。
  • 高保真 HUD 覆盖层 - 清晰的覆盖界面，带有透明背景框，确保在所有环境下信息清晰可读。
  • 生物头颅 / 刷怪蛋图标 - 每种刷怪笼类型旁边都会渲染视觉图标，便于直观阅读。

高级功能（v2.0.0 新增）

  • 交互式搜索界面 - 按 U 键打开，可实时过滤刷怪笼。支持 TAB 键循环切换搜索建议。
  • 自定义整合包与服务器支持 - 动态扫描游戏注册表，识别模组/非原版刷怪笼。
  • 刷怪笼群组查找器 - 自动检测彼此在激活范围内（16 格）的刷怪笼，并计算你应该站立的精确坐标中心点，以便同时运行多个刷怪笼。
  • 全屏高度扩展 - 使用 I 键在紧凑（前 5 个）和展开列表视图之间切换，以查看范围内的所有刷怪笼。

支持的生物类型

生物类型 颜色 十六进制代码
骷髅 白色 #FFFFFF
僵尸 绿色 #00FF00
蜘蛛 红色 #FF0000
洞穴蜘蛛 蓝色 #0000FF
岩浆怪 橙色 #FF8000
烈焰人 黄色 #FFFF00
蠹虫 灰色 #808080
未知类型 品红色 #FF00FF

仅客户端 & 反作弊安全

  • ✅ 100% 客户端 - 无需服务器修改
  • ✅ 服务器安全 - 不会被反作弊系统检测到
  • ✅ 无网络流量 - 仅使用本地可用数据
  • ✅ 适用于任何服务器 - 兼容原版和模组服务器
  • ✅ 仅 HUD 显示 - 无视觉覆盖层或 ESP，避免行为检测

📋 环境要求

  • Minecraft: 26.1
  • Fabric Loader: 0.18.4 或更高版本
  • Fabric API: 0.144.1+26.1 或更高版本
  • Java: 25 或更高版本

🚀 安装方法

  1. 安装 Fabric Loader - 从 FabricMC 下载
  2. 下载 Fabric API - 从 Modrinth 或 CurseForge 获取
  3. 下载 SpawnerFinder - 从发布页面获取最新版本
  4. 安装模组 - 将 spawnerfinder-2.0.0.jar 放入你的 .minecraft/mods/ 文件夹中
  5. 启动 Minecraft - 使用 Fabric 配置文件启动游戏

🎮 使用方法

按键绑定与控制

你可以在标准 Minecraft 设置中自定义这些控制：

  • O - 开关整个 SpawnerFinder HUD。
  • I - 在紧凑（显示前 5 个刷怪笼）和展开（显示已加载区块中的所有刷怪笼，利用整个屏幕高度）列表视图之间切换。
  • U - 打开刷怪笼搜索与设置界面。

游戏内显示

安装后，模组会自动开始工作：

  1. 左侧面板（HUD） - 按距离排序（最近的在前）显示找到的刷怪笼，并附有特定生物图标、坐标和距离信息，格式为：生物类型: X, Y, Z（距离）。
  2. 右侧面板（HUD） - 显示在激活邻近范围内找到的刷怪笼群组，以及计算出的坐标中心点，标记为 激活位置: X, Y, Z。
  3. 自动扫描 - 每 2 秒异步扫描已加载区块，确保零性能下降。

显示示例

最近的刷怪笼：
骷髅: 245, 23, -156 (12.3米)
僵尸: 267, 18, -145 (28.7米)
蜘蛛: 223, 31, -178 (35.1米)
洞穴蜘蛛: 289, 15, -134 (45.6米)
烈焰人: 201, 22, -189 (52.4米)

⚠️ 重要行为警告

为什么采用仅 HUD 设计？

本模组刻意仅使用 HUD 显示，而非视觉覆盖层（ESP/透视），这是出于重要的安全考虑：

  • 行为追踪防护 - 许多服务器使用行为分析，可以检测玩家是否通过方块直接看向目标位置
  • 反作弊规避 - 当玩家表现出"不可能"的知情行为时，视觉 ESP 模组可能触发反作弊系统
  • 自然游戏体验 - HUD 显示鼓励正常探索，而非直接导航到隐藏刷怪笼

推荐使用方式

  • ✅ 使用坐标确定大致方向 - 自然地朝目标区域前进
  • ✅ 正常探索 - 不要径直穿过方块直线冲向刷怪笼
  • ✅ 自然挖掘 - 遵循正常的洞穴系统和采矿模式
  • ❌ 不要盯着方块看 - 避免通过方块直接注视刷怪笼位置
  • ❌ 不要直线挖掘 - 避免挖掘直达刷怪笼的捷径

服务器安全说明

尽管本模组从技术角度不可检测：

  • 行为比模组本身更重要 - 你的行为方式才是导致被发现的真正原因
  • 自然游玩 - 将信息作为指南，而非 GPS
  • 遵守服务器规则 - 部分服务器禁止任何形式的刷怪笼检测
  • 有疑问时，不要使用 - 安全第一，避免被封禁

🔧 技术细节

性能表现

  • 基于区块扫描 - 扫描已加载的区块数据，而非暴力检查方块坐标，从而获得巨大的 FPS 提升。
  • 优化扫描周期 - 将区块扫描限制为每 2 秒一次，保持 100% 稳定的性能。
  • 优化扫描范围 - 高效扫描最多 10 个区块半径（约 160 格）。
  • 内存友好 - 轻量级集合和动态注册表查找，确保可忽略不计的内存占用。

兼容性

  • Fabric 生态 - 使用标准 Fabric API 构建
  • 模组兼容性 - 应与大多数其他客户端模组协同工作
  • 资源包安全 - 不干扰纹理包或光影

安全与设计理念

  • 无服务器检测 - 仅使用客户端世界数据
  • 反作弊安全 - 从服务器角度看，行为与原版客户端完全相同
  • 无视觉 ESP - 刻意避免渲染覆盖层，以防行为追踪
  • 仅 HUD 信息 - 提供数据而不鼓励可疑的移动模式
  • 无不公平优势 - 仅显示已加载区块中的信息

🛠️ 从源码构建

前置条件

  • Java 21 或更高版本
  • Git

构建步骤

# 克隆仓库
git clone <仓库地址>
cd spawnerfinder

# 构建模组
./gradlew build

# 找到构建好的 JAR 文件
ls build/libs/spawnerfinder-2.0.0.jar

📝 许可证

本项目采用 CC0-1.0 许可证 - 详情请参阅 LICENSE 文件。

🤝 贡献

欢迎贡献代码！请随时提交拉取请求。

开发环境设置

  1. 克隆仓库
  2. 导入到你的 IDE（推荐使用 IntelliJ IDEA）
  3. 运行 ./gradlew genEclipseRuns 或 ./gradlew genIntellijRuns
  4. 使用生成的运行配置进行测试

贡献指南

  • 遵循现有代码风格和模式
  • 提交 PR 前进行充分测试
  • 为新功能更新文档
  • 考虑配置更改的向后兼容性

📞 支持

  • 问题反馈 - 通过 GitHub Issues 报告问题或请求功能
  • 兼容性 - 查看环境要求部分了解支持的版本
  • 性能问题 - 如果遇到卡顿，尝试降低渲染距离

🔄 版本历史

v1.0.0

  • 首次发布
  • 基础刷怪笼检测和 HUD 显示
  • 支持常见生物类型
  • 仅客户端实现

v1.1.0 - 大型更新

新功能：

  • 刷怪笼群组查找器：自动识别可同时激活的刷怪笼群组！
    • 在 HUD 右侧显示"发现刷怪笼群组"。
    • 显示最佳激活坐标（中心点），便于有效堆叠刷怪塔。
    • 列出每个群组内的各个刷怪笼。
    • 按群组大小排序（最大的群组优先），帮助你立即找到最佳刷怪位置。
  • 按键绑定控制：
    • O：开关整个模组。
    • I：展开/折叠刷怪笼列表（显示前 5 个或全部）。
  • 性能大幅优化：
    • 完全重写了扫描引擎，使用"已加载区块"而非暴力方块检查。
    • 零卡顿：即使在低端硬件上也能实现 100% 高效的 CPU 使用率。
  • 视觉改进：
    • 改进 HUD 可读性，使用更清晰的字体并移除了不必要的阴影。
    • "已发现刷怪笼"标题现在清晰可见，带有分隔线。
    • 右侧 HUD 显示群组信息，保持屏幕整洁有序。

v1.2.0

  • 更新至 Minecraft 26.1（Tiny Takeover 更新）
  • 移植以兼容 Java 25
  • 将渲染逻辑迁移至新的 HudElementRegistry API

v2.0.0 - 终极搜索与界面更新（Minecraft 26.1）

新功能与增强：

  • 精炼的 HUD 界面：
    • 刷怪笼列表后方添加深色透明背景面板，提升可读性。
    • 交互式屏幕高度扩展（使用 I 键在紧凑和展开视图之间切换）。
    • 高保真生物图标渲染（使用自定义生物头颅或刷怪蛋），紧邻 HUD 和搜索界面中的每个条目。
  • 高级分组系统：
    • 自动识别位于激活邻近范围内（16 格半径）的刷怪笼群组。
    • 计算玩家应站立以同时激活和运行多个刷怪笼的精确坐标中心点。
    • 在 HUD 右侧显示群组，按群组大小（最大的优先）和距离排序。
  • 动态搜索与过滤：
    • 全新的交互式搜索界面（默认按键：U）。
    • 通过输入生物名称实时搜索过滤，缩小 HUD 上的刷怪笼范围。
    • 支持 TAB 补全，可在搜索框中快速循环浏览可用的生物名称。
    • 完全支持非原版和模组刷怪笼（从注册表动态加载）。
    • "仅原版"过滤器开关，可轻松在基础游戏和自定义模组生物之间切换。
  • 显著性能调优：
    • 扫描引擎使用区块加载追踪（LevelChunk）而非暴力方块检查，实现零卡顿和高 FPS。
    • 扫描间隔优化为 2 秒，确保即使在较低配置的系统上也能流畅运行。

🚨 免责声明

本模组旨在辅助探索和提升便利性，而非用于作弊。

核心要点：

  • 仅提供信息 - 显示已加载区块中刷怪笼的数据，不提供 ESP/透视功能
  • 行为责任 - 你是否会被发现取决于你如何使用这些信息，而非模组本身
  • 服务器规则 - 始终检查并遵守各个服务器关于客户端修改的政策
  • 鼓励自然游玩 - 将坐标作为探索的指南，而非直接导航

法律声明：

  • 本模组仅访问你的 Minecraft 客户端已可用的数据
  • 技术上无法进行服务器端检测
  • 玩家行为和移动模式由你自己负责
  • 开发者不对任何因可疑游戏行为导致的封禁负责

记住：目标是增强探索体验，而非规避游戏机制。请理性游玩！