? 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 处,输入
/wparkour pos1。
- 站在角落 2 处,输入
/wparkour pos2。
- 创建竞技场:
- 输入
/wparkour create MyArena。
- 设置返回重生点:
- 站在玩家掉落或离开时应生成的位置,输入
/wparkour setspawn MyArena。
- 放置起始压力板:
- 输入
/wparkour item MyArena 以获取触发器压力板。
- 将其放置在任意固体方块上(其上方会自动出现一个 Toplist 全息图!)。
- 配置奖励:
- 输入
/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 社区!
? wParkour
The next-generation endless procedural parkour plugin for modern Minecraft servers.
? Overview
wParkour is a lightweight, feature-packed procedural parkour plugin built from the ground up for high-performance Paper and Purpur 1.21+ servers.
Unlike traditional static parkour plugins where every jump is pre-built, wParkour generates infinite, intelligent jump sequences dynamically in real-time inside your custom-defined arena regions. Players never jump on the same route twice!
✨ Features
- ? Dynamic Procedural Generation: Infinite, non-repetitive jumps generated dynamically ahead of the player. The generator intelligently avoids walls, corners, and other active players.
- ? Adjustable Difficulties: Support for
EASY, NORMAL, and HARD modes with physics-accurate gap and height calculations.
- ? Exploit-Proof Reward Storage (
/parkour storage):
- If a player's inventory is full when they fall, earned items and item-giving commands are automatically routed into their personal Storage GUI.
- Packet-Proof & Anti-UiUtils: Hardened with strict server-side cursor sanitization, synchronous row deletion verification, and click-type filtering to prevent window desyncs and dupe exploits.
- Configurable Expiration: Storage items automatically expire after a set time (default: 24h) with real-time countdown lore in the GUI.
- ? Unified Milestone Loot Pool:
- Add item rewards via an intuitive drag-and-drop GUI or command rewards (e.g.
/eco give %player% 100).
- Configurable win chances (%) and milestone intervals (e.g. every 10 or 50 jumps).
- Consolidated rolling ensures strictly one reward per milestone—no unfair double rewards!
- ? Personal Cosmetic Blocks:
- Players receive an interactive block selector chest item while parkouring to customize the look of their own generated blocks.
- ? Interactive Toplist Holograms:
- Automatically spawned floating
TextDisplay holograms above activator pressure plates showcasing the arena's top parkour runners.
- Chunk-safe and auto-recovering across server restarts and unloads.
- ? Robust SQLite Engine:
- Uses high-performance SQLite in WAL (Write-Ahead Logging) mode with busy timeout handling.
- Includes crash and restart inventory recovery (
saved_inventories).
- ⚡ Zero-Flicker Hitbox Detection:
- Uses accurate Axis-Aligned Bounding Box (AABB) edge detection—players don't need to land dead-center on blocks for jumps to register.
? Player Commands
| Command |
Permission |
Description |
/parkour storage |
None |
Opens your personal unclaimed rewards storage GUI. |
/wparkour start <arena> |
wparkour.play |
Starts parkour in the specified arena. |
/wparkour list |
wparkour.play |
Lists all available parkour arenas. |
/wparkour leave |
wparkour.play |
Leaves your current parkour run and restores your inventory. |
?️ Admin Commands
| Command |
Permission |
Description |
/wparkour pos1 |
wparkour.admin |
Sets the first corner point for a new arena. |
/wparkour pos2 |
wparkour.admin |
Sets the second corner point for a new arena. |
/wparkour create <name> |
wparkour.admin |
Creates a new arena within the selected region. |
/wparkour item <name> |
wparkour.admin |
Gives you an activator pressure plate for the arena. |
/wparkour setspawn <name> |
wparkour.admin |
Sets the respawn/teleport location for the arena. |
/wparkour difficulty <name> <easy|normal|hard> |
wparkour.admin |
Changes the jump generation difficulty. |
/wparkour config <name> reward-interval <number> |
wparkour.admin |
Sets the default reward frequency (e.g. every 10 jumps). |
/wparkour rewards [name] |
wparkour.admin |
Opens the GUI to configure items, chances, and commands. |
/wparkour start <name> [player] |
wparkour.admin |
Forces a parkour start for yourself or another player. |
/wparkour resetstats <player | *> |
wparkour.admin |
Clears high scores for a specific player or everyone (*). |
/wparkour delete <name> |
wparkour.admin |
Deletes an arena and cleans up its data. |
/wparkour reload |
wparkour.admin |
Reloads config.yml, messages.yml, and rewards without restarting. |
? Permissions
| Permission |
Default |
Description |
wparkour.play |
true |
Allows players to use parkour arenas and start runs. |
wparkour.admin |
op |
Grants access to all admin setup and management commands. |
wparkour.toplist.bypass |
false |
Players with this permission will not appear on toplist holograms. |
? Quick Setup Guide
- Select Arena Boundaries:
- Stand at corner 1 and type
/wparkour pos1.
- Stand at corner 2 and type
/wparkour pos2.
- Create Arena:
- Type
/wparkour create MyArena.
- Set Return Spawn:
- Stand where players should spawn when falling or leaving and type
/wparkour setspawn MyArena.
- Place Start Pressure Plate:
- Type
/wparkour item MyArena to get the activator pressure plate.
- Place it on any solid block (a toplist hologram will automatically appear above it!).
- Configure Rewards:
- Type
/wparkour rewards MyArena.
- Click items from your own inventory into the GUI to add item rewards.
- Use the command block button to add command rewards (e.g.
eco give %player% 50).
- Use Shift + Right Click on any item or command to toggle whether it should route to
/parkour storage if a player's inventory is full.
⚙️ Configuration (config.yml)
# Gameplay settings
gameplay:
fall-y-threshold: 2.2 # Blocks below lowest active block before trigger fall
chest-slot: 4 # Inventory slot for the cosmetic block selector chest
# Reward Storage (/parkour storage)
storage:
# How long unclaimed rewards are stored in hours (default: 24h, 0 = never expires)
expiration-hours: 24
# Toplist settings
toplista:
# Permission to exclude staff/admins from holograms
bypass-permission: "wparkour.toplist.bypass"
# Refresh interval in seconds for top scores
frissitesi-ido: 300
? Placeholders
In command rewards, you can use the following dynamic placeholders:
%player% or <player> - The player's name
%player_uuid% - The player's UUID
%score% - The jump score reached when the reward was triggered
? Compatibility & Requirements
- Server Software: Paper, Purpur, or Folia compatible fork (1.21.x+)
- Java: Java 21 or newer
- Dependencies: None! (SQLite database is embedded and auto-configured)
- Soft Dependencies: PlaceholderAPI (optional)
? Support & Community
Need help configuring wParkour, have questions, or want to suggest new features? Join our official community Discord!
评论 0
登录后参与评分
还没有评论,来抢沙发吧