# DeathPulse Plugin ## Introduction DeathPulse is a Minecraft plugin designed to enhance gameplay by modifying player health mechanics upon death. The plugin allows server administrators to configure health gained or lost when players die, providing a unique twist to the game. ## Installation 1. Download the latest version of the DeathPulse plugin . 2. Place the downloaded JAR file into your server's `plugins` directory. 3. Start or restart your Minecraft server. 4. The plugin will generate a default configuration file in the `plugins/DeathPulse` directory. ## Commands ### Main Command - `/DeathPulse` or `/dp` - **Aliases**: `dp` - **Usage**: `/dp ` - **Description**: Main command for the DeathPulse plugin. - **Permission**: `dp.admin` ### Subcommands - **reload**: - **Usage**: `/dp reload` - **Description**: Reloads the plugin configuration. - **Permission**: `dp.reload` - **setHealth**: - **Usage**: `/dp setHealth ` - **Description**: Sets the health of a specified player. - **Permission**: `dp.setHealth` - **viewHealth**: - **Usage**: `/dp viewHealth ` - **Description**: Views the health of a specified player. - **Permission**: `dp.viewHealth` - **setStartHealth**: - **Usage**: `/dp setStartHealth ` - **Description**: Sets the starting health for players. - **Permission**: `dp.setStartHealth` - **setGainedPerDeath**: - **Usage**: `/dp setGainedPerDeath ` - **Description**: Sets the health gained per death. - **Permission**: `dp.setGainedPerDeath` - **setGainedMax**: - **Usage**: `/dp setGainedMax ` - **Description**: Sets the maximum health gain per death. - **Permission**: `dp.setGainedMax` - **setDecrease**: - **Usage**: `/dp setDecrease ` - **Description**: Sets the health decrease per death. - **Permission**: `dp.setDecrease` - **help**: - **Usage**: `/dp help` - **Description**: Shows this help message. - **Permission**: `dp.help` ## Permissions - `dp.admin`: Access to all [DeathPulse](https://github.com/b4n9z/DeathPulse) commands. - `dp.reload`: Permission to reload the plugin configuration. - `dp.setHealth`: Permission to set player health. - `dp.viewHealth`: Permission to view player health. - `dp.setStartHealth`: Permission to set starting health. - `dp.setGainedPerDeath`: Permission to set health gained per death. - `dp.setGainedMax`: Permission to set maximum gained health. - `dp.setDecrease`: Permission to set health decrease. ## Configuration The configuration file (`config.yml`) allows you to customize various aspects of the plugin: ```yaml HP: start: 20 #Sart HP player gained: per_death: 2 #HP Gained per player death max: enabled: false #Max HP player, true or false, when true, player has max HP limit amount: 114 #Max HP player limit decrease: #decrease HP player when death with certain type enabled: false #true or false, when true, player can decrease their HP per_death: 2 #HP decrease per player death min: 2 #HP minimum player when always death with decrease type death: must_difference: true #true or false, when true, player must die with different way to gained HP ignored: #Ignored death type cause player not gain HP # - lava # - fall # - player_attack decrease: #decrease HP player when death with certain type # - lava # - fall # - player_attack notifications: death_message: player: gained: "&fYou gained &9{gain}&f health cause : &c{cause}" ifSameWay: "&cYou don't gained health with death same way" ignored: "&fDied with &c{cause}&f not gained HP" decrease: "&fYou decrease &c{decrease}&f health cause : &c{cause}" maxHealth: "&fYou have reached the&c maximum health limit&f." logServer: gained: "{name} gained {gain} health by {cause}" decrease: "{name} decrease {decrease} health cause : {cause}" ``` ## Features - **Health Gain**: Players gain health upon death. - **Health Decrease**: Players can lose health upon death if configured. - **Customizable Messages**: Tailor the messages players receive upon death. - **Ignored Death Causes**: Specify certain death causes to ignore. - **First Join Health**: Set the health players start with on their first join. ## Contributing Contributions are welcome! While DeathPulse provides a unique twist on Minecraft gameplay, there is always room for improvement. Future enhancements could include more granular control over health modifications and additional configurable events. Your feedback and contributions would be invaluable in making this plugin even better! Enjoy your time with DeathPulse!