Simple Location Marking

概览

简单地点标记是一款轻量级客户端地点标记模组，直接受到 Waypoints系统的启发，并采用现代Xaero’s Minimap风格的半透明深色玻璃美学设计。

它专为想要清晰易读的 3D 游戏内地点标记、又不想安装占用资源的迷你地图覆盖层或传送作弊功能的玩家打造。几秒钟即可标记重要地点；使用 MS Paint 风格的六边形调色板和实时标记预览整理路标；无论距离多远，都能轻松导航，且对帧率毫无影响。

主要功能

• 半透明深色玻璃游戏内 3D 标记：
  • 将 3D 路标直接投射到 HUD 上，锚定在其精确的世界坐标处 (x + 0.5, y + 1.0, z + 0.5)，并可透过地形显示。
  • 任意距离下保持固定的屏幕尺寸：先将相机相对方向向量归一化并投射到单位球面，再进行视图/投影变换，确保位于 10m、500m 或 50km+ 处的路标（远超原版渲染距离）不会被裁切，且始终以完全相同的紧凑屏幕尺寸显示。
  • 默认紧凑标记牌：显示简洁的16x16深色玻璃标记牌（0xA6101218），带有1px外边框和2px顶部强调条，二者均采用路标的 RGB 颜色；中央则显示路标名称中以大写形式显示的首字母，并以鲜艳色彩突出。
  • 动态准星悬停信息条：将准星瞄向标记时，标记牌会平滑展开为半透明深色玻璃信息条（0xBF101218），显示完整的路标名称（首字母大写）。
  • 清晰易读的距离标签（m 和 km）：实时显示欧几里得距离（<number>m以下显示于10000m下方；在<number>km及更远距离时显示于10000m），位置就在标记牌下方；距离标签采用紧凑的0.75x缩放深色信息条（0x80000000、0xFFE0E0E0文字），在天空、雪地或熔岩背景下也清晰醒目。
• MS Paint 风格六边形调色板与实时预览：
  • 内置自定义交互式蜂巢调色板，由同心六边形环构成，覆盖完整的 HSV/RGB 色谱，底部另有灰度色阶；选中的色块会以清晰发光的轮廓标示。
  • 调色板旁还提供实时的颜色与标记预览框，让你立即查看紧凑标记牌和展开后的悬停信息条在游戏中的效果。
• 维度隔离：
  • 路标按维度严格区分（Overworld、Nether、The End及自定义维度）。管理界面只会列出当前维度的标记，HUD 也只会渲染当前维度的标记。
• 自动按世界和服务器分别存储：
  • 路标以 JSON 文件形式保存在 .minecraft/config/simplelocationmarking/ 中。
  • 系统会根据当前单人世界文件夹名称或多人服务器 IP 地址自动生成独立的存储文件，确保标记不会串到其他世界或服务器。
• 内置本地化：
  • 开箱即用，完整支持英语（en_us）和越南语（vi_vn）翻译。

界面与操作指南

1. 主管理界面（P键）

• 在游戏中按下 P（可在 选项 -> 控制 -> 按键绑定中的 Simple Location Marking下重新绑定），即可打开 位置管理界面。界面显示在柔和的深色半透明遮罩上方（0x7008090C），不会使用不透明的泥土背景，也不会使用导致颜色失真的模糊光影。
• 顶部信息栏：在强调色胶囊徽章中显示你当前所在的维度（Overworld为翡翠绿，Nether为深红色，The End为紫色），并在旁边的胶囊框中显示你当前的坐标（X, Y, Z）。
• 可滚动的路径点列表：在内嵌式深色玻璃视窗（0x880B0C10）中显示当前维度的所有路径点，并配有纤细的4px半透明滚动条。每张路径点卡片显示：
  • 带有1px边框的发光彩色方块色样、路径点名称、灰色的(X, Y, Z)坐标、右对齐的距离徽章（m/km），以及隐藏时显示的独特琥珀色/红色[Hidden])徽章。
  • 点击任意卡片可选中该路径点，双击卡片可直接编辑。

2. 操作按钮

• Add（始终启用）：
  • 打开添加位置界面，其中包含间距舒适的半透明子面板，分别用于填写位置名称、查看只读的X、Y和Z坐标字段（预先填入你当前所在方块的位置），以及使用六边形调色板选择颜色并在实时标记预览框中查看效果，系统会预先随机选中一种鲜艳颜色。
  • 点击 Add（或按下 Enter）即可保存新路径点并返回主列表。
• Edit（选中路径点时启用）：
  • 打开编辑位置界面，并预先填入所选路径点的当前数据。
  • 可编辑位置名称、修改整数X、Y和Z坐标，并在六边形调色板中选择新颜色，同时实时预览效果。
  • 点击 Submit（或按下 Enter）即可保存更改。
• Hide/Show（选中路径点时启用）：
  • 立即切换所选路径点的可见状态。
  • 隐藏的路径点会在管理列表中显示琥珀色/红色[Hidden]标签，并且在重新启用前不会显示在游戏内的 3D HUD 上。
• Delete（选中路径点时启用）：
  • 从管理列表、存储文件和游戏内 HUD 中移除所选路径点。

性能与公平游戏理念

• 严格禁止传送：Simple Location Marking 专为真实的生存玩法打造。它不提供传送按钮或作弊命令，让探索与旅行保持意义。
• 每帧零分配：摄像机投影运算、排序缓冲区和文本测量结果都会缓存并跨帧复用，因此 HUD 渲染器不会造成垃圾回收压力，也不会导致 FPS 下降。
• 纯客户端运行：完全在客户端运行，可在单人世界以及任何多人服务器上无缝使用，无需在服务端安装。

安装

1. 为你的游戏版本安装相应的模组加载器和所需的前置库。
2. 下载与你的游戏版本匹配的 Simple Location Marking .jar 文件。
3. 将 .jar 文件放入你的 .minecraft/mods/ 目录。
4. 启动游戏并在游戏中按下 P 来管理位置。

支持本项目

如果你喜欢 Simple Location Marking，欢迎考虑通过 Ko-fi 支持项目开发：

• Ko-fi： https://ko-fi.com/thaistoanf