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 in certain types of deaths, providing a unique twist to the game.

Installation

Download the latest version of the DeathPulse plugin from the releases page.
Place the downloaded JAR file into your server's plugins directory.
Start or restart your Minecraft server.
The plugin will generate a default configuration file in the plugins/DeathPulse directory.
Edit the configuration file to customize the plugin's behavior.
Reload the plugin using the /dp reload command.

Commands

Main Command

/DeathPulse or /dp
- Aliases: dp
- Usage: /dp <subcommand>
- Description: Main command for the DeathPulse plugin.
- Permission: dp.admin or just set permissionsAllPlayer for specific Subcommands to true (keep in mind this is not recommended to all subcommands)

Subcommands

reload:
- Usage: /dp reload
- Description: Reloads the plugin configuration without restarting the server.
- Permission: dp.reload
setConfig:
- Usage: /dp setConfig <key> <value>
- Description: Sets a configuration value for the plugin just using command.
- Permission: dp.setConfig
setMaxHealth:
- Usage: /dp setMaxHealth <player> <amount>
- Description: Sets the maximum health of a specified player.
- Permission: dp.setMaxHealth
viewHealth:
- Usage: /dp viewHealth <player>
- Description: Views the health of a specified player their debt data and death data.
- Permission: dp.viewHealth
viewDeathData:
- Usage: /dp viewDeathData
- Description: Views the death data of players who run the command.
- Permission: dp.viewDeathData
viewDebtData:
- Usage: /dp viewDebtData
- Description: Views the debt data of players who run the command.
- Permission: dp.viewDebtData
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
removeDebtData:
- Usage: /dp removeDebtData <player|allPlayer>
- Description: Removes the debt data of a specified player or all players.
- Permission: dp.removeDebtData
transferHealth:
- Usage: /dp transferHealth <player> <amount>
- Description: Transfers health from one player(who run the command) to another.
- Permission: dp.transferHealth
withdrawHealth:
- Usage: /dp withdrawHealth <player> <amount>
- Description: Withdraws health from a player(who run the command) to make HealthItem.
- Permission: dp.withdrawHealth
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.setConfig: Permission to change config plugin.
dp.setMaxHealth: Permission to set player health.
dp.viewHealth: Permission to view player health.
dp.viewDeathData: Permission to view death data player.
dp.viewDebtData: Permission to view debt data player.
dp.resetHealth: Permission to reset player health.
dp.matchHealth: Permission to match player health.
dp.removeDeathData: Permission to remove player death data.
dp.removeDebtData: Permission to remove player debt data.
dp.transferHealth: Permission to transfer health to another player.
dp.withdrawHealth: Permission to withdraw health to make HealthItem.
dp.help: Permission to view the help message.

Features

Ignore Death: Ignored death so player could not get Increase or Decrease.
Health Increase: Players increase health upon death.
Health Decrease: Players can lose health upon death if configured.
Ignore, Increase, and Decrease Death Types: Specify certain death types to ignore, increase, or decrease health.
All Type Death Ignoring, Increasing, and Decreasing: Use ALL to ignore, increase, or decrease health for all death causes.
Increase and Decrease Amount: Specify Amount to increase or decrease health on certain death types.
Ignore, Increase, and Decrease Exclude Death Type: EXCLUDE some death causes from being used in certain death types.
Day Ignored, Increase, and Decrease: Allows configuration of specific days when death ignore, increase, and decrease is active, regardless of the cause of death with some settings. If you only want to decrease health on specified days without affecting player health on other days, set per_death in the increase or decrease settings to 0.
DeActive Another Death In Certain Days: Allow deactivating another death type in certain days.
Same Way Death: If it must difference is false, and the death is the same as the last death, the player will not increase or decrease health again.
Customizable Priority: Set a priority for different death types to determine the order of health modification.
Season Change: Configure season settings to make players increase or decrease health with same cause again when season change.
Day Reset: Configure day reset settings in when season change to make day back to 0.
Customizable Messages: Tailor the messages players receive upon death.
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.
Debt Health: Make players incur debt if their health is below the minimum or below 0 when it decreases.
Health Item: Customize the health item settings, and make it so that the item cannot be used for crafting specific items.
Health Item Drop: Drop a health item when a player reaches the maximum health limit upon got increase.
First Time Setup: Set the first day Plugin setup in this server (System.currentTimeMillis()), don't change this section if you don't know what you are doing.
Day Check Period: Set the day check period in this server(in seconds), lower value is more accurate but may cause lag.
World Day Settings: Set the ticks per day in different worlds to used in ignored day, increase day, and decrease day.
Configuration Reload: Reload the plugin configuration without restarting the server with commands.
Set Config Using Command: Set a specific configuration value using a command.
Health Matching: Match the health of a specified player or all players based on their death data with commands.
Transfer Health: Transfer the health to another player using commands.
Withdraw Health: Withdraw health item from using commands.
Permissions: Set specific permissions for different commands to All Players, so players can run the commands without having the dp.* permission(at your own risk).

Event Listeners

PlayerJoinListener: Sets the player's start health when they join the server for the first time.
HealthItemListener: Handles Health Item logic.
PlayerDeathListener: Handles health modification logic upon player death.

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!