Skip to content

Style Configuration

Style files are located at:

config/stylizeddamage/styles/<style_name>.json

Each file defines the visual appearance for a damage number. The filename (without .json) is the style name.

Style Properties

PropertyTypeDefaultDescription
colorstring"#FFFFFF"Text color (solid/rainbow)
fontSizefloat1.0Font size multiplier
fontStylestring"bold"Font style
shadowbooleantrueText shadow
outlineColorstring/nullnullOutline color
backgroundColorstring/nullnullBackground color
soundstring/nullnullSound effect on spawn
prefixstring""Text prefix
suffixstring""Text suffix
iconstring/nullnullIcon texture path
iconPositionstring"left"Icon position: "left" or "right"
iconOffsetXfloat0Horizontal icon offset in pixels
iconOffsetYfloat0Vertical icon offset in pixels
killTextstring/nullnullText for kill-type numbers (replaces damage value)
bypassDisplayOpacitybooleanfalseWhen true, ignores global displayOpacity config
animationobjectAnimation config
damageScaleobjectDamage-based scaling

Color Formats

Solid:

json
"color": "#FF4444"

Rainbow:

json
"color": "rainbow:speed:10"

Font Styles

ValueEffect
"normal"Normal
"bold"Bold
"italic"Italic
"bold_italic"Bold Italic

Damage Scale

Automatically scales font size and increases hold time based on damage amount.

json
"damageScale": {
  "enabled": true,
  "baseFontSize": 1.0,
  "stepSize": 10,
  "sizeOffsetPerStep": 1,
  "maxSize": 2.5,
  "holdBase": 0,
  "holdOffsetPerStep": 10,
  "holdMax": 20
}
ParameterTypeDefaultDescription
enabledbooleantrueEnable damage scaling
baseFontSizefloat1.0Base font size at zero damage
stepSizefloat10Damage points per scaling step
sizeOffsetPerStepfloat1Font size added per step
maxSizefloat2.5Maximum font size multiplier
holdBasefloat0Base extra hold ticks
holdOffsetPerStepfloat10Extra hold ticks added per step
holdMaxfloat20Maximum extra hold ticks

Formulas

fontSize = clamp(baseFontSize + (damage / stepSize) × sizeOffsetPerStep, baseFontSize, maxSize)
holdExtra = clamp(round((damage / stepSize) × holdOffsetPerStep), 0, holdMax - holdBase)

Total hold time = animation hold + holdExtra.

See Animation Guide for detailed animation configuration.

Released under the MIT License