DROPKICKS?

# 🦶 Dropkick

**Fight with your feet.** Dropkick adds snappy kicks, flying dropkicks, a skill-based parry, and an anime-style **cinematic ultimate**, all with custom animations in both first and third person.

> ⚠️ **Requires [Player Animator](https://www.curseforge.com/minecraft/mc-mods/playeranimator)** (Forge 1.20.1). Install it on the client **and** the server.

---

## 🥾 Kick: `V`
A fast front kick that launches mobs back.
- In first person you actually **see your leg** swing up into view.
- **Kicks doors open (or shut).** Wooden doors, **iron doors**, trapdoors and fence gates. No redstone needed.

## 🚀 Dropkick: `G`
Launch yourself forward feet-first, body flat in the air.
- Hit a mob and it goes **flying**, while you bounce off it.
- **Bursts doors open** as you fly through them, iron doors included.
- No fall damage from your own dropkick. One per jump.

## 🛡️ Parry: hold `R`
Raise your guard. When something hits you while you're guarding:
- Time freezes on the attacker, the camera pulls back, and a **random WASD combo** appears on screen (e.g. `W - D - S - A`).
- **Nail it:** you take **no damage**, the attacker loses **half its max HP**, you counter-kick it, and your parry is ready again instantly.
- **Miss a key or run out of time:** the hit lands and your parry goes on cooldown.
- Your on-screen keys follow your own movement bindings.

## 💥 Ultimate Dropkick: `B`
Unlock it with **`/dropkick unlock`**, look at a mob, and press `B`. Then watch a **~10 second cutscene**:
1. You appear behind your target and **shove it back**.
2. A low angle from behind the mob: **you're hanging in the air right in front of its face.**
3. Slow zoom on the mob's face as it **looks up at you**.
4. A close-up of you glaring down.
5. **DROPKICK TO THE FACE.** Black/white/red **impact frames**, hit-stop, and a title slam.
6. The mob is **launched through every block in its path** while the camera **chases it at high speed** with speed lines…
7. …until it **explodes**.

Letterbox bars, camera shake, handheld wobble, fades: the full cinematic treatment. You're invulnerable during the cutscene. Unbreakable blocks (bedrock) stop the flight.

---

## ⌨️ Commands
| Command | Who | What |
|---|---|---|
| `/dropkick unlock [players]` | anyone for self*, op for others | Unlock the ultimate |
| `/dropkick lock [players]` | anyone for self*, op for others | Lock it again |
| `/dropkick status` | anyone | Check your ultimate / cooldown |
| `/dropkick resetcooldown [players]` | op | Reset all cooldowns |
| `/dropkick disable [players]` | op | Turn **all** Dropkick moves off for someone |
| `/dropkick enable [players]` | op | Turn them back on |

\* Server owners can require op for self-unlocking in the config.

## ⚙️ Config
Everything is tunable per world in `serverconfig/dropkick-server.toml`, and it's synced to clients:
- Kick / dropkick damage, knockback, reach, speed, cooldowns
- Whether kicks open doors
- Parry: number of keys, time window, cooldown, % of max HP taken
- Ultimate: range, cooldown, flight speed and duration, whether it breaks blocks, whether broken blocks drop items, damage to things it crashes into

## 🎮 Default keys
`V` Kick · `G` Dropkick · `R` Parry (hold) · `B` Ultimate. Rebind them under *Options → Controls → Dropkick*.

---

### Compatibility notes
- **Forge 1.20.1** (47.x). Needed on **both client and server**.
- The impact frames use a post-processing shader. With some shader packs they fall back to a simple flash.
- For the ultimate's chase cam, keep `flightSpeed × flightTicks` within your render distance (the default is ~90 blocks).

### Credits
Animations are played with **Player Animator** by KosmX.