EliteMobs/com.magmaguy.elitemobs.testing/CombatSimulator

CombatSimulator

public class CombatSimulator

Combat Simulator - Manages test dummies and simulates attacks for skill testing.

Uses a singleton dummy pattern - one dummy at a time, killed and replaced between weapon types.

ATTACK SIMULATION:

simulateMeleeAttack() - Uses player.attack(target), resets iframes before each hit
simulateRangedAttack() - Spawns arrow toward target, needs tick delay for travel
simulateTridentAttack() - Spawns trident toward target, needs tick delay for travel
simulateIncomingDamage() - For armor skills, calls player.damage(amount, attacker)

CONFIG REQUIREMENTS:

training_dummy.yml - For offensive skill tests (damageMultiplier can be 0)
training_dummy_combat.yml - For armor skill tests (needs damageMultiplier >0)

Constructors

CombatSimulator

public void CombatSimulator(Player player)

Properties

player

public final Player player

testDamageOverride

public static double testDamageOverride

When >= 0, bypasses the defense formula in PlayerDamagedByEliteMobEvent and uses this fixed damage value instead.

Functions

applyPassiveWeaponEffects

public void applyPassiveWeaponEffects(SkillType skillType, int skillLevel)

Applies passive weapon effects that normally trigger on PlayerItemHeldEvent.

calculateExpectedDefensiveDamage

public static double calculateExpectedDefensiveDamage(int armorSkillLevel, int mobLevel, Player player)

Calculates the expected defensive damage (elite → player) from the formula constants.

cleanupTestEntities

public void cleanupTestEntities()

Cleans up any projectile entities and area-effect-clouds spawned near the test area.

equipArmorSet

public void equipArmorSet(int level)

Equips the player with a full armor set at the specified elite level.

equipWeapon

public void equipWeapon(SkillType skillType)

Equips the player with a weapon appropriate for the skill type.

getDummy

public CustomBossEntity getDummy(String skillId)

Gets a dummy by skill ID.

getDummyCount

public int getDummyCount()

Gets the number of active dummies.

getDummyEntity

public LivingEntity getDummyEntity(String skillId)

Gets the living entity for a dummy.

getPlayer

public Player getPlayer()

getTestDamageOverride

public static double getTestDamageOverride()

When >= 0, bypasses the defense formula in PlayerDamagedByEliteMobEvent and uses this fixed damage value instead.

hasActiveBreakdownTracking

public boolean hasActiveBreakdownTracking()

Checks if the player has an active damage breakdown tracking session.

hasDummy

public boolean hasDummy(String skillId)

Checks if a dummy exists and is alive.

healDummy

public void healDummy(String skillId)

Heals a specific dummy.

isBlockingOverride

public static boolean isBlockingOverride()

isTestingActive

public static boolean isTestingActive()

markDummyAsFailed

public void markDummyAsFailed(String skillId, String skillName, SkillType skillType, String reason)

Updates a dummy's name to show the test failed.

markDummyAsPassed

public void markDummyAsPassed(String skillId, String skillName, SkillType skillType, double procRate)

Updates a dummy's name to show the test passed.

markDummyAsTesting

public void markDummyAsTesting(String skillId, String skillName, SkillType skillType)

Updates a dummy's name to show it's currently being tested.

placeWaterAtDummy

public void placeWaterAtDummy(String skillId)

Places a water block at the dummy's feet for testing water-dependent skills (Depth Charge).

removeAllDummies

public void removeAllDummies()

Removes all dummies.

removeDummy

public void removeDummy(String skillId)

Removes a specific dummy by skill ID.

resetProjectileTracking

public void resetProjectileTracking()

Clears projectile tracking state.

respawnIfDead

public boolean respawnIfDead(String skillId, SkillBonus skill)

Respawns a dummy if it died.

restorePlayerArmor

public void restorePlayerArmor()

Restores the player's saved armor.

restoreWaterBlock

public void restoreWaterBlock()

Restores the original block material at the water placement location.

runQuickDamageTest

public void runQuickDamageTest(int dummyLevel)

Runs a quick damage test and outputs the results.

savePlayerArmor

public void savePlayerArmor()

Saves the player's current armor for later restoration.

sendBreakdownToPlayer

public void sendBreakdownToPlayer(DamageBreakdown breakdown)

Outputs a detailed damage breakdown to the player.

setBlockingOverride

public static void setBlockingOverride(boolean blockingOverride)

setDummyHealthPercent

public void setDummyHealthPercent(String skillId, double percent)

Sets a dummy's health to a percentage of its max health.

setTestDamageOverride

public static void setTestDamageOverride(double testDamageOverride)

When >= 0, bypasses the defense formula in PlayerDamagedByEliteMobEvent and uses this fixed damage value instead.

setTestingActive

public static void setTestingActive(boolean active)

simulateBlockingIncomingDamage

public double simulateBlockingIncomingDamage(String skillId, double amount)

Simulates the player taking damage while blocking.

simulateCriticalAttack

public double simulateCriticalAttack(String skillId)

Performs a direct event-based attack with critical strike flag set to true.

simulateDirectAttack

public double simulateDirectAttack(String skillId)

Performs a direct event-based attack against a specific dummy.

simulateFatalIncomingDamage

public double simulateFatalIncomingDamage(String skillId)

Simulates the player taking fatal damage without absorption buffer.

simulateHighDamageWithOverride

public double simulateHighDamageWithOverride(String skillId, double amount)

Simulates incoming high damage with override for skills with high damage thresholds.

simulateIncomingDamage

public double simulateIncomingDamage(String skillId, double amount)

Simulates the player taking damage from a specific dummy (for armor skill testing).

public double simulateIncomingDamage(String skillId, double amount, double healthPercent)

Simulates incoming damage with the player at a specified health percentage.

simulateIncomingDamageWithOverride

public double simulateIncomingDamageWithOverride(String skillId, double amount)

Simulates incoming damage with the test damage override enabled.

simulateKill

public boolean simulateKill(String skillId)

Kills a dummy with a real player swing, so the whole death chain actually runs.

simulateMeleeAttack

public double simulateMeleeAttack(String skillId)

Performs a melee attack against a specific dummy.

simulateMeleeAttackWithBreakdown

public DamageBreakdown simulateMeleeAttackWithBreakdown(String skillId)

Performs a melee attack with full damage breakdown tracking.

simulateMultipleAttacksWithBreakdown

public String simulateMultipleAttacksWithBreakdown(String skillId, int hitCount)

Performs multiple melee attacks and returns an averaged breakdown summary.

simulateRangedAttack

public double simulateRangedAttack(String skillId)

Performs a ranged attack (bow/crossbow) against a specific dummy.

simulateTridentAttack

public double simulateTridentAttack(String skillId)

Performs a trident throw attack against a specific dummy.

spawnDamageTestDummy

public boolean spawnDamageTestDummy(String skillId)

Spawns the dedicated damage test dummy for baseline damage validation.

spawnSingleDummy

public boolean spawnSingleDummy(SkillBonus skill)

Spawns a single dummy for the current skill test.

stopBreakdownTracking

public DamageBreakdown stopBreakdownTracking()

Stops breakdown tracking and returns the result.

CombatSimulator

See also

Constructors

Properties

Functions