SPknockout - downed state & rescue [1.21+]

✨ What is SPknockout?
SPknockout turns lethal situations into a knockout phase instead of always killing the player instantly (when enabled). Perfect for survival, RP, or any server that wants “get picked up” moments instead of flat instant deaths.

• ⚔️ Any lethal damage can trigger knockout — players, mobs, projectiles, lava, void, etc. (toggle via config; you can also restrict to “entity damage only” mode).
• Teammate rescue: a nearby player sneaks next to the victim while a revive bar fills — titles, action bar, optional heart particles & sound.
• /die — surrender while knocked out (counts as a real death: loot & respawn rules apply).
• ⏱️ Timeout: if nobody saves them in time, they die automatically.
• Quit while downed = same as /die — no “safe log” escape; normal death handling.
• Optional crawl mode — slow movement on the ground with a crawl-style pose (1.21-friendly); fully tunable.
• Self-revive — roll a chance when downed if they carry HEALING / REGENERATION potions; per-type chances + optional consume.
• Repeat knockout cooldown — after a successful revive only, block another knockout for X seconds; any death clears it so respawns feel fair.
• ️ Finisher hits, environmental damage while downed, mob knockouts, team-only rescue — all configurable.
• Built-in EN/RU messages + full custom text under messages with & color codes and {percent} for rescue UI.
• ⚙️ /knockout reload — hot-reload config.yml without restarting the server.

Photos of plugin!






Commands

• /die — end knockout by dying (only while knocked out).
• /knockout reload — reload configuration (permission required).

Permissions

• knockout.admin.reload — use /knockout reload (default: OP; customizable in config).

Installation

• Drop SPknockout-*.jar into plugins/.
• Start the server — config appears at plugins/SPknockout/config.yml.
• Tune values, then /knockout reload or restart.

Requirements

• ✅ Paper (or compatible fork) 1.21.x — built against Paper API 1.21.1.
• ☕ Java 21 on the server.

Config highlights
Everything lives in one clean config.yml: knockout duration & rescue time, radii, crawl pose & slowness, revive health (percent or fixed), slowness/blindness strengths, particles, revive sound, repeat-knockout cooldown, self-revive chances, permissions string for reload, and every player-facing message.


Support & source
Found a bug or want a feature? Open a discussion or issue on the resource page. Include your Paper build, Java version, and relevant parts of your config (redact secrets).