
在游戏中构建粒子系统。以 JSON 格式分享。
Spigot、Paper 和 Purpur · Minecraft 1.21.0 至 26.x · Java 21 · 可选 PlaceholderAPI 支持
ProxyParticle 是什么?
ProxyParticle 是一款专为服务器设计的粒子效果创作工具。你可以在基于箱子界面的编辑器中设计效果,同时实时预览会直接显示在你面前,因此每次点击都会立即生效。无需 YAML,无需代码,也无需重启服务器。
每个效果都保存为一个小型 JSON 文件。导出它,发送给好友或发布到网上,任何运行 ProxyParticle 的服务器都可以通过一条命令导入该效果。

功能特性
- 带实时预览的游戏内 GUI 编辑器。左键/右键可更改数值,按 Q 输入精确值,Ctrl+Q 重置该值。
- 分层效果: 可将任意数量的发射器堆叠到一个效果中,每个发射器拥有独立的粒子类型、形状、时序和运动方式。
- 19 种形状: 点、线、圆、圆盘、球体、实心球、环面、立方体、长方体、圆柱体、圆锥体、螺旋线、漩涡、多边形、星形、心形、波浪和网格。
- 支持你服务器版本中的所有原版粒子,包括尘埃(dust)、彩色效果以及方块和物品粒子。
- 颜色系统: 支持颜色列表,包含静态、随机、生命周期渐变、沿形状渐变和彩虹模式。尘埃粒子可以在其生命周期内变大或变小。
- 动画功能: 倾斜、绕任意轴旋转、脉冲、跟随玩家朝向,以及逐点追踪形状的序列绘制。
- 物理模拟: 速度、重力、阻力、湍流、轨道运动、吸引力,以及停留在发射位置的世界空间轨迹。
- 时序控制: 发射速率、爆发、延迟、各层持续时间、循环或一次性效果,以及可选的声音。
- 永久放置的效果 可保留至服务器重启。你可以移动它们,以 0.25 格为单位微调,赋予自定义 ID,并通过 Tab 补全或可点击列表快速查找。
- JSON 分享: 支持导出、从文件夹导入,或直接从 pastebin、GitHub 或 gist 链接导入。
- 向前兼容的文件格式: 缺失的设置将使用默认值,未知的设置会被跳过,确保文件在插件和 Minecraft 版本更新后仍能正常工作。
- 内置 PlaceholderAPI 扩展。
- 开发者 API 允许你的其他插件播放这些效果。
- 防卡顿机制: 渲染距离、全局粒子上限和效果数量上限均可在
config.yml 中配置。
- 9 个示例效果: 火焰光环、彩虹螺旋、爱心光晕、魔法漩涡、烟花爆发、雪云、原子、星辰皇冠和激光束。


分享效果
- 运行
/pp export <effect>。文件将被写入 plugins/ProxyParticle/exports/ 目录。
- 发送该文件,或将其发布到 pastebin 或 GitHub。
- 在另一台服务器上,将文件放入
plugins/ProxyParticle/imports/ 目录,然后运行 /pp import all,或者直接运行 /pp import <link>。

命令
主命令为 /pp(别名 /proxyparticle、/pparticle)。所有命令均支持 Tab 自动补全。
| 命令 |
功能 |
/pp 或 /pp editor [effect] |
打开编辑器 |
/pp list, /pp info <effect> |
浏览效果详情 |
/pp play <effect> [player|here] [loop] |
播放效果 |
/pp stop [player|all] |
停止效果 |
/pp create <name> |
创建新效果 |
/pp clone <from> <to> |
复制效果 |
/pp rename <old> <new> |
重命名效果 |
/pp delete <name> |
删除效果(保留备份) |
/pp layer <effect> add|remove <n>|list |
管理图层 |
/pp set <effect> <layer#|effect> <key> <value> |
修改任意设置 |
/pp get <effect> [layer#] |
显示所有设置 |
/pp keys, /pp particles |
列出设置键名和粒子类型 |
/pp export <effect|all> |
将 JSON 写入 exports/ 目录 |
/pp import <file|all|link> [name] |
导入 JSON |
/pp place <effect> [id] |
放置永久效果 |
/pp unplace [id] |
移除已放置的效果 |
/pp placed [name] |
显示已放置效果的 clickable 列表,优先显示最近的 |
/pp movehere [id] |
将已放置的效果移动到你身边 |
/pp moveto <player> [id] |
将已放置的效果移动到指定玩家处 |
/pp adjust <x|y|z|yaw> <+0.25|-0.25> [id] |
微调已放置的效果 |
/pp select [id|nearest] |
选择要编辑的已放置效果 |
/pp setid <placed> <id|none> |
为已放置的效果设置自定义 ID |
/pp tp <id> |
传送至已放置的效果处 |
/pp reload, /pp stats |
管理员命令 |
权限
所有权限默认仅 OP 可用。
| 权限节点 |
允许操作 |
proxyparticle.use |
浏览效果、在自己身上播放效果、停止自己的效果 |
proxyparticle.play.others |
在其他玩家身上播放和停止效果 |
proxyparticle.edit |
使用编辑器、创建、编辑、克隆、重命名、导出效果 |
proxyparticle.import |
从文件和链接导入效果 |
proxyparticle.admin |
上述所有权限,以及删除、放置、停止全部效果和重载配置 |
占位符
需要 PlaceholderAPI 2.11 或更高版本。该扩展会自动注册自身。
| 占位符 |
值 |
%proxyparticle_effects_total% |
服务器上的特效总数 |
%proxyparticle_placed_total% |
已放置的特效数量 |
%proxyparticle_running_total% |
当前正在播放的特效数量 |
%proxyparticle_particles_live% |
模拟粒子的存活数量 |
%proxyparticle_active% |
玩家身上正在播放的特效 |
%proxyparticle_active_ids% |
它们的 ID(若为空则为 none) |
%proxyparticle_active_names% |
它们的显示名称 |
%proxyparticle_is_active% |
true 或 false |
%proxyparticle_is_active_<effect>% |
该特效是否正在玩家身上播放 |
%proxyparticle_previewing% |
玩家在编辑器中预览的特效 |
%proxyparticle_selected% |
玩家选中的已放置特效 |
%proxyparticle_selected_effect% |
选中的已放置特效所播放的特效 |
%proxyparticle_effect_<effect>_<field>% |
name、name_plain、author、description、layers、duration 或 exists |
%proxyparticle_placed_<id>_<field>% |
effect、world、x、y、z 或 exists |

要求
- Spigot、Paper 或 Purpur,Minecraft 1.21.0 或更高版本(包括 26.x)
- Java 21
- 可选:PlaceholderAPI 2.11 或更高版本
- 不支持 Folia
安装
- 将
ProxyParticle.jar 放入你的 plugins 文件夹并重启服务器。
- 运行
/pp 打开编辑器。9 个示例特效已准备好播放。
- 右键点击一个特效可在自己身上播放它,左键点击可编辑它。
支持
SUPPORT_LINE

Build particle systems in-game. Share them as JSON.
Spigot, Paper and Purpur · Minecraft 1.21.0 to 26.x · Java 21 · optional PlaceholderAPI support
What is ProxyParticle?
ProxyParticle is a particle-effect creator for your server. You design effects in a chest-GUI editor while a live preview plays in front of you, so every click shows up instantly. No YAML, no code, no restarts.
Every effect is saved as a small JSON file. Export it, send it to a friend or post it online, and any server running ProxyParticle can import it with one command.

Features
- In-game GUI editor with a live preview. Left/right click changes a value, Q types an exact value, Ctrl+Q resets it.
- Layered effects: stack as many emitters as you like into one effect, each with its own particle, shape, timing and motion.
- 19 shapes: point, line, circle, disc, sphere, ball, torus, cube, box, cylinder, cone, helix, spiral, vortex, polygon, star, heart, wave and grid.
- Every vanilla particle on your server version, including dust, colored effects, and block and item particles.
- Colors: color lists with static, random, gradient-over-life, gradient-along-shape and rainbow modes. Dust can grow or shrink over its life.
- Animation: tilt, spin on any axis, pulse, follow the player's facing, and sequential drawing that traces a shape point by point.
- Physics: speed, gravity, drag, turbulence, orbit, attraction, and world-space trails that stay where they were emitted.
- Timing: emission rate, bursts, delays, per-layer durations, looping or one-shot effects, and optional sounds.
- Permanent placed effects that survive restarts. Move them, nudge them by 0.25 blocks, give them your own ids, and find them with Tab or a clickable list.
- JSON sharing: export, import from a folder, or import straight from a pastebin, GitHub or gist link.
- Forward-compatible files: missing settings use defaults and unknown ones are skipped, so files keep working across plugin and Minecraft versions.
- PlaceholderAPI expansion built in.
- Developer API to play effects from your own plugins.
- Lag-safe: render distance, a server-wide particle cap and an effect cap, all in config.yml.
- 9 sample effects: flame ring, rainbow helix, heart halo, magic vortex, firework burst, snow cloud, atom, star crown and laser beam.


Sharing effects
- Run
/pp export <effect>. The file is written to plugins/ProxyParticle/exports/.
- Send the file, or post it on pastebin or GitHub.
- On the other server, put it in
plugins/ProxyParticle/imports/ and run /pp import all, or run /pp import <link>.

Commands
The main command is /pp (aliases /proxyparticle, /pparticle). Everything tab-completes.
| Command |
What it does |
/pp or /pp editor [effect] |
Open the editor |
/pp list, /pp info <effect> |
Browse effects |
/pp play <effect> [player|here] [loop] |
Play an effect |
/pp stop [player|all] |
Stop effects |
/pp create <name> |
Create an effect |
/pp clone <from> <to> |
Copy an effect |
/pp rename <old> <new> |
Rename an effect |
/pp delete <name> |
Delete an effect (a backup is kept) |
/pp layer <effect> add|remove <n>|list |
Manage layers |
/pp set <effect> <layer#|effect> <key> <value> |
Change any setting |
/pp get <effect> [layer#] |
Show all settings |
/pp keys, /pp particles |
List setting keys and particles |
/pp export <effect|all> |
Write JSON to exports/ |
/pp import <file|all|link> [name] |
Import JSON |
/pp place <effect> [id] |
Place a permanent effect |
/pp unplace [id] |
Remove a placed effect |
/pp placed [name] |
Clickable list of placed effects, nearest first |
/pp movehere [id] |
Move a placed effect to you |
/pp moveto <player> [id] |
Move a placed effect to a player |
/pp adjust <x|y|z|yaw> <+0.25|-0.25> [id] |
Nudge a placed effect |
/pp select [id|nearest] |
Choose which placed effect to edit |
/pp setid <placed> <id|none> |
Give a placed effect your own id |
/pp tp <id> |
Teleport to a placed effect |
/pp reload, /pp stats |
Admin |
Permissions
All permissions default to OP.
| Permission |
Allows |
proxyparticle.use |
List effects, play them on yourself, stop your own |
proxyparticle.play.others |
Play and stop effects on other players |
proxyparticle.edit |
Editor, create, edit, clone, rename, export |
proxyparticle.import |
Import from files and links |
proxyparticle.admin |
Everything above, plus delete, place, stop all and reload |
Placeholders
Requires PlaceholderAPI 2.11 or newer. The expansion registers itself.
| Placeholder |
Value |
%proxyparticle_effects_total% |
Effects on the server |
%proxyparticle_placed_total% |
Placed effects |
%proxyparticle_running_total% |
Effects playing right now |
%proxyparticle_particles_live% |
Simulated particles alive |
%proxyparticle_active% |
Effects playing on the player |
%proxyparticle_active_ids% |
Their ids (none if empty) |
%proxyparticle_active_names% |
Their display names |
%proxyparticle_is_active% |
true or false |
%proxyparticle_is_active_<effect>% |
Whether that effect is playing on the player |
%proxyparticle_previewing% |
Effect the player is previewing in the editor |
%proxyparticle_selected% |
The player's selected placed effect |
%proxyparticle_selected_effect% |
Which effect the selected placed effect plays |
%proxyparticle_effect_<effect>_<field>% |
name, name_plain, author, description, layers, duration or exists |
%proxyparticle_placed_<id>_<field>% |
effect, world, x, y, z or exists |

Requirements
- Spigot, Paper or Purpur, Minecraft 1.21.0 or newer (including 26.x)
- Java 21
- Optional: PlaceholderAPI 2.11 or newer
- Folia is not supported
Installation
- Put
ProxyParticle.jar in your plugins folder and restart the server.
- Run
/pp to open the editor. The 9 sample effects are ready to play.
- Right-click an effect to play it on yourself, left-click to edit it.
Support
SUPPORT_LINE
评论 0
登录后参与评分
还没有评论,来抢沙发吧