mirror of
https://github.com/KAMKEEL/CustomNPC-Plus-API.git
synced 2026-11-16 09:34:47 +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
@@ -1,6 +1,7 @@
|
||||
package noppes.npcs.api;
|
||||
|
||||
import noppes.npcs.api.entity.*;
|
||||
import noppes.npcs.api.entity.IEnergyExplosion;
|
||||
|
||||
/**
|
||||
* Central controller for creating energy entities and routing energy damage.
|
||||
@@ -63,4 +64,12 @@ public interface IEnergyController {
|
||||
* Panels are flat energy barriers that can deal damage on contact.
|
||||
*/
|
||||
IEnergyPanel createPanel(IWorld world, IEntity owner, double x, double y, double z);
|
||||
|
||||
// ==================== EXPLOSION CREATION ====================
|
||||
|
||||
/**
|
||||
* Create an energy explosion entity. Not spawned until spawn() is called.
|
||||
* Visual-only by default. Set damage > 0 to enable area damage with falloff.
|
||||
*/
|
||||
IEnergyExplosion createExplosion(IWorld world, IEntity owner, double x, double y, double z, float radius);
|
||||
}
|
||||
@@ -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();
|
||||
}
|
||||
@@ -139,27 +139,27 @@ public interface IEnergyProjectile<T extends Entity> extends IEnergyAbility<T> {
|
||||
/**
|
||||
* Spawns the projectile in the world (if not yet spawned) and starts it moving toward the target entity.
|
||||
*/
|
||||
void fire(IEntity target);
|
||||
void fireAt(IEntity target);
|
||||
|
||||
/**
|
||||
* Spawns the projectile in the world (if not yet spawned) and starts it moving toward the specified coordinates.
|
||||
*/
|
||||
void fire(double x, double y, double z);
|
||||
void fireAt(double x, double y, double z);
|
||||
|
||||
/**
|
||||
* Spawns the projectile in the world (if not yet spawned) and starts it moving in the specified direction.
|
||||
*/
|
||||
void fire(float yaw, float pitch);
|
||||
void fireDirection(float yaw, float pitch);
|
||||
|
||||
/**
|
||||
* Sets the owner, positions the projectile at the caster's eye level, and fires in the caster's look direction.
|
||||
* Convenience method similar to how fireKiAttack works.
|
||||
*/
|
||||
void fire(IEntityLivingBase caster);
|
||||
void fireFrom(IEntityLivingBase caster);
|
||||
|
||||
/**
|
||||
* Sets the owner, positions the projectile at the caster's eye level, and fires toward the target entity.
|
||||
*/
|
||||
void fire(IEntityLivingBase caster, IEntity target);
|
||||
void fireFrom(IEntityLivingBase caster, IEntity target);
|
||||
|
||||
}
|
||||
Reference in new issue
Block a user