Ouch!

Tired of estimating how much damage your target has taken? Want to make battles more visual and spectacular? Then this mod is exactly what you need!

Ouch! is a server-side mod for Fabric and Quilt, built on Polymer technology, that adds numeric indicators in the form of text particles displayed when taking damage, dying, or receiving healing (by default, only damage and healing are visible)! The mod offers complete customization of all parameters: text, display colors, size, movement, and particle visibility time with the ability to check damage type, target, attack source, and attacker through predicates. It also allows creating multiple different particles for the same damage instance, opening up endless possibilities for creative messages and effects.

Configuration

Mod configuration file is located at: ./config/ouch.json

Preset Selection

Configuration defaults to preset selection format with predefined display styles:

{
  "preset": "default"
}

Available presets: default, minimal

Advanced Configuration

This configuration format allows fine-tuning every aspect of text particle display. Uses QuickText format for custom text and Predicate API for trigger conditions. Lines with // symbols are explanatory comments not part of the actual configuration.

{
  // Damage display settings
  "damage": [
    [
      {
        // [Optional] Damage type (single, tag, or list)
        "type": "...",
        // [Optional] Target check (entity receiving damage)
        "victim": {
          "type": "..."
        },
        // [Optional] Attacker check
        "attacker": {
          "type": "..."
        },
        // [Optional] Source check (projectile or attacker)
        "source": {
          "type": "..."
        },
        "min_value": 0,        // Minimum damage for display
        "max_value": 999999,   // Maximum damage for display
        "chance": 1,           // Trigger chance (0-1)
        "per_tick_velocity_multiplier": 0.7, // Velocity multiplier per tick
        "gravity": 0.05,       // Particle gravity
        "staying_time": 20,    // Display time in ticks
        "text_scale": 0.8,     // Text scale
        "velocity_override": [0, 2, 0], // Static velocity override
        "text": "<red>-${value}" // Text with placeholders ${value}, ${value_rounded}, ${value_raw}
      }
    ]
  ],
  // Death display settings
  "death": [
    [
      {
        // Similar parameters for death display
        "type": "...",
        "victim": { "type": "..." },
        "attacker": { "type": "..." },
        "source": { "type": "..." },
        "min_value": 0,
        "max_value": 999999,
        "chance": 1,
        "per_tick_velocity_multiplier": 0.7,
        "gravity": 0.05,
        "staying_time": 20,
        "text_scale": 0.8,
        "velocity_override": [0, 2, 0],
        "text": "<red>${message}" // ${message}, ${victim}, ${attacker}
      }
    ]
  ],
  // Healing display settings
  "healing": [
    [
      {
        "entity": { "type": "..." }, // Healed entity check
        "chance": 1,
        "per_tick_velocity_multiplier": 0.7,
        "gravity": 0.05,
        "staying_time": 20,
        "text_scale": 0.8,
        "velocity_override": [0, 2, 0],
        "text": "<green>+${value}" // ${value}, ${value_rounded}, ${value_raw}
      }
    ]
  ]
}