Harbinger项目中的自定义状态效果开发指南

状态效果基础概念

在Harbinger项目中，状态效果（Potion）是指能够影响实体行为的特殊效果，类似于原版游戏中的药水效果。这些效果可以给玩家或生物带来各种增益或减益，如加速、隐身、中毒等。理解如何创建和自定义状态效果是扩展游戏玩法的重要环节。

创建自定义状态效果

要创建一个新的状态效果，我们需要继承Potion类并实现其基本结构：

public class CustomEffect extends Potion {
    public CustomEffect(boolean isNegative, int color) {
        super(isNegative, color);
        // isNegative参数决定这是否为负面效果
        // color参数是效果的RGB颜色值
    }
}

构造函数中的两个关键参数：

1. isNegative：布尔值，表示这是否为负面效果（如中毒、虚弱等）
2. color：整型RGB值，定义效果在HUD中显示的颜色

注册状态效果

与游戏中的其他元素一样，状态效果需要通过注册系统进行注册：

@SubscribeEvent
public static void registerEffects(RegistryEvent.Register<Potion> event) {
    event.getRegistry().register(
        new CustomEffect(true, 0xFF0000)  // 红色负面效果
            .setRegistryName("example_mod", "custom_effect")
    );
}

注册时需要注意命名空间的唯一性，避免与其他mod冲突。

应用状态效果

开发过程中，我们可以通过多种方式测试和应用状态效果：

1. 命令测试：使用游戏内命令快速测试效果

   /effect <玩家名> example_mod:custom_effect 1 60
   

2. 代码应用：在游戏逻辑中动态添加效果

   // 持续时间以tick为单位(20tick=1秒)
   // 效果等级从0开始(0=等级1)
   entity.addPotionEffect(new PotionEffect(
       customEffect,  // 效果实例
       1200,         // 持续时间(60秒)
       0             // 效果等级
   ));
   

自定义效果图标

原版的状态效果图标系统存在局限性，Harbinger项目推荐使用Forge提供的扩展方案来实现更灵活的图标渲染：

@Override
public boolean hasStatusIcon() {
    return false;  // 禁用原版图标系统
}

@Override
public void renderHUDEffect(int x, int y, PotionEffect effect, 
                          Minecraft mc, float alpha) {
    // 绑定自定义纹理
    mc.getTextureManager().bindTexture(CUSTOM_ICON_TEXTURE);
    
    // 绘制图标
    Gui.drawModalRectWithCustomSizedTexture(
        x, y,          // 屏幕坐标
        0, 0,          // 纹理起始坐标
        18, 18,        // 绘制区域大小
        256, 256       // 纹理总尺寸
    );
}

高级效果实现

在Harbinger项目中，我们可以通过重写Potion类的方法来实现更复杂的效果：

1. 持续效果逻辑：通过performEffect方法实现每tick执行的效果

   @Override
   public void performEffect(EntityLivingBase entity, int amplifier) {
       // 每tick执行的逻辑
       if(entity instanceof EntityPlayer) {
           // 对玩家特定的效果处理
       }
   }
   

2. 效果激活/失效：通过onStarted和onEnded方法处理效果开始和结束时的逻辑

   @Override
   public void onStarted(EntityLivingBase entity, int amplifier) {
       // 效果激活时的初始化
   }
   
   @Override
   public void onEnded(EntityLivingBase entity, int amplifier) {
       // 效果结束时的清理工作
   }
   

效果组合与冲突

在开发复杂的状态效果时，需要考虑效果间的相互作用：

// 设置效果冲突
setBeneficial();  // 标记为有益效果
// 或者与其他效果明确冲突
setPotionName("effect.conflict").setEffectiveness(0.5F);

性能优化建议

1. 避免在performEffect中执行昂贵的操作
2. 对于长时间持续的效果，考虑使用tick计数器减少计算频率
3. 合理使用效果缓存，避免重复创建PotionEffect实例

通过Harbinger项目提供的这些扩展点，开发者可以创建出比原版更加丰富和复杂的状态效果系统，为游戏玩法带来更多可能性。