Menu
PasterDream模组药水效果注册专用API，提供Facade+Builder模式一键注册自定义MobEffect。在需要创建新状态效果、配置效果属性/着色器/粒子/回调/药水酿造时调用。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | pasterdream-effect-api |
| description | PasterDream模组药水效果注册专用API，提供Facade+Builder模式一键注册自定义MobEffect。在需要创建新状态效果、配置效果属性/着色器/粒子/回调/药水酿造时调用。 |
本 Skill 提供 PasterDream 模组药水效果（MobEffect）注册专用 API 的使用指南，采用 Facade + Builder 模式（与 BlockAPI / EntityAPI / ParticleAPI 风格一致），通过链式调用即可完成状态效果的类型注册、属性配置和资源引用。
// ====== 在 PDEffects.java（或任意注册类）中注册效果 ======
MobEffectResult dreamwish = MobEffectAPI.createEffect("dreamwish_buff")
.beneficial() // 有益效果
.color(0xFFFA8CE6) // 粉红色
.build();
// ====== 在其他地方获取效果引用 ======
MobEffectResult result = MobEffectAPI.getEffect("dreamwish_buff");
if (result != null) {
MobEffect effect = result.effect(); // 获取 MobEffect 实例
}
在 PasterDreamMod 构造函数中注册 MobEffectAPI 的 REGISTRY：
public PasterDreamMod(IEventBus modEventBus) {
// ... 其他注册器 ...
MobEffectAPI.REGISTRY.register(modEventBus);
}
MobEffectAPI ← Facade 门面
├── createEffect(name) ← 工厂方法 → MobEffectBuilder
├── getEffect(name) ← 查询 MobEffectResult
├── getEffectType(name) ← 查询 MobEffect 直接引用
├── getEffectSupplier(name) ← 查询 MobEffect Supplier
├── getPasterDreamEffect(name) ← 查询 PasterDreamEffect 强类型引用
├── getRegisteredEffects() ← 所有已注册效果的不可变视图
└── REGISTRY ← DeferredRegister<MobEffect>
MobEffectBuilder ← Builder 构建器
├── beneficial() / harmful() / neutral() / category() ← 分类
├── color(int) ← 效果颜色（十六进制）
├── instant() ← 瞬时效果（如瞬间治疗）
├── shaderTexture(ResourceLocation) ← 屏幕着色器
├── particleType(ParticleType<?>) ← 粒子联动
├── onTick(ObjIntConsumer) ← 每 tick 回调
├── onApply(BiConsumer) ← 应用回调
├── onRemove(BiConsumer) ← 移除回调
├── stackingHandler(BiFunction) ← 叠加处理
├── builder(name) ← 静态工厂方法
└── build() ← 注册 + 缓存 → MobEffectResult
MobEffectResult ← Record 结果
├── name() → String（注册名）
├── holder() → DeferredHolder<MobEffect, MobEffect>
├── typeSupplier() → Supplier<MobEffect>
├── effect() → MobEffect
└── asPasterDreamEffect() → PasterDreamEffect / null
PasterDreamEffect ← MobEffect 子类
├── getConfig() → EffectConfig
├── getShaderTexture() → ResourceLocation / null
├── getEffectParticleType() → ParticleType<?> / null
├── spawnEffectParticles(...) → 生成效果粒子
├── onApply(entity, amp) → 应用时回调
├── onRemove(entity, amp) → 移除时回调
├── handleStacking(existing, new) → 叠加处理
└── EffectConfig ← 内部配置类（Builder 模式）
├── builder() → EffectConfig.Builder
├── DEFAULT → 默认空配置
└── 支持 shaderTexture / particleType / onTick / onApply / onRemove / stackingHandler
| 方法 | 参数 | 说明 |
|---|---|---|
beneficial() | — | 设置为有益效果 |
harmful() | — | 设置为有害效果 |
neutral() | — | 设置为中性效果 |
category(MobEffectCategory) | 分类 | 直接设置效果分类 |
color(int) | 十六进制颜色 | 效果颜色（如 0xFF69B4） |
instant() | — | 标记为瞬时效果（如瞬间治疗/伤害） |
shaderTexture(ResourceLocation) | 资源路径 | 屏幕后期着色器纹理 |
particleType(ParticleType<?>) | 粒子类型 | 与 ParticleAPI 联动 |
onTick(ObjIntConsumer<LivingEntity>) | (entity, amp) -> {} | 每 tick 逻辑 |
onApply(BiConsumer<LivingEntity, Integer>) | (entity, amp) -> {} | 应用时回调 |
onRemove(BiConsumer<LivingEntity, Integer>) | (entity, amp) -> {} | 移除时回调 |
stackingHandler(BiFunction<MobEffectInstance, MobEffectInstance, MobEffectInstance>) | (existing, newInstance) -> result | 叠加行为自定义 |
| 方法 | 说明 |
|---|---|
MobEffectBuilder.builder(String name) | 直接创建构建器（无需通过 MobEffectAPI） |
// 简单的有益标记效果，无额外逻辑
MobEffectResult dreamwish = MobEffectAPI.createEffect("dreamwish_buff")
.beneficial()
.color(0xFFFA8CE6)
.build();
MobEffectResult dreamwish = MobEffectAPI.createEffect("dreamwish_buff")
.beneficial()
.color(0xFF69B4)
.shaderTexture(new ResourceLocation("pasterdream", "shaders/post/dreamwish.json"))
.particleType(ParticleTypes.END_ROD)
.build();
MobEffectResult expup = MobEffectAPI.createEffect("expup_buff")
.beneficial()
.color(0xFFABABD5)
.onTick((entity, amplifier) -> {
// 每 tick 1/1000 概率给 1 点经验
if (Mth.nextInt(RandomSource.create(), 1, 1000) <= 10) {
if (entity instanceof Player player) {
player.giveExperiencePoints(1);
}
}
})
.onApply((entity, amp) -> entity.heal(5))
.onRemove((entity, amp) -> {
entity.hurt(entity.damageSources().magic(), 2);
})
.build();
MobEffectResult stackingEffect = MobEffectAPI.createEffect("stacking_demo")
.beneficial()
.color(0xFFFF9F6A)
.stackingHandler((existing, newInstance) -> {
// 叠加时延长持续时间（上限 6000 ticks）
int totalDuration = existing.getDuration() + newInstance.getDuration();
existing.duration = Math.min(totalDuration, 6000);
return existing;
})
.build();
MobEffectResult confusion = MobEffectAPI.createEffect("confusion_buff")
.harmful()
.color(0xFF4A0080)
.build();
MobEffectResult silence = MobEffectAPI.createEffect("shadow_silence_buff")
.harmful()
.color(0xFF2A0040)
.build();
在 PDPotions.java 中注册可酿造药水，与已注册的 MobEffect 联动：
public class PDPotions {
public static final DeferredRegister<Potion> POTIONS = DeferredRegister.create(
Registries.POTION, PasterDreamMod.MOD_ID);
// 梦境祝福药水（3 分钟 = 3600 ticks）
public static final DeferredHolder<Potion, Potion> DREAMWISH_POTION =
POTIONS.register("dreamwish_potion",
() -> new Potion(new MobEffectInstance(
PDEffects.DREAMWISH_BUFF.holder(), 3600, 0, false, true)));
// 经验提升药水（3 分钟 = 3600 ticks）
public static final DeferredHolder<Potion, Potion> EXPUP_POTION =
POTIONS.register("expup_potion",
() -> new Potion(new MobEffectInstance(
PDEffects.EXPUP_BUFF.holder(), 3600, 0, false, true)));
}
// 通过名称查询 MobEffectResult
MobEffectResult result = MobEffectAPI.getEffect("dreamwish_buff");
if (result != null) {
MobEffect effect = result.effect();
}
// 直接获取 MobEffect 引用（无结果时返回 null）
MobEffect effect = MobEffectAPI.getEffectType("dreamwish_buff");
// 获取 Supplier 形式（延迟获取）
Supplier<MobEffect> supplier = MobEffectAPI.getEffectSupplier("dreamwish_buff");
// 获取 PasterDreamEffect 强类型引用（可访问自定义配置）
PasterDreamEffect pde = MobEffectAPI.getPasterDreamEffect("dreamwish_buff");
if (pde != null) {
ResourceLocation shader = pde.getShaderTexture();
ParticleType<?> particle = pde.getEffectParticleType();
}
// 获取所有已注册效果
Map<String, MobEffectResult> all = MobEffectAPI.getRegisteredEffects();
category 和 color 为必填参数，缺少任一会在 build() 时抛出 IllegalStateExceptionMobEffectAPI.REGISTRY.register(modEventBus);PasterDreamEffect 类不包含任何客户端专属类型引用，确保服务端兼容DeferredRegister<Potion>，通过 MobEffectInstance 与效果联动Guides API-Split multi-module architecture decisions for NeoPasterDream (NeoForge 1.21.1). Invoke when deciding where to place new code (PasterDreamAPI vs PasterDream), creating Builder/Facade/Result/Config classes, or designing new registration systems.
PasterDream模组实体注册专用API，提供Facade+Builder模式一键注册自定义实体。在需要创建新实体、配置实体属性/AI/碰撞箱/追踪范围/生物技能、动画系统或注册渲染器时调用。
PasterDream NeoForge 1.21.1 模组开发指南。提供项目结构、注册系统、实体系统、物品系统等的开发规范，以及常见崩溃问题的解决方案。Invoke when developing or modifying PasterDream mod features, creating new items/blocks/entities, fixing crashes, or when needing to understand the mod's architecture.
PasterDream 物品移植 API —— 用于将原 FixPasterDream 模组（MCreator 生成）中的物品系统化移植到 NeoForge 1.21.1。提供 Builder 模式、批量注册、迁移追踪、配方生成、战利品表生成、方块数据生成、创造标签页生成、语言文件生成及超级快速导入器等一站式工具链。Invoke when needing to port items from the old FixPasterDream mod, register new items in PDItems.java, batch-create items with consistent patterns, generate recipes/loot tables/block tags, or create creative tab registration code.
Minecraft NeoForge 1.21.1 方块掉落问题诊断与修复指南。Invoke when user encounters block drop issues, missing loot drops, or needs to implement custom block drops. Covers getDrops() override, BlockItem registration, and loot table JSON troubleshooting.
PasterDream模组维度注册专用API，提供Facade+Builder模式一键注册自定义维度。在需要创建新维度、配置维度类型/生物群系/背景音乐或生成维度JSON时调用。