QuickCast PvP

## QuickCast PvP

**QuickCast PvP** is a lightweight **client-side Fabric** mod for **Minecraft Java** designed for PvP: press **Middle Mouse Button** to instantly perform a selected quick action (Ender Pearl / Wind Charge / End Crystal).  
After the action, the mod can automatically **restore your previous hotbar slot** (default), so you can keep your combo flow without manual switching.

This mod only runs logic when you press the keybind (no heavy tick spam).

---

## Features

- **Middle-click quickcast** for:
  - **Ender Pearl** (use/throw)
  - **Wind Charge** (use/throw)
  - **End Crystal** (attempt placement at your crosshair target)
- **Hotbar search (0..8)** → temporary slot switch → action → optional restore
- **After-use behavior**
  - `RESTORE` (default): return to previous slot
  - `KEEP_NEW_SLOT`: stay on the used item slot
- **Cooldown** (default `120ms`) to prevent spam
- Optional **chat feedback**
- Optional **allowWhileScreenOpen** (works while inventory/menu is open)
- Optional **Mod Menu + Cloth Config** config screen

---

## How it works

When you press **Middle Mouse Button**, the mod:
1. Reads your selected `defaultAction` (Pearl / Wind Charge / Crystal)
2. Searches for the required item in your **hotbar**
3. If found: switches to that slot and triggers a client interaction (use/place)
4. By default, switches back to your **previous hotbar slot**
5. If not found: does nothing (or shows an optional chat message)

**Important:** End Crystal placement is **server-validated** (obsidian/bedrock rules, space, permissions, etc.). This mod only attempts the placement.

---

## Configuration

Config file:
- `.minecraft/config/quickcastpvp.json`

Options:
- `defaultAction`: `ENDER_PEARL | WIND_CHARGE | END_CRYSTAL`
- `afterUseBehavior`: `RESTORE | KEEP_NEW_SLOT`
- `restorePreviousSlot`: `true/false`
- `cooldownMs`: integer (default `120`)
- `showChatFeedback`: `true/false`
- `allowWhileScreenOpen`: `true/false`
- `crystalPlaceMode`: `TRY_PLACE | PLACE_AT_CROSSHAIR_IF_POSSIBLE`
- `requireHotbarOnly`: `true/false`
  - **Note (v1.0.0):** `requireHotbarOnly=false` (inventory-to-hotbar swap) is **not implemented yet** and will fall back to hotbar-only.

If you install **Mod Menu** and **Cloth Config**, you can edit these settings in-game.

---

## Requirements

- Minecraft
- Loader: **Fabric**
- **Fabric API**: required
- Environment: **Client-side**

---

## Links

- Source / Issues: https://github.com/modclaim/QuickCast-PvP