EntityWhiteSparkleFXProvider
⚠️ 它不是 Minecraft 世界实体。 这是 LogisticsPipes 的客户端粒子颜色工厂, 只在客户端渲染时使用。没有生命值、没有碰撞箱、没有生成条件、不能被召唤。 归入
entity目录属分类定性错误(已订正)。
基本信息
| 属性 | 值 |
|---|---|
| 真实类别 | 客户端粒子工厂(实现 ParticleProvider),非世界实体 |
| 源码包 | logisticspipes.pipefxhandlers.providers |
| 实现接口 | logisticspipes.pipefxhandlers.ParticleProvider |
| 父类 | 无(接口实现,不继承 EntityFX) |
| 注册名 | 无。全项目零 EntityRegistry 调用,LP 不注册任何世界实体 |
| 产出粒子 | EntitySparkleFX(唯一粒子类) |
颜色
| 分量 | 值 |
|---|---|
| red | 1 |
| green | 1 |
| blue | 1 |
EntityWhiteSparkleFXProvider 是 9 个 Provider 中唯一不自持 RGB 的:它不定义自己的
red/green/blue 字段,而是直接用接口 ParticleProvider 的接口常量
red = 1 / green = 1 / blue = 1(pipefxhandlers/ParticleProvider.java:7-9)。
⚠️ 因此类体是空的 —— 这不是漏写,是设计如此。
注册
注册点:proxy/side/ClientProxy.java:145-156
PipeFXRenderHandler.registerParticleHandler(Particles.WhiteParticle, new EntityWhiteSparkleFXProvider());
对应的 Particles 枚举值共 9 个(pipefxhandlers/Particles.java),
没有 Yellow。源码注释给出的颜色语义(Particles.java 注释块):
| 颜色 | 语义 |
|---|---|
| Blue | Sink 回复 |
| Orange | 抽取 |
| Violet | 提供 / 请求 |
| Gold | 使用能量 |
| Green | 渲染更新 |
| Red | 能量状态变化 |
| White | 特殊情况 |
方法
| 方法 | 签名 | 行为 |
|---|---|---|
createGenericParticle |
(WorldClient, double x, double y, double z, int amount) |
委托 GenericSparkleFactory.getSparkleInstance(...),把本类的 RGB 常量传入 |
🐛 注意
- 类名以
Entity开头、字段也命名EntityXXX(注册表用),但不是实体。 - 不要给白色 Provider 编造独立颜色字段,源码里没有。
第三方集成
| 集成 Mod | 集成类型 | 功能 |
|---|---|---|
| Minecraft Forge | 粒子渲染 | 通过 EntityFX 渲染(非 mod 依赖) |