Creeper Healing

This server side, customizable mod allows the world to automatically heal Creeper explosions. It has support for configuring a custom block-replace list, for telling the mod what blocks to use to replace a previously broken one, allowing for balancing and preventing potential abuse of this mod.

Features

Explosion healing modes

Special modes that customize the way explosions are healed even further:

• Daytime Healing Mode: Makes explosions wait until sunrise to begin healing. When they do, they will need a source of light to be able to heal.
• Difficulty-based Healing Mode: Speeds up or slows down the healing of explosions depending on the difficulty of the world or server.
• Blast-resistance based Healing Mode: Blocks with a higher blast resistance will take longer to heal. Their delays will also receive a randomized offset, causing blocks to heal in bursts.

Blocks will be healed during the explosion healing process. A block may be healed at a position if a player would also be able to place a block at that position.

Different explosion sources

This mod also supports healing explosions of different sources, such as Ghasts and Withers. By default, the mod will only heal Creeper explosions, but you can toggle each explosion source individually.

Make explosions not drop items

You can individually configure whether explosions coming from different sources should drop their items. By default, all explosion source types are allowed to drop their items, but you can configure these settings individually via the config file or via commands.

Configurable delays

Configure the amount of time it takes for an explosion to start healing, and the amount of time between each block placement. Keep in mind that some explosion modes will use their own values for the explosion heal and block placement delays.

• Warning: Both delays have a minimum value of 0.05 seconds. Attempting to force a lower value by setting it manually in the config will make the mod use the default values instead.

Restore the NBT data of block entities

Toggle the restoration of block NBT data when healing the block. You can also optionally force this block to always heal to guarantee the original block along with its nbt data is always healed

Make falling blocks not fall

You can make blocks such as sand and gravel remain in place when healed. These will only fall when receiving a neighbor update.

Whitelist

You can configure an optional whitelist that allows you to specify the blocks that are allowed to heal in an explosion. To do this, you can open the mod's configuration file, and find the following section:

#Use an optional whitelist to customize which blocks are allowed to heal. To add an entry, specify the block's namespace
#along with its identifier, separated by a colon, and add it in-between the square brackets below. Separate each entry with a comma.
#Example entries:
#whitelist_entries = ["minecraft:grass",  "minecraft:stone", "minecraft:sand"]
[whitelist]
	whitelist_entries = ["minecraft:placeholder"]

To add entries to the whitelist, you can add a string containing the block's namespace and identifier separated by a colon to the array, like shown in the example above. Separate each entry with a comma. You can also find a preference setting named "enable_whitelist" to enable or disable the usage of the whitelist.

Replace map

In the mod's config file, you can customize a "replace map". This is used if you would like a certain block to be healed with another one, instead of using the same block. If a block is healed with another one, the properties of the original block will be carried over to the new block, preserving properties like the block's orientation.

To add entries to the replace map, you can open the configuration file (located in your config folder and named creeper-healing.toml), scroll down and add entries below the [replace_map] section, using the following format, and separating each entry by skipping a line:

"minecraft:name_of_old_block" = "minecraft:name_of_new_block"

By default, the mod includes the following entry in the replace map:

"minecraft:diamond_block" = "minecraft:stone"

• Warning: Do not set the same block to be replaced with multiple blocks, as this will cause a crash upon game startup. That is, do not use the same key twice or more in the replace map.

Extra settings

You can also find settings to toggle extra features, such as:

• Enable or disable the block placement sound effect when a block is healed.
• Heal explosions faster via splash potions of Healing or Regeneration.

Commands

All of the mod's settings can also be modified in-game via commands. Access all of them via the /creeper-healing parent command. The config file also supports being reloaded in-game via /creeper-healing reload_config to avoid having to restart the server or world. Note that all commands require operator permission.

Configuration File

When the server or game is started, the mod will look for an existing creeper-healing.toml file for the config folder of your game. If it exists, it will read the values from there. If not, it will create a new config file in /config/creeper-healing.toml. You can then edit this file to configure the mod, and restart the server or game to apply the changes, or use the /creeper-healing reload_config in-game command.

The following is the default configuration file generated upon first mod initialization or whenever the mod fails to find the config file during server or world shutdown.

#Configure the delays related to the healing of explosions.
[delays]
    #(Default = 3) How much time in seconds should an explosion wait for to begin healing.
    explosion_heal_delay = 3.0
    #(Default = 1) The time in seconds that a block takes to heal.
    block_placement_delay = 1.0
    #Toggle whether certain explosion should drop items. Does not include items stored in container blocks.
    [explosion_item_drops]
    #(Default = true) Whether to drop items when a creeper explodes.
    drop_items_on_creeper_explosions = true
    #(Default = true) Whether to drop items when a ghast explodes.
    drop_items_on_ghast_explosions = true
    #(Default = true) Whether to drop items when a wither explodes.
    drop_items_on_wither_explosions = true
    #(Default = true) Whether to drop items when a tnt explodes.
    drop_items_on_tnt_explosions = true
    #(Default = true) Whether to drop items when a tnt minecart explodes.
    drop_items_on_tnt_minecart_explosions = true
    #(Default = true) Whether to drop items when a bed or respawn anchor explodes.
    drop_items_on_bed_and_respawn_anchor_explosions = true
    #(Default = true) Whether to drop items when an end crystal explodes.
    drop_items_on_end_crystal_explosions = true
#Configure which explosions are allowed to heal.
[explosion_sources]
    #(Default = true) Heal explosions caused by Creepers.
    heal_creeper_explosions = true
    #(Default = false) Heal explosions caused by Ghasts.
    heal_ghast_explosions = false
    #(Default = false) Heal explosions caused by Withers.
    heal_wither_explosions = false
    #(Default = false) Heal explosions caused by TNT blocks.
    heal_tnt_explosions = false
    #(Default = false) Heal explosions caused by TNT minecarts.
    heal_tnt_minecart_explosions = false
    #(Default = false) Heal explosions caused by beds and respawn anchors.
    heal_bed_and_respawn_anchor_explosions = false
    #(Default = false) Heal explosions caused by End Crystals.
    heal_end_crystal_explosions = false
#Choose between different special modes for explosion healing. Note that certain healing modes will not follow the explosion delay and block delay settings.
[explosion_healing_mode]
    #(Default = "default_mode") Choose any of the following healing modes by copying one of the strings and pasting it into the value of the "mode" setting below:
    #- "default_mode", "daytime_healing_mode", "difficulty_based_healing_mode", "blast_resistance_based_healing_mode"
    mode = "default_mode"
#Toggleable settings for extra features.
[preferences]
    #(Default = false) Whether to restore block nbt data upon healing. This option prevents container blocks like chests from dropping their inventories. Does not apply when the healed block is different from the destroyed block due to a replace map entry.
    restore_block_nbt = false
    #(Default = false) Whether to force blocks with nbt data to always heal, even if the replace map specifies a replacement for that block, and regardless of the block that may be occupying that position at the moment of healing.
    force_blocks_with_nbt_to_always_heal = false
    #(Default = true) Allows for a falling block, like sand or gravel, to fall when healed. Disabling this option makes the falling block have to receive a neighbor update before falling.
    make_falling_blocks_fall = true
    #(Default = true) Whether a block placement sound effect should be played when a block is healed.
    block_placement_sound_effect = true
    #(Default = true) Makes explosion heal immediately when a potion of Healing is thrown on them.
    heal_on_healing_potion_splash = true
    #(Default = true) Makes explosions begin their healing process when a potion of Regeneration is thrown on them.
    heal_on_regeneration_potion_splash = true
    #(Default = false) Toggle the usage of the whitelist.
    enable_whitelist = false
# Use an optional whitelist to customize which blocks are allowed to heal. To add an entry, specify the block's namespace
#along with its identifier, separated by a colon and enclosed in double quotes, and add it in-between the square brackets below. Separate each entry with a comma.
#Example entries:
#whitelist_entries = ["minecraft:grass",  "minecraft:stone", "minecraft:sand"]
[whitelist]
    whitelist = ["minecraft:placeholder"]
#Add your own replace entries to configure which blocks should be used to heal other blocks. The block on the right will be used to heal the block on the left.
#Specify the block's namespace along with the block's name identifier, separated by a colon and enclosed in double quotes.
#Example entry:
#"minecraft:gold_block" = "minecraft:stone"
#Warning, the same key cannot appear more than once in the replace map! For example, the following will cause an error:
#"minecraft:diamond_block" = "minecraft:stone"
#"minecraft:diamond_block" = "minecraft:air" 
[replace_map]
    "minecraft:diamond_block" = "minecraft:stone"

Support

If you would like to report a bug, or make a suggestion, you can do so via the mod's issue tracker or join the Creeper Healing mod's Discord server.

Building

Clone this repository on your PC, then open your command line prompt on the main directory of the mod, and run the command: gradlew build. Once the build is successful, you can find the mod under /creeper-healing/build/libs. Use the .jar file without the "sources".

Credits

• Thanks to @sulpherstaer for giving me the idea and inspiration for making this mod.
• Thansk to @_jacg on the Fabric Discord server helping me out with setting up the custom config file.
• Thanks to @dale8699 for helping me improve and give me ideas for the mod.