ParkourBattle
ParkourBattle 为 Paper 1.21 将跑酷转化为一种竞争性的 1v1(以及由管理员控制)战斗模式。两名玩家不仅使用武器进行对抗,还通过移动和方块放置进行博弈:每一次跳跃都至关重要。落地失误——你会受到伤害。利用方块控制空间,迫使对手处于别扭的角度,并惩罚犹豫不决的行为。
这不是一个通用的小游戏中心克隆版。它是一个专注的跑酷决斗引擎,具备严格的失误判定逻辑、可选的即时战斗、套装、竞技场、箱子交互以及完整的管理员/调试层。
核心理念
玩家在建造和跳跃的同时进行战斗。服务器会追踪你放置的战斗方块。如果你落在非战斗部分(且未标记为安全区域)的方块上,将被计为一次失误。失误会造成伤害——支持可配置的伤害值、动作栏反馈,以及可选的严格半径判定,确保“几乎踩到方块边缘”仍被视为失败。
这一单一规则创造了真实的紧张感:你不能无限地随意堆砌脚手架;每一个方块的放置都是一种承诺。
功能特性
决斗与流程
- 支持玩家之间发起/接受风格化的战斗挑战
- 可查询的战斗阶段(准备 → 战斗 → 结束)
- 投降和重赛路径(包括在支持的版本中,即使回合已结束也可触发重赛)
- 离开 / 全部离开工具,供管理员在匹配卡顿时使用
- 支持观战者及观战者列表
- 可选的即时战斗(无需竞技场),带有短距离邀请窗口——适用于活动和自发性战斗
- HP 和 phase 命令,方便工作人员和玩家快速查看比赛状态
失误系统(插件的核心)
- 在战斗期间落在非战斗方块上 = 失误
- 可配置的方块周围严格半径(防止“边缘滥用”)
- 安全标记 (Safe-stick):标记那些永远不应被计为失误的方块(练习路线、活动路线、管理员测试)
- 防抖动的安全标记切换,确保一次点击不会连续触发 10 次切换
- 成功标记或失误原因的动作栏反馈(基于 Adventure API,并提供旧版回退方案)
- 可选的调试失误日志(控制台 + 轮转文件),用于规则调整
- 管理员测试标记功能,可在非实时战斗中运行(创意模式测试),带有脉冲粒子效果并可传送至标记点
方块、箱子与修饰符
- 允许在决斗几何结构中放置方块
- 箱子对箱子跳跃可以窃取对手的库存(可配置攻击者/受害者消息)
- 区分站在箱子上 vs 跳上箱子的逻辑(修饰符钩子)
- 提供大量战斗修饰符,满足想要排名规则与休闲乐趣规则的服务器需求
套装与竞技场
- 从配置的套装物品应用套装
- 从 kits 文件夹列出套装
- 竞技场注册表:显示空闲/忙碌状态
- 面向工作人员的比赛信息命令
- 启用时显示队列大小
用户体验与反馈
- 动作栏 HUD 行:显示已放置方块数、安全键、失误原因
- 安全标记上的可选粒子效果(脉冲)
- 触发箱子窃取时的清晰消息
- 面向观战者和工作人员的友好状态命令
管理与完整性
/pkbattle doctor 及 --brief 摘要(活跃战斗、上一位对手地图大小、配置标志)
- 上一位对手追踪:查看、清除、全部清除、大小/计数、在线过滤
- 失误日志尾部查看/清除辅助工具
- 带版本控制的配置键,用于防抖、失误半径、HUD 开关、软性行为规范
适用对象
- 希望获得超越平坦竞技场的基于技巧的 PvP 的生存/小游戏服务器
- 活动主办者(跑酷锦标赛、创作者挑战、工作人员对战玩家)
- 已经运行开放组合(SimpleItems、GUIPro、PvPMonster 等)且需要一个以移动作为武器的战斗模式的服务器
要求
- Paper 1.21+(或其紧密分支)
- Java 21
- 无 ModelEngine 或 MythicMobs 依赖
配置(高层概览)
| 区域 |
示例 |
| 失误 |
严格半径、动作栏刷新间隔、调试日志开/关 |
| 安全标记 |
快捷栏槽位、防抖毫秒数、脉冲粒子 |
| 箱子 |
窃取消息、启用/禁用样式规则 |
| HUD |
显示放置/安全计数、失误原因持续时间 |
| 套装 / 竞技场 |
套装物品、竞技场世界坐标 |
所有关键调节项均设计为无需重新编译即可调整。Doctor 命令会暴露实时数值,让你无需猜测。
命令(概览)
具体的权限和语法可能随版本演变;典型界面包括:
- 开始 / 接受 / 离开决斗流程
/pkbattle hp, phase, forfeit, rematch
/pkbattle kit, arenas, spectators
/pkbattle lastopp(查看、清除、大小/计数、帮助)
/pkbattle admin doctor, misslog, testmarks
- 安全标记是战斗中的物品交互(以及管理员测试模式)
主要管理员子命令提供 Tab 自动补全。
公平性与安全说明
- 失误规则在服务端强制执行;客户端无法“选择”忽略它们
- 安全标记是故意的例外——在竞争性服务器上请保持由工作人员控制
- 调试失误日志是可选的;除非你在调整规则,否则在生产环境中将其关闭
- 软失败路径避免在玩家战斗中途断开连接时发生硬崩溃(战斗清理机制)
ParkourBattle 不是什么
- 不是一个完整的 Bedwars/Skywars 克隆版
- 不是一个 AI 机器人竞技场(关于类玩家机器人,请参阅 PvPMonster)
- 不是一个通用的 GUI 库(请参阅 GUIPro)
- 不是一个自定义物品框架(请参阅 SimpleItems)
它只做一件事并且做得很好:将跑酷变成一项决斗运动。
支持
报告问题时,请包含以下内容:
- Paper 版本
- ParkourBattle 版本
doctor 或 doctor --brief 的输出结果
- 问题类型:失误检测、套装、竞技场或箱子窃取
许可 / 组合
作为开源 Paper 1.21 工具包的一部分开发,与 SimpleItems、GUIPro、PvPMonster、CommandPortal 和 ParticleStudio 并行存在。每个插件均可独立运行;在一起时,它们形成一个更完整的战斗 + 内容堆栈。
ParkourBattle
ParkourBattle превращает паркур в соревновательный режим дуэлей для Paper 1.21. Игроки сражаются не только оружием, но и движением и постановкой блоков: каждый прыжок важен. Приземлился не туда — получил урон. Контролируй пространство блоками, ломай удобные линии противнику и наказывай за суету.
Это не очередной клон «хаба мини-игр». Это сфокусированный движок паркур-дуэлей со строгой логикой промахов, опциональным боем «на месте», китами, аренами, взаимодействием с сундуками и нормальным админ/debug-слоем.
Главная идея
Во время боя игрок ставит блоки и прыгает. Сервер помнит боевые блоки. Если ты приземлился на то, что не относится к бою (и не помечено как safe), это промах. Промах бьёт по HP — урон настраивается, есть actionbar и опциональный строгий радиус, чтобы «почти попал на блок» не прокатывало.
Одно это правило меняет темп: нельзя бесконечно спамить случайные блоки — каждая постановка что-то значит.
Возможности
Дуэли и процесс
- Вызов / принятие боя между игроками
- Фазы боя (подготовка → бой → завершение), их можно смотреть командами
- Forfeit и rematch (в том числе когда раунд уже закончился — по возможности версии)
- Leave / leave-all для админов, если матч завис
- Зрители и списки spectators
- Опциональный бой прямо на месте (без арены) с коротким радиусом приглашения — удобно для ивентов
- Команды HP и phase, чтобы быстро видеть состояние матча
Система промахов (ядро плагина)
- Приземление не на боевой блок = miss
- Настраиваемый строгий радиус вокруг блока
- Safe-stick: пометить блоки, которые никогда не считаются промахом (трень, ивент-трассы, админ-тесты)
- Debounce на стик, чтобы один клик не давал пачку переключений
- Actionbar: причина промаха, успешная метка (Adventure, с запасным legacy-путём)
- Опциональный debug-лог промахов (консоль + файл с ротацией)
- Админские test marks вне живого боя, частицы и телепорт к метке
Блоки, сундуки и модификаторы
- Постановка блоков как геометрия дуэли
- Прыжки сундук → сундук могут забирать инвентарь соперника (сообщения атакующему/жертве)
- Разная логика «стою на блоке сундука» / «прыгнул на сундук»
- Много модификаторов под ranked или casual-правила
Киты и арены
- Выдача кита из конфига / папки kits
- Список китов
- Арены: free / busy
- Инфо по арене для стаффа
- Размер очереди (где включено)
UX
- HUD в actionbar: поставленные блоки, safe-метки, причины miss
- Частицы на safe-метках (pulse)
- Понятные сообщения при chest-steal
- Команды статуса для зрителей и админов
Админка и целостность
/pkbattle doctor и --brief (активные бои, размер last-opponent map, флаги конфига)
- Last opponent: peeks, clear, clearall, size/count, фильтр online
- Хвост/очистка miss-лога
- Версионируемые ключи конфига: debounce, радиус miss, HUD, поведение
Для кого
- Сервера survival / mini-games, где нужен skill-based PvP, а не только плоская арена
- Ивенты: паркур-турниры, челленджи, staff vs players
- Сборки с открытым комбайном (SimpleItems, GUIPro, PvPMonster и т.д.), где бой должен требовать движение как навык
Требования
- Paper 1.21+ (или близкий форк)
- Java 21
- Без зависимости от ModelEngine / MythicMobs
Конфиг (укрупнённо)
| Зона |
Примеры |
| Miss |
строгий радиус, время actionbar, debug-лог |
| Safe-stick |
слот хотбара, debounce, частицы |
| Сундуки |
сообщения steal, вкл/выкл правил |
| HUD |
счётчики placed/safe, длительность miss-reason |
| Киты / арены |
предметы кита, точки арен |
Важные параметры крутятся без пересборки. Doctor показывает живые значения.
Команды (обзор)
Точный синтаксис зависит от версии; обычно есть:
- Старт / accept / leave дуэли
/pkbattle hp, phase, forfeit, rematch
/pkbattle kit, arenas, spectators
/pkbattle lastopp (peeks, clear, size/count, help)
/pkbattle admin doctor, misslog, testmarks
- Safe-stick — предметом в бою (и в admin test)
Tab-complete на основных админ-подкомандах.
Честность
- Промахи считаются на сервере
- Safe-метки — явные исключения; на ranked лучше оставить стаффу
- Debug-лог miss в проде обычно выключают
- При дисконнекте бой корректно чистится (без «вечных» арен)
Чем ParkourBattle не является
- Не клон bedwars/skywars
- Не AI-арена с ботами (для ботов — PvPMonster)
- Не библиотека GUI (GUIPro)
- Не фреймворк кастом-предметов (SimpleItems)
Одна задача: сделать из паркура дуэльный спорт.
Поддержка
В баг-репорте укажите:
- Версию Paper
- Версию ParkourBattle
- Вывод doctor / doctor --brief
- Суть: miss, киты, арены или сундуки
Комбайн
Плагин из открытого набора для Paper 1.21 вместе с SimpleItems, GUIPro, PvPMonster, CommandPortal и ParticleStudio. Может жить отдельно; в связке даёт более полный боевой и контентный стек.
ParkourBattle
ParkourBattle turns parkour into a competitive 1v1 (and admin-controlled) combat mode for Paper 1.21. Two players fight not only with weapons, but with movement and block placement: every jump matters. Land wrong — you take damage. Control space with blocks, force awkward angles, and punish hesitation.
This is not a generic minigame hub clone. It is a focused parkour duel engine with strict miss logic, optional in-place fights, kits, arenas, chest interactions, and a full admin/debug layer.
Core idea
Players battle while building and jumping. The server tracks battle blocks you placed. If you land on something that is not part of the fight (and not marked safe), it counts as a miss. Misses hurt — configurable damage, actionbar feedback, optional strict radius so “almost on the block” still counts as failure.
That single rule creates real tension: you cannot spam random scaffolding forever; every block is a commitment.
Features
Duels & flow
- Challenge / accept style battles between players
- Battle phases (setup → fight → end) queryable in-game
- Forfeit and rematch paths (including rematch when the round already ended, where supported)
- Leave / leave-all tools for admins when a match is stuck
- Spectators support and spectator listing
- Optional battle on the spot (no arena) with a short range invite window — useful for events and spontaneous fights
- HP and phase commands so staff and players can see match state quickly
Miss system (the heart of the plugin)
- Landing on a non-battle block during a fight = miss
- Configurable strict radius around blocks (anti “edge abuse”)
- Safe-stick: mark blocks that must never count as a miss (practice lines, event routes, admin tests)
- Debounced safe-stick toggles so one click does not spam 10 toggles
- Actionbar feedback on successful mark / miss reason (Adventure API with legacy fallback)
- Optional debug miss log (console + rotating file) for rules tuning
- Admin test marks outside live battles (creative testing), with pulse particles and teleport-to-mark
Blocks, chests & modifiers
- Place blocks as part of the duel geometry
- Chest-to-chest jumps can steal inventory from the opponent (configurable attacker/victim messages)
- Separate logic for standing on the chest block vs jumping onto it (modifier hooks)
- Large set of battle modifiers for servers that want ranked rules vs casual fun rules
Kits & arenas
- Kit apply from configured kit items
- Kit list from kits folder
- Arena registry: free / busy status
- Arena info command for staff
- Queue size visibility where enabled
UX & feedback
- Actionbar HUD lines: placed blocks, safe keys, miss reasons
- Optional particles on safe marks (pulse)
- Clear messages when chest-steal triggers
- Spectator and staff-friendly status commands
Admin & integrity
/pkbattle doctor and --brief summaries (active battles, last-opponent map size, config flags)
- Last opponent tracking: peeks, clear, clearall, size/count, online filters
- Miss log tail/clear helpers
- Versioned config keys for debounce, miss radius, HUD toggles, soft behavior
Who is it for?
- Survival / mini-games servers that want skill-based PvP beyond flat arenas
- Event hosts (parkour tournaments, creator challenges, staff vs players)
- Servers already running the open combo (SimpleItems, GUIPro, PvPMonster, etc.) that need a combat mode where movement is the weapon
Requirements
- Paper 1.21+ (or a close fork)
- Java 21
- No ModelEngine / MythicMobs dependency
Configuration (high level)
| Area |
Examples |
| Miss |
strict radius, actionbar ticks, debug log on/off |
| Safe-stick |
hotbar slot, debounce ms, pulse particles |
| Chests |
steal messages, enable/disable style rules |
| HUD |
show placed/safe counts, miss reason duration |
| Kits / arenas |
kit items, arena world positions |
All critical knobs are meant to be tunable without a rebuild. Doctor commands expose the live values so you are not guessing.
Commands (overview)
Exact permissions and syntax can evolve by version; typical surface includes:
- Start / accept / leave duel flows
/pkbattle hp, phase, forfeit, rematch
/pkbattle kit, arenas, spectators
/pkbattle lastopp (peeks, clear, size/count, help)
/pkbattle admin doctor, misslog, testmarks
- Safe-stick is an item interaction in battle (and admin test mode)
Tab-complete is provided for the main admin subcommands.
Fairness & safety notes
- Miss rules are enforced server-side; clients cannot “choose” to ignore them
- Safe marks are intentional exceptions — keep them staff-controlled on competitive servers
- Debug miss logging is optional; leave it off in production unless you are tuning rules
- Soft-fail paths avoid hard crashes if a player disconnects mid-battle (battle cleanup)
What ParkourBattle is not
- Not a full bedwars/skywars clone
- Not an AI bot arena (see PvPMonster for player-like bots)
- Not a general GUI library (see GUIPro)
- Not a custom item framework (see SimpleItems)
It does one job hard: make parkour into a duel sport.
Support
When reporting issues, include:
- Paper version
- ParkourBattle version
- Output of doctor / doctor --brief
- Whether the problem is miss detection, kits, arenas, or chest-steal
License / combo
Developed as part of an open Paper 1.21 toolkit alongside SimpleItems, GUIPro, PvPMonster, CommandPortal, and ParticleStudio. Each plugin can run standalone; together they form a fuller combat + content stack.
ParkourBattle
ParkourBattle превращает паркур в соревновательный режим дуэлей для Paper 1.21. Игроки сражаются не только оружием, но движением и постановкой блоков: каждый прыжок важен. Приземлился не туда — получил урон. Контролируй пространство блоками, ломай удобные линии противнику и наказывай за суету.
Это не очередной клон «хаба мини-игр». Это сфокусированный движок паркур-дуэлей со строгой логикой промахов, опциональным боем «на месте», китами, аренами, взаимодействием с сундуками и нормальным админ/debug-слоем.
Главная идея
Во время боя игрок ставит блоки и прыгает. Сервер помнит боевые блоки. Если ты приземлился на то, что не относится к бою (и не помечено как safe), это промах. Промах бьёт по HP — урон настраивается, есть actionbar и опциональный строгий радиус, чтобы «почти попал на блок» не прокатывало.
Одно это правило меняет темп: нельзя бесконечно спамить случайные блоки — каждая постановка что-то значит.
Возможности
Дуэли и процесс
- Вызов / принятие боя между игроками
- Фазы боя (подготовка → бой → завершение), их можно смотреть командами
- Forfeit и rematch (в том числе когда раунд уже закончился — по возможности версии)
- Leave / leave-all для админов, если матч завис
- Зрители и списки spectators
- Опциональный бой прямо на месте (без арены) с коротким радиусом приглашения — удобно для ивентов
- Команды HP и phase, чтобы быстро видеть состояние матча
Система промахов (ядро плагина)
- Приземление не на боевой блок = miss
- Настраиваемый строгий радиус вокруг блока
- Safe-stick: пометить блоки, которые никогда не считаются промахом (трень, ивент-трассы, админ-тесты)
- Debounce на стик, чтобы один клик не давал пачку переключений
- Actionbar: причина промаха, успешная метка (Adventure, с запасным legacy-путём)
- Опциональный debug-лог промахов (консоль + файл с ротацией)
- Админские test marks вне живого боя, частицы и телепорт к метке
Блоки, сундуки и модификаторы
- Постановка блоков как геометрия дуэли
- Прыжки сундук → сундук могут забирать инвентарь соперника (сообщения атакующему/жертве)
- Разная логика «стою на блоке сундука» / «прыгнул на сундук»
- Много модификаторов под ranked или casual-правила
Киты и арены
- Выдача кита из конфига / папки kits
- Список китов
- Арены: free / busy
- Инфо по арене для стаффа
- Размер очереди (где включено)
UX
- HUD в actionbar: поставленные блоки, safe-метки, причины miss
- Частицы на safe-метках (pulse)
- Понятные сообщения при chest-steal
- Команды статуса для зрителей и админов
Админка и целостность
/pkbattle doctor и --brief (активные бои, размер last-opponent map, флаги конфига)
- Last opponent: peeks, clear, clearall, size/count, фильтр online
- Хвост/очистка miss-лога
- Версионируемые ключи конфига: debounce, радиус miss, HUD, поведение
Для кого
- Сервера survival / mini-games, где нужен skill-based PvP, а не только плоская арена
- Ивенты: паркур-турниры, челленджи, staff vs players
- Сборки с открытым комбайном (SimpleItems, GUIPro, PvPMonster и т.д.), где бой должен требовать движение как навык
Требования
- Paper 1.21+ (или близкий форк)
- Java 21
- Без зависимости от ModelEngine / MythicMobs
Конфиг (укрупнённо)
| Зона |
Примеры |
| Miss |
строгий радиус, время actionbar, debug-лог |
| Safe-stick |
слот хотбара, debounce, частицы |
| Сундуки |
сообщения steal, вкл/выкл правил |
| HUD |
счётчики placed/safe, длительность miss-reason |
| Киты / арены |
предметы кита, точки арен |
Важные параметры крутятся без пересборки. Doctor показывает живые значения.
Команды (обзор)
Точный синтаксис зависит от версии; обычно есть:
- Старт / accept / leave дуэли
/pkbattle hp, phase, forfeit, rematch
/pkbattle kit, arenas, spectators
/pkbattle lastopp (peeks, clear, size/count, help)
/pkbattle admin doctor, misslog, testmarks
- Safe-stick — предметом в бою (и в admin test)
Tab-complete на основных админ-подкомандах.
Честность
- Промахи считаются на сервере
- Safe-метки — явные исключения; на ranked лучше оставить стаффу
- Debug-лог miss в проде обычно выключают
- При дисконнекте бой корректно чистится (без «вечных» арен)
Чем ParkourBattle не является
- Не клон bedwars/skywars
- Не AI-арена с ботами (для ботов — PvPMonster)
- Не библиотека GUI (GUIPro)
- Не фреймворк кастом-предметов (SimpleItems)
Одна задача: сделать из паркура дуэльный спорт.
Поддержка
В баг-репорте укажите:
- Версию Paper
- Версию ParkourBattle
- Вывод doctor / doctor --brief
- Суть: miss, киты, арены или сундуки
Комбайн
Плагин из открытого набора для Paper 1.21 вместе с SimpleItems, GUIPro, PvPMonster, CommandPortal и ParticleStudio. Может жить отдельно; в связке даёт более полный боевой и контентный стек.
评论 0
登录后参与评分
还没有评论,来抢沙发吧