Weapon Kinesis: Survival Mastery

Ever wanted to fight like a true telekinetic master whose weapons orbit around them and whose inventory instinctively reacts to any lethal danger? 

rewards dedicated combat mastery with an awakened telekinetic state. Once unlocked, non-held weapons and shields in your hotbar physically float around you in 3D space with customizable translucent ribbon trails—striking down hostile mobs, intercepting projectiles, blocking explosions, and using items straight from your backpack to clutch falls, escape traps, and survive the impossible!

---

## ⚔️ 1. The Awakening (Mastery Progression)
True telekinesis must be earned. By default, players awaken their Kinesis after proving their mastery across every weapon class:
* **1,000 Kills** each with **Swords**, **Axes**, **Tridents**, and **Bows/Crossbows**.
* **1,000 Deflected Attacks** using a **Shield**.
* **Dynamic Mod Compatibility:** Automatically detects if your modpack includes **Maces** or **Spears/Halberds/Pikes** and seamlessly adds them to the mastery requirements!
* **Live HUD Progress Bar:** Holding any weapon before unlocking displays your live mastery progress bar above your hotbar.

---

## 🗡️ 2. Autonomous 3D Orbiting Arsenal
Any weapon or shield placed in your hotbar (excluding the item currently held in your main hand or off-hand) floats in a smooth 3D ring around you:
* **Sword (Whirlwind Sweep):** Lunges at nearby enemies and cleaves adjacent hostile mobs in a sweeping arc.
* **Axe (Shield-Breaker & Projectile Chopper):** Deals heavy 1.25x cleave damage, disables enemy shields for 5 seconds, and **chops incoming arrows and projectiles out of mid-air!**
* **Mace (Gravity Ground Slam):** Unleashes an AoE shockwave on impact, launching surrounding mobs into the air.
* **Trident & Spear (Long-Reach Piercing Thrust):** Strikes enemies from an extended 7-block telekinetic reach.
* **Bow & Crossbow (Autonomous Volley):** Automatically consumes arrows from your inventory (or uses Infinity) to snipe hostile threats from up to 16 blocks away.
* **Shield (360° Projectile & Explosion Aegis):** Intercepts incoming arrows/fireballs, nudges swelling Creepers and primed TNT away, and **blocks 100% of explosion damage!**
* **Pet & Villager Safe:** Smart targeting ensures your floating weapons never harm tamed pets, mounts, villagers, or teammates.

---

## 🪂 3. Telekinetic Auto-Clutch AI
When falling from a dangerous height, your inventory items **visually float out of your chest** ahead of impact to break your fall:
* **All Fluid & Aquatic Buckets:** Uses Water Buckets, Powder Snow Buckets, and even Aquatic Mob Buckets (Cod, Salmon, Axolotl, Tropical Fish, Pufferfish, Tadpole)—placing the water to break your fall and **automatically scooping the water back into your bucket!**
* **Horizontal & Vertical Auto-Block Clutching:** If you only have solid building blocks in your inventory, Kinesis scans nearby cliff faces to **horizontally bridge out from the wall** beneath your feet, or **rapidly stacks a vertical column** from the floor to catch you mid-air!
* **Slime Blocks, Cobwebs, Hay Bales, Boats & Ender Pearls:** Automatically deploys cushion blocks or warps you to safety.
* **Last-Resort Lava Bucket Clutch:** If you have zero other clutch items except a Lava Bucket, Kinesis places the lava for a split second to arrest your fall momentum, grants brief fire protection, and scoops the lava right back up!

---

## 🛡️ 4. Auto-Survive Traps & Environmental Hazards
Kinesis constantly monitors your surroundings to rescue you from lethal traps using the tools and items in your backpack:
* **Falling Anvils, Stalactites & Sand:** Uses a **Shield** to bat falling anvils sideways mid-air, or a **Pickaxe/Shovel** to shatter falling blocks above your head before they hit you!
* **Burning & Cobwebs:** Splashes water (or a **Cauldron + Water Bucket** combo in the Nether!) at your feet to extinguish flames or flush cobwebs, then picks everything back up.
* **Suffocation & Powder Snow:** Automatically mines you out of buried sand/gravel/stone with a Shovel or Pickaxe—or shoots a **Flame Bow** at your feet to melt Powder Snow if you have no tools!
* **Underwater Drowning:** When your oxygen drops low, deploys a **Trapdoor**, **Door**, **Soul Sand / Magma Block** (on the seabed for bubble columns), or plants **Sugar Cane** underwater so you can breathe.
* **Lava Submersion & Lakes:** Freezes obsidian pads over lava lakes, drinks Fire Resistance potions, warps to dry land with Ender Pearls/Chorus Fruit, or builds a stepping-stone elevator out of deep lava.
* **Void Fall Rescue:** Falling into the End Void? Kinesis warps you to the nearest island with Pearls/Chorus Fruit, **auto-equips your Elytra + launches a Firework Rocket**, or builds a 3x3 mid-air platform beneath you!
* **Smart Auto-Eat:** Floats nourishing food from your inventory to your mouth when hungry or injured (while saving Golden Apples/Chorus Fruit for emergencies).

---

## ⚙️ 5. Commands, Keybinds & Full Server Configuration
* **Keybind (`[K]`):** Toggle your Weapon Kinesis on or off at any time with a sleek on-screen HUD indicator.
* **Commands:**
  * `/kinesis status` — View your current weapon mastery progress and active server modules.
  * `/kinesis toggle` — Enable or pause your awakened Kinesis.
  * `/kinesis unlock` *(OP)* — Instantly unlock Weapon Kinesis for testing or events.
  * `/kinesis reload` *(OP)* — Live-reload both client and server TOML configs without restarting!
* **100% Configurable (`weaponkinesis-server.toml` & `weaponkinesis-client.toml`):**
  * Server admins can independently toggle **Orbiting Weapons**, **Auto-Clutch**, **Lava Clutch**, **Trap Survival**, **Void Rescue**, **Auto-Eat**, and **PvP Targeting**, or customize the required kill counts for every weapon (set any category to `0` to disable its requirement).
  * Clients can customize the translucent ribbon trail's **RGB color**, **opacity**, **orbit radius**, and **rotation speed**.