CombatLogX Plugin Guide

HolyHosting
Oct 31
3 min read

✨ One of the best parts of running a Minecraft server is having full control over the gameplay — including PvP combat. By default, Minecraft servers allow player vs. player combat, which is widely used in many types of servers. However, there’s a recurring issue: players can log out mid-fight, unfairly escaping death and depriving their opponent of well-earned loot. 💥

This is where CombatLogX comes in — a powerful Bukkit plugin designed to prevent combat logging and ensure fair fights. Installing it on your Paper server enhances your PvP experience with unique features like a visible combat timer, restricting players from logging out until the fight is over. 🕒 It also manages command restrictions, item drops, and protection mechanics, creating a balanced and immersive combat environment.

In this guide, we’ll explore what CombatLogX is, how to install it, and how you can use its many features to take your server’s PvP system to the next level. ⚔️

🧩 Overview

CombatLogX was first developed by SirBlobman in 2016 and quickly became a must-have PvP plugin on Spigot, amassing over 210,000 downloads. It supports Minecraft versions 1.8.8 through 1.19.2, including pre–1.9 combat mechanics.

While its main function is preventing combat logouts, the plugin includes a wealth of additional features — from boss bars to death effects, and even trap prevention. Most of these can be fine-tuned in the configuration files, while expansions give you deeper control and customization.

Let’s go over how to get CombatLogX up and running! ⚙️

💾 Installation

Go to the official CombatLogX page on Spigot and click “Download Now.”
Save the downloaded .zip file to an easy-to-access location.
Log into your Holy Hosting control panel and open FTP File Access.
Sign in using your control panel password.
Open the plugins folder.
Click Upload, then drag and drop the downloaded .zip file.
Wait for the upload to complete, then Unzip the file from the FTP menu.
Once done, return to your panel and restart your server.
Use /plugins in chat to confirm installation.
📝 Note: BlueSlimeCore is a required dependency included in the archive.

⚔️ Main Features

With CombatLogX installed, you can now explore its main features and customize them to suit your server’s playstyle. Most adjustments are made directly in the configuration files — no complicated commands needed!

🔥 Combat Logging Prevention

The core feature: players who disconnect during combat are punished. This ensures fair PvP encounters by preventing players from avoiding death. By default, logging out during combat results in the player dropping all their items, with a 10-second combat timer. You can easily modify these values in the config file.

🧱 Combat Expansions

CombatLogX comes with multiple expansions, which are add-ons that extend the plugin’s features. These range from combat glow effects to status scoreboards. You can enable or disable each expansion individually for full control.

💎 Rewards

Reward your players for winning fights or slaying mobs! Configure custom reward commands, whitelists, and world restrictions in the expansions folder. You can even make rewards chance-based for more dynamic gameplay.

🛡 Loot Protection

Protects dropped loot for a set amount of time — by default, 30 seconds. If a player dies in the void, their items can automatically be transferred to their killer. You can also enable protection for players who disconnect mid-fight.

🌱 Newbie Helper

Give new players a fighting chance! When someone joins, they’re protected from PvP for 30 seconds unless they initiate combat. The /togglepvp command allows players to manually enable or disable PvP, perfect for survival or faction servers.

🗂 Accessing Expansion Files

Go to FTP File Access in your server panel.
Log in and open the plugins folder.
Navigate to CombatLogX → Expansions.
Inside, you’ll find configuration files for each module.
Edit config.yml as needed, click Save, and restart your server.
💡 Tip: Use /clx reload in-game to apply changes instantly!

💬 Commands & Permissions

CombatLogX provides several commands and permission nodes to customize access. Make sure to install LuckPerms or a similar permissions manager to assign them properly. Operators automatically have full access.