OutCombatLog

⚔️ OutCombatLog — Ultimate Combat Logging Prevention System

<b>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.</b>

---

⚔️ About OutCombatLog

complete combat logging prevention system 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 | |---------|-------------| | Login Notification | Configurable duration (default: 30 seconds) that resets with each hit | | Login Notification | Beautiful BossBar on top with real-time timer and custom text | | Login Notification | Configurable - killer remains in PvP after kill to prevent instant logout | | Login Notification | 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 | |---------|-------------| | Item Cooldowns | Block all commands during PvP except allowed ones (msg, tell, help, etc.) | | Item Cooldowns | Prevent players from opening Ender Chests during combat | | Item Cooldowns | 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_CHEST | 15 seconds | | ENDER_CHEST | 60 seconds | | ENDER_CHEST | 30 seconds | | ENDER_CHEST | 10 seconds | | ENDER_CHEST | 10 seconds | | ENDER_CHEST | 30 seconds |

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

🔊 Audio & Visual

| Feature | Description | |---------|-------------| | BossBar Styles | Configurable sound when entering PvP | | BossBar Styles | Ticking sound 3 seconds before PvP ends | | BossBar Styles | Victory sound when PvP timer expires | | BossBar Styles | 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 | |---------|-------------| | Update Checker | `/ocl reload` - Reload configuration without restart | | Update Checker | `/ocl list` - View all items with cooldowns | | Update Checker | `/ocl check` - Check current PvP status | | Update Checker | `/ocl info` - View plugin information and statistics | | Update Checker | Automatic notification when new version is available |

---

📥 Installation Guide

| Step | Action | |------|--------| | 1️⃣ | Enjoy! — Get the latest `.jar` from Enjoy! | | 2️⃣ | Enjoy! — Place the JAR into your server's `plugins/` folder | | 3️⃣ | Enjoy! — Restart your server (or use `/reload` if you must) | | 4️⃣ | Enjoy! — 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