wParkour

插件

· 作者 ywxlol

无尽程序化跑酷,包含动态跳跃、装饰性方块和奖励存储。

0 本站下载 0 关注 更新于 2 个月前

最新 1.1 · 26.2 · Bukkit / Paper

一键开服(送7天)

? wParkour

面向现代 Minecraft 服务器的下一代无限程序化跑酷插件。


? 概述

wParkour 是一款轻量级且功能丰富的程序化跑酷插件,专为高性能的 Paper 和 Purpur 1.21+ 服务器从头构建。

与传统静态跑酷插件中所有跳跃路径均为预设不同,wParkour 会在你自定义定义的竞技场区域内实时动态生成无限、智能的跳跃序列。玩家永远不会在同一条路线上跳跃两次!


✨ 特性

  • ? 动态程序化生成:在玩家前方动态生成无限、无重复的跳跃路径。生成器会智能地避开墙壁、角落以及其他活跃玩家。
  • ? 可调节难度:支持 EASY(简单)、NORMAL(普通)和 HARD(困难)模式,并提供符合物理规律的间距和高度计算。
  • ? 防漏洞奖励存储 (/parkour storage):
    • 如果玩家在掉落时背包已满,获得的物品及给予物品的命令将自动路由至其个人 储物 GUI。
    • 数据包防护与反 UIUtils 利用:通过严格的服务器端光标清理、同步行删除验证以及点击类型过滤来加固,防止窗口不同步和复制漏洞。
    • 可配置的过期时间:储物中的物品会在设定时间后自动过期(默认:24小时),GUI 中会显示实时倒计时文本。
  • ? 统一的里程碑奖池:
    • 通过直观的拖拽式 GUI 或命令奖励(例如 /eco give %player% 100)添加物品奖励。
    • 可配置中奖概率 (%) 和里程碑间隔(例如每 10 或 50 次跳跃)。
    • 整合滚动机制确保每个里程碑严格只发放一次奖励——杜绝不公平的双重奖励!
  • ? 个人装饰方块:
    • 玩家在跑酷时会获得一个交互式方块选择器的箱子物品,用于自定义自己生成的方块的视觉效果。
  • ? 互动排行榜全息图:
    • 在激活压力板上方自动生成的悬浮 TextDisplay 全息图,展示该竞技场的顶级跑酷者。
    • 区块安全,并在服务器重启和区块卸载后自动恢复。
  • ? 健壮的 SQLite 引擎:
    • 使用 WAL(预写日志) 模式下的高性能 SQLite,并具备繁忙超时处理机制。
    • 包含崩溃和重启后的库存恢复功能(saved_inventories)。
  • ⚡ 零闪烁碰撞箱检测:
    • 使用精确的轴对齐包围盒 (AABB) 边缘检测——玩家无需精准落在方块正中心,跳跃即可被正确注册。

? 玩家指令

指令 权限 描述
/parkour storage 无 打开你的个人未领取奖励储物 GUI。
/wparkour start <arena> wparkour.play 在指定竞技场开始跑酷。
/wparkour list wparkour.play 列出所有可用的跑酷竞技场。
/wparkour leave wparkour.play 离开当前跑酷进程并恢复你的背包。

?️ 管理员指令

指令 权限 描述
/wparkour pos1 wparkour.admin 设置新竞技场的第一个角点。
/wparkour pos2 wparkour.admin 设置新竞技场的第二个角点。
/wparkour create <name> wparkour.admin 在选定区域内创建新竞技场。
/wparkour item <name> wparkour.admin 获取用于该竞技场的激活压力板。
/wparkour setspawn <name> wparkour.admin 设置竞技场的重生/传送位置。
/wparkour difficulty <name> <easy|normal|hard> wparkour.admin 更改跳跃生成的难度。
/wparkour config <name> reward-interval <number> wparkour.admin 设置默认奖励频率(例如每 10 次跳跃)。
/wparkour rewards [name] wparkour.admin 打开 GUI 以配置物品、概率和命令。
/wparkour start <name> [player] wparkour.admin 强制你自己或其他玩家开始跑酷。
/wparkour resetstats <player | *> wparkour.admin 清除特定玩家或所有玩家 (*) 的最高分记录。
/wparkour delete <name> wparkour.admin 删除竞技场并清理其数据。
/wparkour reload wparkour.admin 重新加载 config.yml、messages.yml 和奖励配置,无需重启服务器。

? 权限

权限 默认值 描述
wparkour.play true 允许玩家使用跑酷竞技场并开始跑步。
wparkour.admin op 授予访问所有管理员设置和管理指令的权限。
wparkour.toplist.bypass false 拥有此权限的玩家不会出现在排行榜全息图中。

? 快速设置指南

  1. 选择跑酷竞技场边界:
    • 站在角落 1 处,输入 /wparkour pos1。
    • 站在角落 2 处,输入 /wparkour pos2。
  2. 创建竞技场:
    • 输入 /wparkour create MyArena。
  3. 设置返回重生点:
    • 站在玩家掉落或离开时应生成的位置,输入 /wparkour setspawn MyArena。
  4. 放置起始压力板:
    • 输入 /wparkour item MyArena 以获取触发器压力板。
    • 将其放置在任意固体方块上(其上方会自动出现一个 Toplist 全息图!)。
  5. 配置奖励:
    • 输入 /wparkour rewards MyArena。
    • 从自己的物品栏中点击物品放入 GUI,以添加物品奖励。
    • 使用命令块按钮添加命令奖励(例如 eco give %player% 50)。
    • 对任意物品或命令按住 Shift + 右键,可切换该奖励是否在玩家背包已满时路由至 /parkour storage。

⚙️ 配置文件 (config.yml)

# 游戏设置
gameplay:
  fall-y-threshold: 2.2      # 低于最低激活方块的方块数,触发掉落判定
  chest-slot: 4              # 用于装饰性方块选择器的箱子背包槽位

# 奖励存储 (/parkour storage)
storage:
  # 未领取的奖励在仓库中保留的小时数(默认:24小时,0 = 永不过期)
  expiration-hours: 24

# Toplist 设置
toplista:
  # 用于将工作人员/管理员排除在全息图之外的权限节点
  bypass-permission: "wparkour.toplist.bypass"
  # 最高分刷新间隔(秒)
  frissitesi-ido: 300

? 占位符

在命令奖励中,可以使用以下动态占位符:

  • %player% 或 <player> - 玩家名称
  • %player_uuid% - 玩家的 UUID
  • %score% - 触发奖励时达到的跳跃分数

? 兼容性与要求

  • 服务端软件:兼容 Paper、Purpur 或 Folia 的分支(1.21.x+)
  • Java:Java 21 或更高版本
  • 依赖项:无!(SQLite 数据库已内置并自动配置)
  • 软依赖:PlaceholderAPI(可选)

? 支持与社区

需要帮助配置 wParkour、有问题想咨询,或希望建议新功能?加入我们的官方 Discord 社区!


由 ywxlol ❤️ 制作 • Discord: dc.coolnw.eu

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源