Configuration Documentation

config.yml
Global plugin messages and shared behavior

• messages.no-permission
• messages.only-players
• messages.reloaded

death-messages.yml
Settings section

• settings.enabled
• settings.delivery-mode
• settings.send-delay-ticks
• settings.broadcast-mode
• settings.radius-blocks
• settings.suppress-event-death-message
• settings.last-attacker-window-seconds
• settings.use-display-names
• settings.use-named-mob-messages
• settings.show-custom-death-msg-on-all-weapons
• settings.long-range-attacks-count-as-projectiles
• settings.long-range-projectile-threshold-blocks
• settings.duckshot-integration-enabled
• settings.duckshot-custom-messages-enabled
• settings.vehiclemc-integration-enabled
• settings.vehiclemc-attribution-radius-blocks
• settings.vehiclemc-attribution-min-speed-blocks-per-tick
• settings.debug

Parachute section

• parachute.enabled
• parachute.item
• parachute.require-in-inventory
• parachute.require-not-in-offhand
• parachute.min-fall-distance

Message sections

• death-messages.suffix
• death-messages.unknown
• death-messages.pvp.*
• death-messages.duckshot.pvp.*
• death-messages.duckshot.mob.*
• death-messages.mob.*
• death-messages.namedmob.*
• death-messages.natural.*
• mob-names.*

death-spectate.yml
General section

• general.debug

Respawn section

• respawn.forceInstantRespawn
• respawn.forceSurvivalOnEnd
• respawn.spawn.world
• respawn.spawn.x
• respawn.spawn.y
• respawn.spawn.z
• respawn.spawn.yaw
• respawn.spawn.pitch

UI section

• ui.showTitle
• ui.bossbar.enabled
• ui.bossbar.title
• ui.actionbar.enabled
• ui.actionbar.text
• ui.messages.[PROFILE][]
• title
• subtitle

Transition section

• transition.enabled
• transition.screen.effect
• transition.screen.duration-ticks
• transition.screen.amplifier
• transition.screen.ambient
• transition.screen.particles
• transition.screen.icon
• transition.sound.name
• transition.sound.volume
• transition.sound.pitch
• transition.maxDistance
• transition.speed
• transition.easeInOut

Corpse Integration section

• corpseIntegration.enabled
• corpseIntegration.mode
• corpseIntegration.scoreboardTag
• corpseIntegration.pdcKey
• corpseIntegration.searchRadius
• corpseIntegration.retryTicks

Recommended corpse mode notes:

• AUTO - recommended public/default mode
• SCOREBOARD_TAG - use if your corpse plugin tags entities
• PDC_KEY - use if your corpse plugin marks entities with a persistent data flag
• OFF - disables corpse lookup

Camera section

• camera.smoothing.enabled
• camera.smoothing.alpha
• camera.smoothing.maxDistancePerTick
• camera.classifier.roofMaxDistance
• camera.classifier.undergroundY
• camera.safety.minDistanceFromTarget
• camera.safety.maxClipResolveChecks
• camera.safety.shrinkMaxSteps
• camera.safety.shrinkStep

Profiles section

• profiles.durationMultiplier
• profiles.PVP_PROJECTILE.*
• profiles.PVP_MELEE.*
• profiles.MOB_PROJECTILE.*
• profiles.MOB_MELEE.*
• profiles.FALL.*
• profiles.DROWN.*
• profiles.EXPLOSION.*
• profiles.VOID.*
• profiles.DEFAULT.*

Per-profile / per-stage tuning can include:

• skipSpectate
• respawnSeconds
• stages
• type
• seconds
• ticks
• radius
• height
• rotationDegrees
• panAmplitude
• rise
• fovSpeedAmplifier

[HR][/HR]

Quick Setup Guide

1. Drop DeathPlus.jar into your server plugins folder.
2. Start the server once to generate all default files.
3. Set the DeathSpectate respawn location with /deathspectate setspawn.
4. Review death-messages.yml if you want to change message style, delivery mode, broadcast mode, integrations, or placeholders.
5. Review death-spectate.yml if you want to tune the smart kill-cam behavior, UI, transitions, corpse integration, or profile timings.
6. Use the in-game GUI and editor tools to make adjustments without manually editing every section.

[HR][/HR]

How The Smart Kill-Cam Chooses Shots

DeathSpectate is designed to do more than a simple spectator teleport. It tries to build a camera path that makes sense for the death scene.

• If the death is out in the open, wider orbit and overview style shots can be used.
• If the death happens in tighter areas, indoor pan or shorter tracking shots can be used instead.
• If a corpse plugin is available and found, the camera can transition toward the corpse instead of only focusing on the killer.
• If the death type changes, the profile can also change, which means melee, projectile, mob, fall, drowning, explosion, void, and default deaths can all feel different.
• Camera safety values help reduce bad camera positions, clipping, and invalid line-of-sight behavior.

This is the core reason DeathPlus feels like a smarter and more cinematic kill-cam system than standard post-death spectator plugins.

[HR][/HR]

Death Message Notes

The DeathMessages module is built so that servers can make death output match their actual gameplay.

• PvP deaths can use player, weapon, and distance-aware placeholders.
• Mob deaths can use mob name handling, named mob handling, and fallback natural death messaging.
• Duckshot integration allows custom weapon-aware messages when enabled.
• VehicleMC integration allows vehicle-attributed kills when enabled and when movement thresholds are met.
• Last attacker windows allow follow-up deaths such as falling, drowning, or lava deaths to still credit the relevant attacker when configured.

[HR][/HR]

UI / Editor Documentation

/deathplus gui

• Main entry point for admin configuration access.

/deathmessages gui

• Used for quick DeathMessages editing and overview access.

/deathspectate gui

• Used for quick DeathSpectate access and settings navigation.

/deathspectate editor

• Used to tune or build spectate profiles and stage layouts for different death types.

/deathspectate ui

• Used to edit title, subtitle, actionbar, and bossbar presentation for the death sequence.

These editor tools are important because the plugin is designed for real staff use, not only for direct YAML editing.

[HR][/HR]

Override File System

DeathPlus uses an override workflow designed for real admins and real live servers:

• Base YAML files stay readable and commented
• In-game changes are written to override files
• Overrides are loaded after the base files and take priority

Override files:

• death-messages-overrides.yml
• death-spectate-overrides.yml

If you ever want to roll back in-game changes, remove the relevant override file and reload the plugin.

[HR][/HR]

Recommended Companion Setup

DeathPlus only

• Great if you want powerful death messages and a cinematic smart kill-cam system.

DeathPlus + Dead Body

• Recommended if you want the full physical + cinematic death package: lootable corpses plus smart corpse-aware death spectating.

DeathPlus + Duckshot

• Recommended for servers with custom firearms or weapon systems.

DeathPlus + VehicleMC

• Recommended for vehicle-heavy combat servers that need proper run-over attribution.

[HR][/HR]

Permissions Reference

• deathplus.admin
  Main admin permission for reloads, setup tools, GUIs, editor access, and module control.
  
• deathplus.spectate.bypass
  Allows testing or bypass access for DeathSpectate toggle style commands.

[HR][/HR]

Command Reference

/deathplus

• /deathplus
• /deathplus gui
• /deathplus gui main
• /deathplus gui messages
• /deathplus gui spectate
• /deathplus reload
• /deathplus status
• /deathplus files
• /deathplus help

/deathmessages

• /deathmessages
• /deathmessages gui
• /deathmessages reload
• /deathmessages status
• /deathmessages test
• /deathmessages help

/deathspectate

• /deathspectate
• /deathspectate gui
• /deathspectate ui
• /deathspectate editor
• /deathspectate editor [PROFILE]
• /deathspectate preview stop
• /deathspectate reload
• /deathspectate status
• /deathspectate on
• /deathspectate off
• /deathspectate toggle
• /deathspectate on [player]
• /deathspectate off [player]
• /deathspectate toggle [player]
• /deathspectate setspawn
• /deathspectate end [player]
• /deathspectate help

[HR][/HR]

Troubleshooting / Admin Notes

• If spectate does not behave as expected, confirm your respawn spawn location has been set correctly.
• If corpse tracking is not being used, verify corpseIntegration settings and the mode selected in death-spectate.yml.
• If custom weapons are not appearing in messages, verify the relevant integration settings are enabled.
• If vehicle-attributed kills are not triggering, verify VehicleMC integration settings and threshold values.
• If in-game changes seem to override manual edits, check the override files first.
• If debugging is needed, enable the relevant debug options in the module config you are working on.

[HR][/HR]

Final Notes

DeathPlus was built for servers that want death to feel important.

Instead of a generic respawn flow, you get a full death experience layer:

• clear and customizable death messaging
• rich contextual kill attribution
• a cinematic smart kill-cam
• corpse-aware companion support
• practical in-game editing tools

Recommended companion: Dead Body

• Dead Body — Realistic Lootable Corpses (Player & Mob Bodies)

Built by Duq_ | mcwar.co