# CombatTimer<\/p>\n
**CombatTimer** is a lightweight and configurable Minecraft plugin that stops players from **escaping combat by logging out**.<\/p>\n
It is built for survival, SMP, factions, and PvP servers that want fair fights without constantly needing staff to punish combat loggers manually.<\/p>\n
CombatTimer can simply kill or ban combat loggers, or it can replace them with a **lootable logout villager** so the fight continues even after they disconnect.<\/p>\n
—<\/p>\n
## Key Features<\/p>\n
### Combat Timer<\/p>\n
CombatTimer tags players when they enter combat.<\/p>\n
You decide what should trigger combat:<\/p>\n
“`text
\nMOB
\nPLAYER
\nBOTH
\n“`<\/p>\n
This allows you to use CombatTimer for:<\/p>\n
– PvP-only combat tagging
\n– mob combat tagging
\n– full survival combat tagging
\n– faction or SMP combat protection<\/p>\n
The combat duration is fully configurable.<\/p>\n
—<\/p>\n
### On-Screen Combat Timer<\/p>\n
Players can clearly see when they are still in combat.<\/p>\n
Available display modes:<\/p>\n
| Mode | Description |
\n|——|————-|
\n| `ACTIONBAR` | Shows the timer above the hotbar |
\n| `BOSSBAR` | Shows the timer as a bossbar |
\n| `BOTH` | Shows both actionbar and bossbar |
\n| `NONE` | Hides the timer display |<\/p>\n
Bossbar color is configurable.<\/p>\n
—<\/p>\n
### Logout Villagers<\/p>\n
One of CombatTimer\u2019s main features is the optional **logout villager** system.<\/p>\n
When a player logs out during combat, they can be replaced by a villager at their logout location.<\/p>\n
That villager represents the logged-out player.<\/p>\n
Other players can:<\/p>\n
– find the logout villager
\n– click it
\n– open the combat logger\u2019s stored inventory
\n– loot items directly from the GUI
\n– kill the villager to treat the combat logger as killed<\/p>\n
If the combat logger rejoins while their villager still exists:<\/p>\n
– the villager is removed
\n– the remaining inventory is restored
\n– armor is restored
\n– offhand item is restored
\n– the player returns at the villager location<\/p>\n
Logout villagers are saved in the database and restored after server restarts, so combat loggers cannot escape by waiting for a reboot.<\/p>\n
—<\/p>\n
### Combat Logout Punishments<\/p>\n
If logout villagers are disabled, CombatTimer can still punish combat loggers directly.<\/p>\n
Supported punishment options:<\/p>\n
– kill on logout
\n– permanent combat-log ban
\n– temporary combat-log ban<\/p>\n
Temporary bans support flexible durations:<\/p>\n
“`text
\n30m
\n1h
\n1h 30m
\n2d
\n1w
\n“`<\/p>\n
If logout villagers are enabled, the configured punishment can still be applied when the villager is killed.<\/p>\n
—<\/p>\n
### Custom Ban System<\/p>\n
CombatTimer uses its own SQLite-backed ban system instead of relying on Minecraft\u2019s default ban list.<\/p>\n
This allows cleaner ban screens and better control over combat-log punishments.<\/p>\n
Bans are stored locally in:<\/p>\n
“`text
\nplugins\/CombatTimer\/combattimer.db
\n“`<\/p>\n
Staff can view and remove CombatTimer bans with plugin commands.<\/p>\n
—<\/p>\n
### Fully Configurable<\/p>\n
CombatTimer uses simple JSON configuration.<\/p>\n
Example config:<\/p>\n
“`json
\n{
\n “trigger_when”: “BOTH”,
\n “timer_seconds”: 30,
\n “timer_display”: “ACTIONBAR”,
\n “bossbar_color”: “GREEN”,<\/p>\n
“kill_on_logout”: true,
\n “ban_on_logout”: false,
\n “ban_type”: “PERMANENT”,
\n “tempban_duration”: “1d”,<\/p>\n
“logout_villagers_enabled”: true
\n}
\n“`<\/p>\n
—<\/p>\n
### Customizable Messages<\/p>\n
All plugin messages can be edited.<\/p>\n
You can customize:<\/p>\n
– combat timer text
\n– actionbar text
\n– bossbar text
\n– logout broadcasts
\n– logout villager names
\n– villager inventory title
\n– ban screen message
\n– command messages
\n– update notifications<\/p>\n
File structure:<\/p>\n
“`text
\nplugins\/CombatTimer\/<\/p>\n
config.json
\ncombattimer.db<\/p>\n
translations\/
\n messages.json
\n“`<\/p>\n
—<\/p>\n
### Bypass Permission<\/p>\n
Trusted players or staff groups can bypass combat tagging.<\/p>\n
“`text
\ncombattimer.bypass
\n“`<\/p>\n
—<\/p>\n
### Hot Reload Support<\/p>\n
Reload config and translation files without restarting the server.<\/p>\n
“`text
\n\/combattimer reload
\n“`<\/p>\n
Missing files are recreated automatically.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Alias:<\/p>\n “`text —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## Why Use CombatTimer?<\/p>\n Combat logging can ruin fights.<\/p>\n Common problems include:<\/p>\n – players disconnecting before dying CombatTimer solves this by keeping combat fair, visible, and configurable.<\/p>\n Use a simple timer, punish combat loggers directly, or enable logout villagers for a more interactive and loot-friendly system.<\/p>\n —<\/p>\n ## Best For<\/p>\n “`text —<\/p>\n ## Compatibility<\/p>\n – Minecraft **1.21+** —<\/p>\n ## Configuration Philosophy<\/p>\n CombatTimer is designed to be:<\/p>\n – **simple to configure** You decide when combat starts, how long it lasts, and what happens when someone logs out.<\/p>\n —<\/p>\n ## Support<\/p>\n If you encounter issues or have feature requests, feel free to open a ticket in the Discord server.<\/p>\n Keep combat fair, stop logout abuse, and make every fight count.<\/p>\n","protected":false},"excerpt":{"rendered":" A simple and lightweight CombatTimer plugin!<\/p>\n","protected":false},"featured_media":44360,"template":"","meta":{"_minecraft_slug":"combattimer","_minecraft_project_id":"vHq8YFx8","_minecraft_author":"nieuwjaar","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":21,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"combattimer.zip","_minecraft_size_bytes":14476010,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:42:35.279678Z","_minecraft_date_created":"2026-05-12T00:23:28.652439Z","_minecraft_date_modified":"2026-05-08T17:04:30.139871Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/combattimer","_minecraft_icon_attachment_id":44360,"_minecraft_imported_at":"2026-06-02T02:27:50+00:00","_minecraft_import_hash":"29115a29f6b9cc1190626abb2e3a7762","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-44359","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|——–|————-|
\n| `\/combattimer help` | Displays plugin commands |
\n| `\/combattimer reload` | Reloads config and messages |
\n| `\/combattimer unban
\n| `\/combattimer banlist [page]` | Lists active CombatTimer bans |<\/p>\n
\n\/ctimer
\n“`<\/p>\n
\n|———–|————-|———|
\n| `combattimer.help` | Allows `\/combattimer help` | true |
\n| `combattimer.reload` | Allows `\/combattimer reload` | op |
\n| `combattimer.unban` | Allows unbanning players | op |
\n| `combattimer.banlist` | Allows viewing CombatTimer bans | op |
\n| `combattimer.bypass` | Bypasses combat timer tagging | false |
\n| `combattimer.update.notify` | Allows receiving update notifications | op |<\/p>\n
\n– players saving loot by logging out
\n– PvP fights ending unfairly
\n– combat loggers avoiding consequences
\n– staff needing to handle reports manually
\n– players abusing restarts to escape combat<\/p>\n
\nPvP servers
\nSMP servers
\nSurvival servers
\nFaction servers
\nHardcore servers
\nEvent servers
\nLifesteal-style servers
\n“`<\/p>\n
\n– Spigot \/ Paper
\n– Lightweight with minimal performance impact<\/p>\n
\n– **fair for players**
\n– **useful for staff**
\n– **strong against combat logging**<\/p>\n