Conflux Map

Conflux Map

A client-side minimap and world map for Fabric, written from scratch for Minecraft 1.17.1 and the whole 1.21 line. It runs standalone against any server — vanilla, modded, or proxied — and needs no server-side installation. An optional server companion is available, but every feature that matters day to day works client-only.

Features

• HUD minimap — always-on corner overlay: square or circular, 4 corner positions, 4 sizes, 4 zoom levels, optional player-facing rotation, coordinate and biome readout.
• Fullscreen world map — pan and zoom over multi-resolution tiles, cursor-anchored zoom, right-click to drop a waypoint anywhere.
• Cave / Nether / End layers — automatic underground detection in the Overworld with hysteresis so the view does not flicker at the boundary; Nether current-layer, ceiling, and manual Y-slice modes; End void-background rendering.
• Waypoints and death points — create, edit, color, group into sets, and toggle; automatic death markers; strict per-dimension rendering with an optional 8:1 Overworld/Nether cross-view; edge-of-minimap direction arrows for off-screen points.
• Waypoint sets — create, rename, and delete local sets; multi-select or select-all-in-filter to move points between sets in one operation.
• Coordinate sharing — preview-before-send chat sharing (Conflux Map and Xaero formats) and click-to-import for coordinate messages, on any server. With the companion installed, an operator-gated public waypoint catalog with locks and per-player limits.
• Entity radar — hostile / passive / player / other classified separately, each with its own toggle, range, and entity cap.
• Persistent disk cache — explored terrain is stored per world, server, dimension, and layer, so rejoining shows the map you already drew instead of a blank canvas.
• Seed-predicted underlay — panning into unexplored Overworld or End terrain shows an instant seed-based estimate of biomes, terrain height, and tree cover; real captured tiles draw over it as they load. Backed by a bundled cubiomes native build for Windows, Linux, and macOS (x86_64 and aarch64).
• Structure candidates — villages, ocean monuments, woodland mansions, outposts, ruined portals, and end cities appear as semi-transparent markers until real data confirms or rules them out.
• Prediction modes — press P to cycle everywhere (default), generated-only (underlay masked to chunks the server has generated), or visited-only (captured map only, no prediction).
• In-game settings screen — every option above is adjustable in game and applies immediately, no restart. Full English and Simplified Chinese localization.

Keybinds

All rebindable under Minecraft's Controls screen, category "Conflux Map".

| Key | Action | |---|---| | H | Toggle the minimap | | ] / [ | Minimap zoom in / out | | M | Open the fullscreen world map | | Y | Cycle the manual layer override | | U | Open the waypoint list | | B | New waypoint at your position | | J | Toggle local waypoints | | , | Open the settings screen | | P | Cycle prediction mode | | F9 | Reload prediction tiles |

Supported versions

One build per Minecraft version that broke an API this mod uses; each build loads on every patch release that shares that API.

| Build | Loads on | |---|---| | 1.17.1 | 1.17.1 | | 1.21.1 | 1.21, 1.21.1 | | 1.21.3 | 1.21.2, 1.21.3 | | 1.21.4 | 1.21.4 | | 1.21.5 | 1.21.5 | | 1.21.8 | 1.21.6, 1.21.7, 1.21.8 | | 1.21.9 | 1.21.9, 1.21.10 | | 1.21.11 | 1.21.11 |

Requires Fabric Loader and Fabric API. Not a Forge/NeoForge mod.

Optional server companion

The same jar can run on an integrated or dedicated server. When an operator enables it, the companion returns compact per-column corrections so predicted terrain converges on the real world, and hosts the public waypoint catalog. The world seed and the catalog are shared only when the operator explicitly opts in; with no companion present the client simply falls back to its own captured data.

License and source

GPL-3.0. Source, issue tracker, and third-party attributions: <https://github.com/Conflux-Union/conflux-map>

Conflux Map 是一个 Fabric 客户端小地图 / 世界地图模组，支持 Minecraft 1.17.1 与整条 1.21 线，全部代码从零实现。对任意服务端（原版、模组端或代理端）都可独立使用，不需要安装服务端组件。

• 小地图 HUD：方形或圆形，4 个角落位置、4 档尺寸、4 档缩放，可跟随视角旋转，显示坐标与生物群系。
• 全屏世界地图：多分辨率瓦片，可拖动缩放，以光标为中心缩放，右键直接创建路径点。
• 洞穴 / 下界 / 末地图层：主世界地下模式自动检测（带滞回，不会在边界反复闪烁）；下界当前层 / 基岩顶层 / 手动 Y 切片；末地虚空背景渲染。
• 路径点与死亡点：创建、编辑、上色、分集管理，死亡自动记录；按维度显示，可选开启主世界与下界 8:1 互见；小地图边缘方向指示器提示范围外的点。
• 坐标共享：聊天共享发送前可预览（Conflux Map 与 Xaero 两种格式），识别到坐标消息可点击导入；服务端安装 companion 后还提供 OP 可控的公共坐标点目录。
• 实体雷达：敌对 / 被动 / 玩家 / 其他四类独立开关，各自可配置范围与数量上限。
• 磁盘缓存：已探索地形按世界 / 服务器 / 维度 / 图层持久化，重进世界直接显示此前画过的地图。
• 种子预测底图：拖到未探索区域时立即显示基于种子推算的生物群系、地形高度与树木分布，真实瓦片加载后覆盖其上；内置 cubiomes 原生库（Windows / Linux / macOS，x86_64 与 aarch64）。
• 结构候选标记：村庄、海底神殿、林地府邸、前哨站、废弃传送门、末地城以半透明标记显示，直到真实数据确认或排除。
• 预测模式：按 P 在「全部 / 仅已生成 / 仅已访问」之间切换。
• 游戏内设置界面：所有选项即时生效、无需重启，完整中英文本地化。

需要 Fabric Loader 与 Fabric API。许可证 GPL-3.0。