VoxelMap x SeedMapper (VoxelMapper)

作者：cev-api

VoxelMap x SeedMapper 是深度改版的 VoxelMap 分支，将 SeedMapper 直接整合进客户端，并为 VoxelMap 添加高级区块叠加层、数据共享和世界地图工具。

模组 Fabric 实用

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

VoxelMap x SeedMapper by CevAPI

LOGO

VoxelMap x SeedMapper 是 VoxelMap Updated 的深度修改分支，将 SeedMapper 直接整合到客户端，并为 VoxelMap 扩展了高级区块叠加层、数据共享和世界地图工具。非常适合搜寻基地和结构战利品！

GIF

当前功能

SeedMapper 核心

将 SeedMapper 整合到客户端（无需外部模组工作流）。
支持定位结构、生物群系、史莱姆区块、矿脉、地形、洞穴、峡谷和战利品。
支持定位废弃矿井、沙漠水井、紫水晶 geode、峡谷、下界化石和 26.3 废弃营地。
在矿石高亮中包含被虫蚀的矿石（蠹虫方块）。
在世界地图和小地图上显示 SeedMapper 的结果。
跟踪已定位目标的完成状态。
提供已保存的种子、手动输入种子，以及按世界/服务器分别保存的 SeedMapper 状态。
为每个世界和服务器保存自定义结构盐值，以支持数据包和模组结构。
提供埋藏宝藏聚集点查找器，可扫描世界边界，寻找罕见的多宝藏聚集地。
提供试炼密室宝库战利品预测，包含普通和不祥奖励表。
通过 SeedMapper’s Fork捆绑 cubiomes 支持。

实体显示与标记

可在小地图和全屏世界地图上检测已加载区块中的容器、工作站、红石组件、刷怪笼和试炼刷怪笼。
容器筛选器包括单箱、双箱、陷阱箱、末影箱、潜影盒、木桶、漏斗、发射器、投掷器、酿造台和合成器。
每个类别都可以单独启用，并可通过 ... 子菜单选择具体方块类型。
若末地船标记对应的物品展示框中不再有鞘翅（包括被玩家取走的情况），会在标记上显示红色斜杠。
支持可选的标记聚类：相邻且匹配的标记会合并为一个带白色数量标记的 Minecraft 图标，放大时则会再次分开。
按服务器和维度保存已检测到的标记，重新连接后恢复，并在区块重新扫描时更新。
通过实时方块/区块钩子更新已加载实体，无需等待完整的渲染距离扫描。

Entities

地图图标缩放

为传送门、末地传送门、末地折跃门、容器、工作站、红石和刷怪笼分别提供 Map Entities Scale 和 Minimap Entities Scale 控制项。
小地图实体缩放默认值为 0.6x，上限为 1.2x；全屏地图实体缩放则独立设置。
在 SeedMapper 的“世界与结构”设置下，分别提供小地图和全屏世界地图的 SeedMapper 结构图标缩放选项。

SeedMap

根据已配置的种子预测生物群系和地形，不受已探索地形数据影响。
在不同缩放级别下使用与世界对齐的采样；近距离缩放时逐方块采样生物群系，粗略纹素则使用多个采样点。
分配预览分辨率时优先保证地图可视区域，而非屏幕外留白，因此拖动地图不会降低所设的细节级别。
先显示生物群系预览，再基于有限且经过插值的高度网格细化地形阴影。SeedMap 地形阴影是预测效果，并非逐方块完整渲染世界。
在 World Map → Seed Map 下提供最高可达 Preview Resolution 4096 的预览分辨率，以及预览缓存、留白、地形样式和移动时更新等控制项。现有已保存的分辨率数值会予以保留。
光标生物群系查询保持异步处理，并在地图关闭或上下文发生变化时取消过时的预览任务。

SeedMap

SeedMapper 菜单

SeedMapMenu

定位结构

LocateStructure

SeedMapper 命令

暴露本地命令根：/seedmap、/sm、/voxelmap、/vmap。
支持 locate、highlight、vault、treasure-cluster 和 source-chain 命令。
提供独立的 SeedMap 界面和埋藏宝藏簇搜索。

常用命令：

/seedmap help
/seedmap seed <seed> [--structureSalt <structure>=<salt> ...]
/seedmap version [auto|supported version]（选择 cubiomes 的 Minecraft 版本；auto 跟随客户端）
/seedmap map
/seedmap locate structure <feature_id>
/seedmap locate treasurecluster
/seedmap locate biome <biome_name>
/seedmap locate orevein <iron|copper>
/seedmap locate slime
/seedmap locate loot <text>
/seedmap vault predict [offset] [ominous] [amount]
/seedmap highlight ore <block> [chunks]
/seedmap highlight orevein [chunks]
/seedmap highlight terrain [chunks]
/seedmap highlight surface [chunks]
/seedmap highlight canyon [chunks]
/seedmap highlight cave [chunks]
/seedmap highlight clear
/seedmap chunkanalysis scan [radius]（默认进行 9×9 已加载区块对比）
/seedmap chunkanalysis esp ore <block> [chunks]
/seedmap chunkanalysis ore <block> [chunks]
/seedmap chunkanalysis voids [radius]
/seedmap chunkanalysis audit [radius]
/seedmap chunkanalysis unexpected [radius]
/seedmap chunkanalysis continuous <off|voids|audit|both>
/seedmap chunkanalysis clear
/seedmap chunkanalysis status
/seedmap chunkanalysis ghost [on|off]
/seedmap chunkanalysis <status|clear>
/seedmap export [visible|radius <blocks>|area <x> <z> <radius>]
/seedmap source <run|seeded|positioned|in|versioned|flagged|as|rotated> ...

ChunkAnalysis

根据配置的种子和当前原版维度，在内存中生成原版ProtoChunk区块，包含结构和特征，但不保存区块数据。
客户端版本与服务器版本一致时效果最佳。
谨慎比较种子推算出的方块类型与已加载的多人游戏区块：红色表示预期存在但缺失，蓝色表示意外出现，黄色表示方块类型已改变。
忽略精确状态属性、流体和随机刻方块，因为它们可能在没有玩家操作的情况下因正常模拟而改变。
高置信度过滤还会排除植被和装饰噪声、意外出现的自然地形，以及自然地形材料之间模棱两可的替换。
通过快速连通分量形态学扫描检测玩家挖出的空洞，并将可能的隧道、竖井、楼梯、房间和挖掘区域标记为深红色。
提供/seedmap chunkanalysis voids [radius]，可跳过群系装饰和特征生成，进行更快速的纯空洞扫描。
将装饰阶段的方块写入与稳定地形分开追踪，因此无需方块白名单，也能检测种子推算地形中的任意方块替换；对于洞穴差异明显且双向不一致的区块，会报告并过滤为不兼容基线。
使用半透明染色方块模型幽灵效果或可选的纯色 ESP 填充，并在已扫描区块之间公平抽样，同时提供可配置的性能限制。
支持在命令和 ChunkAnalysis 设置界面中使用scan、voids、audit、unexpected、continuous、clear、status和ghost模式。
通过/seedmap chunkanalysis esp ore <block> [chunks]（或/seedmap chunkanalysis ore <block> [chunks]）提供原版世界生成的矿石 ESP。
矿石 ESP 位置取自 ChunkAnalysis 在内存中生成的原版ProtoChunk区块，而非 SeedMapper 的 Cubiomes 矿石生成路径。
提供矿石 ESP 目标和区块半径控制，并为钻石、铁、金、绿宝石、铜、煤、青金石、红石、下界矿石、远古残骸和蠹虫方块提供自动补全。
ChunkAnalysis 的颜色选项中提供专用的矿石 ESP 颜色。
在模组化客户端中，寻找隧道、洞穴和楼梯的速度比传统的“TunnelHoleStairESP”作弊模组更快。

ChunkAnal
Interesting
Everything

ChunkAnalysis ESP

SeedMapper 使用 Cubiomes 预测矿石生成位置。ChunkAnalysis 则使用 Minecraft 自身的世界生成代码重新生成区块，然后扫描生成结果，寻找所选矿石。
差异可能取决于 MC/客户端版本不匹配或反 X 光实现方式。两者各有优势。
蓝色是 ChunkAnalysis ESP，红色是 SeedMapper ESP。

Blue
Red

SeedMapper ESP、追踪与战利品工作流

为方块、矿脉、洞穴、峡谷和地形渲染 ESP。
提供地表 ESP，仅高亮每列中预测位置最高的方块。
支持在下界和末地使用地形 ESP，也支持主世界。
提供可配置的 ESP 样式配置，包括填充、轮廓、颜色、透明度和超时行为。
为已定位的结构和战利品结果提供高亮与追踪工作流。
玩家靠近目标时自动隐藏高亮。
提供集成式战利品查看器，可按名称、ID、附魔和类似 NBT 的词条搜索。
可打开试炼密室、远古城市和古迹废墟的战利品视图。
可直接根据世界地图上的试炼密室标记预测宝库战利品。
保留战利品表，使容器战利品在生成后仍可识别。
从上方查看时，ESP 和 ChunkAnalysis 覆盖层会显示在地形上方。
可以忽略与世界的比对，这可能有助于应对反 X 光。

ESP 设置

ESPSettings

地形高亮

TerrainESP

矿物高亮

HardcOre

战利品查看器

LocateLoot

数据包结构支持

为 SeedMapper 导入数据包结构。
将自定义结构盐应用于世界地图标记、定位器查询和战利品查找。
提供数据包 URL、缓存路径、自动加载和启用控制。
提供图标样式和配色方案控制。
按世界持久化数据包结构的启用/禁用状态。
持久化从数据包定位到的标记。
在地图隐藏或禁用时以及精确结果解析后可靠地清除 SeedMapper 加载文本。

Baritone 集成

通过 BaritoneHelper 与 Baritone 集成。
提供自动矿脉挖掘器，可检测暴露的矿脉并使用 Baritone 进行分支采矿。
需要单独安装 Baritone。

CPU 渲染器

提供完整的基于 CPU 的雷达渲染器，作为 GPU 管线的替代方案。
通过 Enable CPU Rendering 设置启用 CPU 渲染。
在 CPU 路径上支持方块头盔渲染。
提供与 Vulkan 及其他修改渲染器的模组的 VoxelMap 兼容性。

渲染与兼容性

通过兼容 Iris 的辅助程序路由小地图和世界地图渲染，使小地图文本、图标和生物图标在 Iris 光影下保持可见。
对兼容的生物图标使用 Geckolib 支持的实体渲染，包括盔甲和实体变体。
处理世界地图渲染和坐标的视网膜显示缩放。
在资源重载后正确重建资源支持的地图、图标和实体数据。
保持渲染管线和叠加层深度排序与 ChunkAnalysis、ESP、实体和世界地图图层兼容。

世界地图改进

在全屏地图上渲染 SeedMapper 标记图标和战利品标记。
在全屏地图上渲染带宝藏数量的埋藏宝藏集群标记。
提供独立的 SeedMap 界面，支持拖动平移、滚动缩放和坐标输入。
提供生物群系采样 Y 控制，使种子地图生物群系在所选高度采样。
支持更深入的 SeedMap 放大和缩小，按住 Shift 可加快步进。
支持在 SeedMap 和全屏地图上使用触摸板/触控板捏合缩放。
提供标记上下文操作，用于完成切换、战利品操作和路径点交互。
提供可配置的传送快捷方式，用于传送、飞行、寻路及其他客户端/服务端命令。
提供传送快捷方式控制，可排除 Y 坐标并在主菜单中显示所有快捷方式。
传送快捷方式的名称、命令、可见性和客户端命令标志在启动之间持久化。
持久化世界地图绘图线，支持编辑、复制、删除、颜色、粗细和跨维度。
支持可见区域导出。
提供坐标重新居中/编辑和玩家重新居中操作。
通过改进的纹理处理和渲染处理深度缩小和性能模式。
在世界地图性能模式下选中时保持路径点可见。
在全屏地图标题中显示缩放比例和每像素方块数。
提供改进的路径点分层、深度处理、标签排序、图标渲染和高亮路径点透明度。
安全处理世界地图缓存位置和区块就绪检查。
保护缓存写入和解压缩；升级后过期的缓存数据可能需要清除。
处理世界地图右键操作、坐标编辑、自动补全和调整大小的输入，且不丢失屏幕值。
支持玩家和维度感知的世界地图状态，包括自定义服务器维度和别名。

细节、可见性和性能

全屏地图的细节、可见性、渲染和缩放控制位于侧边栏选项屏幕中的 世界地图。

细节提供 完整细节和均衡预设，可分别设置区块轨迹、新旧区块的分辨率、已探索地形的分辨率，以及自动隐藏图层的控制项。完整细节会保持所有图层可见，使用精确的区块覆盖层，并显示所有已探索地形像素。
按缩放级别控制可见性提供独立滑块，用于控制地形、区块轨迹、轨迹节点、新旧区块、路径点、路径点名称、实体和 SeedMap 生物群系的显示。每个滑块的末端都有始终选项。
渲染提供自动、缓存图像和几何覆盖模式、图像缩放、平滑处理，以及移动时或标记数量过多时可选的标记精简功能。
缩放与存储用于设置缩放范围、滚动多少步翻倍、缩放吸附，以及 保留缩放视图缓存。已完成的视图会在可配置的内存预算内保留，以便重复缩放时重用；较旧的视图可能会被清除。
显示 → 显示加载进度条可启用或禁用左下角各个加载进度条。
裁剪屏幕外的覆盖层、缓存稀疏区块查询结果和已完成的地图视图，并将预览任务与已探索地形加载任务分开调度。几何数据会拆分成多个批次，以避免超过渲染器的顶点限制。

完整细节适用于已探索地形和覆盖层。SeedMap 的预览分辨率和地形着色各自有采样限制；提高预览分辨率需要更多计算资源和内存。

SeedMapper 集成

LargeMap

标记完成示例

MarkComplete

坐标视图

View

绘制线条与区块试验

Example

小地图和区块覆盖层改进

在小地图上渲染 SeedMapper 标记。
在小地图和世界地图上渲染更新版新生成区块覆盖层（参见上文的“新生成区块系统”）。
提供区块网格和史莱姆区块选项。
提供实心区块线渲染和线条粗细控制。
提供小地图下方的计分板位置选项。
在小地图上显示已加载的玩家，并允许设置默认小地图位置。

NewChunks

传送门和路径点增强

为下界传送门、末地传送门和末地信标渲染传送门标记覆盖层。
自动记录传送门，并在受支持的维度中检测传送门。
从 Xaero’s Minimap 和 Wurst 导入路径点。
支持多选路径点，并可选择启用删除确认。
提供更多路径点罗盘和标签位置选项。
在分享流程中提供维度筛选和复制到剪贴板功能。
提供路径点图标选择器，并在当前设置流程中保留已选图标。

ExploredChunks+PortalDetection

WayPoints

新生成区块系统

提供专属的新生成区块功能集，并设有独立的选项类别和屏幕。
可检测并渲染：
新生成的区块
已探索区块历史
液体漏洞区块信号
方块更新漏洞区块信号
在小地图和全屏世界地图上显示新生成区块图层。
保存区块历史数据，让已检测到的状态在重启后仍然保留。
提供区块覆盖层样式控制，包括线条模式、粗细和可见性开关。

区块选项

ChunkOptions

ChunkSync/共享

ChunkSync 可让你安全地与其他玩家共享区块图层数据。

一次性设置

/chunksync key <passphrase>
/chunksync host <litterbox|file.io>

/chunksync share
/chunksync share to <name>

导出你的区块共享包。
使用你配置的密码短语加密。
上传到所选主机。
发布（或私信发送）编码后的导入令牌。

接收

/chunksync get <code>
/chunksync get <code> as <name>

默认情况下，get会合并到你自己的图层中。
as <name>会作为单独的彩色玩家图层导入。
通过聊天提示执行的导入操作会自动使用独立图层流程。

手动文件传输

/chunksync export [name]会写入voxelmap/chunk_share/<name>/（支持文件夹或 ZIP 工作流）。
/chunksync import [name] [as <name>]导入本地文件夹或.zip包。

管理已导入的图层

/chunksync players
/chunksync remove <name>

ChunkSync

界面与设置

提供专用的 SeedMapper 选项标签页及相关界面。
提供定位器、战利品查看器、ESP 配置文件、数据包、已保存种子/地图以及独立 SeedMap 的界面。
提供 SeedMapper 设置，包括自定义结构盐值、宝藏簇扫描、生物群系采样 Y 坐标和 ChunkAnalysis 模式。
提供分类式设置侧边栏，支持每个选项的工具提示、自动补全、依赖感知控件和分类下拉菜单。
提供高级 → 服务器与种子 → 管理服务器种子，并支持搜索以及所有服务器 / 有种子 / 无种子筛选器。
列出已保存的 Minecraft 服务器、VoxelMap 服务器/世界种子记录和 SeedMapper 覆盖项，并提供复制、编辑或删除种子的控件。编辑种子不会影响路径点记录；删除种子不会删除服务器的地图数据。
提供区块管理界面。
提供 ChunkSync 管理界面，可管理密码短语、共享、接收、手动导入/导出、玩家图层和状态。
使用VoxelMap x SeedMapper by CevAPI品牌标识。
包含 SeedMapper、ChunkSync 和当前 26.3 设置项的本地化键。
在非服务器环境中禁用仅限服务器的设置，并在界面调整大小时保留输入值。