package com.minelittlepony.unicopia.ability; import javax.annotation.Nullable; import com.google.gson.annotations.Expose; import com.minelittlepony.unicopia.IKeyBinding; import com.minelittlepony.unicopia.Race; import com.minelittlepony.unicopia.entity.player.IPlayer; import net.minecraft.util.math.BlockPos; import net.minecraft.world.World; public interface Ability extends IKeyBinding { @Override default String getKeyCategory() { return "unicopia.category.name"; } /** * Returns the number of ticks the player must hold the ability key to trigger this ability. */ int getWarmupTime(IPlayer player); /** * Returns the number of ticks allowed for cooldown */ int getCooldownTime(IPlayer player); /** * Called to check preconditions for activating the ability. * * @param w The world * @param player The player * @return True to allow activation */ default boolean canActivate(World w, IPlayer player) { return true; } /** * Checks if the given race is permitted to use this ability * @param playerSpecies The player's species */ boolean canUse(Race playerSpecies); /** * Called on the client to activate the ability. * * @param player The player activating the ability * @return Data to be sent, or null if activation failed */ @Nullable T tryActivate(IPlayer player); Class getPackageType(); /** * Called to actually apply the ability. * Only called on the server side. * * @param player The player that triggered the ability * @param data Data previously sent from the client */ void apply(IPlayer player, T data); /** * Called every tick until the warmup timer runs out. * @param player The current player */ void preApply(IPlayer player); /** * Called every tick until the cooldown timer runs out. * @param player The current player */ void postApply(IPlayer player); public interface IData { } class Pos implements Ability.IData { @Expose public int x; @Expose public int y; @Expose public int z; public Pos(int x, int y, int z) { this.x = x; this.y = y; this.z = z; } public Pos(BlockPos pos) { x = pos.getX(); y = pos.getY(); z = pos.getZ(); } public BlockPos pos() { return new BlockPos(x, y, z); } } class Hit implements Ability.IData { } class Numeric implements IData { @Expose public int type; public Numeric(int t) { type = t; } } }