二次开发 闭源 娱乐 BeaconWaypointsReloaded —— 信标地标传送直接飞升 [1.21~26.2] 1.5.0

信标传送点（BeaconWaypointsReloaded）​

声明：本项目是 Beacon Waypoints Reloaded（原作者 KurosawaTomoya ）的二次开发分支，非专业开发，可能存在 bug，请自行评估后再用于正式服务器。

点击展开...

1. 增加了移动地标指南针，不需要在信标上点击传送。
2. 增加了传送点收费功能，玩家可以在管理菜单中设置收费金额及关闭传送点。
3. 参考 Residence 的权限组概念，修改原插件传送点逻辑，增加权限组传送点数量限制。
4. 修改原版判断逻辑：绑定传送点的信标，必须通过指令或 GUI 删除传送点后方可拆除，直接破坏无效。
5. 修复 Residence 领地无权限也可传送的漏洞。
6. 增加传送点开启 / 关闭开关，创建者可自主控制是否允许传送。

• 运行环境：Java 21，Paper / Purpur / Leaf 等兼容服务端（api-version: 1.21），在 26.2 版本运行正常
• 经济依赖（可选）：Vault + 经济插件（如 CMI）。未安装经济插件时，所有收费功能自动跳过，插件仍可正常使用。

目录​

• 一、环境与依赖
• 二、安装
• 三、快速上手
• 四、指令详解
• 五、图形界面（GUI）
• 六、功能特性详解
• 七、权限清单
• 八、配置文件详解（config.yml）
• 九、消息节点（messages）
• 十、数据存储
• 十一、常见问题与排错
• 十二、致谢

一、环境与依赖​

• 服务端：Java 21+，Paper / Purpur / Leaf 等兼容服务端（api-version: 1.21）。
• 经济（可选）：安装 Vault + 经济插件（如 CMI、EssentialsX 等）。
  • 插件通过 Vault 读取经济，不硬编码任何经济实现。
  • 未检测到 Vault 经济服务时，插件会自动禁用经济功能（控制台红色告警），创建 / 传送全部免费，其它功能不受影响。
  • 使用 CMI 时：需在 plugins/CMI/config.yml 把 Economy.Enabled 设为 true，并完整重启服务器（CMI 需要配套 Vault 版本或 injector）。
• EssentialsX（可选）：仅旧版兼容，非必需。

二、安装​

1. 把 BeaconWaypointsReloaded-1.5.0.jar 放入服务端 plugins/ 目录。
2. 启动 / 重启服务器，插件会自动生成 plugins/BeaconWaypointsReloaded/ 下的 config.yml、language.yml 等文件。
3. 按需修改 config.yml，然后执行 /wt reload 或重启。

三、快速上手​

1. 放置一个信标（搭建完整信标基座）。
2. 站到信标上，执行 /wt create 家 private（或 public 创建公共传送点）。
3. 在弹出的图标菜单里点选图标作为该传送点的图标。
4. 之后右键该信标 → 打开传送菜单 → 选择目标传送点即可传送。
5. 管理员 / 有权限的玩家可执行 /wt getcompass 领取「移动地标」指南针，右键指南针即可随时随地打开传送菜单。

四、指令详解​

• 第一层：子指令（create / remove / share / tp / list / rename / help / getcompass / reload）。
• /wt create → 补全 public / private。
• /wt remove、/wt rename、/wt tp → 动态补全地标名称。
• /wt share、/wt list（OP）→ 补全在线玩家名。

五、图形界面（GUI）​

1. 信标菜单（右键信标）​

• 更改信标效果：关闭本菜单后再点一次信标，打开原版信标效果界面。
• 公共传送点：进入公共传送点列表。
• 私人传送点：进入私人传送点列表（需私人传送点权限）。

2. 传送点列表​

• 左键某个传送点：传送到该点（需站在当前信标附近 5.5 格内）。
• 右键某个传送点（创建者或 manageAllWaypoints）：打开该传送点的选项菜单。
• 菜单底部有翻页按钮；右下角有当前信标传送点的选项入口。

3. 传送点选项菜单​

• 更改图标、删除传送点（需确认，且校验归属）。
• 公共传送点：manageAllWaypoints 可置顶 / 取消置顶；第一个格子是【传送收费管理】入口。
• 私人传送点：可管理分享访问权限。

4. 移动地标指南针菜单​

• 手持「移动地标」指南针右键打开，分【公共地标】【私有地标】两个分类：
  • 公共地标：所有玩家都能看到全部公共地标；
  • 私有地标：普通玩家只看自己创建的；OP 可看所有玩家的私人地标。
• 每个地标的说明（Lore）会显示「传送费用 + 传送状态」。
• 指南针物品用 PDC 持久化标记：只有 /wt getcompass 产出的指南针才能使用，原版指南针或铁砧改名的指南针无效。

5. 公共地标传送收费管理面板​

• 在公共地标选项菜单的第一个格子是【传送收费管理】按钮，仅该地标创建者（或 OP）可进入，其他玩家点击提示无权限。
• 面板功能：
  • 查看当前传送费用与传送开关状态；
  • 修改传送费用：点击后在聊天栏输入数字（0 表示永久免费）；
  • 开启 / 关闭传送开关。

六、功能特性详解​

1. 公共 / 私人传送点​

• 站在信标上创建，支持公共（所有人可见可用）与私人（仅自己 + 被分享者）两类。
• 传送点名称服务器内全局唯一（公共与私人之间也不能重名）。
• 传送点数据永久保存，拆除信标不会删除传送点，只能通过指令删除。

2. 传送与表现​

• 传送默认带预热 / 发射动画与音效；可配置为立即传送、禁用动画。
• 可配置把玩家弹射到指定高度再传送（launch-player / launch-player-height，反作弊插件可能需要调整）。
• 默认会连带传送站在信标上的其他玩家（disable-group-teleporting 可限制为仅发起者）。
• 传送过程中会拦截末影珍珠、紫颂果传送与摔落伤害，避免传送被打断。
• 目标信标必须建造正确且无方块阻挡（基岩除外），否则无法传送。

3. 移动地标指南针​

4. 信标方块保护​

• 绑定了传送点的信标默认受保护：必须先用指令删除传送点，才能拆除信标，创建者本人也不例外。
• 拥有 BeaconWaypoints.beacon.break.bypass（默认 OP）可直接拆除受保护信标。
• 没有绑定传送点的信标可正常拆除。

5. 公共地标传送收费（创建者可管理）​

• 每个公共地标独立保存两个属性：
  • teleport-fee：传送至该公共地标的单次费用，默认 0（免费）；
  • teleport-enabled：是否允许玩家传送，默认开启。
• 原版信标传送 与 指南针传送共用同一套收费规则，扣费顺序：
  1. 仅公共地标执行；私有地标不收费；
  2. OP 无条件放行（不扣费、不转账、无视传送开关）；
  3. 创建者本人始终可传送且免费；
  4. teleport-enabled 关闭时拦截其他玩家（提示「创建者已关闭传送功能」）；
  5. 拥有 BeaconWaypoints.bypass.teleport-fee 的玩家免费、不转账；
  6. 费用为 0 免费；
  7. 费用 > 0：校验余额，余额不足拦截；
  8. 扣除玩家费用并转账给该地标创建者（Vault/CMI）；转账失败则退款、控制台报错并终止传送。
• economy-enabled: false 时所有公共地标传送免费。

6. 创建收费与经济总开关​

• 创建地标费用：cost-create-public / cost-create-private，通过 Vault/CMI 扣除；拥有 bypass.cost 免费。
• economy-enabled：经济总开关。关闭时创建 / 传送全部免费，跳过余额检测与扣费。

7. 数量上限​

• 单玩家上限：max-public-per-player（公共）、max-private-per-player（私人），-1 表示不限制。
• 权限组独立上限 group-limits：玩家拥有权限 group.<组名> 即视为属于该组；同时属于多个组时取上限最大者；无匹配则用默认上限；-1 不限制。
• 拥有 bypass.limit 跳过全部数量上限检测。
• 不限制服务器公共地标总数量（全局公共总数上限已移除）。

8. 名称唯一性​

• 所有地标（公共 / 私人）名称全局唯一，创建与重命名时都会校验。
• name-case-sensitive：是否区分大小写（默认 false，HOME 与 home 视为同名）。

9. 探索模式​

• discovery-mode: true 时，公共传送点只对「已发现」的玩家显示。
• 玩家通过右键 / 交互关联的信标来「发现」该传送点。

10. 消息与帮助​

• 所有提示消息集中在 config.yml 的 messages 节点，支持 MiniMessage 标签（如 <red>、<gold>、<bold>）与传统 & 颜色代码。
• /wt help 帮助菜单分段排版（玩家指令 / 管理员指令），文本同样可在 config.yml 自定义。

七、权限清单​

权限规则：OP 自动豁免权限校验；非 OP 玩家严格校验对应权限。

点击展开...

八、配置文件详解（config.yml）​

数量上限​

• max-public-per-player：单玩家能创建的公共地标最大数量（默认 3，-1 不限制）
• max-private-per-player：单玩家能创建的私人地标最大数量（默认 10，-1 不限制）
• group-limits：按权限组单独设置上限

group-limits:
  vip:
    max-public: 3
    max-private: 20

名称与创建​

• name-case-sensitive：地标名是否区分大小写（默认 false）
• force-alphanumeric-names：是否强制名称仅含字母、数字、空格、下划线、连字符（默认 false）
• allow-all-worlds：是否允许在任意世界创建传送点（默认 true）
• allowed-worlds：allow-all-worlds 关闭时允许创建传送点的世界列表

经济​

• economy-enabled：经济总开关（默认 true）
• cost-create-public：创建公共地标费用（默认 500）
• cost-create-private：创建私人地标费用（默认 100）
• 公共地标传送费用不在此处配置，由每个地标自身的 teleport-fee 控制。

菜单与显示​

• public-waypoint-menu-rows：公共传送点菜单每页行数（1-5，默认 3）
• private-waypoint-menu-rows：私人传送点菜单每页行数（1-5，默认 2）
• waypoint-icons：可用图标物品列表（顺序即菜单中的显示顺序）
• compass：移动地标指南针配置

compass:
  material: COMPASS
  name: "&6移动地标"
  lore:
    - "&7右键打开地标传送菜单"
    - "&7无需站在信标旁"

传送表现​

• instant-teleport：选定目的地后立即传送，不播放预热动画（默认 false）
• disable-animations：禁用传送粒子动画（默认 false）
• launch-player：传送前把玩家弹射到空中（默认 true）
• launch-player-height：弹射高度（默认 576，最小为世界高度）
• disable-group-teleporting：是否只传送发起者本人（默认 false，即连带传送信标上的其他玩家）

其它​

• discovery-mode：探索模式（默认 false）
• messages：所有提示消息（见下节）

已废弃 / 移除的旧配置（保留说明，不再读取）：max-public-waypoints、max-private-waypoints、max-global-public-waypoints、cost-teleport、payment-mode、xp-cost-*、money-cost-*、cost-multiplier、required-items、banned-items、allow-beacon-break-by-owner。

点击展开...

九、消息节点（messages）​

• %amount%：金额（如余额不足提示、传送费用提示）
• %player%：玩家名（list-player-header）
• %name% / %owner%：地标名 / 拥有者名（list-entry）

language.yml 作为回退语言文件仍有效；config.yml 的 messages 优先级更高。

点击展开...

十、数据存储​

• plugins/BeaconWaypointsReloaded/waypoints.yml：公共、置顶、未激活地标
• plugins/BeaconWaypointsReloaded/players/<uuid>.yml：每个玩家的私人地标

十一、常见问题与排错​

• 确认已安装 Vault 与经济插件；使用 CMI 时在 plugins/CMI/config.yml 把 Economy.Enabled 设为 true 并完整重启。
• 插件会在启动后延迟重试（2s/5s/10s）；若仍未挂载，日志会输出 [经济诊断] 帮助定位。

• BeaconWaypoints.create.public 默认不授予，需要手动给权限。

• 该信标绑定了传送点，请先用 /wt remove <名称> 删除传送点，或用拥有 beacon.break.bypass 的账号拆除。

• /wt tp 仅限 OP；普通玩家请使用「移动地标指南针」右键传送（需 getcompass 权限，默认 OP）。

• 每个公共地标独立：创建者进入该地标的【传送收费管理】面板，在聊天栏输入费用（0 = 免费）。私有地标不收费。

• 不会。传送点数据永久保留，拆信标只是让它暂时不可用；放回信标即可恢复，删除只能通过指令。

十二、致谢​

注意：信标传送要求信标上方没有方块（包括玻璃等透明方块），因此在下界无法使用，但是移动指南针是可以的。

点击展开...