BeaconWaypoints - 灯塔传送点

💡信标传送点

信标传送点（Beacon Waypoints）为信标增添了全新的功能，允许玩家在已设置的信标之间快速传送。安装本插件只需将 JAR 文件放入服务器的 plugins 文件夹并重启服务器即可。支持 Minecraft 1.14 至 1.20.4 版本。本插件使用 bStats 收集匿名使用数据。

🎮功能特性

• 在信标处创建公共或私人传送点。
• 可配置的传送点图标选择器。
• 探索模式：玩家需与信标互动来“发现”公共传送点，之后才能传送到已发现的传送点。
• 多种传送支付选项（经验、游戏货币、物品）。
• 提供 language.yml 文件，支持自定义翻译。

🔧命令与权限

命令

• /waypoint <名称> <public | private> - 在玩家所站的信标上创建一个公共或私人传送点。
• /waypoints reload - 重载插件配置文件。

权限

• BeaconWaypoints.createWaypoints - 允许玩家创建传送点。
• BeaconWaypoints.useWaypoints - 允许玩家使用传送点。
• BeaconWaypoints.usePrivateWaypoints - 允许玩家创建并传送到私人传送点。
• BeaconWaypoints.breakWaypointBeacons - 允许玩家破坏已设置传送点的信标。
• BeaconWaypoints.manageAllWaypoints - 允许玩家编辑、置顶或移除所有公共传送点及其对应的信标。
• BeaconWaypoints.reload - 允许玩家重载配置文件。

⭐配置说明

配置文件 config.yml 允许你深度自定义插件行为。以下是一些关键配置项：

基础设置

• max-public-waypoints - 服务器上允许同时存在的最大公共传送点数量（默认：100）。
• max-private-waypoints - 每个玩家允许拥有的最大私人传送点数量（默认：30）。
• force-alphanumeric-names - 创建传送点时强制名称只能为字母数字（默认：false）。
• discovery-mode - 启用探索模式（默认：false）。
• allow-all-worlds - 允许在任何世界创建传送点（默认：true）。
• allowed-worlds - 当 allow-all-worlds 为 false 时，允许创建传送点的世界列表（基于文件夹名称）。

传送体验

• instant-teleport - 选择目的地后立即传送，无准备动画（默认：false）。
• disable-animations - 禁用传送时的粒子动画（默认：false）。
• launch-player - 传送时将玩家发射到空中（默认：true）。
• launch-player-height - 玩家传送前被发射到的 Y 轴高度。可调整以适应反作弊插件限制（默认：576）。
• disable-group-teleporting - 设为 true 时，仅限选择目的地的玩家传送，而非信标上的所有玩家（默认：false）。

支付与经济

• payment-mode - 支付模式：none、xp 或 money（默认：none）。
• xp-cost-per-chunk - XP 模式下，每区块距离的传送费用（默认：0）。
• money-cost-per-chunk - 金钱模式下，每区块距离的传送费用（默认：0）。
• cost-multiplier - 基于距离的费用乘数。公式为：费用 * (距离 ^ 乘数)（默认：0）。
• required-items - 传送所需的特定物品列表（可设置名称、数量、是否消耗等）。
• banned-items - 玩家物品栏中若存在这些物品，则禁止传送。

界面与图标

• public-waypoint-menu-rows - 公共传送点选择菜单每页显示的行数（范围：1-5，默认：3）。
• private-waypoint-menu-rows - 私人传送点选择菜单每页显示的行数（范围：1-5，默认：2）。
• waypoint-icons - 可用于传送点图标的物品列表，顺序即为图标选择器中的显示顺序（默认包含 111 种物品）。

❓使用须知与提示

传送条件

• 传送要求目标信标的光束畅通无阻，包括玻璃在内的透明方块也会阻挡光束。基岩除外，因此本插件在下界可以正常工作。
• 如果使用 WorldEdit 删除信标，关联的传送点不会被自动删除。你需要手动放回信标并破坏它，或者使用 setblock 和 fill 命令来代替。

所有权与破坏

• 信标的所有者是放置它的玩家。
• 配置项 allow-beacon-break-by-owner 为 true 时，即使玩家没有 BeaconWaypoints.breakWaypointBeacons 权限，只要信标上的所有传送点都属于该玩家，他仍可破坏此信标（默认：true）。

私人传送点共享（v1.7+）

• 新增命令 /waypoint share <玩家名>，用于将你的私人传送点共享给其他玩家。
• 被共享的传送点会出现在对方玩家的私人传送点列表中。
• 可以在传送点选项菜单中移除玩家的访问权限。

✨链接与支持

• 问题追踪：请在此报告 Bug。
• Discord 联系：ti.mirro
• 插件包含更新检查器，新版本可用时会在控制台和管理员处通知。