Damage Numbers

Configuration

Display, incoming-damage and timing options.

On this page7 sections

General
Placement
Incoming damage
Shield blocks
Colour renderer
Explosives
Messages

Configuration is read once when the plugin loads, so every change needs a server restart to take effect. Defaults are the values in the shipped config.json.

Defaults are conservative

Several of the most useful options ship disabled so the plugin does nothing unexpected on first install. Enable the ones you want.

General

Key	Default	What it does
`DefaultEnabled`	true	Level 1 for players who have never used `/dmg`. `false` starts them at level 0.
`ShowStructureDamage`	false	Allows structure numbers at all. Required before players can use `/dmg 2`. Off by default because raids produce a very large number of hits.
`ShowFriendlyFire`	false	Numbers for hits on your own side — yourself, tribemates and the tribe's own tames.
`ShareWithTribe`	false	Delivers relevant numbers to the whole online tribe.
`MinimumDamage`	1	Hits below this show nothing.
`MaxViewDistanceFoundations`	50	View distance in foundations. Hits further away are not shown. `0` means no limit.
`ChatCommand`	/dmg	The player command. If you rename it, update `Messages.Usage` and `Messages.UsageWithStructures` to match.
`DebugLogging`	false	Verbose per-event logging. Leave off in production — it writes a line per damage event server-wide.

Placement

Key	Default	What it does
`UseImpactPoint`	true	Draws numbers where the hit landed. Off draws every number at the target's centre.
`ImpactSpreadRadius`	40	How far apart, in world units, numbers drawn at an impact point are spread. `0` disables it.
`NumberSpreadRadius`	220	The same for numbers drawn at the target's centre, such as arrows. `0` disables it.
`HeightOffset`	0	Raises every number by this many world units.

Both spreads are kept within the target's own size, so numbers on a small creature stay close to it. If close-range numbers look too tight or too scattered, adjust ImpactSpreadRadius first.

Incoming damage

Key	Default	What it does
`IncomingDamage.Enabled`	false	Master switch for damage taken. A server decision rather than a player one, because on PvP it tells players how hard they are being hit.
`IncomingDamage.IncludeUnriddenTames`	false	Numbers for tames your tribe owns but nobody is riding.
`IncomingDamage.IncludeStructures`	false	Numbers when your tribe's structures are damaged. This is what makes a base under attack visible. Needs `ShowStructureDamage` too, and players at `/dmg 2`.
`IncomingDamage.Colour`	255, 0, 0	Incoming colour, with the colour renderer on.

Shield blocks

Key	Default	What it does
`ShieldBlock.Enabled`	true	Shows damage on a raised shield in the block colour.
`ShieldBlock.Colour`	60, 220, 200	Block colour, with the colour renderer on. Teal.

Colour renderer

With DistanceScaling.Enabled off, numbers use the game's own style and none of the colours on this page apply. Turn it on for your own colours, thousands separators and sizing.

Key	Default	What it does
`DistanceScaling.Enabled`	false	Switches to the plugin's own renderer.
`DistanceScaling.Colour`	0, 255, 0	Colour of damage you deal. Green.
`DistanceScaling.MinScale`	1.0	Text size up close.
`DistanceScaling.MaxScale`	1.0	Largest text size at a distance. Equal to `MinScale` keeps every number the same size.
`DistanceScaling.DistancePerExtraScale`	4000	World units of distance for each extra step of size, when `MaxScale` is above `MinScale`.
`DistanceScaling.LifeSpan`	3.0	How long a number stays on screen.
`DistanceScaling.FadeOutTime`	1.0	How long it takes to fade at the end.
`DistanceScaling.RiseSpeed`	40	How quickly a number drifts upward.

Explosives

Key	Default	What it does
`ExplosiveAggregationSeconds`	0.15	How long to wait before summing charges that detonate together. If a stack ever splits into two numbers, raise it slightly.

Messages

Every reply to /dmg is configurable under Messages:

Key	Shown when
`SenderName`	The name shown in chat beside every reply. Default `DamageNumbers`.
`Enabled`	A player turns numbers on.
`EnabledStructures`	A player turns numbers on including structures.
`Disabled`	A player turns numbers off.
`Usage`	The command is used wrongly on a map without structure numbers.
`UsageWithStructures`	The same, on a map with structure numbers.
`StructuresOff`	A player asks for `/dmg 2` on a map where structure numbers are off.

If you delete a setting from the file

A setting left out of config.json uses its built-in value. Most match the defaults above, but four renderer settings do not: MaxScale becomes 3.0, LifeSpan 1.5, FadeOutTime 0.5, and the dealt colour becomes the game's own cyan. Keeping the shipped file and editing values avoids surprises.

A reasonable starting point

Enable IncomingDamage.Enabled, ShowStructureDamage and ShareWithTribe for a PvP server — that combination is what makes raids and base attacks legible to a whole tribe. Turn on DistanceScaling.Enabled as well if you want dealt and incoming damage in different colours.