Configuration

Combat Tell is configured via a JSON file. Below is the default configuration:

{
  "baseParticleScale": 0.025,
  "blacklist": [],
  "damageColor": "#FF0000",
  "distanceFactor": 0.15,
  "healColor": "#00FF00",
  "hitboxSafetyBuffer": 0.42,
  "maxCeiling": 5.0,
  "maxSpreadSide": 1.3,
  "particleDisplays": "DAMAGE_HEAL",
  "particleLifetime": 1.5,
  "particleRiseSpeed": 0.012,
  "torsoHeightMultiplier": 0.65,
  "whitelist": [],
  "whitelistMode": false
}

Display Options

particleDisplays

• Type: string
• Default: "DAMAGE_HEAL"
• Accepted values: "DAMAGE", "HEAL", "DAMAGE_HEAL" Controls which particles are shown.

Value	Description
"DAMAGE"	Only damage particles are shown
"HEAL"	Only heal particles are shown
"DAMAGE_HEAL"	Both damage and heal particles are shown

damageColor

• Type: string (hex color)
• Default: "#FF0000" Color of the particle shown when an entity takes damage.

healColor

• Type: string (hex color)
• Default: "#00FF00" Color of the particle shown when an entity is healed.

Particle Scaling & Behavior

baseParticleScale

• Type: number
• Default: 0.025 The base size of each particle before distance scaling is applied.

distanceFactor

• Type: number
• Default: 0.15 How much particle size increases per block of distance from the camera, so particles stay readable at long range.

maxCeiling

• Type: number
• Default: 5.0 The maximum size a particle can reach, regardless of distance. Prevents particles from growing too large at extreme range.

maxSpreadSide

• Type: number
• Default: 1.3 The maximum horizontal spread of particles from the entity's center.

particleLifetime

• Type: number (seconds)
• Default: 1.5 How long each particle stays visible before disappearing.

particleRiseSpeed

• Type: number
• Default: 0.012 How fast particles rise upward over their lifetime.

torsoHeightMultiplier

• Type: number
• Default: 0.65 Vertical spawn position of particles, relative to the entity's height (e.g. 0.65 spawns particles around torso height).

hitboxSafetyBuffer

• Type: number
• Default: 0.42 Extra buffer added around an entity's hitbox to prevent particles from spawning inside blocks or clipping through the entity.

Entity Filtering

whitelist / blacklist

• Type: array of strings
• Default: [] Lists of entities to allow or exclude from showing particles. Both follow the pattern:

namespace:mob_id

Example — target skeletons specifically:

{
  "whitelist": [
    "minecraft:skeleton"
  ]
}

whitelistMode

• Type: boolean

• Default: false Controls which list is active.

• false — blacklist is used; all entities show particles except those listed

• true — whitelist is used; only listed entities show particles