x3d Map

!Discord !GitHub License

A 3D terrain map mod for Minecraft. Provides a rotatable, zoomable 3D world map with terrain rendering, minimap overlay, and waypoint management.

本模组为 Minecraft 添加了一个可旋转、缩放的三维立体世界地图，支持地形渲染、小地图覆盖层和路径点管理。

Demonstrate 效果展示

!3D Map !Performance !Minimap

Feature List 功能列表

Feature	Description
3D Terrain Map	Block-level high-detail terrain rendering with LOD system
Minimap	Configurable minimap HUD overlay with compass
Waypoints	Add, edit, delete, teleport, and share waypoints on the map
Chunk Selection	Box-select chunks for batch re-render, re-request, or delete operations
Picture-in-Picture	Render the 3D map in a PIP overlay
Compatibility Mode	Fallback mode for GPUs lacking MDI, sparse texture, or SSBO support
Server Chunk Request	Request server-side chunk re-sending (requires server permission)
Auto Save	Periodic auto-saving of map data

功能	说明
3D 地形地图	带 LOD 系统的高精度方块级地形渲染
小地图	可配置的小地图 HUD 覆盖层，带指南针
路径点	在地图上添加、编辑、删除、传送和分享路径点
区块选择	框选区块以进行批量重渲染、重新请求或删除
画中画	在画中画覆盖层中渲染 3D 地图
兼容模式	为不支持 MDI、稀疏纹理或 SSBO 的 GPU 提供降级兼容模式
服务器区块请求	向服务器请求重新发送区块数据（需要服务器权限）
自动保存	定期自动保存地图数据

Controls 操作说明

Action	Control
Open Map	Press M (configurable)
Move Map	Right-click drag / WASD
Rotate Map	Middle-click drag / Q / E
Zoom In/Out	Scroll wheel
Quick Add Waypoint	Double left-click on map
Add Waypoint (manual)	Click add waypoint button, then left-click on map
Select Chunks	Toggle selection mode, left-drag on map

操作	按键
打开地图	按 M 键（可配置）
移动地图	右键拖拽 / WASD
旋转地图	中键拖拽 / Q / E
缩放	鼠标滚轮
快速添加路径点	双击地图左键
手动添加路径点	点击添加路径点按钮，然后在地图上左键
选择区块	切换选择模式，左键拖拽

Some Explanation 一些说明

• The 3D map does not support cave views.
• In non-compatibility mode, the map has high-detail block-level terrain and less detailed heightfield terrain. The map loads block-level terrain based on load distance and renders it based on LOD distance.
• When compatibility mode is active, severe frame drops or crashes may occur.
• Compatibility mode is automatically detected based on GPU capabilities; use forceCompatibilityMode to manually enable it.
• Server-side chunk re-sending (Request Geomatics) requires allowServerSentChunk to be set to true in the server config. Enabling this may cause server lag because it forces the server to load and send chunks on demand.
• 3D 地图不支持洞穴视图；
• 非兼容模式下，地图分为高精度的方块级别地形和较少细节的高度场地形，地图根据加载距离加载方块级别地形，根据 LOD 距离来渲染；
• 兼容模式下可能严重掉帧或崩溃；
• 兼容模式基于 GPU 能力自动检测，可通过 forceCompatibilityMode 手动启用；
• 服务端重新发送区块（"请求地理数据"按钮）需要在服务端配置文件中将 allowServerSentChunk 设置为 true，开启后可能造成服务端卡顿，因为服务器需要按需强制加载并发送区块。