Understanding the Combat Tag Keep Inventory Plugin for Minecraft
Minecraft servers often face a classic dilemma: players want the convenience of keeping their precious gear after a fall into lava or a creeper explosion, but they also crave the high-stakes thrill of PvP where losing items is part of the risk. The vanilla keepInventory gamerule is an all-or-nothing switch. Turn it on, and nobody drops anything ever. Turn it off, and even a clumsy misstep into the void wipes out hours of progress. The Combat Tag Keep Inventory plugin elegantly solves this by splitting the difference, giving server owners precise control over when inventories are preserved and when they are forfeit.
How the Plugin Separates Natural Deaths from PvP Kills
At its core, the plugin introduces a combat tagging system. When a player is hit by another player, they receive a temporary “combat tag” that lasts for a configurable number of seconds. If the tagged player dies while the tag is active, the death is treated as a PvP kill and their inventory drops as normal. If they die from any other cause—mob attacks, environmental damage, starvation, or even a self-inflicted accident—the plugin respects the world’s keepInventory setting, which you will typically set to false. The result is a server where you can explore and build without fear of losing your enchanted diamond tools, yet every sword swing in a player duel carries real consequences.
This mechanic is perfect for survival servers that host designated PvP arenas, faction worlds, or simply want to encourage organic player conflict without punishing everyday gameplay. The plugin only activates in worlds you explicitly list in the config.yml file, so you can keep a peaceful creative world completely unaffected while a hardcore survival nether dimension uses the full combat-tag rules.
Key Configuration Options
Setting up Combat Tag Keep Inventory is straightforward. After placing the plugin in your server’s plugins folder and restarting, you will find a config.yml with three main settings:
- cooldownTime – The duration in seconds a player remains combat-tagged after the last PvP hit. A typical value is 30 seconds, but you can adjust it to make escaping a fight more or less forgiving.
- killCombatLoggers – A boolean (true/false) that determines whether a player who disconnects while combat-tagged is instantly killed. Setting this to true discourages cowardly log-outs during a fight, ensuring their items still drop.
- worlds – A list of world names where the plugin logic applies. Only worlds with keepInventory set to false in their own game rules will be affected. This prevents accidental double-keeping of items.
For example, a server with a main survival world called “world” and a PvP arena called “arena” might list both in the worlds section. In “world”, players keep items when a zombie kills them, but drop everything if another player lands the final blow. In “arena”, the same rules apply, making every duel a high-stakes gamble.
Permission-Based Exemptions
Not every player needs to be subject to the combat-tag rules. The plugin includes a special permission node: combattagkeepinv.exempt. Any player granted this permission will keep their inventory regardless of whether they are combat-tagged. This is ideal for staff members, event hosts, or VIPs who should not lose items during moderated PvP events. Importantly, this permission must be explicitly assigned; server operators do not automatically receive it. You can add it via your permissions plugin (like LuckPerms) to specific groups or players, ensuring fine-grained control.
Preventing Combat Logging Abuse
One of the most frustrating behaviors on PvP servers is combat logging—players disconnecting the moment they start losing a fight to avoid dropping their gear. With killCombatLoggers enabled, the plugin immediately eliminates this loophole. If a tagged player quits the game, they are killed by the server, and their inventory scatters on the ground at their logout location. This not only preserves the integrity of PvP but also adds a layer of strategy: you must commit to a fight once engaged, or risk losing everything without even the chance to fight back.
Many server administrators find that combining a moderate cooldown (20-30 seconds) with killCombatLoggers set to true creates the perfect balance. It gives players a brief window to escape and de-tag if they can break line of sight, but punishes those who try to cheat the system. Meanwhile, natural deaths remain completely safe, encouraging exploration and building without constant anxiety.
Installation and Compatibility
Combat Tag Keep Inventory is a lightweight plugin designed for Spigot, Paper, and other compatible Minecraft server software. It does not require any additional dependencies and runs smoothly alongside popular plugins like WorldGuard, EssentialsX, and anti-cheat solutions. The open-source nature of the project, available on GitHub under the developer Eric (yoonicode.com), means you can inspect the code, suggest improvements, or even fork it for custom modifications. For players who enjoy modded single-player experiences, a similar functionality can sometimes be found in modpacks, and if you are using a launcher like the foxygame.net launcher, you can conveniently browse and install mods right from the menu, making it easy to experiment with inventory management tweaks without manual file hunting.
Practical Use Cases on Your Server
This plugin shines in several common server scenarios:
- Faction or Towny servers – Keep inventory during wilderness exploration but force drops during faction wars or enemy encounters.
- Mini-game hubs – Apply the plugin only to a dedicated PvP world while leaving the lobby and build worlds untouched.
- Hardcore survival with PvP zones – Use WorldGuard regions to allow PvP only in certain areas, and let the plugin handle the inventory logic automatically when players fight there.
- Roleplay servers – Maintain immersion by letting characters die from mobs without losing their story items, but create real consequences for player duels.
Because the plugin checks the world’s keepInventory gamerule, you can even have different behaviors per world. For instance, set keepInventory to true in a creative world (the plugin will ignore it), and false in your survival world where the plugin activates. This layered approach gives you total flexibility without conflicting settings.
Final Thoughts on Smart Inventory Management
The Combat Tag Keep Inventory plugin fills a gap that vanilla Minecraft leaves wide open. It respects the player’s desire for a forgiving environment against environmental hazards while preserving the adrenaline of PvP. With simple configuration, permission-based exemptions, and a robust anti-combat-logging feature, it is a must-have for any server that wants to offer the best of both worlds. Whether you run a small community server or a large network, this plugin helps you tailor the death penalty exactly to your vision, keeping players engaged and fair play intact.