resurrection-logic.yml

The Resurrection System allows players to revive fallen teammates using a custom resurrection item. It provides fully configurable settings for timings, effects, sounds, holograms, cooldowns, and messages — ensuring a polished and immersive experience.

This feature is controlled through:

/plugins/CrisStealCore/
 ├── resurrection-logic.yml

⚙️ General Settings

enabled: true
revive-item-id: "item-resurrection"
click-action: "ALL_CLICK"
resurrection-time: 12
cancel-on-move: true
death-timeout: 60
cooldown: 0
consume-on-use: true
revive-range: 1.5

Explanation

Key
Type
Description

enabled

Boolean

Enables or disables the resurrection system.

revive-item-id

String

ID of the item from /items/ used to revive players (e.g. item-resurrection.yml).

click-action

String

Defines which interaction triggers revival — ALL_CLICK, LEFT_CLICK, RIGHT_CLICK, SHIFT_LEFT_CLICK, SHIFT_RIGHT_CLICK.

resurrection-time

Integer

Time in seconds required to complete resurrection (hold right-click).

cancel-on-move

Boolean

Cancels the process if the reviver moves more than 0.5 blocks.

death-timeout

Integer

Time before a dead player permanently dies (0 = disabled).

cooldown

Integer

Cooldown before the item can be used again (in seconds).

consume-on-use

Boolean

Whether to consume the resurrection item on success.

revive-range

Double

Maximum detection range (in blocks) for nearby dead players.


💉 On Bleeding

on-bleeding:
  message: "&4{player} &cis bleeding..."

Shows a message when a player begins bleeding out. Supports {player} placeholder for the victim’s name.


⏱️ Resurrection Countdown Messages

countdown:
  actionbar: "&e&lResurrecting {victim}... &7{time}s remaining"
  title:
    message: "&a&lRESURRECTING..."
    fade-in: 5
    stay: 10
    fade-out: 5
  subtitle:
    message: "&7Hold still! &e{time}s"
  success:
    title: "&a&lRESURRECTED!"
    subtitle: "&7{victim} has been brought back to life!"
    actionbar: "&aSuccessfully resurrected {victim}!"
  cancelled:
    title: "&c&lCANCELLED"
    subtitle: "&7You moved! Resurrection cancelled."
    actionbar: "&cResurrection cancelled - don't move!"

Placeholders

Placeholder
Description

{victim}

The player being revived.

{time}

Remaining seconds of the countdown.

Displays actionbar, title, and subtitle during the resurrection process — including messages for success or cancellation.


⚰️ Dead Player Messages

dead-player:
  countdown:
    actionbar: "&c&lWaiting for revival... &7{time}s until permanent death"
    title:
      message: "&c&lYOU ARE DEAD"
      fade-in: 10
      stay: 40
      fade-out: 10
    subtitle:
      message: "&7Someone can revive you with a resurrection item! &e{time}s"
  being-revived:
    actionbar: "&a&l{reviver} &7is resurrecting you! &e{time}s"
    title:
      message: "&a&lBEING RESURRECTED"
      fade-in: 5
      stay: 10
      fade-out: 5
    subtitle:
      message: "&7{reviver} is bringing you back to life!"
  revived:
    title: "&a&lYOU WERE RESURRECTED!"
    subtitle: "&7{reviver} brought you back to life!"
    actionbar: "&aWelcome back to life!"
  permanent-death:
    title: "&c&lPERMANENT DEATH"
    subtitle: "&7Your time ran out..."
    actionbar: "&cYou have permanently died."

Placeholders

Placeholder
Description

{reviver}

Name of the player reviving you.

{time}

Remaining seconds before permanent death.

Defines what the dead player sees while waiting for revival, being revived, or dying permanently.


🧙 Reviver Messages and Effects

reviver:
  started:
    actionbar: "&eHold right-click to resurrect {victim}! &7{time}s"
  start:
    sound: "BLOCK_NOTE_BLOCK_PLING"
    particles: "SPELL_WITCH"
    title: "&e&lRESURRECTING..."
    subtitle: "&7Hold still! &e{time}s"
    title:
      fade-in: 5
      stay: 20
      fade-out: 5
  success:
    title: "&a&lSUCCESS"
    subtitle: "&7You resurrected {victim}!"
    actionbar: "&aYou successfully resurrected {victim}!"
    sound: "ENTITY_PLAYER_LEVELUP"
    particles: "TOTEM"
    title:
      fade-in: 10
      stay: 40
      fade-out: 10
  cancelled:
    actionbar: "&cYou moved! Resurrection cancelled."
  cooldown-message: "&cYou must wait &e{time}s &cbefore using this again!"
  cooldown:
    sound: "ENTITY_VILLAGER_NO"
    particles: "SMOKE_NORMAL"
    title: "&c&lON COOLDOWN"
    subtitle: "&7Wait &e{time}s &7more!"
    title:
      fade-in: 5
      stay: 20
      fade-out: 5
  no-target-message: "&cNo dead player found nearby! Stand within &e{range} &cblocks and look at them."
  already-reviving-message: "&cSomeone is already reviving this player!"

Description

Defines all feedback for the reviver — including actionbars, titles, sounds, particles, and cooldown indicators.

Category
Description

started / start

When revival begins (with sounds & particles).

success

On successful resurrection.

cancelled

When cancelled due to movement.

cooldown

When on cooldown (includes sound, particles, and titles).

no-target-message

If no corpse is found in range.

already-reviving-message

If another player is already reviving the same corpse.


🌍 Disabled Worlds

disabled-worlds: []

List of worlds where the resurrection system is disabled. Example:

disabled-worlds: [world_nether, world_the_end]

🪦 Corpse Configuration

corpse:
  hologram:
    text: "&c&l✟ &7{player}"
    text2: "&4&l{time}"
    offset-y: 1.4
    text2-offset-y: 0.25
    separate: true
  head:
    offset-y: -1.4

Explanation

Key
Description

text / text2

Lines displayed above the corpse (supports placeholders {player}, {time}).

offset-y

Vertical offset for hologram or head position (positive = higher).

text2-offset-y

Offset for the second hologram line (only used when separate: true).

separate

If true, hologram uses a separate armor stand from the head (more flexible).

head.offset-y

Vertical position of the floating player head.

Example hologram setup:

line 1 :✟ PlayerName
line 2: 45s

🚫 Reviver Error Messages

reviver:
  no-item-message: "&cYou need a resurrection item to revive this player!"
  wrong-activator-message: "&cThis item cannot be used to revive players!"
  need-shift-message: "&cYou must be sneaking to use this item!"

Messages shown when a player tries to revive but fails due to:

  • Missing the resurrection item.

  • Incorrect activator type (e.g., item only accepts right-clicks).

  • Not sneaking when required.


🧩 Placeholders Reference

Placeholder
Description

{player}

Dead player’s name

{victim}

Player being revived

{reviver}

Player performing the resurrection

{time}

Remaining seconds

{range}

Range distance from corpse


Last updated