快速小地图 - 小地图、坐标与指南针 HUD

推荐模组

FastMiniMap

FastMiniMap 是 Hytale 的服务端小地图 HUD。地形渲染、HUD 传输和实时更新均在服务器端完成，因此玩家无需单独安装客户端模组即可查看小地图。

该模组旨在与 MultipleHUD 及其他 HUD 模组平稳协作，而不会独占唯一的自定义 HUD 槽位。

功能

• 基于 WorldMap 区块瓦片渲染的北向上地形小地图
• 圆角或圆形小地图样式，可配置边框颜色、粗细和角半径
• 可配置的中心标记颜色，支持静态菱形或方向指针模式
• 可选的方位标签和坐标栏
• 针对每个玩家的世界级配置文件，带有游戏内 /minimap 设置页面
• 与 MultipleHUD 共存，无需争夺默认 HUD 槽位
• 每个玩家独立的后台会话，使小地图不会在主游戏线程上运行
• 独立的地形、覆盖层和标记更新路径，以减少不必要的计算
• 无缝的实时区块刷新，复用最后一次有效瓦片，避免闪烁黑屏
• 安装 MobMapMarkers 后启用生物覆盖层
• 安装 PlayerAvatarMarker 后启用玩家覆盖层
• 基于资源文件的本地化支持，适用于 HUD 和设置页面

配置

配置路径：UserData/Saves/<World>/plugins/FastMiniMap/fastminimap-config.json

玩家配置文件路径：UserData/Saves/<World>/plugins/FastMiniMap/player-settings/<player-uuid>/<world-key>.json

键	默认值	说明
schemaVersion	2	由 FastMiniMap 写入的配置架构版本，用于将来的迁移
anchorPreset	"TOP_RIGHT"	新玩家配置文件的默认 HUD 角落
hudOffsetRight	24	HUD 右边缘偏移量（像素）
hudOffsetTop	24	HUD 顶部边缘偏移量（像素）
displaySize	220	地形图像大小（像素）（128-320）
visibleRadiusBlocks	50	可见区域的半宽（方块数）
tickIntervalMs	50	渲染检查间隔（毫秒）
settingsCommandEnabled	true	启用或禁用通过 /minimap 打开游戏内设置界面
showPlayerMarker	true	显示中心标记
showPlayerMarkerPointer	false	用方向指针替换中心标记
showCardinals	true	显示 N / E / S / W 方位标签
showCoordsBar	true	在地图下方显示坐标栏
showMobOverlay	true	启用来自提供方模组的生物标记
showPlayerOverlay	true	启用来自提供方模组的玩家头像覆盖层
borderColor	"D4A843"	地图边框颜色，十六进制 RRGGBB 或 AARRGGBB
centerMarkerColor	"E04444"	中心标记颜色，十六进制 RRGGBB 或 AARRGGBB
borderThickness	3	边框描边粗细（像素）
cornerRadius	18	圆角小地图的角半径（像素）
mapShape	"ROUNDED"	小地图形状：ROUNDED 或 CIRCLE

玩家特定设置按世界单独存储，当 settingsCommandEnabled 为 true 时，可在游戏内通过 /minimap 即时更改。

命令

• 当 settingsCommandEnabled 为 true 时，/minimap 打开 FastMiniMap 设置页面
• FastMiniMap 有意不设置权限层级；配置标志是唯一的公共门控

兼容性

• 独立运行：无需其他模组即可完整运行
• 安装 MultipleHUD 时可与其共存
• 安装 MobMapMarkers 后获得生物覆盖层
• 安装 PlayerAvatarMarker 后获得玩家头像覆盖层

FastMiniMap 负责小地图地形、HUD、中心标记、会话循环和覆盖层合成。MobMapMarkers 为小地图提供方表面提供生物点和生物图标，PlayerAvatarMarker 为同一提供方表面提供玩家头像点和头像图像。