Install Combat Log

Requirements

RequirementDetails
ServerPaper or Folia 26.1 or newer
JavaJava 25
Internet on first startCombat Log downloads Kotlin and the database drivers once through the server’s library loader.
PlaceholderAPIOptional. Enables the placeholders.
WorldGuardOptional. Needed for safe zones. Without it, only disabled-worlds works.
DatabaseOptional. Stats are saved in SQLite in the plugin folder by default. Use MySQL, MariaDB, PostgreSQL or MongoDB to share them between servers. See Storage.

Install

  1. Place CombatLog-1.0.0.jar in the plugins folder.
  2. Start the server once so the default files are created, then stop it.
  3. Paste your license key into license-key in plugins/CombatLog/config.yml.
  4. Start the server. The console shows License verified with the product and version.
  5. Hit another player in survival. You both see the combat timer above the hotbar.
Testing on your own
Test in survival mode. Players in creative or spectator are never tagged, and neither are players with combatlog.bypass. A * permission includes combatlog.bypass.

Created files

FilePurpose
config.ymlLicense key, storage, combat time, timer resets, countdown sound, item cooldowns, blocked potions, command and teleport blocking, safe zones and the wall, disabled worlds, the boss bar, kill and death messages, kill streaks and anti-farm.
messages.ymlEvery chat, action bar and boss bar message, the kill and death messages, and the sound of each message. New messages from plugin updates are added to it by themselves.
stats.dbKills, deaths and kill streaks, when type: sqlite under storage: is set.
tags.ymlCombat time left when the plugin stopped, blocked potion effects waiting to be given back, and who logged out in combat. Restored when each player joins again.
.installation-id, .installation-v2.keyIdentify this server for the license. Don’t delete or copy them.