Zeto 管理地图标记

Zeto 管理员地图标记

Zeto 管理员地图标记是一款服务端 Hytale 模组，允许管理员直接在通过按 M 键打开的世界地图上放置持久的、可缩放的文本标签和自定义图形。

与传统的图钉、路径点或玩家标记不同，使用此模组创建的元素会直接渲染到服务端的地图块中。玩家无需下载外部图像、安装额外的客户端模组或进行任何配置，就能收到一份完整合成的地图。

该模组专为希望清晰标记重要地点的服务器所有者设计，例如城市、商店、银行、传送门、地牢、活动区域、寺庙、玩家市场、重生区和其他兴趣点。

主要特性

• 将永久文本标签直接添加到世界地图上。
• 在地图块上显示自定义 PNG 图像和图标。
• 将文本和图形组合成一个地图元素。
• 创建纯文本或纯图形标记。
• 根据世界方块大小缩放标记。
• 通过游戏内图形界面编辑标记。
• 自动使用管理员的当前位置。
• 手动输入标记坐标。
• 为每个世界分别组织标记。
• 无论玩家距离标记多远，都显示标记。
• 从 URL、本地文件、模组数据文件夹或捆绑资源加载图像。
• 通过命令或游戏内 GUI 管理标记。
• 在服务器重启之间持久存储标记数据。
• 无需重启服务器即可重新加载标记数据。

直接地图渲染

管理员地图标记不会创建浮动在地图界面上方的标准图钉。每个元素都直接合成到地图块的图像中。

这使得标记感觉像是世界地图的自然组成部分，并允许管理员创建比简单路径点系统详细得多的地图布局。

您可以使用此模组显示：

• 地点名称
• 服务器区域
• 王国边界
• 城市标签
• 自定义徽标
• 商店图标
• 地牢符号
• 活动图形
• 装饰性地图插图
• 管理信息
• 服务器支持的任何自定义 PNG 图像

由于最终的地图块由服务器生成，玩家会收到可直接显示的地图图像。远程文件和本地图形永远不会由玩家直接下载。

标记类型

每个地图元素可以包含：

• 一个文本标签
• 一个图形
• 文本和图形两者

文本是可选的，图形也是可选的。编辑器只要求至少填写其中一个字段。

这意味着您可以创建一个不带图标的大型城市名称，放置一个不带文本的装饰性图像，或者将一个地点名称与一个可识别的符号结合起来。

命令

管理地图标记需要以下权限：

zeto.adminmapmaker.manage

打开图形编辑器

/mapmarker gui

打开游戏内图形化管理面板。

GUI 允许管理员创建、编辑和移除地图元素，而无需手动编辑配置文件。

添加或更新标记

/mapmarker add <id> <icon> <name>

在管理员当前位置创建一个新标记。

当具有相同 ID 的标记已存在时，会更新它而不是创建重复项。

示例：

/mapmarker add spawn spawn 主重生点
/mapmarker add shop shop 玩家市场
/mapmarker add bank bank 皇家银行

移除标记

/mapmarker remove <id>

从管理员当前世界移除选定的标记。

列出标记

/mapmarker list

显示当前世界中所有已注册的标记。

重新加载标记数据

/mapmarker reload

从数据文件重新加载标记信息，无需重启服务器。

内置图标别名

该模组包含几个便捷的图标别名，可在创建标记时使用：

shop
bank
spawn
home
portal
warp
campfire
temple

例如：

/mapmarker add temple temple 古代寺庙

要创建一个仅包含文本的标记，请使用：

none

或配置的等效项，例如：

brak

这将阻止渲染图标，并仅在地图上显示标记名称。

自定义图形

管理员地图标记支持多种图像源。

标记图形可以从以下位置加载：

• 一个 http 或 https URL
• 服务器上的绝对文件路径
• 位于模组数据目录相对路径的文件
• 捆绑在模组包内的 PNG 图像

示例 URL 源：

https://example.com/images/castle.png

示例绝对服务器路径：

/home/hytale/server/map-icons/castle.png

示例 Windows 路径：

C:\HytaleServer\map-icons\castle.png

示例模组数据文件夹的相对路径：

icons/castle.png

所有远程和本地图像都由服务器处理。玩家不会连接到提供的 URL，也不需要访问服务器的文件系统。

为获得最佳效果，请使用具有清晰轮廓和足够分辨率的透明 PNG 文件。

游戏内图形编辑器

可以使用以下命令打开图形编辑器：

/mapmarker gui

该面板允许管理员：

• 创建新标记
• 编辑现有标记
• 删除标记
• 输入唯一的标记 ID
• 添加可选的文本标签
• 选择一个图标别名
• 输入自定义图形源
• 设置标记的世界坐标
• 使用管理员的当前位置
• 更改标记大小
• 控制标记占用的世界空间

标记大小以世界方块而非屏幕像素定义。这允许图形和标签与地图比例正确对齐。

例如，代表大城市的标记可以覆盖更广的区域，而商店或传送门图标则可以保持小而精确。

基于世界的标记分离

标记为每个世界分别存储。

在一个世界中创建的标记不会自动出现在另一个世界中。这对于包含多个维度、地牢世界、活动地图、季节性区域或单独游戏区域的服务器非常有用。

相同的标记 ID 可以在不同的世界中使用而不会引起冲突。

诸如以下的命令：

/mapmarker list
/mapmarker remove <id>

作用于管理员的当前世界。

持久化数据存储

标记自动保存在：

mods/Zeto_AdminMapMarkers/markers.tsv

确切的模组数据目录名称可能因 Hytale 服务器版本和服务器实现而略有不同。

标记数据以原子方式写入。这降低了在保存文件时服务器意外停止而导致数据损坏的风险。

数据文件包含按世界分隔的标记信息，包括标记标识符、坐标、文本、图像源和缩放设置。

可以手动编辑，但建议使用游戏内 GUI 以防止无效条目。

手动更改文件后，运行：

/mapmarker reload

以加载更新后的数据。

安装

要求

• 兼容的 Hytale 专用服务器
• JDK 25
• 用于管理员命令的权限管理支持
• 从源代码编译项目时需要本地 Hytale 安装

从源代码构建

在项目目录中打开终端并运行：

./gradlew.bat clean build

构建成功后，编译好的模组将在以下位置：

build/libs/AdminMapMarkers-1.2.3.jar

服务器安装

1. 停止 Hytale 服务器。

2. 将生成的 JAR 文件复制到服务器的 mods 目录中。

3. 重新启动服务器。

4. 向管理员授予所需权限：

zeto.adminmapmaker.manage

1. 使用以下命令打开编辑器：

/mapmarker gui

示例配置工作流

为主服务器重生点创建标记：

/mapmarker add spawn spawn 主要复活点

为玩家市场创建标记：

/mapmarker add marketplace shop 玩家市场

为银行创建标记：

/mapmarker add royal_bank bank 皇家银行

创建纯文本城市标签：

/mapmarker add capital none 首都城市

查看当前世界中的所有标记：

/mapmarker list

移除市场标记：

/mapmarker remove marketplace

推荐用途

管理员地图标记特别适用于：

• 生存服务器
• MMORPG 服务器
• 角色扮演服务器
• 经济服务器
• 冒险地图
• 派系服务器
• 王国类服务器
• 地牢网络
• 小游戏大厅
• 季节性世界
• 大型自定义地图

服务器所有者可以创建专业标记的地图，而无需玩家记忆坐标或依赖外部网站。

重要说明

• 标记直接渲染到地图块中，不是常规的地图图钉。
• 必须至少提供一个文本标签或图形。
• 远程图形必须可供服务器访问。
• 本地文件路径指的是服务器机器，而非玩家的计算机。
• 透明 PNG 图像通常能提供最佳的视觉效果。
• 非常大的图形可能会覆盖地图的很大一部分。
• 标记 ID 在每个世界中应是唯一的。
• 移除标记仅影响当前世界。
• 玩家无需管理员权限即可看到标记。
• 玩家收到的是已完成的地图块，而不是原始图像文件。

总结

Zeto 管理员地图标记让 Hytale 服务器管理员能够完全控制世界地图上显示的视觉信息。

无论您是想标记一个小型玩家商店、命名整个王国、显示自定义服务器徽标，还是为 MMORPG 世界创建一幅完整的地图插图，该模组都提供了一个灵活的服务器端解决方案，具有持久化存储、自定义图形、基于世界的组织和易于使用的游戏内编辑器。

您可以在我们的服务器中查看此模组效果：play.hytaris.pl

 

查看我的其他模组：

 Metin Reforging - 像在 Metin2 中一样升级物品

 Zeto Gambling - 赌场！

 Zeto Fake Players - 在聊天中使用 AI 的假玩家

 

高级模组：

 Daily Streak Rewards - 每日登录连续奖励！