Combat XP Modes

Overview

Combat XP Mode controls how offensive weapon skills (Swords, Axes, Polearms, Staves, Blunt, Daggers, Archery, Unarmed) earn experience. Defense and Acrobatics always earn XP per-hit regardless of the selected mode.

Change the mode from the admin dashboard (/mmoadmin) under General Settings, or set combatXpMode directly in mods/mmoskilltree/skill-config.json.

Available Modes

Damage+Kill (Default)

The hybrid mode combines the best of both worlds: immediate feedback from every hit plus a satisfying kill reward.

• Per-hit component: 1 XP per point of damage dealt. A hit dealing 15 damage awards 15 XP immediately
• Kill component: When you land the killing blow, bonus XP is awarded based on the mob type (from mob-kill-xp.json)
• If Weapon XP Scaling is enabled (default), your weapon's per-hit XP value acts as a percentage bonus on the mob's base kill XP

This mode rewards both sustained combat and finishing kills, making progression feel natural regardless of weapon type or enemy difficulty.

Damage

The simplest mode: XP equals damage dealt in a 1:1 ratio. No kill bonuses.

• A hit dealing 15 damage awards 15 XP
• Stronger weapons that deal more damage naturally award more XP
• No need to land the killing blow — all damage counts equally
• Broken weapons (0 durability) award no XP

Per-Hit

The traditional mode from earlier versions. Each weapon has a fixed XP value defined in xp-maps.json, awarded on every hit regardless of damage dealt.

• XP is determined by the weapon's entry in XP maps, not by damage dealt
• Higher-tier weapons have higher per-hit XP values
• Customize per-weapon XP from the admin dashboard via XP Values

Kill-Only

XP is only awarded when you kill a mob. No XP from individual hits. See the Mob Kill XP page for details on per-mob XP values and the kill XP formula.

• Kill XP comes from mob-kill-xp.json with over 100 default mob entries
• Optional Weapon XP Scaling applies your weapon's per-hit value as a percentage bonus on kill
• Only the player who lands the killing blow earns XP

Hostility Requirement

In all modes except Kill-Only, combat XP is only awarded when attacking hostile mobs. Hitting passive or friendly mobs (e.g., livestock, fish) does not award weapon XP. This prevents farming XP from harmless targets.

Kill-Only mode does not check hostility — any mob kill awards XP based on its entry in mob-kill-xp.json.

Fish & Aquatic Mobs

How fish mob kills are handled depends on whether a fishing mod is installed:

With a fishing mod (e.g., HyFishing)

When a fishing integration is active, Fishing XP comes exclusively from rod catches. Killing fish mobs awards weapon combat XP (or nothing) like any other mob — no Fishing XP is awarded from kills in any mode.

Without a fishing mod

Unaffected Skills

The following skills always earn XP per-hit, regardless of which combat XP mode is active:

• Defense — Earns XP when the player takes damage
• Acrobatics — Earns XP when the player survives fall damage

Config File

The combat XP mode is stored in mods/mmoskilltree/skill-config.json:

{
  "combatXpMode": "damage_plus_kill"
}

Valid values: damage_plus_kill, damage_based, per_hit, kill_only

Choosing a Mode