Configuration

The configuration is minimal to accommodate for general use cases. More fine-tuned configuration may be better suited for an addon.

References:

• List of DamageCauses

Configuration file with notes:

# Respawn time can be a decimal value.
# Note that your value will be rounded down to the nearest tick (0.05s)
respawnTimeInSeconds: 8

# Requires players to have the deathspectating.spectate permission to be put in death spectating mode
usePermissionForSpectating: false

# List of DamageCauses that should NOT put a player into spectating mode on death.
# Useful if you want to prevent players from trying to "abuse" spectating mode
# Also useful for "compatibility" with /kill commands like Essentials; their /kill command circumvents DeathSpectating
useDamageCauseBlacklist: true
damageCauseBlacklist:
- SUFFOCATION
- SUICIDE

# List of worlds where DeathSpectating should be enabled
# Useful if DeathSpectating is somehow incompatible with a minigame plugin.
# Or you simply don't want to use it on some worlds.
useWorldWhitelist: false
worldWhitelist:
- world
- world_nether
- world_the_end

# List of commands that a player is allowed to use while DeathSpectating.
# Players with deathspectating.commands are not subject to this whitelist.
commandWhitelist:
- me
- m
- msg
- message
- t
- tell
- w
- whisper
- list
- '?'
- info
- report
messages:
  # Printed to player when they "die." {0} is the respawnTimeInSeconds value
  spectating: '&cYou died! Respawning in {0} seconds.'

  # Printed to player when they try to use a command not on the commandWhitelist
  deniedCommand: '&cYou are not allowed to use that command while death spectating.'

# Printed to player as a title/subtitle message when they "die."
# {0} is the respawnTimeInSeconds value
# {1} is the "score." As far as I'm aware, the "score" is Player#getTotalExperience. If I'm wrong, either let me know or PR the correct solution please, thank you!
titleMessages:
  titles:
  - '&cYou died!'
  - '&cGame over!'
  subtitles:
  - Respawning in {0}
  - 'Score: &e{1}'
  - 'Score: &e{1}&f, Respawning in {0}'

To remove a message, make it an empty string with two single quotes (not double quotes), like so:

  spectating: ''

To disable the titleMessages, simply have a single empty string (two single quotes, like above) for each list, like so:

titleMessages:
  titles:
  - ''
  subtitles:
  - ''