Собственные события. Часть первая: Создание

public class ItemUsedEvent extends Event {
  
    /**
     * ItemUsedEvent срабатывает когда EntityLivingBase завершает использование предмета.<br>
     * Срабатывает через {@link DemoEventsInjection#onLivingUseItem(LivingEntityUseItemEvent.Tick)}<br>
     * <br>
     * {@link #livingBase} EntityLivingBase, использовавшую предмет.<br>
     * {@link #itemStack} используемый предмет.<br>
     * <br>
     * Это событие нельзя отменить. {@link Cancelable}. <br>
     * <br>
     * Это событие не имеет результата. {@link HasResult}<br>
     * <br>
     * Это событие использует {@link MinecraftForge#EVENT_BUS}.<br>
     **/
  
    private final EntityLivingBase livingBase;

    private final ItemStack itemStack;

    public ItemUsedEvent(EntityLivingBase livingBase, ItemStack itemStack) {
      
        this.livingBase = livingBase;
        this.itemStack = itemStack;
    }
  
    public EntityLivingBase getEntityLiving() {
      
        return this.livingBase;
    }
  
    public ItemStack getItemStack() {
      
        return this.itemStack;
    }
}

public class DemoEventFactory {

    /*
     * Статические методы для внедрения в стандартные события для демонстрации.
     */
  
    public static void onLivingFinishesUsingItem(EntityLivingBase livingBase, ItemStack itemStack) {
      
        //Вызов события.
        MinecraftForge.EVENT_BUS.post(new ItemUsedEvent(livingBase, itemStack));
    }
}

@EventBusSubscriber(modid = EventsMain.MODID)
public class DemoEventsInjection {
  
    /*
     * Демонстрационные хуки собственных простых событий.
     * Созданы для симуляции настоящих.
     */

    @SubscribeEvent
    public static void onLivingUseItem(LivingEntityUseItemEvent.Tick event) {         
          
        if (event.getEntityLiving().getItemInUseCount() == 1) {//За тик до окончания использования предмета.
                      
            //Вызов статического метода фабрики для запуска события.
            DemoEventFactory.onLivingFinishesUsingItem(event.getEntityLiving(), event.getItem());
        }
    }
}

@EventBusSubscriber(modid = EventsMain.MODID)
public class CustomEvents {

    @SubscribeEvent
    public static void onPlayerUsedItem(ItemUsedEvent event) {     
      
        //Только на сервере, только для игрока и при поедании еды.
        if (!event.getEntityLiving().world.isRemote && event.getEntityLiving() instanceof EntityPlayer && event.getItemStack().getItem() instanceof ItemFood) {
                      
            //Отправка игроку сообщения с названиеим съеденного предмета.
            ((EntityPlayer) event.getEntityLiving()).sendMessage(new TextComponentTranslation("event.itemUsed", event.getItemStack().getDisplayName()));
        }
    }
}

@Cancelable
public class OpenInventoryEvent extends Event {
  
    /**
     * OpenInventoryEvent срабатывает когда игрок открывает инвентарь.<br>
     * Срабатывает через {@link DemoEventsInjection#onInventoryOpen(GuiOpenEvent)}<br>
     * <br>
     * Это событие можно отменить. {@link Cancelable}. <br>
     * Отмена предотвратит открытие инвентаря.<br>
     * <br>
     * Это событие не имеет результата. {@link HasResult}<br>
     * <br>
     * Это событие использует {@link MinecraftForge#EVENT_BUS}.<br>
     **/

    public OpenInventoryEvent() {}
}

public class DemoEventFactory {

    /*
     * Статические методы для внедрения в стандартные события для демонстрации.
     */

    public static boolean onPlayerOpenInventory() {
      
        //Вернёт true при отмене события OpenInventoryEvent.
        return MinecraftForge.EVENT_BUS.post(new OpenInventoryEvent());
    }
}

@EventBusSubscriber(modid = EventsMain.MODID)
public class DemoEventsInjection {
  
    /*
     * Демонстрационные хуки собственных простых событий.
     * Созданы для симуляции настоящих событий.
     */
  
    @SubscribeEvent
    public static void onInventoryOpen(GuiOpenEvent event) {         
      
        if (event.getGui() instanceof GuiInventory) {
                      
            //Вызов события.
            //Если OpenInventoryEvent будет отменено, это событие так же прервётся.
            event.setCanceled(DemoEventFactory.onPlayerOpenInventory());
        }
    }
}

@EventBusSubscriber(modid = EventsMain.MODID)
public class CustomEvents {

    @SubscribeEvent
    @SideOnly(Side.CLIENT) 
    public static void onPlayerOpenInventory(OpenInventoryEvent event) {
      
        //Если у игрока занята правая рука, то он не сможет открыть инвентарь.
        if (Minecraft.getMinecraft().player.getHeldItemMainhand().getItem() != Items.AIR) {
                      
            //Отмена собственного события.
            event.setCanceled(true);
        }
    }
}

@Cancelable
public class PlayerFallEvent extends Event {

    /**
     * PlayerFallEvent срабатывает когда грок приземляется после падения.<br>
     * Срабатывает через {@link DemoEventsInjection#onPlayerFall(LivingFallEvent)}<br>
     * <br>
     * {@link #player} упавший игрок.<br>
     * {@link #distance} дистанция падения.<br>
     * <br>
     * Это событие можно отменить. {@link Cancelable}. <br>
     * При отмене игрок не получит урона от падения.<br>
     * <br>
     * Это событие не имеет результата. {@link HasResult}<br>
     * <br>
     * Это событие использует {@link MinecraftForge#EVENT_BUS}.<br>
     **/
  
    private final EntityPlayer player;
  
    private float distance;
  
    public PlayerFallEvent(EntityPlayer player, float distance) {
      
        this.player = player;
        this.distance = distance;
    }
  
    public EntityPlayer getPlayer() {
      
        return this.player;
    }
  
    public float getDistance() {
      
        return this.distance;
    }
  
    public void setDistance(float distance) {
      
        this.distance = distance;
    }
}

public class DemoEventFactory {

    /*
     * Статические методы для внедрения в стандартные события для демонстрации.
     */
  
    public static float onPlayerFall(EntityPlayer player, float distance) {
      
        PlayerFallEvent event = new PlayerFallEvent(player, distance);
      
        //При отмене вернёт нулевую дистанцию падения, иначе возможно изменённую.
        return MinecraftForge.EVENT_BUS.post(event) ? 0.0F : event.getDistance();
    }
}

@EventBusSubscriber(modid = EventsMain.MODID)
public class DemoEventsInjection {
  
    /*
     * Демонстрационные хуки собственных простых событий.
     * Созданы для симуляции настоящих.
     */
  
    @SubscribeEvent
    public static void onLivingFall(LivingFallEvent event) {
      
        if (event.getEntityLiving() instanceof EntityPlayer) {
          
            //Вызов события.
            float distance = DemoEventFactory.onPlayerFall((EntityPlayer) event.getEntityLiving(), event.getDistance());
          
            //Установка дистанции падения.
            event.setDistance(distance);
          
            //Отмена события.
            event.setCanceled(distance == 0.0F);
        }
    }
}

@EventBusSubscriber(modid = EventsMain.MODID)
public class CustomEvents { 

    @SubscribeEvent
    public static void onPlayerFall(PlayerFallEvent event) {

        //Уменьшение высоты падения для смягчения урона в два раза.
        event.setDistance(event.getDistance() / 2);
    }
}