Lives and Cooldowns

SinceDungeon includes two progression gates:

  • Lives control entry, death penalties, revives, and regeneration.
  • Cooldowns control how soon players can rerun a dungeon.

Lives Configuration

lives:
  default-max-lives: 3
  default-start-lives: 3
  regen-interval-seconds: 3600
  regen-amount: 1

Dungeon files can require and deduct lives:

settings:
  required-lives-to-join: 1
  lives-deducted-per-death: 1

Out of Lives

Global config:

dungeon:
  out-of-lives-action: "SPECTATE"

Common behaviors:

  • SPECTATE: player becomes spectator.
  • KICK: player is removed from the dungeon.
  • FAIL: the team fails the dungeon.

Soul Crystal

Soul Crystals can restore lives and are also used by /dungeon revive.

Admin command:

/sincedungeonpremium givelifeitem <target> <amount>

Configured item:

items:
  life_crystal:
    material: "NETHER_STAR"
    name: "&d&lSoul Crystal &8| &a+<amount> Lives"

Reviving Teammates

/dungeon revive <target>

Requirements:

  • The sender must be in the same dungeon.
  • The target must be a dungeon participant.
  • The target must be in spectator mode.
  • The sender must have a Soul Crystal in inventory.

Lives Admin Commands

/sincedungeonpremium lives <target> add <amount>
/sincedungeonpremium lives <target> set <amount>
/sincedungeonpremium lives <target> addmax <amount>
/sincedungeonpremium lives <target> setregenamount <amount>
/sincedungeonpremium lives <target> setregeninterval <seconds>
/sincedungeonpremium lives <target> resetregen
/sincedungeonpremium lives <target> check

Cooldowns

Dungeon file:

settings:
  cooldown-seconds: 1800
  cooldown-on-leave: true

Global fallback:

dungeon:
  gameplay:
    cooldown-on-leave: false

cooldown-on-leave applies cooldowns even when a player leaves, disconnects, or fails.

Cooldown Items

Reset ticket:

/sincedungeonpremium givecooldownitem reset <target> <amount>

Reduction ticket:

/sincedungeonpremium givecooldownitem reduce <target> <amount> <seconds>

Configured items:

items:
  cooldown_reset: {}
  cooldown_reduce: {}

Cooldown Admin Commands

/sincedungeonpremium cooldown check <target> <map>
/sincedungeonpremium cooldown reset <target> <map>
/sincedungeonpremium cooldown resetall <target>
/sincedungeonpremium cooldown reduce <target> <seconds>

PlaceholderAPI

%sincedungeon_lives%
%sincedungeon_max_lives%
%sincedungeon_lives_regen_amount%
%sincedungeon_lives_regen_interval%
%sincedungeon_lives_time_to_regen%
%sincedungeon_cooldown_<map>%