Combat Pets

Combat Pets

Combat pets are NPC battle companions that automatically engage enemies. They are summoned via Battle Runes and fight alongside the player at all times.

Version: 1.3.0

How It Works

1. Summon: Right-click a Battle Rune or use the Combat Pet UI
2. Follow: The combat pet follows the owner (via LockedTarget)
3. Attack: When the owner attacks an enemy, the pet engages that target
4. Defend: When the owner is attacked, the pet retaliates against the attacker
5. XP: Pet gains XP from kills

Combat pets always fight — there are no combat modes. Whenever the player attacks or is attacked, the pet automatically joins the fight.

Combat Behavior

Trigger	Pet Action
Owner attacks enemy	Pet targets and attacks that enemy
Owner is attacked	Pet retaliates against the attacker
Target dies	Pet returns to following the owner
Target out of leash range	Pet disengages and returns to owner

Damage System

Pet damage is calculated as:

baseDamage = baseDamage + (level * damagePerLevel)
damage = baseDamage * (1.0 + damage_bonus_stat)
DPS = damage * attackSpeed

If the pet has a damage_bonus stat, it multiplies the base damage. Damage is attributed to the owner — the owner receives loot and XP from kills.

Floating Damage Numbers: Combat pets display floating damage numbers above the target when they deal damage, visible to the pet owner.

Attack Animations: Each combat pet type has a configured attack animation (e.g., Bite, Attack) that plays when the pet strikes. The animation is determined by the attackAnimation and attackAnimationsId fields in the pet type config.

Combat Stats

Configured per pet type in combatStats:

Field	Default	Description
baseDamage	8.0	Base damage at level 1
damagePerLevel	0.5	Additional damage per level
attackSpeed	1.5	Attacks per second (used in DPS calculation)
attackRange	3.0	Range to deal damage (blocks)
aggroRange	15.0	Range to detect enemies (blocks)
leashDistance	20.0	Max distance from owner before returning
attackAnimation	"Attack"	NPC attack animation name
attackAnimationsId	—	Animation set ID for the NPC type

Combat Stats Pool

Combat pets have randomized bonus stats rolled from the following pool:

Stat	Description
damage_bonus	Percentage bonus damage multiplier on attacks
crit_chance	Chance for critical hits (percentage)
max_health	Additional maximum health for the pet
life_steal	Percentage of damage dealt restored as health
armor_bonus	Flat bonus armor for damage reduction

Stats can be re-rolled or upgraded using scroll items (see below).

Leash System

If the combat target is farther than leashDistance from the owner, the pet disengages and returns. This prevents pets from chasing enemies across the map.

Battle Runes

Battle Runes are tradeable items used to summon combat pets:

• Item ID: Configured per type (e.g., Battle_Rune_Wolf)
• Metadata: BsonDocument with pet instance data
• Right-click: Spawns or dismisses the combat pet

Scroll Items

Item	Description
Battle_Reroll_Scroll	Re-rolls a single bonus stat (new type + value) on a combat pet. Opens a UI to select which stat to reroll.
Battle_Refine_Scroll	Refines a single bonus stat (same type, new value) on a combat pet. Opens a UI to select which stat to refine.
Battle_Reroll_All_Scroll	Previews a full reroll of all stats. Confirm to apply.
Battle_Refine_All_Scroll	Previews a full refine of all stats. Confirm to apply.

Combat Pet Types

Uncommon

Pet	Entity	Base Damage
Bramblekin	Bramblekin	6.0
Sand Lizard	Lizard_Sand	—

Rare

Pet	Entity	Base Damage
Wolf	Wolf_Black	8.0
Boar	Boar	—
Crocodile	Crocodile	—
Spider	Spider	—
Scorpion	Scorpion	—
Hyena	Hyena	—

Epic

Pet	Entity	Base Damage
Void Crawler	Crawler_Void	—
Cave Rex	Rex_Cave	—
Outlander Wolf	Wolf_Outlander	—

Legendary

Pet	Entity	Base Damage
Shadow Knight	Shadow_Knight	—
Yeti	Yeti	—

Combat pets do NOT pick up items. Only pickup pets have the auto-pickup system.

Combat Pet UI

Access via /kspet combat:

• Pet name, level, XP progress
• Combat stats (Damage, DPS, Attack Range, Kill Count)
• Bonus stats from the combat stats pool