mc-particle v1.20.1A

Immutable. This exact content is served forever at /api/v1/blob/4a9cd23eb37afa98.

---
name: mc-particle
description: Fabric 粒子系统。ParticleType、ParticleHandler、DefaultParticleType。触发词：粒子、Particle、ParticleType
platform: fabric
version: "1.20.1"
dependencies: []
mappings: yarn
---

# 粒子系统（Fabric 1.20.1）

## 快速开始

```java
// 1. 创建粒子类型
public class MyParticleType extends DefaultParticleType {
    public MyParticleType() {
        super(true);  // alwaysShow = true
    }
}

// 2. 注册粒子
private static final RegistrySupplier<ParticleType<?>> MY_PARTICLE =
    Registry.register(
        Registries.PARTICLE_TYPE,
        new Identifier(MOD_ID, "my_particle"),
        new MyParticleType()
    );

// 3. 注册粒子工厂（客户端）
public class ExampleModClient implements ClientModInitializer {
    @Override
    public void onInitializeClient() {
        ParticleFactoryRegistry.INSTANCE.register(
            (ParticleType<MyParticle>) MY_PARTICLE.get(),
            MyParticle.Factory::new
        );
    }
}
```

## 常见错误

- ❌忘记在客户端注册粒子工厂 — 粒子不显示
- ❌粒子工厂在服务端执行 — 粒子是客户端的

## 扩展点

| 配合 Skill | 协作说明 |
|-----------|---------|
| `mc-registry` | 粒子类型通过 Registry.register() 注册 |
| `mc-entity` | 实体可以生成粒子 |