# DeathMoney DeathMoney is a Paper/Spigot plugin that handles money loss and rewards when players die. It uses Vault for economy support. Install Vault and an economy plugin before using this plugin. ## What It Does - Takes money from players on natural deaths, if enabled. - Rewards killers after PvP deaths, if enabled. - Can split PvP rewards between players based on damage dealt. - Can send taxes, natural death losses, and debt payments into a treasury account. - Can block abuse such as repeated farming kills or same-IP rewards. - Can limit DeathMoney behavior by world. - Can track stats and leaderboards. - Can show optional DecentHolograms popups/stats if DecentHolograms is installed. ## First Setup 1. Put `deathmoney-1.0.0.jar` in your server `plugins` folder. 2. Start the server once. 3. Run: ```text /deathmoney setup ``` This enables the default core modules and marks setup as complete. Then run: ```text /deathmoney reload ``` ## Commands ```text /deathmoney help ``` Shows available commands. ```text /deathmoney setup ``` Completes first-time setup. ```text /deathmoney reload ``` Reloads config and modules. ```text /deathmoney module list ``` Lists all modules and whether they are enabled. ```text /deathmoney module enable <module> ``` Enables a module. ```text /deathmoney module disable <module> ``` Disables a module. ```text /deathmoney treasury balance ``` Shows the treasury balance. ```text /deathmoney treasury deposit <amount> ``` Deposits your money into the treasury. ```text /deathmoney treasury withdraw <amount> ``` Withdraws money from the treasury to you. ```text /deathmoney stats ``` Opens your stats GUI. Requires the leaderboard module. ```text /deathmoney top <earned|lost|kills|assists> ``` Shows the top 10 leaderboard for that category. ## Module Names Use these names with `/deathmoney module enable` and `/deathmoney module disable`: - `natural` - `pvp` - `damage-split` - `debt` - `broadcast` - `anti-abuse` - `world-rules` - `treasury` - `killstreak` - `leaderboard` - `hologram` - `seasonal-reset` - `lifesteal-compat` ## Permissions - `deathmoney.admin` - All admin permissions. - `deathmoney.setup` - Use setup. - `deathmoney.reload` - Reload config. - `deathmoney.module` - Manage modules. - `deathmoney.treasury` - Manage treasury. - `deathmoney.stats` - View stats. - `deathmoney.top` - View leaderboards. - `deathmoney.notify` - Receive admin notices. ## Required Plugins - Vault - Any Vault-compatible economy plugin ## Optional Plugins - DecentHolograms, only needed for the hologram module.