粒子窥视

ParticlePeek

在输入 /particle 之前，先看看粒子到底是什么样子。

ParticlePeek 是一个轻量级的 客户端 工具，专为地图制作者、数据包创作者、命令方块用户和服务器建造者设计。告别猜测粒子名称和反复执行相同命令——在游戏中浏览、搜索并预览每个粒子，然后复制一条立即可用的命令。

✨ 功能特性

浏览与搜索

• 🔎 粒子浏览器 — 通过 /particlepeek 或快捷键打开。列出所有已注册的粒子，包括原版和模组粒子（从游戏注册表中实时读取，无需硬编码）。
• ⌨️ 按名称或命名空间搜索；每个条目都会显示其命名空间。
• ⭐ 收藏夹 — 为你最常用的粒子标星；它们会排在顶部，并在会话间保持记忆。
• 🖼️ 无处不在的图标 — 浏览器中每个粒子名称旁和 /particle 自动补全中的每个建议旁都会显示一个小的粒子精灵图，让你一眼就能找到正确的粒子。

真实预览

• 🎬 粒子的实际纹理，显示其真实颜色（例如 dripping_lava 是橙色的——直接从粒子本身读取，而非猜测）……
• 🌀 ……配合实时动画 — 一个真实的粒子会被 tick 驱动，因此预览会像真实粒子一样漂移/下落/淡出，并循环播放。你可随时播放/暂停。

构建与测试

• 🛠️ 参数编辑器 — 对于需要额外数据的粒子（dust、block、item、dust_color_transition 等），可直接在面板中编辑参数。输入会实时验证（使用游戏自身的粒子解析器，因此同样适用于模组粒子），并转化为一条完全正确的命令。
• ⚡ 本地测试 — 在你面前生成该粒子（或你配置的粒子），纯客户端操作，无需服务器。
• 📋 复制 /particle 命令 — 每次都能得到一条正确且可直接粘贴的命令。

🧩 客户端专用——无需安装服务器端

ParticlePeek 完全在你的客户端上运行。你可以在单人游戏或任何多人服务器（原版或模组）中使用，无需在服务器端安装。它永远不会因遇到未知或模组粒子而崩溃。

📦 运行需求

• Minecraft 1.21.8 — Fabric 版本
• Fabric API
• Java 21

🎮 使用方法

1. 安装 Fabric Loader + Fabric API，然后将 ParticlePeek 放入你的 mods 文件夹。
2. 进入游戏，输入 /particlepeek — 或通过 选项 → 控制 → ParticlePeek 绑定快捷键。
3. 搜索、观看预览、调整参数，然后本地测试或复制命令。