UltimateBounce

插件

· 作者 geturplugins

制作弹跳方块和其他方块,根据你为小游戏输入的 velocity 进行高跳跃。

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

最新 1.0.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

** BouncePads — 完整插件文档


概述

什么是 BouncePads?

BouncePads 是一款轻量级、性能优化的 Minecraft 插件,可将任何固体方块转换为可配置的弹跳/跳跃垫。当玩家站在配置好的方块上时,他们会被自动发射到空中,并具有可自定义的速度、方向、音效和粒子效果。

灵感源自 CubeCraft、Hypixel 和 Hive 等热门服务器,该插件为您的服务器带来流畅、无卡顿的弹跳机制。非常适合用于 FFA 竞技场、BedWars、SkyWars、跑酷地图、大厅以及任何需要发射台的玩法模式。

插件信息

详情 值
插件名称 BouncePads
版本 1.0.0
API 版本 1.21+
支持版本 Paper/Spigot 1.21 - 1.21.11
服务端软件 Paper, Spigot 及其所有分支
Java 版本 21+
软依赖 PlaceholderAPI, WorldGuard, Vault

工作原理

玩家踩在配置的方块上(或其上方的压力板上)
        │
        ▼
插件检测弹跳方块
        │
        ▼
检查:是否启用?世界是否允许?权限?冷却时间?
        │
        ▼
计算速度(垂直 + 水平 + 方向 + 乘数)
        │
        ▼
将速度应用于玩家
        │
        ▼
播放音效和粒子效果
        │
        ▼
应用坠落伤害保护
        │
        ▼
设置冷却计时器

使用场景

服务器类型 BouncePads 如何提供帮助
FFA / PvP 竞技场 地图上用于快速移动的战略性发射点
BedWars / SkyWars 岛屿之间带有方向性弹跳的发射台
大厅服务器 引导玩家前往不同游戏的趣味弹跳区域
跑酷地图 基于动量的弹跳链,高度各异
Hub / Spawn 指向景点的方向性垫子
小游戏网络 可按世界配置的发射系统

功能摘要

核心功能

✅ 将任何固体方块变为弹跳垫
✅ 每个方块的独立速度配置(垂直 + 水平)
✅ 三种激活模式:直接、压力板、混合
✅ 不同方块拥有不同的弹跳强度
✅ 无需药水效果即可平滑应用速度
✅ 适用于全服所有玩家
✅ 弹跳后自动提供坠落伤害保护
✅ 按方块独立的冷却系统
✅ 按玩家切换(开启/关闭弹跳、音效、粒子)

方向性弹跳

⬆️ VERTICAL_ONLY            — 纯向上弹跳(默认)
? PLAYER_FACING            — 向玩家朝向方向发射
↗️ PLAYER_FACING_HORIZONTAL — 水平朝向 + 垂直方向
? FIXED_DIRECTION          — 始终朝向配置的指南针方向发射
? AWAY_FROM_CENTER         — 远离方块中心发射

压力板系统

✅ 支持 Minecraft 中所有 15 种压力板类型
✅ 每种压力板类型有不同的速度乘数
✅ 加重压力板提供更强的弹跳力
✅ 限制哪些压力板类型可在每个方块上使用
✅ 仅限玩家激活(排除实体和物品)

效果系统

? 每个方块的自定义音效(任意 Minecraft 音效)
? 每个方块的自定义粒子效果(任意 Minecraft 粒子)
? 玩家在空中时的粒子轨迹
? 发射和落地时的粒子效果
? 每个方块的可配置音量和音调
? 按玩家的音效/粒子开关

预设系统

? 8 个内置预设,开箱即用
? 从现有方块创建无限数量的自定义预设
? 通过一条命令立即将预设应用到任何方块
? 内置预设受保护,防止意外删除
? 所有预设持久保存在 presets.yml 中

GUI 管理系统

?️ 基于库存的全功能管理 GUI
? 分页方块列表,点击即可编辑
✏️ 交互式方块编辑,包含增加/减少按钮
? 颜色编码的开关和状态指示器
? GUI 内的统计数据展示
? 预设选择和应用 GUI
⚙️ 个人玩家设置 GUI
✅ 破坏性操作的确认对话框
? 基于聊天的输入以精确输入数值

世界限制

? DISABLED 模式 — 在所有世界中弹跳均有效
? WHITELIST 模式 — 仅在列出的世界中弹跳有效
? BLACKLIST 模式 — 除列出的世界外,其他所有世界均可弹跳
? 按世界覆盖激活模式
? 按世界的速度乘数
?️ 基于 WorldGuard 区域的限制

性能优化

⚡ 优化的移动事件处理,包含提前退出机制
? 用于线程安全的并发数据结构
⏱️ 防抖系统防止重复处理
?️ 自动清理过期的冷却时间
? 异步数据保存
? 可配置的缓存限制
? 即使有 100+ 并发玩家,对 TPS 的影响也极小
? 高效的 HashSet/HashMap 查找,实现 O(1) 方块检测

集成

? PlaceholderAPI — 提供 10+ 个占位符
?️ WorldGuard — 基于区域的弹跳限制
? Vault — 经济支持(为未来功能准备)
? bStats — 匿名使用指标

配置

? messages.yml 中可自定义每条消息
⚙️ config.yml 中可配置每项设置
? 方块数据单独存储在 data/blocks.yml 中
? 预设单独存储在 data/presets.yml 中
? 玩家数据单独存储在 data/players.yml 中
? 完全支持颜色代码(& 代码 + hex &RRGGBB)
? 通过 /bp reload 热重载,无需重启服务器

安装指南

要求

要求 详情
服务端软件 Paper 或 Spigot(或任何分支)
Minecraft 版本 1.21 至 1.21.11
Java 版本 Java 21 或更高
磁盘空间 少于 1MB

可选依赖

插件 用途 必需?
PlaceholderAPI 在聊天、计分板等中显示弹跳统计信息 否
WorldGuard 基于区域的弹跳垫限制 否
Vault 经济集成(为未来功能准备) 否

逐步安装

步骤 1:下载插件

从官方下载页面下载 BouncePads-1.0.0.jar

步骤 2:安装 JAR 文件

将 BouncePads-1.0.0.jar 放入服务器的 plugins/ 文件夹中

Server/
├── plugins/
│   ├── BouncePads-1.0.0.jar    ← 放置在此处
│   └── ... other plugins
├── server.jar
└── ...

步骤 3:启动或重启服务器

插件将自动生成其配置文件:

plugins/BouncePads/
├── config.yml          ← 主配置文件
├── messages.yml        ← 所有消息
└── data/
    ├── blocks.yml      ← 弹跳方块数据
    ├── presets.yml      ← 预设模板
    └── players.yml     ← 玩家偏好和统计数据

步骤 4:验证安装

检查控制台是否有启动消息:

[BouncePads] ========================================
[BouncePads]  BouncePads v1.0.0
[BouncePads]  Server: Paper 1.21.1
[BouncePads]  Bounce Blocks: 2
[BouncePads]  Presets: 8
[BouncePads]  Loaded in 45ms
[BouncePads] ========================================

步骤 5:配置并添加方块

使用游戏内命令添加弹跳方块:
/bp add slime_block 1.5
/bp add emerald_block 3.0

或者编辑配置文件并重新加载:
/bp reload

升级

1. 停止服务器(推荐),或在替换后使用 /bp reload
2. 用新版本替换旧的 JAR 文件
3. 启动服务器
4. 检查控制台中是否有任何迁移消息
5. 所有数据和配置都会自动保留

快速入门指南

你的第一个弹跳垫(30秒)

 步骤 1:添加一个速度为 1.5 的粘液块作为弹跳垫
/bp add slime_block 1.5

 步骤 2:在世界中的任何位置放置粘液块

 步骤 3:踩上去并弹起!

设置具有不同能力的多个方块

 低弹跳 - 用于细微移动
/bp add honey_block 0.8

 中等弹跳 - 标准跳跃垫
/bp add slime_block 1.5

 高弹跳 - 显著高度
/bp add emerald_block 2.5

 超级发射 - 极端高度
/bp add diamond_block 4.0

 方向性发射 - 向前动量
/bp add gold_block 2.0
/bp set gold_block direction player_facing
/bp set gold_block horizontal 1.5

速度参考指南

速度 近似高度 最佳用途
0.5 ~1.5 个方块 小跳跃,装饰
0.8 ~2.5 个方块 轻柔弹跳,大厅
1.0 ~3 个方块 短距离跳跃,跑酷
1.5 ~5 个方块 标准跳跃垫
2.0 ~8 个方块 高跳,自由对战 (FFA)
2.5 ~12 个方块 非常高跳跃
3.0 ~18 个方块 极限跳跃,BedWars
4.0 ~25+ 个方块 发射垫,SkyWars
5.0+ ~35+ 个方块 炮台式发射

使用预设

 查看可用预设
/bp preset list

 将预设应用到方块
/bp preset apply slime_block super_launch

 将自定义方块保存为预设
/bp preset save my_custom_pad emerald_block

 将自定义预设应用到其他方块
/bp preset apply gold_block my_custom_pad

内置预设

预设名称 速度 水平分量 方向 描述
small_hop 0.8 0.0 垂直 细微移动
medium_jump 1.5 0.0 垂直 通用用途
high_launch 2.5 0.0 垂直 显著高度
super_launch 4.0 0.0 垂直 极端高度
directional_push 1.0 1.5 面向玩家 向前动量
elytra_launcher 3.0 2.0 面向玩家 鞘翅起飞
slime_authentic 1.2 0.0 垂直 逼真的粘液感觉
trampoline 1.0 0.0 垂直 连续弹跳

使用图形界面 (GUI)

 打开主要管理 GUI
/bp gui

 GUI 提供以下功能:
 - 方块列表:查看和编辑所有配置的方块
 - 预设:浏览和应用预设
 - 设置:切换个人偏好设置
 - 统计信息:查看弹跳统计数据
 - 重新加载:重新加载配置

激活模式

模式概览

BouncePads 支持三种激活模式,决定玩家如何触发弹跳垫。每个方块可以拥有自己的模式,或者你可以设置全局默认值。

模式 触发方式 最佳用途
DIRECT 直接踩在方块上 自由对战 (FFA),PvP 竞技场,快速响应
PRESSURE_PLATE 踩在方块上方的压力板上 BedWars,受控激活
HYBRID 两种方法均可 灵活设置,混合地图

DIRECT 模式

玩家踩到配置的方块时会立即弹起。
不需要压力板。响应时间最快。

   玩家
     ↓
 [弹跳方块]  ← 玩家踩在这里,立即弹起

设置:

/bp add slime_block 1.5
/bp set slime_block mode direct

PRESSURE_PLATE 模式

需要在弹跳方块上方放置压力板。
只有当压力板被触发时,玩家才会弹起。

   玩家
     ↓
 [压力板]  ← 玩家踩在这里
 [弹跳方块]    ← 提供弹跳效果

设置:

/bp add iron_block 2.0
/bp set iron_block mode pressure_plate

 然后在游戏内的铁块上方放置压力板

HYBRID 模式

直接踩踏和压力板均有效。
最灵活的选项。

   玩家          玩家
     ↓                ↓
 [弹跳方块]   [压力板]
                  [弹跳方块]

 两者都能触发弹跳!

设置:

/bp add gold_block 1.5
/bp set gold_block mode hybrid

设置全局模式

 设置所有方块的默认模式
/bp mode direct
/bp mode pressure_plate
/bp mode hybrid

按世界覆盖模式

 在 config.yml 中
world-restrictions:
  world-modes:
    pvp_arena: DIRECT
    bedwars: PRESSURE_PLATE
    lobby: HYBRID

压力板乘数

不同类型的压力板可以应用不同的速度乘数。

压力板类型 默认倍率 效果
所有木质压力板 1.0x 标准弹跳
石质压力板 1.2x 增强 20%
磨制黑石 1.2x 增强 20%
轻型压力板(金) 1.5x 增强 50%
重型压力板(铁) 2.0x 力量翻倍

示例: 方块速度 2.0 + 重型压力板 = 2.0 × 2.0 = 实际速度 4.0

限制特定方块的可用压力板类型

 仅允许在此方块上使用石质和重型压力板
(需在 blocks.yml 中手动设置)
 在 data/blocks.yml 中
IRON_BLOCK:
  mode: PRESSURE_PLATE
  allowed-plates:
    - STONE_PRESSURE_PLATE
    - HEAVY_WEIGHTED_PRESSURE_PLATE

命令参考

主命令

/bouncepad (别名: /bounce, /bp, /jumppad, /launchpad)

方块管理命令

命令 描述 权限
/bp add <block> <velocity> [mode] 添加新的弹跳方块 bouncepad.add
/bp remove <block> 移除一个弹跳方块 bouncepad.remove
/bp set <block> <setting> <value> 修改方块的设置 bouncepad.set
/bp list [page] 列出所有已配置的方块 bouncepad.list
/bp info <block> 显示方块详细信息 bouncepad.info

示例:

 添加方块
/bp add slime_block 1.5
/bp add emerald_block 3.0 hybrid
/bp add diamond_block 2.0 pressure_plate

 移除一个方块
/bp remove emerald_block

 列出所有方块
/bp list
/bp list 2

 查看详细资讯
/bp info slime_block

方块设置命令

命令 值类型 示例
/bp set <block> velocity <number> 小数 /bp set slime_block velocity 2.5
/bp set <block> horizontal <number> 小数 /bp set slime_block horizontal 1.5
/bp set <block> direction <mode> 方向名称 /bp set slime_block direction player_facing
/bp set <block> mode <mode> 激活模式 /bp set slime_block mode pressure_plate
/bp set <block> sound <sound/none> 音效名称 /bp set slime_block sound entity_slime_jump
/bp set <block> particle <particle/none> 粒子名称 /bp set slime_block particle cloud
/bp set <block> cooldown <ms> 毫秒数 /bp set slime_block cooldown 1000
/bp set <block> falldamage <true/false> 布尔值 /bp set slime_block falldamage true
/bp set <block> permission <perm/none> 权限字符串 /bp set slime_block permission vip.bounce
/bp set <block> enabled <true/false> 布尔值 /bp set slime_block enabled false

全局设置命令

命令 描述 权限
/bp mode <direct/pressure_plate/hybrid> 设置全局激活模式 bouncepad.mode
/bp reload 重新加载所有配置文件 bouncepad.reload

玩家命令

命令 描述 权限
/bp toggle 开启/关闭弹跳功能 bouncepad.toggle
/bp toggle sounds 开启/关闭弹跳音效 bouncepad.toggle.sounds
/bp toggle particles 开启/关闭弹跳粒子 bouncepad.toggle.particles
/bp toggle all 全部开关切换 bouncepad.toggle

世界管理命令

命令 描述 权限
/bp world mode <disabled/whitelist/blacklist> 设置限制模式 bouncepad.world
/bp world add <world> 将世界加入列表 bouncepad.world
/bp world remove <world> 从列表中移除世界 bouncepad.world
/bp world list 显示世界配置 bouncepad.world

示例:

 仅在特定世界中允许弹跳
/bp world mode whitelist
/bp world add pvp_arena
/bp world add bedwars_lobby

 在特定世界中禁止弹跳
/bp world mode blacklist
/bp world add creative_world

 显示当前配置
/bp world list

预设命令

命令 描述 权限
/bp preset list 列出所有预设 bouncepad.preset
/bp preset apply <block> <preset> 将预设应用到方块 bouncepad.preset
/bp preset save <name> <block> 将方块保存为预设 bouncepad.preset
/bp preset delete <name> 删除自定义预设 bouncepad.preset

示例:

 列出所有可用的预设
/bp preset list

 应用内置预设
/bp preset apply slime_block super_launch

 将当前方块配置保存为自定义预设
/bp preset save my_launch_pad emerald_block

 将自定义预设应用到另一个方块
/bp preset apply gold_block my_launch_pad

 删除自定义预设
/bp preset delete my_launch_pad

信息命令

命令 描述 权限
/bp stats [player] 查看统计数据 bouncepad.stats
/bp gui 打开管理界面 bouncepad.gui
/bp help [command] 显示帮助信息 bouncepad.use
/bp debug 显示调试信息 bouncepad.debug

权限参考

用户权限

权限 描述 默认值
bouncepad.use 使用弹跳垫 true
bouncepad.toggle 切换个人设置 true
bouncepad.toggle.sounds 切换音效 true
bouncepad.toggle.particles 切换粒子效果 true
bouncepad.gui 打开设置 GUI true
bouncepad.stats 查看自己的统计信息 true

管理员权限

权限 描述 默认值
bouncepad.admin 所有管理权限(父节点) op
bouncepad.add 添加弹跳方块 op
bouncepad.remove 移除弹跳方块 op
bouncepad.set 修改方块设置 op
bouncepad.list 列出所有方块 op
bouncepad.info 查看方块详情 op
bouncepad.mode 更改全局模式 op
bouncepad.reload 重载配置 op
bouncepad.world 管理世界限制 op
bouncepad.preset 管理预设 op
bouncepad.stats.others 查看其他玩家的统计数据 op
bouncepad.debug 使用调试命令 op
bouncepad.gui.admin 管理 GUI 功能 op

绕过权限

权限 描述 默认值
bouncepad.bypass 所有绕过权限(父节点) op
bouncepad.bypass.cooldown 跳过冷却时间 op
bouncepad.bypass.world 忽略世界限制 op
bouncepad.bypass.region 忽略 WorldGuard 区域 op
bouncepad.bypass.permission 忽略单个方块的权限要求 op
bouncepad.bypass.falldamage 始终拥有跌落保护 op

特定方块权限

bouncepad.block.<material_name>

示例:
  bouncepad.block.slime_block
  bouncepad.block.emerald_block
  bouncepad.block.diamond_block

设置单个方块的权限要求:

/bp set slime_block permission bouncepad.block.slime_block

通配符

权限 描述 默认值
bouncepad.* BouncePads 的所有权限 op

权限设置示例

LuckPerms — 为所有玩家提供基本弹跳访问权限:

/lp group default permission set bouncepad.use true
/lp group default permission set bouncepad.toggle true

LuckPerms — VIP 用户可绕过冷却时间:

/lp group vip permission set bouncepad.bypass.cooldown true

LuckPerms — 管理员拥有所有权限:

/lp group admin permission set bouncepad.* true

blocks.yml — 方块配置

每个弹跳方块条目支持以下设置:

PlaceholderAPI 支持

依赖项

  • 服务器上安装了 PlaceholderAPI 插件
  • config.yml 中设置 integrations.placeholderapi.enabled: true(默认开启)

可用的占位符

占位符 描述 示例输出
%bouncepad_enabled% 玩家的弹跳开关状态 true
%bouncepad_sounds% 玩家的声音开关状态 true
%bouncepad_particles% 玩家的粒子效果开关状态 false
%bouncepad_total_blocks% 配置的方块总数 5
%bouncepad_total_bounces% 玩家的总弹跳次数 1234
%bouncepad_server_bounces% 全服总弹跳次数 98765
%bouncepad_cooldown% 当前剩余冷却时间 2.5s 或 Ready
%bouncepad_last_block% 上次弹跳的方块类型 SLIME_BLOCK
%bouncepad_world_allowed% 当前世界是否允许弹跳 true
%bouncepad_mode% 全局激活模式 Direct
%bouncepad_bounces_<material>% 在特定方块上的弹跳次数 500

特定方块弹跳占位符

%bouncepad_bounces_slime_block%     → 500
%bouncepad_bounces_emerald_block%   → 123
%bouncepad_bounces_diamond_block%   → 42
%bouncepad_bounces_gold_block%      → 78

使用示例

计分板(使用任意计分板插件):

&aBounces: %bouncepad_total_bounces%
&eStatus: %bouncepad_enabled%

Tab 列表:

&7[&a%bouncepad_total_bounces% bounces&7]

聊天格式:

%bouncepad_total_bounces% bounces | %player_name%

常见问题

一般问题

Q: BouncePads 支持哪些版本? A: Paper 和 Spigot 1.21 至 1.21.11 版本。所有子版本均已充分测试并得到支持。

Q: 它是否与 Folia 兼容? A: 当前版本专为 Paper/Spigot 设计。Folia 兼容性可能会在未来的更新中添加。

Q: 有方块类型的数量限制吗? A: 没有。你可以配置任意多种不同的方块类型作为弹跳垫。

Q: 它会影响服务器性能吗? A: BouncePads 经过高度优化。移动事件处理器使用了提前退出检查、防抖处理和缓存机制。大多数服务器报告称,即使有 100+ 名玩家在线,TPS 变化也微乎其微,几乎不可测。

Q: 我可以使用任何方块作为弹跳垫吗? A: 任何固体方块都可以使用。像告示牌、旗帜、按钮和压力板本身不能作为弹跳垫(压力板是放置在弹跳方块之上的)。

配置问题

Q: 我可以为不同世界设置不同的速度吗? A: 可以。在 config.yml 中使用 world-restrictions.world-multipliers 来设置每个世界的速度倍率。

Q: 我可以使某个方块仅与特定的压力板配合使用吗? A: 可以。在 blocks.yml 中为该方块设置 allowed-plates 列表,以限制触发它的压力板类型。

Q: 我可以在不同世界使用不同的激活模式吗? A: 可以。在 config.yml 中使用 world-restrictions.world-modes 来按世界覆盖全局模式。

Q: 如何更改所有消息? A: 每条消息都在 messages.yml 文件中。编辑该文件并运行 /bp reload 即可生效。

游戏性问题

Q: 生物会触发弹跳垫吗? A: 在压力板模式下且 player-only: true(默认值)时,生物无法触发弹跳。在直接模式(Direct mode)下,仅检测玩家移动。

Q: 玩家可以绕过冷却时间吗? A: 拥有 bouncepad.bypass.cooldown 权限的玩家将跳过所有冷却时间。

Q: 该插件是否使用跳跃提升药水效果? A: 不。BouncePads 直接向玩家施加速度,而不是使用药水效果。这样更加平滑且可控性更强。

Q: 我可以禁用弹跳带来的跌落伤害吗? A: 可以。每个方块都有一个 fall-damage-protection 设置。启用后,玩家在弹跳后的指定时间内不会受到跌落伤害。

Q: 玩家能否为自己禁用弹跳效果? A: 可以。玩家可以使用 /bp toggle 命令来开启或关闭自己的弹跳效果,而不会影响其他玩家。

技术问题

Q: 其他插件能否与 BouncePads 交互? A: 可以。该插件提供了完整的公共 API 和自定义事件。其他插件可以添加/移除方块、弹射玩家、监听弹跳事件等。

Q: 数据是如何存储的? A: 所有数据均存储在 plugins/BouncePads/data/ 文件夹中的 YAML 文件里。无需数据库。

Q: 我可以在不重启服务器的情况下重新加载配置吗? A: 可以。使用 /bp reload 命令即可在不重启服务器的情况下重新加载所有配置文件。

Q: 如何重置所有内容? A: 停止服务器,完全删除 plugins/BouncePads/ 文件夹,然后重新启动。所有默认文件将自动重新生成。


故障排除

常见问题

弹跳板无法工作

1. 检查插件是否已启用:
   → 确认 config.yml 中 "general.enabled: true"

2. 检查世界限制:
   → 运行 /bp debug 以查看当前世界是否被允许
   → 检查 config.yml 中的 world-restrictions(世界限制)部分

3. 检查方块是否已配置:
   → 运行 /bp list 查看所有已配置的方块
   → 运行 /bp info <block> 查看特定方块的详情

4. 检查激活模式:
   → 如果模式为 PRESSURE_PLATE(压力板),则上方必须放置一块压力板
   → 运行 /bp debug 以查看当前模式

5. 检查权限:
   → 玩家需要 bouncepad.use 权限(默认:true)
   → 检查该方块是否有特定的权限要求

6. 检查玩家开关状态:
   → 玩家可能已禁用弹跳:/bp toggle
   → 运行 /bp debug 以检查弹跳启用状态

弹跳后玩家受到跌落伤害

1. 检查跌落伤害保护是否已启用:
   → /bp info <block> 显示 fall-damage(跌落伤害)设置
   → 启用方法:/bp set <block> falldamage true

2. 检查保护持续时间:
   → 默认为 5000ms(5秒)
   → 在 config.yml 中增加:fall-damage.protection-duration

3. 检查传送时是否清除保护:
   → config.yml: fall-damage.clear-on-teleport

音效或粒子效果未生效

1. 检查全局开关:
   → config.yml: sounds.enabled 和 particles.enabled

2. 检查单个方块的设置:
   → /bp info <block> 显示音效和粒子设置

3. 检查玩家偏好设置:
   → 玩家可能已关闭音效:/bp toggle sounds

4. 检查音效/粒子名称:
   → 必须是有效的 Minecraft 名称
   → 不区分大小写,但建议使用全大写格式

图形界面(GUI)无法打开

1. 检查 GUI 是否已启用:
   → config.yml: gui.enabled: true

2. 检查权限:
   → 玩家需要 bouncepad.gui 权限

3. 尝试使用命令版本代替:
   → /bp list, /bp info <block> 等

配置文件未重新加载

1. 检查 YAML 语法:
   → 使用 YAML 验证工具(yamllint.com)
   → 常见问题:使用了制表符而非空格、缺少冒号

2. 检查控制台错误信息:
   → 查找 "Failed to reload"(重新加载失败)相关的消息

3. 尝试重新生成:
   → 删除有问题的文件
   → 运行 /bp reload 以重新生成默认值

调试模式

启用调试模式以获取详细的控制台输出:

 config.yml
general:
  debug: true

然后检查控制台,查看有关弹跳检测、速度计算、权限检查等的详细日志。

性能问题

如果遇到 TPS 下降:

1. 增加移动阈值:
   performance.movement-threshold: 0.2(默认 0.1)

2. 增加防抖时间:
   performance.bounce-debounce: 200(默认 100)

3. 增加清理间隔:
   performance.cleanup-interval: 2400(默认 1200)

4. 减少粒子数量:
   particles.max-per-bounce: 20(默认 50)

5. 禁用轨迹效果:
   particles.show-trail: false

寻求帮助

如果您无法解决问题:

1. 启用调试模式并复现问题
2. 复制相关的控制台输出
3. 注明您的服务器版本和插件版本
4. 列出任何可能存在冲突的其他插件
5. 联系支持团队(见下文)

支持与联系方式

获取支持

渠道 链接 适用场景
Bug 报告 报告附带复现步骤的 Bug
功能请求 建议新功能
Discord 快速提问、社区互助

提交 Bug 报告时

请包含以下信息:

1. 服务器软件及版本(例如 Paper 1.21.1)
2. BouncePads 版本(例如 1.0.0)
3. Java 版本(例如 Java 21)
4. 已安装的其他插件列表
5. 复现 Bug 的步骤
6. 预期行为与实际行为对比
7. 控制台错误信息(如有)
8. config.yml 相关部分的设置

性能指标

指标 数值
事件处理 每次弹跳 < 0.5ms
内存占用 基础占用 < 5MB
TPS 影响 100+ 名玩家时几乎无影响
启动时间 < 200ms
JAR 包大小 ~150KB

许可证

ARR License 
Copyright (c) 2026 geturplugins

致谢

开发者:geturplugins
测试环境:Paper 1.21 - 1.21.11
构建工具:Maven, Spigot API, Paper API
统计服务:bStats

感谢您使用 BouncePads! ?

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源