ParticleFX
ParticleFX 是一个适用于 Paper 1.21 的插件,为多种玩家行为添加了可自定义的粒子效果。
玩家可以创建自己的预设、编辑动画参数、添加或移除粒子层、预览效果,并将预设绑定到支持的行为上,而无需手动编辑服务器配置文件。
功能
- 多种内置动画类型,包括
RING_WAVE、DOUBLE_HELIX、PHOENIX_BURST、TORNADO、CELESTIAL_SPHERE、ORBITAL、STARBURST和PILLAR_PULSE - 支持多种触发条件:跳跃、死亡、重生、加入、离开、移动、开始/停止冲刺、开始/停止潜行、攻击、命中、消耗、传送、破坏方块、放置方块、射箭升级
- 通过
config.yml设置全局预设和默认绑定 - 自动在
plugins/ParticleFX/playerdata/中保存每位玩家的预设和绑定 - 使用命令在游戏中编辑预设
- 在游戏中预览系统测试自定义效果
命令
| 命令 | 说明 |
|---|---|
/particlefx help |
显示命令帮助 |
/particlefx reload |
重新加载插件配置 |
/particlefx actions |
列出支持的动作触发器 |
/particlefx animations |
列出可用的动画类型 |
/particlefx presets |
显示个人预设和全局预设 |
/particlefx preview <preset> |
在你所在位置预览某个预设 |
/particlefx preset create <name> |
创建个人预设 |
/particlefx preset clone <source> <new-name> |
将预设克隆到你的个人配置中 |
/particlefx preset rename <old> <new> |
重命名个人预设 |
/particlefx preset delete <name> |
删除个人预设 |
/particlefx preset info <name> |
显示预设详情 |
/particlefx preset set <name> <property> <value> |
编辑预设设置 |
/particlefx preset particle add <preset> <particle> |
添加粒子层 |
/particlefx preset particle remove <preset> <index> |
移除粒子层 |
/particlefx preset particle set <preset> <index> <property> <value> |
编辑粒子层 |
/particlefx preset particle list <preset> |
列出预设中的粒子层 |
/particlefx preset particle clear <preset> |
移除所有粒子层 |
/particlefx bind list |
显示当前生效的绑定 |
/particlefx bind add <action> <preset> |
将预设绑定到动作 |
/particlefx bind remove <action> <preset> |
从动作中移除预设 |
/particlefx bind clear <action> |
在你的个人配置中禁用某动作 |
/particlefx bind reset <action> |
将某动作重置为全局默认值 |
权限
| 权限 | 说明 | 默认值 |
|---|---|---|
particlefx.reload |
重新加载插件配置 | op |
particlefx.customize |
管理个人预设和绑定 | true |
particlefx.effect.jump |
使用默认的跳跃预设 | true |
particlefx.effect.death |
使用默认的死亡预设 | true |
particlefx.effect.respawn |
使用默认的重生预设 | true |
配置
默认配置文件位于:
src/main/resources/config.yml
其中包含:
- 全局预设
- 默认触发绑定
- 默认权限
- 消息设置
- 禁用的世界列表
玩家示例工作流程:
/particlefx preset create myflare
/particlefx preset set myflare animation TORNADO
/particlefx preset particle add myflare DUST
/particlefx preset particle set myflare 1 color 255,80,180
/particlefx bind add sprint-start myflare
/particlefx preview myflare
安装
- 构建插件或下载编译好的 jar 文件。
- 将 jar 文件放入服务器的
plugins/文件夹中。 - 启动服务器。
- 如需更改全局预设或默认绑定,请编辑
plugins/ParticleFX/config.yml。 - 修改配置后,使用
/particlefx reload重新加载。
构建
本项目使用 Gradle。
.\gradlew.bat build
编译后的 jar 文件将生成在:
build/libs/ParticleFX-1.0-SNAPSHOT.jar
注意事项
- 插件目标版本为 Paper
1.21 - 玩家创建的数据会按 UUID 自动存储
- 部分
Sound(声音)查找使用了 Paper 已弃用的兼容 API,但插件在当前目标版本上仍能正常构建和运行
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧