Waystones - 远程传送

Waystones 是一款为 Minecraft 服务器设计的传送插件，它通过游戏内物品与方块交互实现传送，无需依赖指令，非常适合生存模式世界，避免了指令传送可能带来的失衡体验。

💡核心玩法

玩家可以通过放置磁石并与之绑定来创建传送点。绑定后，使用对应的传送钥匙右键点击即可启动传送，前往绑定的磁石位置。

主要特性

• 单次使用钥匙：启用后，传送钥匙在使用后会被消耗。
• 距离强化：启用距离限制后，可以在磁石周围放置特定方块来增加其最大传送距离。
• 传送抑制：在磁石下方放置黑曜石可以阻止其被用作传送点。
• 管理员超频：在磁石下方放置命令方块可以移除该传送点的距离限制和能量需求。
• 能量需求：启用能量需求后，需要在磁石下方放置充能的重生锚才能进行传送。
• 跨维度衰减：可以为跨维度传送设置一个距离衰减比率。
• 自定义命名：可以使用命名牌为传送点命名。
• 传送病：启用后，玩家传送时有几率获得负面状态效果。
• 自定义合成：可以启用传送钥匙的合成配方。

✨距离强化系统

启用 limit-distance 后，可以通过在磁石周围放置特定方块来提升其传送范围。支持的方块及其提供的强化比例如下：

• 下界合金块：提供最大强化值
• 绿宝石块：提供 75% 的强化值
• 钻石块：提供 50% 的强化值
• 金块：提供 33% 的强化值
• 铁块：提供 20% 的强化值

传送点的最终距离 = base-distance + (周围强化方块提供的总强化值)。强化值受 max-boost（每方块最大强化值）和 max-warp-size（最大有效方块数）配置项限制。

✨能量与跨维度传送

能量需求

当 require-power 启用时，传送需要能量。将充能的重生锚放置在磁石下方即可为其供能。

• 能量模式可设置为 INTER_DIMENSION（仅跨维度需要）、ALL（所有传送都需要）或 NONE（禁用）。
• 传送会消耗能量，消耗量由 power-cost 定义。
• 可设置为传送后自动为重生锚重新充能。
• 只要重生锚保持充能状态，传送点即可正常工作。

跨维度传送

• 启用 jump-worlds 以允许跨维度传送。
• 跨维度传送时，最大传送距离会除以 world-ratio 配置的值，导致有效距离缩短。

✨传送病效果

启用 enable-portal-sickness 后，玩家传送时有几率感染“传送病”。

• 效果：获得 30 秒的反胃 X 和 5 秒的失明效果。
• 触发几率：由 portal-sickness-chance 控制。
• 对传送的影响：由 portal-sickness-warping 控制：

- `PREVENT_TELEPORT`：生病时禁止传送。

- `DAMAGE_ON_TELEPORT`：生病时允许传送，但会承受 `portal-sickness-damage` 设定的伤害值。

- `ALLOW`：生病不影响传送。

🎮配置选项

基础设置

• locale [默认: en]：使用的本地化语言文件（格式为 lang-语言代码.yml），同时影响数字和日期的格式化。
• wait-time [默认: 60]：传送前的等待时间（单位：游戏刻），移动会取消传送。
• damage-stops-warping [默认: true]：受到伤害是否打断传送。

距离与范围

• limit-distance [默认: true]：是否限制传送点的最大距离。
• base-distance [默认: 100]：传送点的基础传送距离（单位：格）。
• max-boost [默认: 150]：每个强化方块能提供的最大强化值。
• max-warp-size [默认: 50]：一个传送点最多能计算多少个强化方块。

维度与能量

• jump-worlds [默认: true]：是否允许跨维度传送。
• world-ratio [默认: 8]：跨维度传送时，最大距离除以的比率。
• require-power [默认: INTER_DIMENSION]：传送是否需要能量。可选 INTER_DIMENSION, ALL, NONE。
• power-cost [默认: 1]：每次传送消耗的能量值（当能量需求启用时）。

物品与效果

• single-use [默认: false]：传送钥匙是否单次使用。
• enable-portal-sickness [默认: true]：是否启用传送病。
• relinkable-keys [默认: true]：传送钥匙是否可以重新绑定到其他传送点。
• enable-key-items [默认: true]：是否使用自定义物品作为传送钥匙。启用后将使用自定义合成配方，且普通指南针不能用作传送钥匙。
• key-recipe [默认: 见下方]：自定义传送钥匙的合成配方（仅在 enable-key-items 为 true 时生效）。
• enable-advancements [默认: true]：是否启用进度系统。

🔧合成配方

传送钥匙的默认合成配方如下（仅当配置中 enable-key-items 设置为 true 时生效）：

[ 空 ] [ 铁锭 ] [ 空 ]
[ 铁锭 ] [ 指南针 ] [ 铁锭 ]
[ 空 ] [ 铁锭 ] [ 空 ]

未来更新中，此配方可能支持通过配置文件自定义。

⭐指令与权限

可用指令

• /waystones：显示插件信息。
• /waystones getkey [数量 | 玩家名 [数量]]：给予玩家传送钥匙。
• /waystones ratio [ set <值> [名称] [-environment] | remove [名称] [-environment] | list ]：管理传送比率。
• /waystones config [属性] [新值]：查看或修改插件配置。
• /waystones info：显示插件及其贡献者信息。
• /waystones reload [config | advancements]：重载插件配置或进度数据。

权限节点

• waystones.link：允许玩家将传送钥匙绑定到磁石。
• waystones.getkey.self：允许使用 /waystones getkey 给自己钥匙。
• waystones.getkey.all：允许使用 /waystones getkey 给任何玩家钥匙。
• waystones.config：允许查看和修改插件配置。
• waystones.reload：允许重载插件配置。
• waystones.ratios：允许使用 /waystones ratio 指令管理传送比率。

✨进度系统 (v1.1.0+)

插件内置了以下进度供玩家挑战

• Waystones：将传送钥匙绑定到一个磁石。
• Secret Tunnel：首次使用一个传送点。
• 1.21 Gigawarps：使用传送点旅行超过最大传送距离的 50%。
• I Don't Feel So Good：因使用传送点而感染传送病。
• Heavy Artillery：使用下界合金块强化一个传送点。
• Unlimited Power：过度充能导致传送点的能量源爆炸。
• Quantum Domestication：给一个传送点命名。
• Blocked：用黑曜石抑制一个传送点以防止他人使用。
• Shoot The Messenger：在试图传送逃离时险些被骷髅射杀。
• Clean Energy：使用一个与信标共享能量源的传送点。