⚔️ OutCombatLog — Ultimate Combat Logging Prevention System

The most advanced combat logging prevention plugin for Minecraft. Beautiful BossBar timers, item cooldowns, command blocking, and complete customization for your server's PvP experience.

---

⚔️ About OutCombatLog

OutCombatLog is not just another combat logger — it's a complete combat logging prevention system for your Minecraft server. Unlike standard plugins that simply punish players, OutCombatLog delivers a professional experience with beautiful BossBar timers, stunning visual feedback, and unparalleled customization options.

Whether you're running a small PvP server with friends or a large factions network with hundreds of players, OutCombatLog adapts to your needs with its flexible configuration system, item cooldowns, and comprehensive combat protection.

---

✨ Feature Showcase

⚔️ Core PvP Features

Feature	Description
PvP Timer	Configurable duration (default: 30 seconds) that resets with each hit
BossBar Display	Beautiful BossBar on top with real-time timer and custom text
Combat on Death	Configurable - killer remains in PvP after kill to prevent instant logout
Logout Punishment	Players who log out during PvP are killed with item drops like normal death
Login Notification	Players are notified when they log in if they left during PvP

🛡️ Protection & Safety

Feature	Description
Command Blocking	Block all commands during PvP except allowed ones (msg, tell, help, etc.)
Ender Chest Block	Prevent players from opening Ender Chests during combat
Logout Broadcast	Alert players in radius (configurable) when someone combat logs
Item Cooldowns	Custom cooldowns for specific items during PvP only

⏱️ Item Cooldowns (EXAMPLE)

Item	Default Cooldown
ENDER_PEARL	15 seconds
ENCHANTED_GOLDEN_APPLE	60 seconds
GOLDEN_APPLE	30 seconds
CHORUS_FRUIT	10 seconds
FIREWORK_ROCKET	10 seconds
ENDER_CHEST	30 seconds

Note: All cooldowns are fully configurable and only apply during PvP mode!

🔊 Audio & Visual

Feature	Description
Combat Start Sound	Configurable sound when entering PvP
Combat Tick Sound	Ticking sound 3 seconds before PvP ends
Combat End Sound	Victory sound when PvP timer expires
BossBar Customization	Full RGB color support, custom text, and timer display
BossBar Styles	Multiple styles: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20

👑 Admin Features

Feature	Description
Config Reload	/ocl reload - Reload configuration without restart
Item List	/ocl list - View all items with cooldowns
Combat Status	/ocl check - Check current PvP status
Plugin Info	/ocl info - View plugin information and statistics
Update Checker	Automatic notification when new version is available

---

📥 Installation Guide

Step	Action
1️⃣	Download — Get the latest .jar from Modrinth
2️⃣	Install — Place the JAR into your server's plugins/ folder
3️⃣	Restart — Restart your server (or use /reload if you must)
4️⃣	Configure — Edit plugins/OutCombatLog/config.yml to your liking
5️⃣	Enjoy! — Players are now protected from combat loggers

⚠️ Important: A full server restart is strongly recommended over /reload for optimal performance and to avoid any plugin conflicts.

📊 bStats Metrics

OutCombatLog uses bStats to collect anonymous usage statistics. This helps us improve the plugin based on real usage data. Below is the live statistics chart for OutCombatLog:

---

🎮 Commands & Permissions

👤 Player Commands

Command	Description	Permission	Default
/ocl	Main plugin command	outcombatlog.use	✅ All players
/ocl list	List all items with cooldowns	outcombatlog.use	✅ All players
/ocl check	Check current PvP status	outcombatlog.use	✅ All players
/outcombatlog	Alias for main command	outcombatlog.use	✅ All players
/combatlog	Alias for main command	outcombatlog.use	✅ All players
/cl	Alias for main command	outcombatlog.use	✅ All players
/pvp	Alias for main command	outcombatlog.use	✅ All players

👑 Admin Commands

Command	Description	Permission	Default
/ocl reload	Reload plugin configuration	outcombatlog.admin	❌ Ops only
/ocl info	View detailed plugin information	outcombatlog.admin	❌ Ops only

🔑 Permissions

Permission	Description	Default
outcombatlog.use	Use basic plugin commands	✅ All players
outcombatlog.admin	Admin commands (reload, info)	❌ Ops only
outcombatlog.bypass	Bypass all combat restrictions	❌ Ops only

---

⚙️ Configuration Deep Dive

📁 Core Configuration

prefix: "&f[&x&E&5&4&1&E&7ᴄ&x&D&B&3&9&D&Eᴏ&x&D&1&3&1&D&5ᴍ&x&C&7&2&9&C&Cʙ&x&B&D&2&1&C&3ᴀ&x&B&3&1&8&B&Aᴛ&x&A&9&1&0&B&1ʟ&x&9&F&0&8&A&8ᴏ&x&9&5&0&0&9&Fɢ&f]"

# PvP tag duration (in seconds)
pvp-time: 30

# Death mode in PvP
# true:  Victim exits PvP, BUT killer remains in PvP
# false: Both players exit PvP
combat-on-death: true

# Logout broadcast radius (in blocks)
# 0 = disable broadcasting
logout-broadcast-radius: 25

# Commands allowed during PvP
allowed-commands:
  - msg
  - tell
  - w
  - r
  - reply
  - whisper
  - report
  - help
  - discord
  - donate
  - sites
  - combatlog
  - outcombatlog
  - ocl
  - pvp

# List of all materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
item-cooldowns:
  ENDER_PEARL: 15
  ENCHANTED_GOLDEN_APPLE: 60
  GOLDEN_APPLE: 30
  CHORUS_FRUIT: 10
  FIREWORK_ROCKET: 10
  ENDER_CHEST: 30

bossbar:
  # Enable/disable bossbar
  enabled: true

  # Bossbar color
  # Available colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
  color: "RED"

  # Bossbar style
  # Available styles:
  # • PROGRESS      - solid bar
  # • NOTCHED_6     - divided into 6 parts
  # • NOTCHED_10    - divided into 10 parts
  # • NOTCHED_12    - divided into 12 parts
  # • NOTCHED_20    - divided into 20 parts
  overlay: "PROGRESS"
  text: "&5⚔ &x&E&5&4&1&E&7ᴄ&x&D&B&3&9&D&Eᴏ&x&D&1&3&1&D&5ᴍ&x&C&7&2&9&C&Cʙ&x&B&D&2&1&C&3ᴀ&x&B&3&1&8&B&Aᴛ&x&A&9&1&0&B&1ʟ&x&9&F&0&8&A&8ᴏ&x&9&5&0&0&9&Fɢ &5⚔"

  # Show remaining time in text
  # true  - %seconds% will be replaced with the number (15, 5)
  # false - %seconds% will be removed or left as is
  show-time: true

sounds:
  # Enable/disable all sounds
  enabled: true

  # Sound when entering PvP
  combat-start: "BLOCK_BELL_USE"

  # Ticking sound before PvP ends
  combat-tick: "BLOCK_NOTE_BLOCK_HAT"

  # Sound when PvP ends
  combat-end: "ENTITY_PLAYER_LEVELUP"

messages-enabled:
  logout-punishment: true
  logout-return-message: true
  command-blocked: true
  combat-status: true
  not-in-combat: true
  config-reloaded: true
  no-permission: true
  enderchest-blocked: true
  combat-ended: true
  item-cooldown: true
  plugin-info: true
  cooldowns-list: true

messages:
  # When player logs out during PvP
  logout-punishment: "&e%player% &cʟᴇꜰᴛ ᴛʜᴇ ꜱᴇʀᴠᴇʀ ᴅᴜʀɪɴɢ ᴘᴠᴘ!"

  # When returning after logout punishment
  logout-return-message: "&cʏᴏᴜ ʟᴇꜰᴛ ᴅᴜʀɪɴɢ ᴘᴠᴘ ᴀɴᴅ ᴡᴇʀᴇ ᴀᴜᴛᴏᴍᴀᴛɪᴄᴀʟʟʏ ᴋɪʟʟᴇᴅ..."

  # Command blocked during PvP
  command-blocked: "&c❌ ᴄᴀɴɴᴏᴛ ᴜꜱᴇ ᴄᴏᴍᴍᴀɴᴅꜱ ᴅᴜʀɪɴɢ ᴄᴏᴍʙᴀᴛ!"

  # Combat status check
  combat-status: "&6⚔ ᴘᴠᴘ ꜱᴛᴀᴛᴜꜱ:\n &7└ ᴛɪᴍᴇ ʟᴇꜰᴛ: &e%time% ꜱᴇᴄ\n &7└ ᴏᴘᴘᴏɴᴇɴᴛ: &c%opponent%"

  # Not in combat
  not-in-combat: "&a✓ ʏᴏᴜ ᴀʀᴇ ɴᴏᴛ ɪɴ ᴘᴠᴘ ᴍᴏᴅᴇ"

  # Config reloaded
  config-reloaded: "&a✓ ᴄᴏɴꜰɪɢᴜʀᴀᴛɪᴏɴ ʀᴇʟᴏᴀᴅᴇᴅ"

  # No permission
  no-permission: "&cɴᴏ ᴘᴇʀᴍɪꜱꜱɪᴏɴ"

  # Ender chest blocked
  enderchest-blocked: "&c❌ ᴄᴀɴɴᴏᴛ ᴏᴘᴇɴ ᴇɴᴅᴇʀ ᴄʜᴇꜱᴛ ᴅᴜʀɪɴɢ ᴄᴏᴍʙᴀᴛ!"

  # Combat ended
  combat-ended: "&a✓ ᴘᴠᴘ ᴍᴏᴅᴇ ᴇɴᴅᴇᴅ"

  # Item on cooldown
  item-cooldown: "&c❌ ɪᴛᴇᴍ ᴏɴ ᴄᴏᴏʟᴅᴏᴡɴ: &e%.1f &cꜱᴇᴄ"

  # Plugin info
  plugin-info: "&fᴘʟᴜɢɪɴ ɪɴꜰᴏ:\n&7└ &fᴠᴇʀꜱɪᴏɴ: &e2.3\n&7└ &fᴀᴜᴛʜᴏʀ: &evɪꜱꜱᴇᴅ ꜱᴛᴜᴅɪᴏ\n&7└ &fᴘᴠᴘ ᴛɪᴍᴇ: &e%pvptime% ꜱᴇᴄ\n&7└ &fᴅᴇᴀᴛʜ ᴍᴏᴅᴇ: &e%deathmode%\n&7└ &fɪᴛᴇᴍꜱ: &e%itemscount%"

  # Cooldowns list header
  cooldowns-list: "&fɪᴛᴇᴍꜱ ᴡɪᴛʜ ᴄᴏᴏʟᴅᴏᴡɴꜱ:\n%items%"

  # Cooldown item format
  cooldowns-item-format: "&7└ &f%material%: &e%cooldown% ꜱᴇᴄ"

check-updates: true