GambleHearts

Risk your hearts. Win big. Lose everything.

GambleHearts adds a gambling twist to PvP. Kill someone and you get a choice: play it safe for 1 heart, or open the slot machine and gamble for more. Could get +5, could lose 5, could walk away with nothing.

How it works

When you kill someone:

• A clickable prompt appears in chat
• Click GAMBLE to open the slot machine GUI
• Click SAFE to take 1 heart and move on

The gamble:
The slot machine spins for a few seconds then lands on a random outcome. The chances are configurable but by default:

• +5 hearts (rare)
• +3 hearts (uncommon)
• +2 hearts (decent chance)
• +1 heart (common)
• Nothing (common)
• -1 heart (uncommon)
• -2 hearts (rare)
• -5 hearts (very rare)

You're invincible and frozen while gambling so nobody can kill you mid-roll.

Lifesteal

When someone dies, they lose 1 heart. The killer gets the chance to gamble for more.

If a player hits 0 hearts for the first time, they respawn with 9 hearts and a warning. If they hit 0 again after that, they get sent to the Void.

The Void dimension

The Void is a separate world where banished players go to earn their way back. It's a dark, hard-difficulty dimension with buffed mobs (2x health, 1.5x damage). Players spawn with 10 hearts and need to:

• Survive for X minutes (60 by default)
• Kill zombies (10), creepers (5), and skeletons (2)
• Find the escape portal (generates randomly within 200 blocks of spawn)

A boss bar shows survival time remaining. Once time's up, the portal location is shown in the action bar and you can escape.

After escaping, you get 10 hearts back but you're on LAST LIFE - one more death = permanent ban.

Commands

• /gh accept - Accept a pending gamble (or click the prompt)
• /gh decline - Take the safe hearts
• /gh reload - Reload config (admin)
• /gh voidremove <player> - Pull someone out of the void (admin)
• /gh regenerateportal - Generate a new portal at a random spot (admin)

Permissions

• gamblehearts.use - Can gamble after kills (default true)
• gamblehearts.admin - Admin commands (default op)
• gamblehearts.bypass - Bypass void restrictions (default op)

For server owners

PlaceholderAPI support:
If you have PlaceholderAPI installed, you can display hearts, death counts, void progress, and more on scoreboards. The plugin adds placeholders like %gamblehearts_hearts%, %gamblehearts_zombies_killed%, %gamblehearts_time_remaining%, etc. Void placeholders return empty when players aren't in the void so your scoreboards won't show garbage.

Refer to WIKI page for PlaceholderAPI WIKI

Configuration:
Everything's adjustable in config.yml:

• Gamble outcome chances and values
• Hearts gained/lost
• Void survival time and mob requirements
• Death limits before banishment
• GUI animation speed
• Messages and sounds
• Boss bar colors/styles