Soncresity Industries Wiki

Configuration

A guide on how to configure SI: Death Bolt properly

Server-side Configuration

By default, SI: Death Bolt generates a configuration in /<minecraftDir>/config/ called sidb-server.toml. However, if you want to have a configuration that is specific to each world, you can copy over the sidb-server.toml file from your /<minecraftDir>/config/ folder to your world folder in /<minecraftDir>/saves/<world>/serverconfig/.

Migration to new config system (.cnfg)

In the future we will start using our own config API using SI: Essentials to even allow SI: Death Bolt to run on Fabric. Therefore the config path for the mod will change and you will need to manually migrate to the new format.

Configuration Values

modPrefix

The Mod prefix. This String will be prepended to all messages the mod outputs that can be seen in the chat except in the death messages.

Message Formatting

This value supports MiniMessage Formatting, a more advanced way to style messages.

  • Type: String
  • Default Value: <bold><white>[</white><gradient:#2F97DD:#026DCA>SI: Death Bolt</gradient><white>]</white></bold>

enableLightningBolt

Whether a Lightning Bolt should be spawned at the players death location. Setting this to false will prevent most features of the mod from functioning.

  • Type: Boolean
  • Default Value: true

boltVisual

Whether the Lightning Bolt should only be visual and therefore should not damage entities or burn Items.

globalSound

Whether the Lightning Bolt should be heard from anywhere in the world or not.

Notice

The sound cannot be heard by players that are in a different dimension than the player that died.

blacklistedWorlds

Worlds in which a Lightning Bolt should not strike upon a player's death.

Syntax

This setting will only work if you supply the actual dimension ID, e.g.: minecraft:overworld You can find the ID of the dimension you're currently in by opening the F3 debug screen.

deathAction

What action should be taken upon a players death.

overrideDeathMessage

Whether the vanilla death message should be overridden or not. If enabled, the value of punishMessage will be used.

Independant setting

This setting is independant from every other setting. That means you can, for example, disable the spawning of a lightning bolt but still override everyone's death messages. However, this also means that if you set deathAction to MSG, two messages will appear in chat. Therefore setting deathAction to anything else than MSG is recommended.

msgType

What type of message should be sent upon a player's death.

  • Type: String / Enum
  • Allowed Values: MSG_PRIVATE / MSG_BROADCAST / MSG_PRIVATE_ACTIONBAR / MSG_BROADCAST_ACTIONBAR
  • Default Value: MSG_BROADCAST
  • Requires: deathAction = "MSG"

punishMessage

Message to be sent upon a player's death or the message to be displayed upon disconnecting due to kicking/banning them.

Message Formatting

This value supports MiniMessage Formatting, a more advanced way to style messages.

titleType

What type of title should be sent upon a player's death

  • Type: String / Enum
  • Allowed Values: TITLE_PRIVATE / TITLE_BROADCAST
  • Default Value: TITLE_BROADCAST
  • Requires: deathAction = "TITLE"

titleTitle

The message that the title should show.

Message Formatting

This value supports MiniMessage Formatting, a more advanced way to style messages.

  • Type: String
  • Available Placeholders: %player%
  • Default Value: <red>%player%
  • Requires: deathAction = "TITLE"

titleSubtitle

The message that the subtitle should show.

Message Formatting

This value supports MiniMessage Formatting, a more advanced way to style messages.

  • Type: String
  • Available Placeholders: %player%
  • Default Value: <yellow>died because they weren't careful enough.
  • Requires: deathAction = "TITLE"

titleFadeIn

How long (in milliseconds) the title fade in animation should take.

titleStay

For how long (in milliseconds) the title should stay on the screen.

titleFadeOut

How long (in milliseconds) the title fade out animation should take.

On this page