OutCombatLog
✨ Anti-PvP leave, Item CD, Punishments. BossBar, sounds, chat messages, and more!
⚔️ 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
/reloadfor 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
# ⏱️ PvP tag duration (in seconds)
# After taking damage from another player, the player enters PvP mode
# for this number of seconds. The timer resets with each new hit.
pvp-time: 30
# ⚰️ Death in PvP mode
# true: Upon death, the victim exits PvP, BUT the killer remains in PvP
# (so they cannot immediately run away/logout after the kill)
# false: Upon death, both players exit PvP
combat-on-death: true
# 📢 Logout notification radius (in blocks)
# When a player logs out during PvP and dies, all players within this radius
# will see the logout-punishment message
# 0 = disable notifications
logout-broadcast-radius: 50
# Commands that players can use even while in PvP mode
# All other commands will be blocked
allowed-commands:
- msg
- tell
- w
- r
- reply
- whisper
- report
- help
- discord
- donate
- sites
- combatlog
- outcombatlog
- ocl
- pvp
