engine combat - magemonkeystudio/divinity GitHub Wiki

โš”๏ธ Engine Config: combat

This section controls custom combat behavior, including legacy mechanics, shield bonuses, attack cooldown modifiers, and how players or mobs interact during battle.


๐Ÿ”‘ Options

Key Description
legacy-combat Enables old defense formula (pre-1.9 style).
shield.block.block-rate-bonus Bonus to BLOCK_RATE stat on vanilla shield block.
shield.block.block-damage-bonus Bonus to BLOCK_DAMAGE stat on vanilla shield block.
shield.block.cooldown Cooldown time (in ticks) after successful block.
disable-vanilla-sweep-attack Disables sword sweep attacks (for AoE clarity).
compress-player-health-bar Reduces health bar display to 10 hearts (visual only).
fishing-hook-do-damage Allows fishing rods to damage entities via the hook.
bows-do-full-melee-damage Allows bows to deal full damage in melee.
damage-modifier-for-cooldown Modifies base damage based on attack cooldown (1.0 = vanilla).
max-get-target-distance Max distance for target selection in skills and actions.

๐Ÿงช Example

combat:
  legacy-combat: false
  shield:
    block:
      block-rate-bonus: 100.0
      block-damage-bonus: 35.0
      cooldown: 2
  disable-vanilla-sweep-attack: true
  compress-player-health-bar: false
  fishing-hook-do-damage: true
  bows-do-full-melee-damage: false
  damage-modifier-for-cooldown: 1.0
  max-get-target-distance: 30.0

๐Ÿ’ก Notes

  • Legacy Combat is ideal if you're aiming to replicate older PvP behavior.
  • Shield Bonuses apply directly to stats when a vanilla block event succeeds.
  • Health Compression is purely cosmetic โ€” it only affects the number of visible hearts, not actual health.
  • Cooldown Modifier lets you soften or amplify the impact of Minecraftโ€™s native attack delay system.

๐Ÿ”— Related

  • engine-attributes โ€“ To ensure mobs or offhand items apply effects
  • engine-lore โ€“ For visual formatting of shield and health data