⚔️ Combat Log Module

The Combat Log module provides detailed, interactive logs of recent combat encounters for players. It includes features like floating damage indicators, action bar notifications, and a /log command to review recent fights.

---

📁 Source Folder

plugins/Divinity/modules/combat_log/
├── settings.yml

No item files are required for this module.

---

⚙️ Configuration Overview

Found in settings.yml or generated automatically.

general:
  logging:
    enabled: true
    max-amount: 10
    format:
      time: 'HH:mm'
      text: '&6[%time%] &r%message% %damage% %defense% %details% %weapon%'
      buttons:
        damage:
          name: '&c&l[Damage]'
          text:
            - '&7Total: &c%amount_total% &8(%percent_total%%)'
            - '&7%damage_type%: &c%amount% &8(%percent%%)'
        defense:
          name: '&b&l[Defense]'
          text:
            - '&7Blocked: &b%amount_total% &8(%percent_total%%)'
            - '&7%defense_type%: &b%amount% &8(%percent%%)'
        details:
          name: '&e&l[Details]'
          text:
            - '&ePenetration: %penetrate_modifier%%'
            - '&eBlock: %block_modifier%%'
            - '&eCritical: %critical_modifier%%'
        weapon:
          name: '&d&l[Weapon]'

These fields control combat log formatting, hover text, and dynamic placeholders.

---

📊 Message Indicators (Floating Damage)

If enabled, holograms will appear over targets showing:

• %damage% with color-coded damage types.
• %critical%, %block%, or %dodge% results.
• %healing% indicators for regen or support.

indicators:
  enabled: true
  format:
    order: [ "critical", "dodge", "block", "damage" ]
    damage-types:
      physical: "&c-%damage%"
      fire: "&6-%damage%"
    regen-sources:
      healing: "&a+%hp%"

Requires HolographicDisplays plugin to render holograms.

---

💬 Commands

Command	Description	Permission
/combatlog log	View latest combat log	divinity.combatlog.log
/combatlog help	Show help page	divinity.combatlog.help
/combatlog reload	Reload the module	divinity.combatlog.reload

---

📝 Notes

• Logs are only available for recent combat and capped by max-amount.
• Both attacker and victim can receive logs, if enabled.
• Combat logs are interactive, with clickable damage types, tooltips, and weapon details.
• If ignore-zero-damage: true is set, logs skip entries where no damage occurred.

---

🔗 Return to Home

← Return to Home