The killcam

Which deaths get one

A death is kept for a killcam when every one of these holds:

• the victim has exyliakillcam.use (everybody by default);
• a player killed them: the one the server credits with the kill, so a bow shot or a tamed wolf counts — or a mob, when deaths.mobs is on;
• it was not their own doing (a player is never their own killer);
• the world is not in deaths.disabled-worlds (names, any case);
• no other plugin is in charge of them, while deaths.skip-held-players is on — see Compatibility;
• they are not watching a killcam already;
• no plugin cancelled the death.

The killer's figures are read at that moment: their name (a mob's custom name, or its type such as Zombie), the hearts they had left, the item in their main hand and the distance between the two.

What is recorded

ExyliaKillCam does not start recording when somebody dies; it is always recording. ExyliaLib's black box keeps the last stretch of everything around every player in memory, and on the death the seconds before it are cut out. What a capture holds:

• everything within recording.radius blocks (24 by default) of anywhere the victim was during those seconds — a chase, a pearl, an elytra flight: whoever and whatever was near them is in it;
• the ground as it was when the fight started, including blocks placed and broken since;
• killcam.seconds-before seconds (plus one) before the death, and two after it, for the fall and the puff;
• never a player in vanish, while recording.hide-vanished is on.

The bodies, the arrows and the blocks are what the server saw and decided. The killcam shows the server's answer, which is not always what a player's client showed them at the time — see the FAQ.

A player the box has no frames of (they had just joined, or the server just started) gets no killcam, and nothing is said.

After the respawn

What happens next is the player's mode:

The killcam starts or is offered once, on the respawn that follows the death, and only when that respawn comes within a minute of it. Somebody who waits longer on the death screen gets nothing by itself, but can still type /killcam.

The shot

The summary

Sent when a killcam ends, however it ended — at the end, skipped, or taken over by another plugin:

The lines are summary in messages.yml; Fists is fists.

Watching again

/killcam plays the player's last death again, from the start, as long as it is younger than killcam.rewatch-minutes (5 by default). Only the last one is kept: a new death replaces it, and leaving the server drops it.

A killcam started by itself in AUTO that fails for one of these reasons says nothing: the player simply stays where they respawned.

Skipping

Three ways out, all to the same place — back as they were, with the summary:

• the SKIP button on the hotbar;
• /killcam skip;
• another plugin taking the player over (a duel starting, a queue moving them), which ends the killcam first.

Skipping while the killcam is still loading cancels it before the player is moved. /killcam skip when not watching does nothing.

The skip button

The button lives in lang/<code>/hotbar.yml. It is drawn on the client by ExyliaLib's overlays and never put in the inventory: the viewer's own items stay underneath, untouched, and come back when the killcam ends.

lock: FULL
pickup: false
hide_rest: true
 
items:
  skip:
    slot: 4
    material: BARRIER
    name: '{error}&lSKIP'
    lore:
      - ''
      - '{secondary}Information:'
      - ' {letters_black}▎ {letters}Leave the killcam and go back'
      - ' {letters_black}▎ {letters}to where you were.'
      - ''
      - '{warning}➥ Click to skip'
      - ''
    actions:
      - 'exyliakillcam:skip'

lock: FULL freezes the whole inventory, pickup: false refuses picking items up, and hide_rest: true shows every other slot empty. Slots 0-8 are the hotbar. The keys are ExyliaLib's; the full reference is on the library's overlays page. The action exyliakillcam:skip is what the button runs, and can be put on more items.

If the file is missing or broken the console says so and no button is shown; /killcam skip still works.