- 版权类型
- 二次开发
- 插件中文名称
- 方块粒子
- 插件英文名称
- Block Particles
- 支持的核心（服务端）
- Paper
- Folia
- Purpur
- Leaves
- 语言支持
- 多语言
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
▍这是什么
站在方块前执行一条命令，这个方块就会持续播放指定的粒子效果。
爱心井、女巫龙卷、火焰喷泉、圣诞帽、彩虹、烟花螺旋……
全部以方块为中心，玩家走近才渲染，跑远自动静默。
所有效果保存在 data.yml，重启服务器自动恢复，无需重复设置。
━━━━━━━━━━━━━━━━━━━━
▍核心特性
· 38 种粒子效果 + 8 种喷泉效果，外加可自定义的头颅喷泉
· 图形化选择菜单：/bp set <名字> 直接开 GUI 点选，不用记特效名
· 喷泉会真的喷出物品：宝石、南瓜、礼物、头像……
掉落物 2 秒后自动清除，玩家与漏斗都无法拾取
· HeadDatabase 软依赖：装了可用其头颅 ID 做喷泉，没装也不报错
· 热重载 /bp reload，改配置不用重启服务器
· 零依赖、单 Jar、不注入 NMS，冲突面极小
· 全部调度走 region 调度器，Folia 多线程下也稳定安全
━━━━━━━━━━━━━━━━━━━━
▍支持版本与平台
Minecraft：1.21 ~ 26.3（编译基线 1.21，向上全兼容）
服务端：Paper / Purpur / Folia（含所有 Paper 分支）
Java：插件以 Java 21 编译；26.x 服务端需按官方要求用 Java 25
硬依赖：无
粒子名采用运行时解析，像 redstone → dust、water_drop →
falling_water 这类版本改名不会再让插件崩掉，这也是它能一路
横跨 1.21 到 26.3 的原因。
━━━━━━━━━━━━━━━━━━━━
▍命令与权限
主命令 /blockparticle
别名 blockparticles / bp / bparticle / bparticles
/bp help 查看全部命令
/bp add <名字> <类型> 把正看着的方块注册为粒子点（视线 5 格内）
/bp set <名字> [类型] 修改类型；只写名字会打开图形菜单
/bp delete <名字> 删除该粒子点
/bp list 列出所有粒子点（游戏内）
/bp types 列出全部可用类型
/bp show 查看运行中的粒子数量（控制台可用）
/bp reload 重载配置与所有粒子
权限：bparticles.admin（默认仅 OP）
━━━━━━━━━━━━━━━━━━━━
▍快速上手
1. 把 BlockParticles-1.0.0.jar 放进 plugins/ 文件夹，重启服务器
2. 进游戏，看向想加特效的方块
3. 输入 /bp add 大厅火盆 flame —— 火盆从此开始燃烧
4. 想换特效？/bp set 大厅火盆 打开菜单，点哪个用哪个
━━━━━━━━━━━━━━━━━━━━
▍效果清单（部分）
粒子类：Crit / BigCrit / Flame / BigFlame / Volcano / Spiral /
DoubleSpiral / Storm / FireStorm / SnowStorm / Snow / SnowBlast /
Fog / Enchant / Chains / Magic / Witch / DoubleWitch / Music /
Potion / Water / Rainbow / Halo / SantaHat / SoulWell /
BigSoulWell / LoveWell / BigLoveWell / LoveTornado / WitchTornado /
FlameWheel / EnderSignal / MobSpawner / HappyVillager /
AngryVillager / FootPrint / Spew / FireSpew（共 38 种）
喷泉类：Mario / Pokemon / Food / Mobs / Halloween / Gems /
Heads / Presents（共 8 种）+ 自定义头颅喷泉
自定义喷泉：在 config.yml 里写一组 HeadDatabase 头颅 ID，
即可创建自己的主题喷泉，例如：
settings:
prefix: '&8[&aBP&8]: '
heads:
plants: # 喷泉名，之后用 /bp add <名字> plants
- '1130' # 番茄
- '32596' # 芒果
- '31879' # 樱桃
- '79863' # 金苹果
━━━━━━━━━━━━━━━━━━━━
▍性能说明
· 每个粒子点在半径 25 格内有玩家时才渲染，无人区域不产生粒子包
· 所有循环任务挂在方块所在 region 的调度器上，Folia 下天然并行
· 掉落物 2 秒后自动回收，并禁止玩家 / 实体 / 漏斗拾取
━━━━━━━━━━━━━━━━━━━━
▍常见问题
Q：Spigot / CraftBukkit 能用吗？
A：不能。插件使用了 Paper 的 region 调度器、Adventure 与
PlayerProfile 等 API，请使用 Paper、Purpur 或 Folia。
Q：装很多粒子会不会卡？
A：不会。每个点在独立区域任务里跑，无玩家时直接跳过渲染，
实测上百点位依然轻量。
Q：头颅喷泉没有贴图？
A：喷泉贴图来自 HeadDatabase（软依赖）。装了 HDB 会在其数据
库加载完成后自动重试挂载；不装也能用，只是自定义头颅会显示
默认皮肤。
Q：支持 26.x 吗？
A：支持。已在 Folia 1.21.4、Paper 1.21.1、Paper 26.3 上实测
通过（注意 26.x 服务端本身要求 Java 25）。
━━━━━━━━━━━━━━━━━━━━
▍开源信息
协议：MIT，可自由修改与二次分发（保留版权声明即可）
源码与问题反馈：https://github.com/CatGirlMaoDie/BlockParticles
QQ群：1087780842
自行编译：./gradlew build，产物在 build/libs/
（Gradle 9 + Java 21，仅需 paper-api）
版本：BlockParticles 1.0.0
适用：Minecraft 1.21 ~ 26.3 / Paper / Purpur / Folia
站在方块前执行一条命令，这个方块就会持续播放指定的粒子效果。
爱心井、女巫龙卷、火焰喷泉、圣诞帽、彩虹、烟花螺旋……
全部以方块为中心，玩家走近才渲染，跑远自动静默。
所有效果保存在 data.yml，重启服务器自动恢复，无需重复设置。
━━━━━━━━━━━━━━━━━━━━
▍核心特性
· 38 种粒子效果 + 8 种喷泉效果，外加可自定义的头颅喷泉
· 图形化选择菜单：/bp set <名字> 直接开 GUI 点选，不用记特效名
· 喷泉会真的喷出物品：宝石、南瓜、礼物、头像……
掉落物 2 秒后自动清除，玩家与漏斗都无法拾取
· HeadDatabase 软依赖：装了可用其头颅 ID 做喷泉，没装也不报错
· 热重载 /bp reload，改配置不用重启服务器
· 零依赖、单 Jar、不注入 NMS，冲突面极小
· 全部调度走 region 调度器，Folia 多线程下也稳定安全
━━━━━━━━━━━━━━━━━━━━
▍支持版本与平台
Minecraft：1.21 ~ 26.3（编译基线 1.21，向上全兼容）
服务端：Paper / Purpur / Folia（含所有 Paper 分支）
Java：插件以 Java 21 编译；26.x 服务端需按官方要求用 Java 25
硬依赖：无
粒子名采用运行时解析，像 redstone → dust、water_drop →
falling_water 这类版本改名不会再让插件崩掉，这也是它能一路
横跨 1.21 到 26.3 的原因。
━━━━━━━━━━━━━━━━━━━━
▍命令与权限
主命令 /blockparticle
别名 blockparticles / bp / bparticle / bparticles
/bp help 查看全部命令
/bp add <名字> <类型> 把正看着的方块注册为粒子点（视线 5 格内）
/bp set <名字> [类型] 修改类型；只写名字会打开图形菜单
/bp delete <名字> 删除该粒子点
/bp list 列出所有粒子点（游戏内）
/bp types 列出全部可用类型
/bp show 查看运行中的粒子数量（控制台可用）
/bp reload 重载配置与所有粒子
权限：bparticles.admin（默认仅 OP）
━━━━━━━━━━━━━━━━━━━━
▍快速上手
1. 把 BlockParticles-1.0.0.jar 放进 plugins/ 文件夹，重启服务器
2. 进游戏，看向想加特效的方块
3. 输入 /bp add 大厅火盆 flame —— 火盆从此开始燃烧
4. 想换特效？/bp set 大厅火盆 打开菜单，点哪个用哪个
━━━━━━━━━━━━━━━━━━━━
▍效果清单（部分）
粒子类：Crit / BigCrit / Flame / BigFlame / Volcano / Spiral /
DoubleSpiral / Storm / FireStorm / SnowStorm / Snow / SnowBlast /
Fog / Enchant / Chains / Magic / Witch / DoubleWitch / Music /
Potion / Water / Rainbow / Halo / SantaHat / SoulWell /
BigSoulWell / LoveWell / BigLoveWell / LoveTornado / WitchTornado /
FlameWheel / EnderSignal / MobSpawner / HappyVillager /
AngryVillager / FootPrint / Spew / FireSpew（共 38 种）
喷泉类：Mario / Pokemon / Food / Mobs / Halloween / Gems /
Heads / Presents（共 8 种）+ 自定义头颅喷泉
自定义喷泉：在 config.yml 里写一组 HeadDatabase 头颅 ID，
即可创建自己的主题喷泉，例如：
settings:
prefix: '&8[&aBP&8]: '
heads:
plants: # 喷泉名，之后用 /bp add <名字> plants
- '1130' # 番茄
- '32596' # 芒果
- '31879' # 樱桃
- '79863' # 金苹果
━━━━━━━━━━━━━━━━━━━━
▍性能说明
· 每个粒子点在半径 25 格内有玩家时才渲染，无人区域不产生粒子包
· 所有循环任务挂在方块所在 region 的调度器上，Folia 下天然并行
· 掉落物 2 秒后自动回收，并禁止玩家 / 实体 / 漏斗拾取
━━━━━━━━━━━━━━━━━━━━
▍常见问题
Q：Spigot / CraftBukkit 能用吗？
A：不能。插件使用了 Paper 的 region 调度器、Adventure 与
PlayerProfile 等 API，请使用 Paper、Purpur 或 Folia。
Q：装很多粒子会不会卡？
A：不会。每个点在独立区域任务里跑，无玩家时直接跳过渲染，
实测上百点位依然轻量。
Q：头颅喷泉没有贴图？
A：喷泉贴图来自 HeadDatabase（软依赖）。装了 HDB 会在其数据
库加载完成后自动重试挂载；不装也能用，只是自定义头颅会显示
默认皮肤。
Q：支持 26.x 吗？
A：支持。已在 Folia 1.21.4、Paper 1.21.1、Paper 26.3 上实测
通过（注意 26.x 服务端本身要求 Java 25）。
━━━━━━━━━━━━━━━━━━━━
▍开源信息
协议：MIT，可自由修改与二次分发（保留版权声明即可）
源码与问题反馈：https://github.com/CatGirlMaoDie/BlockParticles
QQ群：1087780842
自行编译：./gradlew build，产物在 build/libs/
（Gradle 9 + Java 21，仅需 paper-api）
版本：BlockParticles 1.0.0
适用：Minecraft 1.21 ~ 26.3 / Paper / Purpur / Folia
