🌀 WindCharge Reset

Bring the competitive Minemen Club (MMC) "Spear-Mace" movement meta to your Spigot or Paper server!

WindCharge Reset is a lightweight, high-performance plugin that allows players to cancel their falling momentum in mid-air using a Wind Charge, without losing forward speed or suffering from camera snaps.

---

✨ Features

• 🚀 MMC-Style Mid-Air Explosion: When a falling player throws a Wind Charge downward, the plugin schedules a mid-air explosion exactly 1 tick later (50ms). The projectile is removed, preventing it from flying all the way to the ground.
• 🏃‍♂️ Horizontal Momentum Preservation: Unlike generic resets that stop you dead in your tracks, this plugin tracks your movement and retains your forward/strafing speed while setting your vertical fall velocity to exactly 0.0.
• 🎥 Buttery-Smooth Flicks: No teleport packets are used for the velocity override. This means client-side mouse movements and ticks are never overridden, allowing you to flick, turn, and aim at targets during the reset without camera stuttering.
• 🛡️ Fall Damage Negation: Resets the player's fall distance upon triggering the reset, preventing instant deaths when landing.
• 🛑 Smart Ground Bypass: Automatically disables the reset if the player is standing on the ground or jumping within 2.5 blocks of solid ground, ensuring vanilla jump-boosting and launcher setups still function perfectly.
• 🛠️ Real-Time Debugger: Includes a built-in debug mode that prints trigger logs directly to your chat (e.g., explaining if pitch, fall distance, or ground checks blocked a reset).

---

⚙️ Configuration (config.yml)

The plugin is highly customizable to match the physics of your duels/practice arenas:

# Enable or disable the momentum reset mechanic
enabled: true

# Enable debug mode to receive feedback messages in chat explaining why a reset did or did not trigger.
debug: false

# Pitch angle range (downward looking angle) required to trigger the reset.
# Pitch ranges from -90 (straight up) to 90 (straight down).
min-pitch: 75.0
max-pitch: 90.0

# Distance checks relative to the wind charge impact point:
# - max-horizontal-distance: How close horizontally (X/Z) the player must be.
# - max-vertical-distance: How high vertically (Y) the player can be.
max-horizontal-distance: 4.0
max-vertical-distance: 50.0

# Audio-visual feedback options
effects:
  # Play the wind burst sound when resetting momentum
  sound: true
  # Spawn gust/cloud particles when resetting momentum
  particles: true

---

💻 Commands & Permissions

• /windchargereset reload — Reloads the plugin configuration.
  • Permission: windchargereset.admin (Default: OP)

---

🔧 Installation

1. Download the latest release .jar.
2. Drag and drop the file into your server's plugins/ directory.
3. Start or reload the server.
4. Edit /plugins/WindChargeReset/config.yml to your liking, and use /windchargereset reload to apply settings!