Configuration (common.json)

The configuration file is located at:

config/stylizeddamage/common.json

If the file does not exist, the mod will automatically generate a default config on first load.

Selectors

Selectors determine which style is used for each damage event. Three-layer matching:

Layer	Match Type
1	Damage value range (optional)
2	Target entity type/team (optional)
3	Damage type match array

Range Key Format

Format	Meaning
"common"	Default fallback
"[min,max]"	Closed interval
"[min,...]"	Min and above
"[...,max]"	Max and below

Branch Paths

Branch	Condition
player.yourTeam	Target is player on your team
player.otherTeam	Target is player on different team
player.common	Target is player with no team info
mob.hostile	Target is hostile mob
mob.passive	Target is passive mob
mob.common	Target is mob with unknown hostility
common	Fallback

Match Array

• Conditions are OR-ed together
• Supports damage type IDs: "minecraft:in_fire"
• Supports tags: "#minecraft:bypasses_armor", "#minecraft:is_fire" (auto-expanded at startup)
• Supports pseudo types: "heal", "absorption", "kill"
• Supports critical hits: "critical"
• Wildcard: "*" matches all real damage types, but not pseudo types (heal, absorption, kill). Pseudo types must be matched by explicit rules; omitting a pseudo type's rule suppresses that pseudo type's popup entirely

Display Filter

Controls which damage events show numbers.

Option	Type	Default	Description
mode	string	"byTarget"	Judgment mode: "bySource" or "byTarget"
hideSelfDamage	boolean	true	Hide self-damage

Display Opacity

Controls damage number opacity based on the damage source.

"displayOpacity": {
    "player": 1.0,
    "mobHostile": 0.5,
    "mobPassive": 0.75,
    "other": 1.0
}

Option	Type	Default	Description
player	float	1.0	Opacity for player-caused damage
mobHostile	float	0.5	Opacity for hostile mob damage
mobPassive	float	0.75	Opacity for passive mob damage
other	float	1.0	Opacity for other sources

This multiplies on top of the animation opacity. E.g. animation opacity 0.8 × mobHostile 0.5 = final alpha 0.4.

Display Settings

Option	Type	Default	Description
minDamageDisplay	float	0.1	Minimum damage to show a number
maxActiveNumbers	int	999	Max concurrent floating numbers
showHealing	boolean	true	Show healing numbers
showAbsorption	boolean	true	Show absorption numbers
hideFullHealthHeal	boolean	true	Hide healing numbers when entity is at full HP
killOnlyOnMobDeath	boolean	false	Only show "kill" text on fatal hits (suppress damage number)
killOnlyFullHealth	boolean	false	When killOnlyOnMobDeath is enabled, only apply to one-shot kills (full-HP targets)
displayScope	string	"all"	Which damage numbers to show: all (everything) / selfDealt (own damage only) / selfRelated (own damage + damage taken)
hideBehindWall	boolean	false	Hide numbers when fully solid opaque blocks block the line between camera and trigger point (glass, leaves etc. do not count)

displayScope and hideBehindWall are disabled by default and do not change existing behavior.

Number Abbreviation

Abbreviates large damage values, e.g. 1200 → 1.2k, 1500000 → 1.5M.

"numberAbbreviation": {
    "enabled": false,
    "threshold": 1000.0,
    "suffixes": ["k", "M", "B", "T"],
    "decimalPlaces": 1
}

Option	Type	Default	Description
enabled	boolean	false	Enable abbreviation (disabled by default)
threshold	float	1000.0	Values below this are never abbreviated
suffixes	string array	["k","M","B","T"]	Suffixes per 1000× step, ascending
decimalPlaces	int	1	Decimal places kept after abbreviation (e.g. 1.2k, 1.23k)

• Integer results drop decimals (2000 → 2k); non-integers keep decimalPlaces digits
• Applies to both floating numbers and the total-damage panel

Distance Scale

The current configuration uses a nested object:

"distanceScale": {
  "segment": 10.0,
  "factor": 0.2,
  "min": 0.3,
  "maxDisplayDistance": 64.0
}

Option	Type	Default	Description
segment	float	10.0	Distance segment (blocks)
factor	float	0.2	Scale factor per segment
min	float	0.3	Minimum scale multiplier
maxDisplayDistance	float	64.0	Maximum display distance (blocks)

Legacy flat fields distanceScaleSegment / distanceScaleFactor / distanceScaleMin / maxDisplayDistance are still accepted for compatibility, but the nested format above is the recommended/current generated form.

Total Damage Panel

Option	Type	Default	Description
enabled	boolean	true	Enable total damage panel
resetTimeout	int	100	Reset delay in ticks (20 ticks = 1 second)
maxTrailCount	int	20	Max trail entries
baseFontSize	float	2.0	Base font size multiplier
sizeOffsetPerThousand	float	0.5	Font size increment per 100 damage
sizeOffsetMax	float	3.0	Max font size multiplier
positionX	float	-0.15	Horizontal offset as fraction of window width (negative = left)
positionY	float	0.15	Vertical offset as fraction of window height (positive = down)
enableEntryAnimation	boolean	true	Play entry animation on total damage number
enableExitAnimation	boolean	true	Play exit animation on total damage number
enableBounceAnimation	boolean	true	Bounce when total damage value changes
enableTrailEntryAnimation	boolean	true	Trail entries slide in from right
enableTrailExitAnimation	boolean	true	Trail entries slide out to left
bounceScalePeak	float	1.4	Peak scale during bounce (1.4 = 140% size)
labelText	string	"Damage"	Label text displayed above the total damage number. Set to "" to hide.

Pseudo Damage Types

ID	Trigger	Notes
heal	Entity healed	Requires showHealing: true
absorption	Absorption increased	Requires showAbsorption: true
kill	Fatal damage	Not counted in total damage / trail. Always rendered on top. Uses matched style's killText field instead of damage value.

Reload

/stylizeddamage reload