[ABANDONED] Flyblock [Highly Configurable] - Flyblock - 飞行方块

Flyblock 是一款让服务器主可以在生存模式服务器中，为玩家提供有限飞行能力的插件。它通过在游戏中放置“飞行方块”来购买飞行权限，在保留生存玩法核心的同时，为玩家增添便利与乐趣。

💡核心机制

Flyblock 允许你配置最多 28 个等级的飞行方块供玩家购买。每个等级都可以独立设置价格、作用范围和持续时间。玩家放置飞行方块后，即可在特定范围内飞行一段时间。方块可以被玩家挖掘回收。

工作原理

• 玩家购买或获得飞行方块物品。
• 放置方块后，放置者（及添加的用户）在方块的作用范围内获得飞行能力。
• 飞行时间开始倒计时，玩家可以随时破坏方块以回收，计时会暂停。
• 当持续时间耗尽，方块会自动销毁，相关玩家的飞行能力也随之移除（即使玩家离线）。

✨主要特性

• 可自定义等级：最多配置 28 个等级，每个等级可独立设置范围、持续时间和价格。
• 灵活的购买方式：支持游戏币（需 Vault）或指定物品购买。
• 共享飞行：每个飞行方块最多可添加 14 名其他用户共同使用。
• 网络化放置：只要负担得起，可以放置无限数量的飞行方块来构建飞行网络。
• 状态查看：右键点击任意飞行方块可查看其详细信息。
• 可回收复用：方块被破坏后可拾取，剩余持续时间会保留。
• 高度自定义：可自定义 GUI 名称、使用的方块、提示信息等。
• 配置验证：全面的配置文件验证。
• 自动更新检查。
• 兼容性：理论上兼容任何领地插件，如 WorldGuard、Residence 等。
• 数据接口：支持 PlaceholderAPI 获取数据。
• 防摔伤范围：可配置“无摔落伤害范围”，防止玩家在离开作用范围时摔伤。
• 数据持久化：可正确处理服务器重载和重启。
• 所有权转移：飞行方块可通过丢弃（若启用）或直接转移所有权的方式在玩家间转让。

🎮指令

/flyblock [指令类型] <可选参数>

• /flyblock 或 /flyblock shop：打开飞行方块商店。
• /flyblock give <玩家> <等级>：给予指定玩家一个特定等级的飞行方块。
• /flyblock clear <玩家>：清除指定玩家的所有飞行方块（使用 -1 或 all 清除所有玩家的）。
• /flyblock locations：显示玩家自身所有飞行方块的坐标。
• /flyblock reload：重载插件配置。
• /flyblock pause：暂停所有飞行方块的放置和使用。
• /flyblock resume：恢复所有飞行方块的放置和使用。
• /flyblock add <玩家>：将指定玩家添加到离你最近的飞行方块中。

🔧权限

• flyblock.shop：允许使用 /flyblock 打开商店。
• flyblock.buy<等级数字>：允许购买指定等级的飞行方块（例如 flyblock.buy1）。
• flyblock.place<等级数字>：允许放置指定等级的飞行方块。
• flyblock.add<用户数量>：允许用户向自己的飞行方块添加指定数量的其他玩家（仅在配置中 addPermissionRequired 为 true 时需此权限）。
• flyblock.breakOthersBlocks：允许破坏他人的飞行方块。
• flyblock.placeAll：允许放置所有可用等级的飞行方块。
• flyblock.buyAll：允许购买所有可用等级的飞行方块。
• flyblock.noPay：绕过支付，免费获得飞行方块。
• flyblock.all：拥有所有权限。
• flyblock.clear：允许使用 /flyblock clear 指令。
• flyblock.give：允许使用 /flyblock give 指令。
• flyblock.reload：允许使用 /flyblock reload 指令。
• flyblock.pause：允许使用 /flyblock pause 和 /flyblock resume 指令。

❓PlaceholderAPI 占位符

如果安装了 PlaceholderAPI，可以使用以下占位符获取 Flyblock 数据：

• %flyblock_display%：显示服务器上飞行方块的总数。若无则返回 0。
• %flyblock_all%：显示玩家所有飞行方块的基本信息。
• 格式：x, y, z, 世界名, 剩余时间(分钟), 作用范围\n
• 可能包含多行。
• %flyblock_locations%：显示玩家所有飞行方块的位置。
• 格式：x, y, z, 世界名\n
• 可能包含多行。

⭐配置与依赖

要求与依赖

• 必需：Vault（仅当使用游戏币商店时需要）。/flyblock give 指令及其他功能无需 Vault 也可运行。
• 本插件使用 bStats 收集匿名统计信息。

重要配置项摘要

• amountOfLevelsToSell：出售的飞行方块等级数量（最大 28）。
• flyblockRanges / flyblockDurations / flyblockPrices：每个等级的作用范围、持续时间（分钟，-1 为无限）和价格。
• flyblockPurchaseUnit：购买单位，设为 "MONEY" 使用游戏币，或设为有效的材料名（如 "DIAMOND"）使用物品购买。
• bannedWorlds：禁止放置飞行方块的世界列表。
• transferOwnershipOnDrop：丢弃后被拾取的飞行方块，所有权是否转移给拾取者。
• noFallDamageRange：无摔落伤害的额外范围（最大 200）。

🔧常见问题与故障排除

Q：遇到错误或问题怎么办？

• 最佳方法是关闭服务器，进入 plugins/flyblock 目录，删除 fbdate.yml 和 flyblocks.yml 文件，然后重启服务器（这将移除所有已放置的飞行方块）。

Q：执行 /flyblock 指令时出现“内部错误…”？

• 自 2.13 版本起，插件引入了更严格的配置验证。请确保你的配置文件设置正确，并参照插件页的最新默认配置进行更新。验证失败会导致插件被禁用。

Q：为什么购买飞行方块不扣钱？

• 可能原因：
• 你拥有 flyblock.all 或 flyblock.noPay 权限。
• 请检查经济插件（Vault）是否正常设置。

Q：飞行方块的作用区域是方形、圆形还是球形？

• 取决于配置中 includeHeightInRadius 的设置。若启用高度限制，区域为立方体；若禁用，则为平面正方形。范围值表示向每个方向延伸的距离。

Q：使用 Paper 1.18.1，但版本号较低（低于 219）？

• 请将 Paper 更新至 1.18.1 的最新版本。

Q：其他问题？

• 可以尝试完全移除插件并重新安装（警告：会删除所有现有飞行方块）：
• 关闭服务器。
• 进入 plugins/ 目录，删除 flyblock 文件夹。
• 重新启动服务器。

如果以上方法均无效，请通过 Discord 联系作者（Erikv#4924 或加入支持服务器）。请在留下差评前联系作者，大多数问题都可以快速解决。

**支持与反馈**

• 如果你喜欢这个插件，一个评分将是对作者极大的鼓励。
• 问题或建议请联系 Spigot 页面或 Discord：https://discord.gg/PwE5ZXZshh