Configuration
A guide on how to configure SI: Death Bolt properly
Server-side Configuration
SI: Death Bolt generates a server-side configuration in /si/db/ called main.cnfg.
This means, that when playing on a singleplayer world, you need to look for it in your world directory (e.g. /<minecraftDir>/saves/MyCoolWorld/), whereas on a server it will be in the servers' world directory (usually called world).
General Settings
mod_prefix
The Mod prefix. This String will be prepended to all messages sent by the mod.
Message Formatting
- Type:
String - Default Value:
<bold><white>[</white><gradient:#2F97DD:#026DCA>SI: Death Bolt</gradient><white>]</white></bold>
enable_lightning_bolt
Whether a lightning bolt should be spawned upon a player's death.
- Type:
Boolean - Default Value:
true
bolt_visual
Whether the lightning bolt should be purely visual or also deal damage to entities and set fires.
- Type:
Boolean - Default Value:
true
blacklisted_worlds
A list of worlds in which no action should be taken upon a player's death. Use the world identifier (e.g., minecraft:overworld, minecraft:the_nether, minecraft:the_end).
- Type:
List<String> - Default Value:
[]
Sound Settings
sound_enabled
Whether the lightning bolt sound should be played upon a player's death.
- Type:
Boolean - Default Value:
true
sound_scope
The scope of the lightning bolt sound effect.
| SoundScope | Description |
|---|---|
ALL | Plays the sound to all players on the server. |
DIMENSION | Plays the sound to all players in the same dimension. |
RADIUS | Plays the sound to all players within a certain radius of the lightning bolt. |
- Type:
SoundScope - Default Value:
RADIUS - Available Values:
ALL,DIMENSION,RADIUS - Requires:
sound_enabled = true
sound_volume
The volume of the lightning bolt sound effect.
- Type:
Float - Default Value:
10.0 - Minimum Value:
0.0 - Maximum Value:
Float.MAX_VALUE - Requires:
sound_enabled = true
sound_pitch
The pitch of the lightning bolt sound effect.
- Type:
Float - Default Value:
1.0 - Minimum Value:
0.0 - Maximum Value:
Float.MAX_VALUE - Requires:
sound_enabled = true
Death Action Settings
death_action
The action to be taken upon a player's death.
| DeathAction | Description |
|---|---|
NONE | No action is taken. |
MSG | Sends a message to the player or broadcasts it to all players. (See msg_type) |
KICK | Kicks the player from the server. The world host is immune. The punish_message will be shown on the Disconnect screen. |
BAN | Bans the player from the server. The world host is immune. The punish_message will be shown on the Disconnect screen. |
TITLE | Displays a title and subtitle to the player or broadcasts them to all players. (See title_type) |
- Type:
DeathAction - Default Value:
MSG - Available Values:
NONE,MSG,KICK,BAN,TITLE
override_death_message
Whether the default death message should be overridden with a custom message.
- Type:
Boolean - Default Value:
false
death_message
The custom death message to be displayed.
Message Formatting
Available placeholder: %player%
- Type:
String - Default Value:
<red>☠ <b>%player%</b> died! - Requires:
override_death_message = true
Message Settings
msg_type
The type of message to be sent upon a player's death. This setting determines how punish_message is delivered.
| MessageType | Description |
|---|---|
MSG_PRIVATE | Sends a private message to the player who died. |
MSG_BROADCAST | Broadcasts a message to all players. Selecting this together with overriding the death message will result in two messages! |
MSG_PRIVATE_ACTIONBAR | Sends a private action bar message to the player who died. |
MSG_BROADCAST_ACTIONBAR | Broadcasts an action bar message to all players. |
- Type:
MessageType - Default Value:
MSG_BROADCAST - Available Values:
MSG_PRIVATE,MSG_BROADCAST,MSG_PRIVATE_ACTIONBAR,MSG_BROADCAST_ACTIONBAR - Requires:
death_action = MSG
punish_message
The message to be sent upon a player's death.
Message Formatting
Available placeholder: %player%
- Type:
String - Default Value:
<red>☠ You were killed/eliminated! - Requires:
death_action = MSG,death_action = KICK, ordeath_action = BAN
Title Settings
title_type
The type of title to be sent upon a player's death.
| TitleType | Description |
|---|---|
TITLE_PRIVATE | Sends a private title to the player who died. |
TITLE_BROADCAST | Broadcasts a title to all players. |
- Type:
TitleType - Default Value:
TITLE_BROADCAST - Available Values:
TITLE_PRIVATE,TITLE_BROADCAST - Requires:
death_action = TITLE
title_title
The title message to be displayed.
Message Formatting
Available placeholder: %player%
- Type:
String - Default Value:
<red>%player% - Requires:
death_action = TITLE
title_subtitle
The subtitle message to be displayed.
Message Formatting
Available placeholder: %player%
- Type:
String - Default Value:
<yellow>died because they weren't careful enough. - Requires:
death_action = TITLE
title_fade_in
The time, in seconds, it takes for the title to fade in.
- Type:
Long - Default Value:
1000 - Minimum Value:
0 - Maximum Value:
Long.MAX_VALUE - Requires:
death_action = TITLE
title_stay
The time, in seconds, the title should stay visible.
- Type:
Long - Default Value:
3000 - Minimum Value:
0 - Maximum Value:
Long.MAX_VALUE - Requires:
death_action = TITLE
title_fade_out
The time, in seconds, it takes for the title to fade out.
- Type:
Long - Default Value:
1000 - Minimum Value:
0 - Maximum Value:
Long.MAX_VALUE - Requires:
death_action = TITLE