CombatBodies and Logout Flow

This page covers the optional combat-logging module that ships with Dead Body.

What CombatBodies does

When enabled, CombatBodies can:

• tag players during combat
• spawn a configurable logout proxy if a tagged player disconnects
• let players use /logout for a safe exit flow
• optionally spawn a Dead Body corpse if the proxy dies

Main file

All combat-logging behavior lives in:

• combat-bodies.yml

Main commands

CombatBodies registers:

• /combatbodies
• /logout

Main permission nodes

• combatbodies.admin
• combatbodies.logout

Main config lanes

combat tagging

Review:

• combat-tag.enabled
• combat-tag.duration-seconds
• tag-on-pvp
• tag-on-pve
• tag-on-environment

proxy body behavior

Review:

• proxy.enabled
• proxy.entity-type
• proxy.lifetime-seconds
• whether armor and hand items are copied
• proxy nameplate settings

safe zones

Review:

• safe-zones.enabled
• safe world list
• spawn-radius
• whether teleport clears combat
• whether proxy spawn is disabled in safe zones

login block and death behavior

Review:

• login-block.enabled
• death-behavior.*

logout countdown

Review:

• logout.countdown-seconds
• action bar format
• sound and particle effects

Relationship to the core corpse system

CombatBodies uses the same Dead Body chat branding and corpse spawn path. It is not a separate visual system with separate branding rules.

If a proxy dies and is configured to spawn a corpse, that corpse still uses the main Dead Body corpse logic.

Best practice

decide whether you want this module at all

Not every server needs combat logging. If you do not need it, leave it disabled and keep the plugin focused on normal death bodies.

test with two real players

Combat logging behavior is much easier to validate with an actual PVP test than with solo assumptions.

review safe zones carefully

If your server already uses region plugins or custom spawn protections, make sure CombatBodies does not duplicate or fight those rules.

Next pages

• admin Commands and Permissions
• integrations and Troubleshooting