RuthlessSMP | Lifesteal, Bounty & Curses v1.0

❤ Lifesteal — Heart Drop System
Victims drop a physical heart item on death. Pick it up, right-click, gain a heart. Lose it in lava, and it's gone forever.

• Configurable start/max hearts · PvP-only or all-deaths mode (lose-on: PVP_ONLY / ALL)
• Custom textured heart item — material, name & lore fully editable in MiniMessage
• 0 hearts → downed (spectator) with auto-revive countdown on the action bar; revive delay & hearts-on-revive configurable, instant /smp revive for admins

Bounty Economy

• Money (Vault) and item bounties — both can pool on the same head
• Escrow-protected: rewards secured on placement, paid automatically on the kill
• Pooling (configurable) · /bounty top leaderboard · paginated bounty GUI with player heads
• Anonymous placement announcements (toggleable) — revenge-proof drama
• No Vault? Item bounties keep working — zero hard dependencies

Contagious Curses
Death inflicts a random timed curse: Daylight Burn, No Water Breath, Weakness, Blindness — each individually toggleable with its own duration. Timers run in real time, even while offline.
The twist: a cursed player's melee hit can pass a curse to the victim — chance, per-pair cooldown and master switch all configurable. Remaining time carries over. Projectiles don't trigger it; downed players are safe.


🗡 5 Sword Elements (custom textured)
Stamp abilities onto swords with /smp element:

• Silver — purges all positive potion effects on hit
• Absolute Failure — the lower your health, the harder you hit (up to 3x; multiplier & curve configurable)
• Tracker — hit a bountied target, see their particle trail for 45s (only you can; duration & particle configurable)
• Entropy — critical hits scramble the target's movement speed
• Override — shift+right-click to arm an armor-piercing true-damage strike; after it lands, heavy slowness hits you (arm window, slowness level & duration configurable)

Resource Pack & Custom GUIs — How It Works
Custom heart & element sword models + negative-space custom menu backgrounds for /smp menu and /bounty gui.

• Pre-hosted — nothing to upload. The download URL and SHA-1 hash ship pre-configured in config.yml.
• Enabling it: open config.yml → set resource-pack.enabled: true → restart. Players download it automatically on join. That's the whole setup.
• Already serve your own pack? With additive: true (default) ours stacks on top of your existing pack (1.20.3+ clients) — no merging, no overwrites. Prefer the old behavior? additive: false replaces instead.
• required: false by default — players who decline simply see vanilla looks. Set required: true only if your gameplay depends on the visuals (decliners get kicked).
• Without the pack everything still works — hearts and element swords fall back to clean vanilla item looks, menus open with standard backgrounds.

Setup (2 minutes)

1. Drop RuthlessSMP.jar into /plugins and restart (Paper 1.21.x, Java 21).
2. Optional: install Vault + an economy plugin (EssentialsX etc.) for money bounties, and PlaceholderAPI for placeholders — both auto-detected, no config needed.
3. Optional: set resource-pack.enabled: true for custom textures & GUIs.
4. Tune config.yml & messages.yml to taste → /smp reload applies both live, no restart.

Commands & Permissions
smp.use & smp.bounty default to everyone · smp.admin (op) grants all granular smp.admin.* children · full tab-completion.

PlaceholderAPI (11 placeholders)
%ruthlesssmp_hearts% · %ruthlesssmp_max_hearts% · %ruthlesssmp_health% · %ruthlesssmp_status% · %ruthlesssmp_downed% · %ruthlesssmp_revive_seconds% · %ruthlesssmp_curse_count% · %ruthlesssmp_curses% · %ruthlesssmp_has_bounty% · %ruthlesssmp_bounty% · %ruthlesssmp_bounty_money%
Works for offline players too — perfect for leaderboards & holograms. Note the identifier is ruthlesssmp (three s's).

⚙ Config Highlights

• hearts: starting / max / minimum · lose-on mode · heart item material, name, lore
• revive: auto-revive seconds · hearts granted on revival
• bounty: minimum amount · self-bounty toggle · pooling · placement announcements
• curse: per-curse enable + duration · stacking · transfer chance / cooldown / master switch
• sword-elements: master switch · per-element tuning (damage curve, durations, particles, backlash)
• storage: async save interval — YAML, no database setup
• Every player-facing message in messages.yml — MiniMessage, hex & gradients, editable prefix

🛠 Troubleshooting

• "Money bounties are disabled": Vault or an economy plugin is missing. Install Vault + EssentialsX (or any Vault-compatible economy) and restart. Item bounties work regardless.
• Players see vanilla textures: resource-pack.enabled is false (default), or the player declined the pack. Nothing is broken — visuals are optional by design.
• Placeholders show as raw text: PlaceholderAPI isn't installed, or the identifier is misspelled — it's ruthlesssmp with three s's.
• My own server pack disappeared: set additive: true (default) so our pack stacks instead of replacing. Note: pre-1.20.3 clients can't stack packs.
• Changed config but nothing happened: run /smp reload — config and messages reload live.

⚙ Tech
Paper 1.21.x · Java 21 · Async YAML storage (no database) · Zero shaded dependencies · Live /smp reload

---

FAQ
Will this conflict with my existing resource pack?
No — ships disabled; when enabled it stacks on top of your pack (1.20.3+). Legacy replace mode available.
Do I need Vault or PlaceholderAPI?
No. Both optional soft-depends. Without Vault, item bounties still work fully.
Does the plugin work without the resource pack?
100%. Vanilla fallback looks; every mechanic identical.
Is player data safe across restarts?
Yes — async periodic saves plus save-on-quit and save-on-shutdown. Curse timers keep counting in real time even while offline.