KillCash

KillCash is a Paper/Purpur/Folia plugin that rewards players with configurable in-game currency whenever they defeat another player in PvP combat. It includes killstreak multipliers, anti-abuse protection, customizable death messages, Vault integration, and flexible storage backends.

---

Compatibility & Requirements

• Supported Platforms:
  • Paper, Purpur, and Folia (fully supported with multi-threaded compatibility).
  • Note: Spigot is not natively supported due to the plugin's direct dependency on Paper's native Adventure Component API (MiniMessage) for formatting and performance.
• Supported Game Versions: Minecraft 1.20 - 1.21.x+
• Java Version: Java 21 or higher

How to Install

1. Download the latest plugin jar file
2. Upload or Drag and Drop the downloaded .jar file into your server's plugins folder
3. Stop and Start or Restart your server

---

• PVP Cash Rewards: Configurable minimum and maximum currency reward ranges.
• Cash Multipliers:
  • Permission-based: Grant custom multipliers based on permissions (e.g. for VIP/MVP ranks).
  • Streak-based: Compounding multipliers applied automatically as players build up killstreaks.
• Anti-Abuse Protection: Built-in safeguards to prevent cash farming, including IP-matching checks, customizable kill cooldowns between the same players, and minimum playtime requirements for victims.
• Rich Death Announcements: Fully customizable death messages for PVP, unarmed fists, mob-specific deaths, and natural causes (lava, gravity, drowning) styled using MiniMessage with hex and gradient colors support.
• Zero-Lag Visuals & Sound: Client-side packet-based lightning and sound effects. Configure whether feedback is private (killer and victim only) or broadcast to all players within a custom radius.
• Vault Integration & Conversion: Allows players to convert their KillCash currency into main server money (Vault/EssentialsX or other vault-based economy plugin) via /killcash convert <amount> with configurable exchange rates.
• Flexible Storage Backends:
  • PDC (PersistentDataContainer): Local, zero-setup storage using vanilla player NBT files. Ideal for single-server setups.
  • DATABASE: Optimized database caching supporting SQLite, MySQL, MariaDB, PostgreSQL, and H2.
• Third-Party Integrations:
  • PlaceholderAPI (PAPI): Fully supported across all messages.
  • PvPManager: Resolves combat logout deaths to reward the last active attacker with the kill credit and killstreak shutdown bonuses.

All commands support the /killcash base command

Command	Description	Permission Node	Default
/killcash help	Shows help menu and commands list.	killcash.command	Operators
/killcash balance [player]	View current or other player's cash balance.	killcash.command.balance	Everyone
/killcash stats or /killcash stats [player]	View current or other player's stats (kills, deaths, balance, streak).	killcash.command.stats	Everyone
/killcash pay <player> <amount>	Send cash directly to another player.	killcash.command.pay	Everyone
/killcash convert <amount>	Convert kill cash currency to main server currency.	killcash.command.convert	Everyone
/killcash baltop	View top 10 players with the highest balance.	killcash.command.baltop	Everyone
/killcash give <player/*> <amount>	Add cash to a player's balance.	killcash.command.give	Operators
/killcash take <player/*> <amount>	Deduct cash from a player's balance.	killcash.command.take	Operators
/killcash reload [config/lang/all]	Reload configurations or language resources on-the-fly.	killcash.command.reload	Operators
/killcash reloadconfig	Reload configuration files only.	killcash.command.reload	Operators
/killcash reloadlang	Reload language translations only.	killcash.command.reload	Operators
/killcash reloadall	Reload all files and systems.	killcash.command.reload	Operators

---