Wilderness-Tp - 荒野传送

WildernessTp 是一款轻量级插件，允许玩家通过指令 /wild 随机传送到世界中的某个位置。它专注于提供核心的随机传送功能，并包含基础的自定义选项，避免不必要的复杂功能。

💡核心特性

• 随机传送：执行 /wild 后，玩家将被传送到一个随机的安全位置。
• 安全保护：传送后提供 10 秒的抗性效果，让玩家有时间应对周围的怪物。
• 安全生成点：自动避免将玩家传送到水体或熔岩上方。
• 基础扩展：支持告示牌、冷却时间、使用成本与音效。
• 多世界支持：可配置从特定世界传送到另一个目标世界。
• 领地保护兼容：支持与 Towny、Factions、WorldGuard、GriefPrevention 等领地插件联动。

🎮指令与权限

主要指令

• /wild - 玩家将自己随机传送。
• /wild <玩家名> - 管理员将指定玩家随机传送。
• /wildtp 或 /wtp - 显示帮助信息。
• /wildtp create - 创建传送门。
• /wildtp destroy - 销毁传送门。
• /wildtp wand - 获取设置区域的选择工具。
• /wildtp setup - 打开插件设置助手。
• /wildtp reload - 重载插件配置（需要权限）。

主要权限

• wildernesstp.command.wild - 允许使用 /wild 指令。
• wildernesstp.limit.<数值> - 设置玩家的使用次数限制（对应配置）。
• wildernesstp.bypass.limit - 绕过次数限制。
• wildernesstp.bypass.cooldown - 绕过冷却时间。
• wildernesstp.bypass.cost - 绕过使用成本。
• wildernesstp.bypass.delay - 移除使用指令前的延迟等待。
• wildernesstp.sign.use - 允许使用告示牌传送。
• wildernesstp.sign.create - 允许创建/删除告示牌。
• wildernesstp.command.create - 允许创建传送门。
• wildernesstp.command.destroy - 允许销毁传送门。
• wildernesstp.command.setup - 允许使用 /wtp setup 指令。
• wildernesstp.command.reload - 允许重载插件。

🔧告示牌与变量

告示牌格式

第一行填写：[WTP]

消息变量

在配置消息时，可使用以下变量

• {cost} - 显示本次传送的成本。
• {rem} - 显示剩余冷却时间。
• {cool} - 显示完整的冷却时间。
• {wait} - 显示预热等待消息。

✨配置说明

以下是配置文件 (config.yml) 的关键部分解析：

# 语言设置，可在 lang 文件夹内添加对应的 yml 文件来支持其他语言
language: english

# 禁止传送的生物群系列表
blacklisted-biomes: [ 'OCEAN' ]

# 是否启用与领地插件的挂钩（如 Towny、Factions）
use_hooks: false

# 检查领地时与传送点的距离
distance: 20

# 每次使用指令的成本（经济）
cost: 150

# 寻找有效传送位置的最大重试次数
retry_limit: 10

# 使用指令前的等待时间（秒），期间玩家不能移动
delay: 5

# 是否允许新手（首次加入的玩家）使用传送
TeleportNewbies: false

# 指令冷却时间（秒）
cooldown: 300

# 世界区域配置
regions:
  # 示例：从世界 "a" 传送到世界 "b"
  a:
    worldTo: 'b'
  # 普通世界的配置示例
  world:
    minX: -100
    maxX: 100
    minZ: -100
    maxZ: 100
    worldTo: "" # 留空则在本世界内传送

添加新世界的方法

• 手动编辑配置：在 regions: 部分复制现有格式并修改对应参数。
• 使用指令：运行 /wtp setup 根据引导进行设置。

❓依赖与支持

必需依赖

• Vault - 用于经济系统功能。

获取支持

• 请在讨论区、GitHub Issues 或 Discord 服务器中寻求帮助，不要在评论区请求技术支持。
• 开发构建与源代码：https://github.com/Qballl/WildernessTp
• 欢迎提交 Pull Request 来帮助改进插件。

⭐注意事项与致谢

• 请勿修改配置中的 config-version 和 migrated 值。
• 感谢所有贡献者和翻译者。
• 特别感谢 @SteveDog79 提供的项目 Logo 艺术作品。

> 最后更新与说明：插件已实现原计划的冷却时间、使用成本、下界支持及传送门功能。音效功能可能根据需求重新添加。欢迎在讨论区提出功能建议。