Universal Compass

Universal Compass (万界罗盘)

One compass that finds biomes, structures and mobs — one item, one GUI, five tabs. Right-click the compass, pick a target, and the needle points the way.

Features

• Five tabs: biomes, structures, mobs, known locations, saved mobs.
• Live HUD: distance, coordinates and the target's dimension while you walk; the needle animates in 32 frames.
• Search filters: match by name, by namespace (@modid), and — with JECharacters installed — by pinyin.
• Adjustable radius (1,000–30,000 blocks), applied live, no restart needed.
• Cross-dimension: the compass tells you which dimension the target is in instead of pointing at nothing.
• Custom groups: sort known locations and saved mobs into your own lists, and add your current position with one click.
• Teleport button: jump to a result, across dimensions, with a safe-landing spot search. Server owners can disable it (allowTeleport).
• Server-side search: structure and biome searches run on the server with a tick budget, a timeout and cancellation, so the world does not freeze.

Optional integrations

• JECharacters — pinyin matching, for players who search in Chinese.
• BiomeSpy — biome search switches to the vanilla findClosestBiome3d path that BiomeSpy accelerates: block-exact results instead of coarse sampling, and narrow biomes are no longer skipped.

Both are optional. Without them the mod works standalone.

Compatibility

• Minecraft 1.20.1 — Forge 47.x (release)
• Minecraft 1.21.1 — NeoForge 21.1.235+ (beta: the server boots and loads cleanly, the client has not been play-tested yet)
• Client and server. On a multiplayer server, everyone should install it.

中文简介

一只罗盘，五个页签：群系 / 结构 / 生物 / 已知地点 / 已知生物。右键打开界面，选中目标后指针即指向其方位，右上角 HUD 实时显示距离与坐标，跨维度时会提示目标所在维度。

• 搜索半径可调（1,000–30,000 格），即时生效，无需重启。
• 安装 JECharacters 后支持拼音搜索；安装 BiomeSpy 后群系搜索改走逐方块精确快路径，窄群系不再漏掉。
• 支持自定义分组与一键记录当前位置；支持传送到搜索结果（服主可在配置里关闭）。

Universal Compass (万界罗盘)

A single compass mod for Minecraft Forge 1.20.1 that locates biomes, structures, and mobs — all from one item, one GUI.

Features

• Three search modes in one item: biome, structure, and mob.
• Biome search: coarse noise sampling (aligned with Nature's Compass: 64-block step, hard-capped samples, zero chunk loading, off-thread) — finds most biomes in 1–2s without freezing.
• Structure search: chunk-spiral checkStructurePresence spread across server ticks (~8ms/tick budget) so the main thread never freezes; uses placement-aware candidate search (same as /locate) for RandomSpread structures.
• Mob search: locates mobs within already-loaded chunks (an honest "loaded-range" search, not full-world).
• HUD pointer + progress: shows direction and a live search-progress percentage.
• Known-target cache: remembers found targets across game sessions.
• Zero hard dependencies: works standalone; optionally accelerates when BiomeSpy is present (auto-detected, routes to findClosestBiome3d).

Usage

Right-click the compass to open the GUI. Pick a mode tab, choose a target from the list, and the compass points toward it.

Compatibility

• Minecraft Forge 1.20.1 (Forge 47+).
• Optional: BiomeSpy (server-side) for faster biome/structure lookup.

License

MIT