SVWaypoint
SVWaypoint 是一款简洁现代的导航点模组,允许玩家和服务器创建持久化的 3D 导航点,并直接渲染在世界中。
与旧式的导航点系统不同,SVWaypoint 不使用盔甲架。相反,它使用一种定制的轻量级导航点实体,旨在提供更好的性能、更干净的渲染效果以及更佳的多玩家支持。
它非常适合用于活动服务器、小游戏服务器、生存服务器、角色扮演服务器、直播项目以及自定义资源包体验。
功能特性
- 定制轻量级导航点实体。
- 无需盔甲架。
- 随世界数据保存的持久化导航点。
- 支持多玩家的服务器端导航点系统。
- 干净的世界内 3D 渲染。
- 可选的距离显示。
- 可选的 Unicode 图标。
- 可选的 Minecraft 物品图标。
- 支持原版和模组物品。
- 支持来自资源包的自定义 Unicode 字体。
- 公开和私有导航点。
- 每个玩家独立的导航点所有权。
- 可配置的文字缩放、图标缩放、颜色、可见性、渲染距离和物品旋转。
- 最近导航点 HUD。
- 快速创建临时导航点的按键绑定。
- 切换导航点 HUD 显示的按键绑定。
渲染系统
每个导航点可以显示:
- 主名称。
- 名称下方的距离。
- Unicode 符号。
- 作为图标的真实 Minecraft 物品。
- 使用
ResourceLocation 的自定义字体。
- 可选的物品图标旋转。
- 可选的穿墙渲染。
示例:
/svwaypoint create home Home
/svwaypoint edit home unicode \uE000
/svwaypoint edit home item minecraft:diamond
/svwaypoint edit home color #55FFAA
如果设置了物品图标,Unicode 图标将自动清除。这能保持导航点整洁,防止两个图标同时渲染。
命令
在当前位置创建导航点
/svwaypoint create <id> <name>
在玩家当前位置创建一个持久化导航点。
示例:
/svwaypoint create home Home
在指定坐标创建导航点
/svwaypoint pos <id> <x> <y> <z> <name>
在特定位置创建一个持久化导航点。
示例:
/svwaypoint pos spawn 0 80 0 Spawn
删除导航点
/svwaypoint remove <id>
完全删除一个导航点。
示例:
/svwaypoint remove home
列出导航点
/svwaypoint list
显示对你可见的导航点。
查看导航点信息
/svwaypoint info <id>
显示导航点数据,如名称、位置、物品、Unicode 图标、颜色、字体、可见性和渲染选项。
传送至导航点
/svwaypoint tp <id>
如果你拥有权限,传送到选定的导航点。
示例:
/svwaypoint tp home
编辑导航点
/svwaypoint edit <id> <field> <value>
可用字段:
name
unicode
item
color
visible
distance
public
font
scale
unicode_scale
render_distance
background
through_walls
rotate_item
示例:
/svwaypoint edit home name Base
/svwaypoint edit home unicode \uE000
/svwaypoint edit home item minecraft:nether_star
/svwaypoint edit home color #FFAA00
/svwaypoint edit home visible true
/svwaypoint edit home distance true
/svwaypoint edit home public false
/svwaypoint edit home font minecraft:default
/svwaypoint edit home scale 1.2
/svwaypoint edit home unicode_scale 1.5
/svwaypoint edit home render_distance 256
/svwaypoint edit home background true
/svwaypoint edit home through_walls false
/svwaypoint edit home rotate_item true
临时导航点
/svwaypoint temp
在玩家注视的位置创建一个临时导航点。
重新加载导航点数据
/svwaypoint reload
重新加载并刷新导航点数据和运行时导航点实体。
调试
/svwaypoint debug
显示已保存的导航点数量、活动的运行时实体数量以及有用的调试信息。
按键绑定
默认按键绑定:
- X — 切换最近导航点 HUD。
- Z — 创建临时射线检测导航点。
可以在 Minecraft 控制菜单中更改按键绑定。
服务器配置
服务器配置文件生成于:
config/svwaypoint-server.toml
可配置的选项包括:
- 临时导航点持续时间。
- 默认渲染距离。
- 默认文字缩放。
- 默认图标缩放。
- 默认导航点颜色。
- 默认导航点字体。
- 默认显示距离。
- 穿墙渲染。
- 文字背景。
- 物品图标动画。
- 最大导航点限制。
- 命令权限。
- 传送权限。
- 调试模式。
资源包 Unicode 支持
SVWaypoint 支持来自资源包的自定义 Unicode 字符。
示例:
/svwaypoint edit home unicode \uE000
/svwaypoint edit home font svwaypoint:waypoint_icons
这允许服务器通过 Minecraft 字体提供程序使用自定义图标、符号和纹理。
如果自定义字体缺失或不可用,渲染器会安全地回退到:
minecraft:default
物品图标支持
SVWaypoint 可以将真实的 Minecraft 物品渲染为导航点图标。
示例:
/svwaypoint edit home item minecraft:diamond
/svwaypoint edit home item minecraft:compass
/svwaypoint edit home item minecraft:nether_star
只要物品在服务器和客户端都存在,也支持模组物品。
示例:
/svwaypoint edit boss item some_mod:custom_sword
SVWaypoint
SVWaypoint is a clean and modern waypoint mod that lets players and servers create persistent 3D waypoints rendered directly in the world.
Unlike older waypoint systems, SVWaypoint does not use Armor Stands. Instead, it uses a custom lightweight waypoint entity designed for better performance, cleaner rendering, and better multiplayer support.
It is perfect for event servers, minigames, survival servers, roleplay servers, stream projects, and custom resource-pack experiences.
Features
- Custom lightweight waypoint entity.
- No Armor Stands.
- Persistent waypoints saved with world data.
- Multiplayer-ready server-side waypoint system.
- Clean 3D in-world rendering.
- Optional distance display.
- Optional unicode icon.
- Optional Minecraft item icon.
- Supports vanilla and modded items.
- Supports custom unicode fonts from resource packs.
- Public and private waypoints.
- Per-player waypoint ownership.
- Configurable text scale, icon scale, color, visibility, render distance, and item rotation.
- Closest-waypoint HUD.
- Keybind for quick temporary waypoints.
- Keybind for toggling the waypoint HUD.
Rendering System
Each waypoint can display:
- A main name.
- Distance below the name.
- A unicode symbol.
- A real Minecraft item as an icon.
- A custom font using a
ResourceLocation.
- Optional rotating item icons.
- Optional through-walls rendering.
Example:
/svwaypoint create home Home
/svwaypoint edit home unicode \uE000
/svwaypoint edit home item minecraft:diamond
/svwaypoint edit home color #55FFAA
If an item icon is set, the unicode icon is cleared automatically. This keeps the waypoint clean and prevents both icons from rendering at the same time.
Commands
Create a waypoint at your current position
/svwaypoint create <id> <name>
Creates a persistent waypoint at the player's current position.
Example:
/svwaypoint create home Home
Create a waypoint at exact coordinates
/svwaypoint pos <id> <x> <y> <z> <name>
Creates a persistent waypoint at a specific position.
Example:
/svwaypoint pos spawn 0 80 0 Spawn
Remove a waypoint
/svwaypoint remove <id>
Deletes a waypoint completely.
Example:
/svwaypoint remove home
List waypoints
/svwaypoint list
Shows the waypoints visible to you.
View waypoint info
/svwaypoint info <id>
Shows waypoint data such as name, position, item, unicode icon, color, font, visibility, and render options.
Teleport to a waypoint
/svwaypoint tp <id>
Teleports you to the selected waypoint if you have permission.
Example:
/svwaypoint tp home
Edit a waypoint
/svwaypoint edit <id> <field> <value>
Available fields:
name
unicode
item
color
visible
distance
public
font
scale
unicode_scale
render_distance
background
through_walls
rotate_item
Examples:
/svwaypoint edit home name Base
/svwaypoint edit home unicode \uE000
/svwaypoint edit home item minecraft:nether_star
/svwaypoint edit home color #FFAA00
/svwaypoint edit home visible true
/svwaypoint edit home distance true
/svwaypoint edit home public false
/svwaypoint edit home font minecraft:default
/svwaypoint edit home scale 1.2
/svwaypoint edit home unicode_scale 1.5
/svwaypoint edit home render_distance 256
/svwaypoint edit home background true
/svwaypoint edit home through_walls false
/svwaypoint edit home rotate_item true
Temporary waypoint
/svwaypoint temp
Creates a temporary waypoint where the player is looking.
Reload waypoint data
/svwaypoint reload
Reloads and refreshes waypoint data and runtime waypoint entities.
Debug
/svwaypoint debug
Shows saved waypoint count, active runtime entity count, and useful debug information.
Keybinds
Default keybinds:
- X — Toggle closest-waypoint HUD.
- Z — Create a temporary raycast waypoint.
Keybinds can be changed from the Minecraft Controls menu.
Server Config
The server config is generated at:
config/svwaypoint-server.toml
Configurable options include:
- Temporary waypoint duration.
- Default render distance.
- Default text scale.
- Default icon scale.
- Default waypoint color.
- Default waypoint font.
- Show distance by default.
- Through-walls rendering.
- Text background.
- Item icon animation.
- Maximum waypoint limit.
- Command permissions.
- Teleport permissions.
- Debug mode.
Resource Pack Unicode Support
SVWaypoint supports custom unicode characters from resource packs.
Example:
/svwaypoint edit home unicode \uE000
/svwaypoint edit home font svwaypoint:waypoint_icons
This allows servers to use custom icons, symbols, and textures through Minecraft font providers.
If a custom font is missing or unavailable, the renderer safely falls back to:
minecraft:default
Item Icon Support
SVWaypoint can render real Minecraft items as waypoint icons.
Examples:
/svwaypoint edit home item minecraft:diamond
/svwaypoint edit home item minecraft:compass
/svwaypoint edit home item minecraft:nether_star
Modded items are also supported as long as the item exists on both the server and the client.
Example:
/svwaypoint edit boss item some_mod:custom_sword
评论 0
登录后参与评分
还没有评论,来抢沙发吧