Skip to content
On this page3 sections

Damage Numbers is an AsaApi plugin. Install it on every map where you want numbers to appear — it is entirely server-side, so players do not install anything.

Steps

  1. Stop the server. The plugin file is locked while it is running.
  2. Place the plugin folder under your AsaApi plugins directory:
path
ShooterGame/Binaries/Win64/ArkApi/Plugins/DamageNumbers/
  1. Adjust the configuration file to taste — see Configuration.
  2. Start the server.
  3. Check the startup log for the Damage Numbers line, which reports the running version and build stamp.

Turn off the vanilla floating text

Leave the game's own damage numbers off in Game.ini. With them on, the server sends its own numbers for everything to everyone, on top of these.

ini
[/script/shootergame.shootergamemode]
ShowFloatingDamageText=false

Save configuration without a BOM

The config file must be plain UTF-8 with no byte order mark. Some editors and PowerShell's default encoding add one invisibly, which breaks parsing in ways that are hard to spot.

Player choices

Each player's /dmg choice is saved in players.json, next to config.json. The plugin creates it the first time someone uses the command — do not create it yourself. Keep it when you update, or everyone goes back to the default.

Updating

Stop the server, replace the plugin file, start it again. If the file appears locked immediately after shutdown, wait about thirty seconds and retry — the lock can linger. Configuration changes are read once at load, so they take effect at the next restart.