KDV_DamageNumbers

Paid KDV_DamageNumbers 2.0.0

No permission to buy ($29.99)
Overview Updates (2) Reviews (4) History Discussion
This resource is paid, and requires to be purchased

v2.0.0 - Major Update.

Release Overview

Version 2.0.0 represents a complete overhaul of nearly every system in the plugin.

Code: 
Metric                  | Value
------------------------|----------------------
Commits                 | 39
Files Changed           | 32
Code Changes            | +4,718 / -1,454 lines
Core Logic Expansion    | +149%
Config Documentation    | +357%

What's New

Player Customization System

Players now have full control over their damage number experience. Every setting persists in the database across server restarts.

  • Text Size - Scale damage numbers from tiny (0.1x) to huge (5x)
  • Display Duration - Control how long numbers stay visible (0.1-25 seconds)
  • Jitter/Spread - Adjust how much numbers spread out to avoid overlap
  • Solo Mode - See only YOUR damage - no tribmates, no allies, just you
  • Hit Location - Numbers appear exactly where the hit landed, not at entity center

All customization can be enabled/disabled by admins, with configurable defaults for new players.

Color Theme System

A sophisticated color system with perspective-based coloring. Players see colors based on their role in combat:

  • Attacker Perspective - Colors you see when dealing damage
  • Defender Perspective - Colors you see when taking damage
  • Neutral Perspective - Colors spectators see

Included Themes:
  • Default - Classic green (attack) / red (defend)
  • High_Contrast - Cyan / Orange for colorblind-friendly visibility

Admins can create unlimited custom themes with named colors, hex codes (#FF0000), or RGB values (255,128,0).

Exact Hit Location

Damage numbers now appear at the precise impact point instead of the entity's center.

  • Shoot a Rex in the tail? Number appears at the tail.
  • Headshot an enemy player? Number appears at their head.
  • Much more realistic and informative combat feedback.

Players can toggle this on/off with /dmg.hitloc.

Solo Mode

For players who might prefer a simple experience. Solo mode filters damage to show only:

  • Damage YOU personally deal
  • Damage YOU personally take

No more screen full of tribmate numbers during massive raids.

Enhanced Visibility Rules

The visibility system has been completely redesigned with a powerful relationship-based matrix and granular audience flags.

Relationships: PvE, Enemy (PvP), Self (tribe), Ally

Categories: Survivor (player/rider), Creature (unridden tame), Structure

Audience Flags:
  • ShowToAttacker / ShowToAttackerTribe / ShowToAttackerAllies
  • ShowToDefender / ShowToDefenderTribe / ShowToDefenderAllies
  • ShowToNeutrals

This enables configurations like:
  • "Both tribes see PvP damage, but neutrals don't"
  • "Only the attacker sees farming damage"
  • "Turret damage visible to attackers only"

See the commented_config.jsonc for detailed examples.

Wild Resource Structure Toggle

New master switch: EnableWildResourceStructureDamageNumbers

Control whether players see damage when harvesting rocks, trees, bushes, and nodes. Most servers will want this OFF to reduce clutter.

Player Commands

Code: 
Command                    | Description                                        | Persistent
---------------------------|----------------------------------------------------|-----------
/dmg                       | Toggle damage numbers on/off                       | Yes
/dmg <theme>               | Enable with specific theme (e.g., /dmg High_Contrast) | Yes
/dmg.solo                  | Toggle solo mode                                   | Yes
/dmg.hitloc                | Toggle exact hit location mode                     | Yes
/dmg.size <value|reset>    | Set text size (0.1-5.0)                            | Yes
/dmg.lifetime <value|reset>| Set display duration (0.1-25s)                     | Yes
/dmg.jitter <value|reset>  | Set spread amount (0-500)                          | Yes
/dmg.themes                | List available color themes                        | -
/dmg.help                  | Show all commands and current settings             | -

Admin Commands:
Code: 
Command              | Description
---------------------|---------------------------
/dmg.config          | Reload configuration (hot reload)
/dmg.reload          | Full plugin reload
/dmg.distance <value>| Set max view distance

For Server Admins

Breaking Change: Configuration Restructured

The configuration format has been completely redesigned for v2.0.0.

Recommended Migration:
  1. Backup your existing config.json
  2. Delete the old config files
  3. Let the plugin generate fresh configs with the new structure
  4. Customize from the new commented_config.jsonc template

The new commented_config.jsonc includes 750+ lines of detailed documentation with examples for every setting.

New Configuration Sections

PlayerCustomization - Control what players can customize:
Code: 
"PlayerCustomization": {
  "AllowSizeOverride": true,
  "AllowLifetimeOverride": true,
  "AllowJitterOverride": true,
  "AllowSoloMode": true,
  "SoloModeByDefault": false,
  "AllowExactHitLocationToggle": true,
  "DefaultExactHitLocationEnabled": true,
  "DefaultSize": 1.0,
  "DefaultLifetime": 1.0,
  "DefaultJitter": 100.0
}

DamageSourceControl - Master switches for damage types:
Code: 
"DamageSourceControl": {
  "EnableStructureDamageNumbers": true,
  "EnableWildDamageNumbers": true,
  "EnableWildResourceStructureDamageNumbers": true
}

VisibilityRules - The new relationship-based matrix system (see config for full structure)

DamageNumberColorThemes - Array of customizable themes

Database Changes

New columns added to the player state table:
  • Theme - Selected color theme
  • Size, Lifetime, Jitter - Player overrides
  • Solo - Solo mode state
  • HitLoc - Hit location mode state

New option: TablePrefix - Useful when sharing a database across multiple plugins/servers.

The plugin handles schema migration automatically.

What's Removed

Vanilla Mode Toggle - The plugin now exclusively controls damage number display. The vanilla ARK damage numbers are completely disabled to prevent conflicts.

Under the Hood

Performance Optimizations
  • Reduced database queries per damage event
  • Zero-allocation rendering pipeline
  • Faster player lookups in high-player scenarios

Stability Improvements
  • Safe config reload during active combat
  • Graceful shutdown even with in-flight events
  • Proper memory cleanup when players disconnect
  • Defensive handling of rapid player joins/leaves

Database Reliability
  • Automatic schema migration on plugin update
  • Continues operating even if individual operations fail
  • Faster bulk saves for multiple player updates

Requirements
  • ARK Server API for ASA v1.19+
  • MySQL/MariaDB (optional, for persistent player settings)

Support

KDV_DamageNumbers v2.0.0 - Built by KADevARK

v1.0.4

v1.0.3: Core Stability & Performance Hardening
* [Improvement] Core backend components have been refactored to further enhance the plugin's performance and stability under heavy server load.

v1.0.4: Join Message for Player Toggle Status
  • [Notice] Config update required.
  • [Feature] Players now receive a chat message on join showing their damage numbers status and the toggle command. Fully customizable or can be disabled. Helps console players discover the plugin, or as a reminder.
Back
Top