Overview
The CombatService orchestrates all combat-related functionality including attack timing, damage calculations, critical hits, enemy health scaling, and reward distribution. It integrates with character stats, upgrade effects, and progression systems.
Properties
isFighting
isFighting: Signal<boolean>
enemyHP
The current enemy’s remaining hit points.
isSwiftAttacking
isSwiftAttacking: Signal<boolean>
SWIFT_ATTACK_DURATION
SWIFT_ATTACK_DURATION: number = 5000
Combat Control Methods
startFighting
Initiates combat by setting isFighting to true and starting the attack loop. Automatically schedules the next attack based on attack speed.
Usage:
combatService.startFighting();
The attack loop continues automatically until stopFighting() is called.
stopFighting
Halts combat by setting isFighting to false and clearing the attack interval.
Usage:
combatService.stopFighting();
- Calculate base damage using
calculateDamage()
- Check for critical hit using
criticalHit()
- Apply critical damage multiplier if applicable:
damage * (2 + criticalDamageBoost)
- Reduce enemy HP (minimum 0)
- Call
handleEnemyDefeat() if HP reaches 0
Usage:
// Called automatically during combat
combatService.performAttack();
handleEnemyDefeat
handleEnemyDefeat(): void
- Calculate and award gold reward
- Advance wave/stage
- Recalculate enemy HP for new enemy
Usage:
// Called automatically when enemy HP reaches 0
Damage & Attack Calculations
calculateDamage
calculateDamage(): number
let damage = (baseStrength + flatStatBoost)
* strengthModifier
* prestigeStrengthMultiplier
* prestigeLevel;
// Apply prestige upgrade boosts
damage *= (1 + prestigeFlatStatBoost);
// Apply per-core DPS boost
damage *= (1 + dpsPerCore * unusedPrestigeCores);
return Math.floor(damage);
const damage = combatService.calculateDamage();
Damage scales with:
- Base character strength
- Gold upgrade flat stat boosts
- Prestige multipliers and level
- Prestige upgrade effects
- Unused prestige cores (with “Hoarded Power” upgrade)
calculateAttackSpeed
calculateAttackSpeed(): number
const BASE_ATTACK_SPEED = 1000; // 1 second
const swiftMultiplier = isSwiftAttacking ? 0.5 : 1;
const speed = BASE_ATTACK_SPEED * (1 - attackSpeedBoost) * swiftMultiplier;
return Math.floor(speed);
const attackInterval = combatService.calculateAttackSpeed();
- Base attack speed is 1000ms (1 attack per second)
- Attack speed upgrades reduce this interval
- Swift Attack skill applies 50% speed boost (0.5x multiplier)
criticalHit
Determines if an attack is a critical hit using random chance.
Formula:
const critChance = 0.1 + goldUpgradeCritBoost; // Base 10% + upgrades
return Math.random() < critChance;
true if the attack is a critical hit
Usage:
if (combatService.criticalHit()) {
// Apply critical damage multiplier
}
Enemy Calculations
calculateEnemyHP
calculateEnemyHP(): number
const baseHP = 100;
const stageMultiplier = Math.pow(1.5, currentStage - 1);
const waveMultiplier = Math.pow(1.05, currentWave - 1);
let enemyHP = baseHP * stageMultiplier * waveMultiplier;
// Apply health reduction from prestige upgrades
enemyHP *= (1 - enemyHealthReduction);
return Math.floor(enemyHP);
- Stage: Exponential growth with 1.5x multiplier per stage
- Wave: Exponential growth with 1.05x multiplier per wave
- Prestige upgrades: “Fragile Foes” reduces enemy HP by 5% per level
Returns: Calculated enemy HP (floored to integer)
Usage:
const newEnemyHP = combatService.calculateEnemyHP();
calculateGoldReward
calculateGoldReward(): number
const baseGold = 10 * currentStage;
const waveBonusGold = 1 + (currentWave * 0.05);
let gold = baseGold * waveBonusGold;
// 10% chance for double gold (critical)
if (Math.random() < 0.1) {
gold *= 2;
}
return Math.floor(gold);
// Called automatically when enemy is defeated
Gold rewards scale with:
- Stage number (10 gold base per stage)
- Wave number (5% bonus per wave)
- 10% chance for critical gold (2x reward)
Special Abilities
useSwiftAttackSkill
useSwiftAttackSkill(): void
- Reduces attack interval by 50%
- Duration: 5000ms (5 seconds)
- Can be refreshed while active
Usage:
combatService.useSwiftAttackSkill();
The Swift Attack skill is implemented as a 0.5x multiplier on attack speed, effectively doubling the attack rate.
Dependencies
The service injects and uses:
- CharacterService - Access to character stats and progression
- PrestigeUpgradeService - Prestige upgrade effect calculations
- GoldUpgradeService - Gold upgrade effect calculations
characterService = inject(CharacterService);
prestigeUpgradeService = inject(PrestigeUpgradeService);
goldUpgradeService = inject(GoldUpgradeService);
Combat Loop Architecture
The combat system uses recursive timeouts for flexible timing:
startFighting() {
this.isFighting.set(true);
this.performAttack();
this.fightIntervalID = setTimeout(() => {
this.startFighting();
}, this.calculateAttackSpeed());
}