QuickCast PvP

QuickCast PvP

QuickCast PvP is a lightweight client-side Fabric mod for Minecraft Java 1.21.1 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: 1.21.1
• Loader: Fabric
• Fabric API: required
• Environment: Client-side

---

Links

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