CloudMap 地 图 系 统 - 使 用 文 档 目 录 插 件 简 介 依 赖 安 装 配 置 文 件 con fi g.yml - 核 心 配 置 waypoints.yml - 锚 点 与 路 径 点 配 置 map/< 世 界 名 >.yml - 地 图 配 置 lang.yml - 语 言 配 置 ui/ - UI 界 面 配 置 命 令 权 限 功 能 说 明 地 图 GUI 小 地 图 HUD 导 航 系 统 锚 点 解 锁 玩 家 自 定 义 路 径 点 地 图 制 作 指 南 准 备 地 图 贴 图 计 算 pixelO ff set 配 置 地 图 文 件 配 置 锚 点 数 据 库 常 ⻅ 问 题 插 件 简 介 CloudMap 是 一个 基 于 ArcartX 的 Minecraft 地 图 系 统 插 件 ， 提 供 ： 全 屏 地 图 GUI （ 按 M 键 打 开 ） 小 地 图 HUD （ 右 上 ⻆ 实 时显 示 ） 锚 点 传 送 （ 支 持 解 锁 机 制 与 费 用 ） 3 D 导 航 路 标 玩 家 自 定 义 路 径 点 多 世 界 支 持 依 赖 插 件 必 须 说 明 ArcartX 是 UI 渲 染 、 按 键 绑 定 、 导 航 路 标 TabooLib 是 框 架 层 （ 命 令 、 数 据 库 、 配 置 ） Vault 否 金 币 经 济 支 持 PlayerPoints 否 点 券 经 济 支 持 安 装 1 将 CloudMap.jar 放 入 服 务 端 plugins/ 目 录 2 确 保 已 安 装 ArcartX 及 TabooLib 3 启 动 服 务 器， 插 件 自 动 生 成 默 认 配 置 文 件 4 将 地 图 贴 图 和 图 标 资 源 放 入 ArcartX 资 源 包 5 修 改 配 置 后 执 行 /cm reload 重 载 配 置 文 件 con fi g.yml - 核 心 配 置 # 聊 天 消 息 前 缀 prefix: "§8[§6 地 图 系 统 §8]" # 按 键 绑 定 key: category: " 云之 地 图 " # 按 键 分 类 名 称 gui: name: " 打 开 地 图 " # GUI 按 键 显 示 名 key: "M" # 默 认 按 键 hud: name: " 显 示 / 隐 藏 小 地 图 " # HUD 按 键 显 示 名 key: "H" # 默 认 按 键 # 数 据 库 配 置 （ 默 认 SQLite ， 支 持 MySQL ） Database: type: sqlite MySQL: host: "localhost" port: 3306 database: "cloudmap" user: "root" password: "password" # 权 限 组 默 认 传 送 点 # 拥 有 cloudmap.default.< 组 名 > 权 限 的 玩 家 自 动 获 得 对 应 锚 点 DefaultPoint: default: - " 新 手 村 " vip1: - " 复 活 点 " - " 郊 外 " vip2: - " 挂 机 池 " - " 郊 外 " waypoints.yml - 锚 点 与 路 径 点 配 置 # 导 航 设 置 navigation: cancelDistance: 5 # 到 达 多 少 格 内 自 动 取 消 导 航 anchorStyle: "default" # 锚 点 导 航 路 标样 式 （ ArcartX 路 标 ID ） playerStyle: "default" # 玩 家 路 径 点 导 航 路 标样 式 # 玩 家 自 定 义 路 径 点 设 置 customWaypoint: texture: "Map/marker.png" # 路 径 点 图 标 textureHover: "Map/marker_.png" # 悬 浮 图 标 textureSize: 16.0 # 图 标 大 小 limit: # 各 权 限 组 的 路 径 点 数 量 上 限 default: 5 # cloudmap.waypoint.default vip1: 10 # cloudmap.waypoint.vip1 vip2: 20 # cloudmap.waypoint.vip2 # 锚 点 配 置 points: 复 活 点 : # 锚 点 ID （ 同 时 作 为 显 示 名 ） world: "world" # 所 属 世 界 x: -8.0 # X 坐 标 y: 65.0 # Y 坐 标 z: 118.0 # Z 坐 标 texture: "Map/tip.png" # 已 解 锁 图 标 textureHover: "Map/tip_.png" # 已 解 锁 悬 浮 图 标 textureSize: 16.0 # 图 标 大 小 vaultCost: 0 # 传 送 金 币 费 用 pointsCost: 0 # 传 送 点 券 费 用 needUnlock: false # 是 否 需 要 解 锁 type: " 传 送 " # 类 型 标 签 （ 显 示 在 信 息 面 板 ） info: " 这 是 主 城 的 复 活 点 " # 描 述 信 息 需 要 解 锁 的 锚 点 示 例 points: 挂 机 池 : world: "world" x: -50.5 y: 60.0 z: 200.5 texture: "Map/afk.png" textureHover: "Map/afk_.png" lockedTexture: "Map/afk_locked.png" # 未 解 锁 图 标 lockedTextureHover: "Map/afk_locked_.png" # 未 解 锁 悬 浮 图 标 textureSize: 20.0 vaultCost: 100 # 每 次 传 送 花 费 100 金 币 pointsCost: 10 # 每 次 传 送 花 费 10 点 券 needUnlock: true unlockCost: vault: 500 # 解 锁 需 要 500 金 币 points: 50 # 解 锁 需 要 50 点 券 items: # 解 锁 需 要 的 物 品 - name: " 解 锁钥 匙 " # 按 物 品 名 称 匹 配 amount: 1 navStyle: "afk_waypoint" # 自 定 义 导 航 路 标样 式 （ 可 选 ） type: " 传 送 " info: " 玩 家 挂 机 区 域 ， 安 全 无 怪 物 " 物 品 匹 配 规 则 解 锁 费 用 中 的 物 品 支 持 两 种 匹 配 方 式 ： 字 段 说 明 name 按 物 品 的 显 示 名 称 精 确 匹 配 lore 按 物 品 Lore 中 包 含 的 文 字 匹 配 （ 模 糊 ） map/< 世 界 名 >.yml - 地 图 配 置 文 件 名 即 为世 界 名 称 （ 如 world.yml 对 应 world 世 界 ） 。 # 地 图 贴 图 路 径 （ ArcartX 资 源 包 内 的 路 径 ） texture: "Map/world.png" # 地 图 贴 图 尺寸 （ 格 式 : " 宽 度 , 高 度 " ） mapInitialSize: "2048,2048" # 像 素 坐 标 偏 移 （ 格 式 : "X 偏 移 ,Z 偏 移 " ） # 计 算 方 法 : 贴 图 上 某 点 的 像 素 坐 标 - 游 戏 中 同 一 点 的 实 际 坐 标 pixelOffset: "0,0" # UI 缩 放 比 例 uiScale: "1.6" pixelO ff set 计 算 方 法 1 在 游 戏 中 找 一个 能 在 地 图 贴 图 上 精 确 定 位 的 参 考 点 2 记 录 该 点 的 游 戏 坐 标 （ 如 X=- 8 5 , Z= 118 ） 3 用 图 片 编 辑 器 打 开 地 图 贴 图 ， 找 到 同 一 点 的 像 素 坐 标 （ 如 X= 503 , Z= 630 ） 4 计 算 ： pixelOffset = 像 素 坐 标 - 游 戏 坐 标 pixelOffsetX = 503 - (-8.5) = 511.5 pixelOffsetZ = 630 - 118 = 512 填 入 配 置 ： pixelOffset: "511.5,512" lang.yml - 语 言 配 置 所 有 可 自 定 义 的 消 息 文 本 ： 键 名 默 认 值 说 明 map-not-found 该 世 界 没 有 配 置 地 图 世 界 无 地 图 时 提 示 map-not-configured 该 地 图 未 配 置 ， 无 法 打 开 地 图 未 配 置 时 提 示 money-not-enough 金 币 不 足 ， 需 要 : {cost} 传 送 金 币 不 足 points-not-enough 点 券 不 足 ， 需 要 : {cost} 传 送 点 券 不 足 waypoint-limit 自 定 义 路 径 点 已 达 上 限 路 径 点 数 量 超 限 unlock-success 锚 点 解 锁 成 功 解 锁 成 功 提 示 unlock-vault-not-enough 金 币 不 足 以 解 锁 : {cost} 解 锁 金 币 不 足 unlock-points-not-enough 点 券 不 足 以 解 锁 : {cost} 解 锁 点 券 不 足 unlock-items-not-enough 缺 少 所 需 物 品 : {item} 解 锁 物 品 不 足 navigate-start 导 航 已 开 始 ， 请 跟 随 路 标 前 进 开 始 导 航 navigate-cancel 导 航 已 取 消 取 消 导 航 navigate-arrived 已 到 达 目 的 地 ， 导 航 已 取 消 到 达 目 标 自 动 取 消 消 息 中 支 持 \n 换 行 。 ui/ - UI 界 面 配 置 文 件 说 明 ui/CloudMapGui.yml 全 屏 地 图 GUI 界 面 配 置 ui/CloudMapHud.yml 小 地 图 HUD 界 面 配 置 这 两个 文 件 使 用 ArcartX UI 配 置 格 式 ， 一 般 无 需 修 改 。 如 需 自 定 义 UI 布 局 ， 请 参 考 ArcartX UI 文 档 。 命 令 基 础 命 令 ： /cloudmap （ 别 名 ： /cm 、 /cmap 、 /map ） 命 令 权 限 说 明 /cm cloudmap.use 显 示 帮 助 /cm open [ 世 界 名 ] cloudmap.use 打 开 地 图 GUI （ 默 认 当 前 世 界 ） /cm reload cloudmap.admin 重 载 所 有 配 置 和 UI /cm list cloudmap.admin 列出 所 有 已 配 置 的 地 图 /cm points cloudmap.admin 列出 所 有 锚 点 信 息 权 限 权 限 节 点 说 明 cloudmap.use 使 用 地 图 基 础 功 能 cloudmap.admin 管 理 员命 令 （ 重 载 / 列 表 / 锚 点 管 理 ） cloudmap.default.< 组 名 > 自 动 获 得 对 应 权 限 组 的 默 认 锚 点 cloudmap.waypoint.< 组 名 > 对 应 权 限 组 的 自 定 义 路 径 点 数 量 上 限 功 能 说 明 地 图 GUI 按 M 键 （ 默 认 ） 或 执 行 /cm open 打 开 打 开 后 自 动 居 中 到 玩 家 当 前 位 置 ， 玩 家 头 像 显 示 在 地 图 中 央 鼠 标 滚 轮 缩 放 地 图 鼠 标 拖 拽 平 移 地 图 点 击 锚 点 图 标查 看 信 息 面 板 ， 可 执 行 传 送 / 导 航 / 解 锁 操 作 右 键 地 图 空 白 区 域 可 创 建 标 点 或 导 航 到 此 支 持 查 看 其 他 世 界 的 地 图 （ 通过 /cm open < 世 界 名 > ） 小 地 图 HUD 玩 家 进 入 服 务 器 后 自 动 显 示 在 屏 幕 右 上 ⻆ 按 H 键 （ 默 认 ） 切 换 显 示 / 隐 藏 实 时 跟 随 玩 家 移 动 ， 显 示 周 围 地 图 玩 家 头 像 始 终 在 小 地 图 正 中 央 显 示 附 近 的 锚 点 和 路 径 点 图 标 导 航 系 统 在 地 图 GUI 中 点 击 锚 点 的 导 航 按 钮 ， 或 右 键 菜 单 选 择 导 航 到 此 启 动 后 在 3D 世 界 中 显 示 ArcartX 路 标 指 引 方 向 到 达 目 标 点 附 近 （ 默 认 5 格 内 ） 自 动 取 消 导 航 可 随 时 通过 右 键 菜 单 手 动 取 消 导 航 支 持 为不 同 锚 点 配 置 不 同 的 导 航 路 标样 式 （ navStyle ） 锚 点 解 锁 锚 点 可 设 置 为 需 要 解 锁 才 能 使 用 ： 1 未 解 锁 的 锚 点 在 地 图 上 显 示 锁 定 图 标 2 点 击 后 信 息 面 板 显 示 解 锁 按 钮 3 解 锁 可 消 耗 金 币 、 点 券 、 物 品 （ 任 意 组 合 ） 4 解 锁 后 永 久 生 效 ， 数 据 存 储 在 数 据 库 中 5 每 次 传 送 可 额 外 收 取 传 送 费 用 玩 家 自 定 义 路 径 点 在 地 图 GUI 中 右 键 点 击 空 白 区 域 ， 选 择 创 建 标 点 输 入 名 称 后 创 建 成 功 ， 会 显 示 在 地 图 上 路 径 点 支 持 导 航 和 删 除 各 权 限 组 有 不 同 的 数 量 上 限 路 径 点 数 据 存 储 在 数 据 库 中 ， 跨 服 务 器 重 启 保 留 地 图 制 作 指 南 1. 准 备 地 图 贴 图 使 用 Dynmap 或 类 似 工 具 导 出 世 界 俯 视 图 保 存 为 PNG 格 式 ， 建 议 尺寸 2048x 2048 或 更 大 将 贴 图 放 入 ArcartX 资 源 包 对 应 目 录 （ 如 Map/world.png ） 2. 计 算 pixelO ff set 找 到 一个 在 游 戏 和 贴 图 中 都 能 精 确 定 位 的 参 考 点 ： pixelOffsetX = 参 考 点 像 素 X - 参 考 点 游 戏 X pixelOffsetZ = 参 考 点 像 素 Z - 参 考 点 游 戏 Z 3. 配 置 地 图 文 件 在 plugins/CloudMap/map/ 目 录 下 创 建 < 世 界 名 >.yml ： texture: "Map/world.png" mapInitialSize: "2048,2048" pixelOffset: "511.5,512" uiScale: "1.6" 4. 配 置 锚 点 在 waypoints.yml 的 points 节 点 下 添 加 锚 点 。 确 保 ： world 与 地 图 文 件 名 对 应 x 、 z 坐 标 为 游 戏 内 实 际 坐 标 图 标 资 源 已 放 入 ArcartX 资 源 包 配 置 完 成 后 执 行 /cm reload 重 载 。 数 据 库 插 件 使 用 TabooLib Database 模 块 ， 支 持 ： 类 型 说 明 SQLite 默 认 ， 数 据 存 储 在 plugins/CloudMap/cloudmap.db MySQL 在 config.yml 中 配 置 连 接 信 息 后 切 换 存 储 内 容 ： 玩 家 已 解 锁 的 锚 点 列 表 玩 家 自 定 义 路 径 点 数 据 常 ⻅ 问 题 Q: 地 图 上 锚 点 位 置 不 对 ？ A: 检 查 pixelOffset 配 置 。 重 新 用 参 考 点 计 算 ： 像 素 坐 标 - 游 戏 坐 标 。 Q: 地 图 贴 图 不 显 示 ？ A: 确 认 贴 图 路 径 与 ArcartX 资 源 包 中 的 路 径 一 致 （ 区 分 大 小 写 ） 。 Q: HUD 不 显 示 ？ A: 检 查 当 前 世 界 是 否 有 对 应 的 map/< 世 界 名 >.yml 配 置 文 件 。 按 H 键 尝 试 切 换 。 Q: 解 锁 / 传 送 扣 费 不 生 效 ？ A: 确 认 已 安 装 Vault （ 金 币 ） 或 PlayerPoints （ 点 券 ） 插 件 ， 并 正 确 连 接 经 济 系 统 。 Q: 如 何 添 加 新 世 界 的 地 图 ？ A: 在 map/ 目 录 下 创 建 < 世 界 名 >.yml ， 配 置 贴 图 路 径 和 参 数 ， 执 行 /cm reload 。