⚔️ 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

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