Waydot
轻量级路标,无需小地图。
Waydot 是我制作的 Minecraft Java 版客户端路标模组。主要理念是在不需要小地图的情况下拥有一个良好的路标系统。
你可以创建路标、使用标签进行整理、自定义外观、导入/导出以及备份。所有内容均本地存储,服务器无需安装 Waydot。
画廊说明: 部分截图是在我使用第三方 GUI 资源包时拍摄的,因此 Minecraft 按钮的外观可能略有不同。实际的 Waydot 菜单和布局属于模组本身。该资源包未包含且非必需。
现已独立运行,地图支持后续添加
Waydot 目前完全独立运行。你不需要安装任何小地图或世界地图模组。
当前版本没有小地图集成,但我打算稍后添加。构想是如果你安装了受支持的地图模组,Waydot 的路标也可以在那里显示。
由于我尚未实现并充分测试这部分功能,暂时不列出具体支持的地图模组。
功能
- 使用自定义名称、坐标、维度、颜色和图标创建路标。
- 使用彩色标签,如基地、挖矿、农场、传送门、村庄、探索、危险和项目。
- 在管理器中搜索、排序和过滤路标。
- 聚焦、复制、隐藏/显示、分享或删除它们。
- 可选的自动死亡路标。
- 以多种不同格式导入和导出路标。
- 重要更改前的备份,降低意外丢失所有内容的风险。
- 当太多路标标记彼此靠近时自动分组。
- 20 种内置像素艺术图标。
- 通过普通 Minecraft 资源包添加自定义图标。
- 不同世界和多玩家服务器拥有独立的路标数据。
还有不少设置项,但大多数可以保持默认。
游戏内标记
路标会作为标记出现在世界中,并面向你的摄像机。它们可以显示图标、路标名称、标签和距离。
标记大小会根据你与它的距离而变化。这能确保远处的路标可见,而不会让近处的路标占据屏幕的一半以上。
你可以在设置中更改渲染距离、不透明度、缩放、淡入淡出、穿墙可见性、距离格式以及其他一些选项。
我在制作过程中遇到的一个问题是一堆路标靠得太近。这会很快变得杂乱无章。Waydot 通过隐藏一些重叠的标签并将密集区域归组到一个集群标记下来处理这个问题。当你靠近或看向该群组时,各个独立的标签会再次显示。
标签与图标
标签基本上就是为路标着色的分类。
它们可以重命名、重新排序或隐藏,并且你可以移除某个标签而不删除使用该标签的所有路标。如果你想恢复,还有一些默认的标签预设。
路标图标与标签是分开的,因此你可以拥有具有自己标记颜色和图标的路标,同时标签控制名称的颜色。
Waydot 目前自带 20 种像素艺术图标。
你也可以使用普通资源包添加自己的图标。自定义图标可以是 16×16、24×24 或 32×32 的 PNG 文件。资源包可以添加新的命名空间图标或替换内置图标。
如果你想制作,我写了一份 资源包图标指南,还有一个 资源包模板 可供起步。
导入、导出与备份
Waydot 可以导出所有路标或仅导出你想要的。你可以导出可见的路标、特定标签、当前过滤结果或手动选择它们。
目前有 3 种格式:
- Waydot JSON 用于完整的路标/标签数据。
- Waydot CSV 如果你希望数据以行形式呈现或在电子表格中打开。
- 纯文本 用于简单的可读
key=value 路标数据。
导入内容会在任何更改之前进行预览。
Waydot 会检查条目,并允许你在确认后跳过重复项、将它们作为新路标添加或替换匹配的项。如果一个条目损坏,其他有效条目仍可导入。
在导入、还原和一些破坏性更改之前也有自动安全备份。如果需要,也可以启用定期备份。
关于数据存储位置及还原工作原理的更多详细信息请参阅 数据管理指南。
安装
- 安装 Fabric Loader。
- 安装 Fabric API。
- 将 Waydot JAR 放入你的
mods 文件夹。
- Mod Menu 是可选的,但能使打开设置更加便捷。
基本上就是这样。
Waydot 完全是客户端侧的。你不需要在服务器上安装任何东西。
它应该可以在包括原版、Fabric、Paper 和 Spigot 在内的使用标准协议的服务端上正常运行。
默认控制
| 操作 |
默认按键 |
| 创建路标 |
B |
| 打开路标管理器 |
M |
| 切换路标渲染 |
N |
| 快速路标 |
未绑定 |
| 隐藏/显示最近的路标 |
未绑定 |
所有这些都可以在 Minecraft 的正常“控制”菜单下的 Waydot 中进行更改。
本地与私密
Waydot 没有遥测、分析、账户或任何在线服务。
也没有传送、雷达、实体追踪、区块扫描或内置小地图。
你的设置、航点、导入、导出和备份都存储在 config/waydot/ 下。
世界路径和服务器地址会被转换为安全的环境键,而不是直接将原始值放入文件名中。除非你选择复制或删除,否则航点数据会保留在你的电脑上。
许可证
Waydot 可免费使用,且源码可用。
你可以查看源代码、修改它并自行编译。在许可证允许下,你也可以将 JAR 包免费分享给一个小范围的私人群组。
公开再分发则有所不同。未经许可,请不要将官方或修改过的 Waydot JAR 包重新上传到其他网站、公共整合包、启动器或镜像站。
你可以在完整的 Waydot 源码可用许可证 1.0 中阅读具体条款。
链接
Waydot
Lightweight waypoints, without needing a minimap.
Waydot is a client-side waypoint mod I made for Minecraft Java Edition. The main idea was to have a good waypoint system without needing a minimap just for that.
You can create waypoints, organize them with tags, customize how they look, import/export them and make backups. Everything is stored locally and the server doesn't need Waydot installed.
Gallery note: Some screenshots were taken while I was using a third-party GUI resource pack, so the Minecraft buttons may look a bit different. The actual Waydot menus and layouts are part of the mod. That resource pack isn't included or required.
Standalone now, map support later
Waydot works completely standalone right now. You don't need a minimap or world map mod installed.
There is no minimap integration in the current release, but I want to add it later. The idea is that if you have a supported map mod installed, Waydot waypoints could also show up there.
I don't want to list specific map mods yet since I haven't implemented and properly tested that part.
Features
- Create waypoints with your own name, coordinates, dimension, color and icon.
- Use colored tags like Base, Mining, Farm, Portal, Village, Exploration, Danger and Project.
- Search, sort and filter waypoints from the manager.
- Focus, duplicate, hide/show, share or delete them.
- Optional automatic death waypoints.
- Import and export waypoints in a few different formats.
- Backups before important changes so accidentally losing everything is less likely.
- Automatic grouping when too many waypoint markers are close together.
- 20 built-in pixel-art icons.
- Custom icons through normal Minecraft resource packs.
- Separate waypoint data for different worlds and multiplayer servers.
There are quite a few settings too, but most of them can just be left at default.
In-world markers
Waypoints show up as markers in the world and face your camera. They can show the icon, waypoint name, tag and distance.
The marker size changes depending on how far away you are. This keeps far away waypoints visible without making nearby ones take over half the screen.
You can change render distance, opacity, scale, fading, through-wall visibility, distance formatting and a few other things from settings.
A problem I ran into while making this was having lots of waypoints close together. It gets cluttered really quickly. Waydot handles this by hiding some overlapping labels and grouping dense areas under a cluster marker. When you move closer or look toward the group, the individual labels show again.
Tags and icons
Tags are basically colored categories for your waypoints.
They can be renamed, reordered or hidden, and you can remove a tag without deleting all the waypoints that were using it. There are also some default tag presets if you want to restore them.
Waypoint icons are separate from tags, so you can have a waypoint with its own marker color and icon while the tag controls the name color.
Waydot comes with 20 pixel-art icons right now.
You can also add your own icons using a normal resource pack. Custom icons can be 16×16, 24×24 or 32×32 PNG files. Resource packs can add new namespaced icons or replace the built-in ones.
If you want to make one, I wrote a resource-pack icon guide and there is also a resource-pack template to start with.
Import, export and backups
Waydot can export all waypoints or only the ones you want. You can export visible waypoints, a certain tag, your current filtered results or manually select them.
Currently there are 3 formats:
- Waydot JSON for the complete waypoint/tag data.
- Waydot CSV if you want the data in rows or open it in a spreadsheet.
- Plain text for simple readable
key=value waypoint data.
Imports get previewed before anything is changed.
Waydot checks the entries and lets you skip duplicates, add them as new waypoints or replace matching ones after confirmation. If one entry is broken, other valid entries can still be imported.
There are also automatic safety backups before things like imports, restores and some destructive changes. Periodic backups can be enabled too if you want them.
More details about where everything is stored and how restoring works are in the data-management guide.
Installation
- Install Fabric Loader.
- Install Fabric API.
- Put the Waydot JAR into your
mods folder.
- Mod Menu is optional, but makes opening the settings easier.
And thats pretty much it.
Waydot is completely client-side. You don't need to install anything on the server.
It should work on normal vanilla-protocol servers including vanilla, Fabric, Paper and Spigot.
Default controls
| Action |
Default key |
| Create waypoint |
B |
| Open Waypoint Manager |
M |
| Toggle waypoint rendering |
N |
| Quick waypoint |
Unbound |
| Hide/show nearest waypoint |
Unbound |
All of these can be changed from Minecraft's normal Controls menu under Waydot.
Local and private
Waydot doesn't have telemetry, analytics, accounts or any online service.
There is also no teleportation, radar, entity tracking, chunk scanning or built-in minimap.
Your settings, waypoints, imports, exports and backups are stored under config/waydot/.
World paths and server addresses are converted into safe context keys instead of putting the original values directly into filenames. Waypoint data stays on your computer unless you choose to copy or export it.
License
Waydot is free to use and source-available.
You can look through the source, modify it and compile it yourself. Sharing the JAR for free with a small private group is also allowed under the license.
Public redistribution is different. Please don't reupload official or modified Waydot JARs to other websites, public modpacks, launchers or mirrors without permission.
You can read the full Waydot Source-Available License 1.0 for the exact terms.
Links
评论 0
登录后参与评分
还没有评论,来抢沙发吧