diff --git a/java/noppes/npcs/api/IEnergyController.java b/java/noppes/npcs/api/IEnergyController.java new file mode 100644 index 0000000..d6fc769 --- /dev/null +++ b/java/noppes/npcs/api/IEnergyController.java @@ -0,0 +1,66 @@ +package noppes.npcs.api; + +import noppes.npcs.api.entity.*; + +/** + * Central controller for creating energy entities and routing energy damage. + * Access via API.getEnergyController(). + * + * All factory methods create entities that are NOT spawned in the world. + * Configure the entity, then call fire() (projectiles) or spawn() (zones/sweepers/panels) + * to place it in the world. + */ +public interface IEnergyController { + + // ==================== PROJECTILE CREATION ==================== + + /** + * Create an energy orb projectile. Not spawned until fire() is called. + */ + IEnergyOrb createOrb(IWorld world, IEntity owner, double x, double y, double z, float size); + + /** + * Create an energy beam projectile. Not spawned until fire() is called. + */ + IEnergyBeam createBeam(IWorld world, IEntity owner, double x, double y, double z, float beamWidth, float headSize); + + /** + * Create an energy disc projectile. Not spawned until fire() is called. + */ + IEnergyDisc createDisc(IWorld world, IEntity owner, double x, double y, double z, float radius, float thickness); + + /** + * Create an energy laser projectile. Not spawned until fire() is called. + */ + IEnergyLaser createLaser(IWorld world, IEntity owner, double x, double y, double z, float laserWidth); + + // ==================== ZONE CREATION ==================== + + /** + * Create a hazard zone entity with defaults. Not spawned until spawn() is called. + * Hazards deal continuous damage to entities within the zone. + */ + IEnergyZone createHazard(IWorld world, IEntity owner, double x, double y, double z); + + /** + * Create a trap zone entity with defaults. Not spawned until spawn() is called. + * Traps trigger when entities enter and deal burst damage. + */ + IEnergyZone createTrap(IWorld world, IEntity owner, double x, double y, double z); + + // ==================== SWEEPER CREATION ==================== + + /** + * Create a sweeper entity with defaults. Not spawned until spawn() is called. + * Sweepers rotate a beam that damages entities in its path. + */ + IEnergySweeper createSweeper(IWorld world, IEntity owner, double x, double y, double z); + + // ==================== PANEL CREATION ==================== + + /** + * Create a panel entity with defaults. Not spawned until spawn() is called. + * Panels are flat energy barriers that can deal damage on contact. + */ + IEnergyPanel createPanel(IWorld world, IEntity owner, double x, double y, double z); +} diff --git a/java/noppes/npcs/api/entity/IEnergySweeper.java b/java/noppes/npcs/api/entity/IEnergySweeper.java new file mode 100644 index 0000000..334679e --- /dev/null +++ b/java/noppes/npcs/api/entity/IEnergySweeper.java @@ -0,0 +1,49 @@ +package noppes.npcs.api.entity; + +import net.minecraft.entity.Entity; + +/** + * Entity-level interface for sweeper beam entities. + * Created via IEnergyController.createSweeper(). + * Configure properties, then call spawn() to place in the world. + */ +public interface IEnergySweeper extends IEnergyAbility { + + // ==================== BEAM DIMENSIONS ==================== + + float getBeamLength(); + void setBeamLength(float length); + + float getBeamWidth(); + void setBeamWidth(float width); + + float getBeamHeight(); + void setBeamHeight(float height); + + // ==================== ROTATION ==================== + + float getSweepSpeed(); + void setSweepSpeed(float degreesPerTick); + + int getNumberOfRotations(); + void setNumberOfRotations(int rotations); + + boolean isLockOnTarget(); + void setLockOnTarget(boolean lock); + + // ==================== DAMAGE ==================== + + float getDamage(); + void setDamage(float damage); + + int getDamageInterval(); + void setDamageInterval(int ticks); + + boolean isPiercing(); + void setPiercing(boolean piercing); + + // ==================== SPAWNING ==================== + + /** Spawn this sweeper entity into the world. */ + void spawn(); +} diff --git a/java/noppes/npcs/api/entity/IEnergyZone.java b/java/noppes/npcs/api/entity/IEnergyZone.java new file mode 100644 index 0000000..35235fc --- /dev/null +++ b/java/noppes/npcs/api/entity/IEnergyZone.java @@ -0,0 +1,103 @@ +package noppes.npcs.api.entity; + +import net.minecraft.entity.Entity; + +/** + * Entity-level interface for zone entities (Hazard and Trap). + * Created via IEnergyController.createHazard() or createTrap(). + * Configure properties, then call spawn() to place in the world. + */ +public interface IEnergyZone extends IEntity { + + // ==================== ZONE TYPE ==================== + + /** @return Zone type: 0=Trap, 1=Hazard */ + int getZoneType(); + + // ==================== COMMON ZONE PROPERTIES ==================== + + /** @return Zone shape: 0=Circle, 1=Square */ + int getZoneShape(); + void setZoneShape(int shape); + + float getRadius(); + void setRadius(float radius); + + float getZoneHeight(); + void setZoneHeight(float height); + + int getDuration(); + void setDuration(int ticks); + + // ==================== COLORS ==================== + + int getInnerColor(); + void setInnerColor(int color); + + int getOuterColor(); + void setOuterColor(int color); + + boolean isOuterColorEnabled(); + void setOuterColorEnabled(boolean enabled); + + // ==================== VISUALS ==================== + + float getParticleDensity(); + void setParticleDensity(float density); + + float getParticleScale(); + void setParticleScale(float scale); + + float getAnimSpeed(); + void setAnimSpeed(float speed); + + boolean isIgnoreIFrames(); + void setIgnoreIFrames(boolean ignore); + + // ==================== HAZARD-SPECIFIC ==================== + + float getDamagePerSecond(); + void setDamagePerSecond(float dps); + + int getDamageInterval(); + void setDamageInterval(int ticks); + + boolean isAffectsCaster(); + void setAffectsCaster(boolean affects); + + // ==================== TRAP-SPECIFIC ==================== + + float getTriggerRadius(); + void setTriggerRadius(float radius); + + int getArmTime(); + void setArmTime(int ticks); + + int getMaxTriggers(); + void setMaxTriggers(int max); + + int getTriggerCooldown(); + void setTriggerCooldown(int ticks); + + float getDamage(); + void setDamage(float damage); + + float getKnockback(); + void setKnockback(float knockback); + + boolean isVisible(); + void setVisible(boolean visible); + + // ==================== CUSTOM DAMAGE DATA ==================== + + /** Get custom damage data for addon handler routing (e.g. DBC damage stats). */ + noppes.npcs.api.INbt getDamageData(); + + /** Set custom damage data for addon handler routing. */ + void setDamageData(noppes.npcs.api.INbt data); + + // ==================== SPAWNING ==================== + + /** Spawn this zone entity into the world. */ + void spawn(); +}