PerKillHealth

Plugin Features:

Health Restoration on Kill Events:

• Restores player health when they kill another player, animal, or monster based on configurable settings.

Configurable Settings:

• Allows configuration of health restoration amount (hearts), delay (ticks), message display, and sound effects for each type of kill event.

Event Types Supported:

• Supports health restoration for killing players (kill-player), animals (kill-animal), and monsters (kill-monster).

Customizable Messages:

• Messages displayed to the player upon health restoration are customizable through config.yml, supporting placeholders like %hearts% and %current_hearts%.

Sound Effects:

• Plays configurable sound effects when health is restored, allowing customization of sound type (type) and enabling/disabling sound (enabled).

Reload Configuration Command:

• Provides a /perkillhealth reload command to reload the plugin configuration (config.yml) in-game.

Permission-Based Commands:

• Restricts access to configuration reload command (perkillhealth.reload permission required).

Language Support:

• Supports customization of all messages and configuration in config.yml, allowing server owners to adjust language and formatting.

Placeholders:

• %hearts%: Represents the number of hearts restored when a kill event occurs. Example: If 5.0 hearts are restored, %hearts% will be replaced with 5.0 in the message.
  
  
• %current_hearts%: Represents the current number of hearts the player has after the restoration event. Example: If the player's health after restoration is 15.0 hearts, %current_hearts% will be replaced with 15.0 in the message.

Commands:

• /perkillhealth reload: Command used to reload the plugin configuration (config.yml) in-game. Allows server administrators to make real-time adjustments to the plugin settings without restarting the server. Requires the perkillhealth.reload permission to execute.

Permissions:

• perkillhealth.reload: Permission required to use the /perkillhealth reload command. Grants access to reload the plugin configuration (config.yml) in-game. Helps in controlling who can modify plugin settings on the server.

Example Configuration (config.yml):

kill-player:
  enabled: true
  ticks: 1200
  hearts: 5.0
  message:
    enabled: true
    text: '&aYou have restored %hearts% hearts! Current hearts: %current_hearts%'
  sound:
    enabled: true
    type: ENTITY_PLAYER_LEVELUP

in this example :

• • %hearts% would be replaced with 5.0 hearts restored.
  • %current_hearts% would be replaced with the current health of the player after restoration.
    
    
    
    Click to see config.yml file :

############################################################
# |                       PerKillHealth
# | Commands: /perkillhealth reload
# | permissions: perkillhealth.reload - to reload config.yml file !
# | PlaceHolders: %hearts% , %current_hearts%
# | %hearts%: The number of hearts restored
# | %current_hearts%: The number of current hearts after restored hearts
# | Sound List : https://www.spigotmc.org/wiki/cc-sounds-list/
# | Plugin Creator: xNessus
# | Creator Discord: zbvczx
############################################################

# Configuration for restoring health when a player kills another player
kill-player:
  enabled: true
  # If true, enables the health restoration feature when a player kills another player.
  ticks: 1200   # Ticks delay before restoring health (20 ticks = 1 second)
  hearts: 5.0   # Number of hearts to restore
  message:
    enabled: true
    text: '&aYou have restored %hearts% hearts! Current hearts: %current_hearts%'
    # Message displayed to the player when health is restored, with placeholders for hearts restored and current hearts
  sound:
    enabled: true
    type: ENTITY_PLAYER_LEVELUP
    # Sound played to the player when health is restored

# Configuration for restoring health when a player kills an animal
kill-animal:
  enabled: true
  # If true, enables the health restoration feature when a player kills an animal.
  ticks: 1200
  hearts: 2.0
  message:
    enabled: true
    text: '&aYou have restored %hearts% hearts by killing an animal! Current hearts: %current_hearts%'
  sound:
    enabled: true
    type: ENTITY_PLAYER_LEVELUP

# Configuration for restoring health when a player kills a monster
kill-monster:
  enabled: true
  # If true, enables the health restoration feature when a player kills a monster.
  ticks: 1200
  hearts: 3.0
  message:
    enabled: true
    text: '&aYou have restored %hearts% hearts by killing a monster! Current hearts: %current_hearts%'
  sound:
    enabled: true
    type: ENTITY_PLAYER_LEVELUP

# Message displayed when configuration is successfully reloaded
reload-success-message: '&aConfiguration reloaded successfully.'