DeathPulse

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 <subcommand>
• 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 <player> <amount>

• Description: Sets the health of a specified player.

• Permission: dp.setHealth

• viewHealth:

• Usage: /dp viewHealth <player>

• Description: Views the health of a specified player.

• Permission: dp.viewHealth

• resetHealth:

• Usage: /dp resetHealth <player|allPlayer>

• Description: Resets the health of a specified player or all players to the starting health.

• Permission: dp.resetHealth

• matchHealth:

• Usage: /dp matchHealth <player|allPlayer>

• Description: Matches the health of a specified player or all players based on their death data.

• Permission: dp.matchHealth

• removeDeathData:

• Usage: /dp removeDeathData <player|allPlayer>

• Description: Removes the death data of a specified player or all players.

• Permission: dp.removeDeathData

• setStartHealth:

• Usage: /dp setStartHealth <amount>

• Description: Sets the starting health for players.

• Permission: dp.setStartHealth

• setGainedPerDeath:

• Usage: /dp setGainedPerDeath <amount>

• Description: Sets the health gained per death.

• Permission: dp.setGainedPerDeath

• setGainedMax:

• Usage: /dp setGainedMax <true/false> <amount>

• Description: Sets the maximum health gain per death.

• Permission: dp.setGainedMax

• setDecrease:

• Usage: /dp setDecrease <true/false> <perDeathAmount> <minHealthAmount>

• 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] commands.
• dp.reload: Permission to reload the plugin configuration.
• dp.setHealth: Permission to set player health.
• dp.viewHealth: Permission to view player health.
• dp.resetHealth: Permission to reset player health.
• dp.matchHealth: Permission to match player health.
• dp.removeDeathData: Permission to remove player death data.
• 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.

Features

• Health Gain: Players gain health upon death.
• Special Day Boosts: Configure specific days where players receive extra health upon death.
• Health Decrease: Players can lose health upon death if configured.
• Global Death Ignoring and Decreasing: Use all to ignore or decrease health for all death types.
• 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.
• Maximum Health Limit: Set a maximum health limit that players can reach.
• Minimum Health Limit/Ban: Set a minimum health limit, or ban players when their health drops to zero.
• Day Decrease: Allows configuration of specific days when health decrease is active, regardless of the cause of death. To activate this feature, you must enable the main decrease setting and day setting. If you only want to decrease health on specified days without affecting player health on other days, set per_death in the decrease settings to 0.
• Health Matching: Match the health of a specified player or all players based on their death data.
• Death Data Management: Remove death data of a specified player or all players.
• Configuration Reload: Reload the plugin configuration without restarting the server.

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!