Update API and Cleanup Unused Code

This commit is contained in:
Kam committed 2026-03-01 02:50:44 -05:00
1 parent 27a41e3a8e
commit b28a7a5c4d
33 files changed
+592 -32

No files matched your search

@@ -1,19 +1,31 @@
package noppes.npcs.api.ability.data;
/**
* Configuration for the anchor point of an energy ability projectile.
* Controls where the projectile spawns relative to the caster.
*/
public interface IEnergyAnchorData {
/** @return Anchor point ordinal (0=FEET, 1=CENTER, 2=RIGHT_HAND, 3=LEFT_HAND, 4=HEAD, 5=FRONT, 6=ABOVE_HEAD). */
int getAnchor();
/** Set the anchor point. @param anchor Anchor ordinal (0=FEET, 1=CENTER, 2=RIGHT_HAND, 3=LEFT_HAND, 4=HEAD, 5=FRONT, 6=ABOVE_HEAD). */
void setAnchor(int anchor);
/** @return X offset from the anchor point (positive = right). */
float getAnchorOffsetX();
/** @param anchorOffsetX X offset from anchor (positive = right). */
void setAnchorOffsetX(float anchorOffsetX);
/** @return Y offset from the anchor point (positive = up). */
float getAnchorOffsetY();
/** @param anchorOffsetY Y offset from anchor (positive = up). */
void setAnchorOffsetY(float anchorOffsetY);
/** @return Z offset from the anchor point (positive = forward). */
float getAnchorOffsetZ();
/** @param anchorOffsetZ Z offset from anchor (positive = forward). */
void setAnchorOffsetZ(float anchorOffsetZ);
}
@@ -1,27 +1,43 @@
package noppes.npcs.api.ability.data;
/**
* Combat properties for energy ability projectiles.
* Controls damage, knockback, and explosion behavior.
*/
public interface IEnergyCombatData {
/** @return Base damage dealt on hit. */
float getDamage();
/** @param damage Base damage on hit. */
void setDamage(float damage);
/** @return Horizontal knockback strength applied on hit. */
float getKnockback();
/** @param knockback Horizontal knockback strength. */
void setKnockback(float knockback);
/** @return Vertical knockback strength applied on hit. */
float getKnockbackUp();
/** @param knockbackUp Vertical knockback strength. */
void setKnockbackUp(float knockbackUp);
/** @return Whether the projectile explodes on impact. */
boolean isExplosive();
/** @param explosive Whether to explode on impact. */
void setExplosive(boolean explosive);
/** @return Explosion radius in blocks. */
float getExplosionRadius();
/** @param explosionRadius Explosion radius in blocks. */
void setExplosionRadius(float explosionRadius);
/** @return Damage falloff multiplier over distance (0.0-1.0). */
float getExplosionDamageFalloff();
/** @param explosionDamageFalloff Damage falloff multiplier (0.0-1.0). */
void setExplosionDamageFalloff(float explosionDamageFalloff);
}
@@ -1,31 +1,49 @@
package noppes.npcs.api.ability.data;
/**
* Visual display properties for energy ability projectiles.
* Controls colors, transparency, and rotation speed.
*/
public interface IEnergyDisplayData {
/** @return Inner (core) color as a packed RGB integer. */
int getInnerColor();
/** @param innerColor Inner color as a packed RGB integer. */
void setInnerColor(int innerColor);
/** @return Outer (glow) color as a packed RGB integer. */
int getOuterColor();
/** @param outerColor Outer color as a packed RGB integer. */
void setOuterColor(int outerColor);
/** @return Whether the outer color layer is rendered. */
boolean isOuterColorEnabled();
/** @param outerColorEnabled Whether to render the outer color layer. */
void setOuterColorEnabled(boolean outerColorEnabled);
/** @return Width of the outer color layer relative to the projectile size. */
float getOuterColorWidth();
/** @param outerColorWidth Outer color layer width. */
void setOuterColorWidth(float outerColorWidth);
/** @return Alpha (opacity) of the outer color layer (0.0-1.0). */
float getOuterColorAlpha();
/** @param outerColorAlpha Outer color opacity (0.0-1.0). */
void setOuterColorAlpha(float outerColorAlpha);
/** @return Alpha (opacity) of the inner color layer (0.0-1.0). */
float getInnerAlpha();
/** @param innerAlpha Inner color opacity (0.0-1.0). */
void setInnerAlpha(float innerAlpha);
/** @return Visual rotation speed in degrees per tick. */
float getRotationSpeed();
/** @param rotationSpeed Rotation speed in degrees per tick. */
void setRotationSpeed(float rotationSpeed);
}
@@ -1,19 +1,31 @@
package noppes.npcs.api.ability.data;
/**
* Homing and speed properties for energy ability projectiles.
* Controls projectile velocity and target-seeking behavior.
*/
public interface IEnergyHomingData {
/** @return Projectile travel speed in blocks per tick. */
float getSpeed();
/** @param speed Travel speed in blocks per tick. */
void setSpeed(float speed);
/** @return Whether the projectile tracks its target. */
boolean isHoming();
/** @param homing Whether to track the target. */
void setHoming(boolean homing);
/** @return Homing turn strength (higher = tighter turns). */
float getHomingStrength();
/** @param homingStrength Homing turn strength. */
void setHomingStrength(float homingStrength);
/** @return Maximum distance at which homing activates, in blocks. */
float getHomingRange();
/** @param homingRange Maximum homing activation range in blocks. */
void setHomingRange(float homingRange);
}
@@ -1,11 +1,19 @@
package noppes.npcs.api.ability.data;
/**
* Lifespan properties for energy ability projectiles.
* Controls how far and how long a projectile can travel before expiring.
*/
public interface IEnergyLifespanData {
/** @return Maximum travel distance in blocks before the projectile expires. */
float getMaxDistance();
/** @param maxDistance Maximum travel distance in blocks. */
void setMaxDistance(float maxDistance);
/** @return Maximum lifetime in ticks before the projectile expires. */
int getMaxLifetime();
/** @param maxLifetime Maximum lifetime in ticks. */
void setMaxLifetime(int maxLifetime);
}
@@ -1,19 +1,31 @@
package noppes.npcs.api.ability.data;
/**
* Lightning visual effect properties for energy ability projectiles.
* Controls the electric arc effect rendered around the projectile.
*/
public interface IEnergyLightningData {
/** @return Whether the lightning visual effect is enabled. */
boolean isLightningEffect();
/** @param lightningEffect Whether to enable the lightning effect. */
void setLightningEffect(boolean lightningEffect);
/** @return Density of lightning arcs (higher = more arcs). */
float getLightningDensity();
/** @param lightningDensity Lightning arc density. */
void setLightningDensity(float lightningDensity);
/** @return Radius of the lightning effect around the projectile, in blocks. */
float getLightningRadius();
/** @param lightningRadius Lightning effect radius in blocks. */
void setLightningRadius(float lightningRadius);
/** @return Fade-out time for lightning arcs in ticks. */
int getLightningFadeTime();
/** @param lightningFadeTime Fade-out time in ticks. */
void setLightningFadeTime(int lightningFadeTime);
}