SVWaypoint

SVWaypoint

为Minecraft服务器提供的现代3D路径点，具有持久的世界标记、自定义图标、物品渲染、Unicode支持以及简洁的游戏内HUD。

冒险

SVWaypoint预览查看大图

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