mirror of
https://github.com/KAMKEEL/CustomNPC-Plus-API.git
synced 2026-11-17 05:15:12 +00:00
Energy Explosion API and some changes to Energy Projectile API
This commit is contained in:
1 parent
e4e2466a6e
commit
4e96425314
3 files changed
+74
-5
No files matched your search
@@ -0,0 +1,60 @@
|
||||
package noppes.npcs.api.entity;
|
||||
|
||||
import net.minecraft.entity.Entity;
|
||||
import noppes.npcs.api.INbt;
|
||||
|
||||
/**
|
||||
* Represents a standalone energy explosion entity.
|
||||
* Created via {@link noppes.npcs.api.IEnergyController#createExplosion}.
|
||||
* Configure visual/damage properties, then call {@link #spawn()} to place in the world.
|
||||
*
|
||||
* When damage is set (> 0), the explosion will deal area damage on the first tick
|
||||
* with distance-based falloff, routing through energy damage handlers for addon integration.
|
||||
*/
|
||||
public interface IEnergyExplosion<T extends Entity> extends IEnergyAbility<T> {
|
||||
|
||||
// ==================== RADIUS & DURATION ====================
|
||||
|
||||
/** @return The maximum explosion radius in blocks. */
|
||||
float getRadius();
|
||||
|
||||
/** @param radius Maximum explosion radius in blocks (clamped 0.5-50). Duration auto-scales. */
|
||||
void setRadius(float radius);
|
||||
|
||||
/** @return Duration of the explosion visual in ticks (auto-calculated from radius). */
|
||||
int getDuration();
|
||||
|
||||
// ==================== DAMAGE ====================
|
||||
|
||||
/** @return Base damage dealt at the center. 0 means visual-only. */
|
||||
float getDamage();
|
||||
|
||||
/** @param damage Base damage at the center. Setting > 0 enables damage. */
|
||||
void setDamage(float damage);
|
||||
|
||||
/** @return Base knockback strength. */
|
||||
float getKnockback();
|
||||
|
||||
/** @param knockback Base knockback strength. */
|
||||
void setKnockback(float knockback);
|
||||
|
||||
/** @return Upward knockback component. */
|
||||
float getKnockbackUp();
|
||||
|
||||
/** @param knockbackUp Upward knockback component. */
|
||||
void setKnockbackUp(float knockbackUp);
|
||||
|
||||
/** @return Damage falloff factor (0=no falloff, 1=full falloff at edge). */
|
||||
float getDamageFalloff();
|
||||
|
||||
/** @param falloff Damage falloff factor (0-1). At 0.5, edge damage = 50% of center. */
|
||||
void setDamageFalloff(float falloff);
|
||||
|
||||
// ==================== SPAWNING ====================
|
||||
|
||||
/**
|
||||
* Spawn this explosion entity into the world.
|
||||
* Sends the visual to nearby clients and, if damage > 0, applies area damage on the first tick.
|
||||
*/
|
||||
void spawn();
|
||||
}
|
||||
Reference in new issue
Block a user