Grand Flying Carpet

# 🪄 Grand Flying Carpet (2-Player Magic Carpet)

Soar through the skies with **Grand Flying Carpet**, a Fabric mod that introduces majestic, rideable magic carpets built with multi-harmonic cloth animations, 3D seating cushions, braided guardrails, and deep in-game customization!

---

## ✨ Features

* **👥 True 2-Player Co-op Seating:** Built at a grand scale (3.0 blocks long × 2.25 blocks wide) with dedicated 3D raised velvet plush thrones for both the pilot (front) and a passenger (rear).
* **🌊 Multi-Harmonic Cloth Physics:** Realistic traveling fabric ripples, banking turn flex, aerodynamic corner tassel swings, and ground-settling drapes.
* **🎨 Ultra-HD 256×256 Procedural Tapestries:** Solar and Lunar mandala throne medallions connected with sacred Persian arabesque knotwork.
* **💨 Dynamic Flight VFX & Audio:** Trailing arcane ribbons, sprint boost cometary afterburners, low-altitude ground/water wake vortices, and atmospheric wind audio.

---

## 🛠️ In-World Customization

Customize your carpet anytime directly in the world! **Shift + Right-Click** a placed carpet with:

### 1. 🧵 16 Fabric Colors
* Apply any **Dye** or **Wool** (Red, Blue, Green, Cyan, Purple, Black, etc.) to dye the base damask velvet.

### 2. 👑 8 Metallic Trims
* **Solar Gold:** `Gold Ingot` — Polished royal gold piping & finials.
* **Celestial Diamond:** `Diamond` — Shimmering cyan diamond trim with stardust trails.
* **Ancient Netherite:** `Netherite Ingot` — Forged dark steel with trailing flame embers.
* **Astral Amethyst:** `Amethyst Shard` — Crystal purple trim with portal sparkles & chime audio.
* **Imperial Emerald:** `Emerald` — Vibrant emerald trim with villager blessing sparkles.
* **Rose Copper:** `Copper Ingot` — Polished warm copper wire rails.
* **Moonstone Quartz:** `Quartz` — Pearlescent silver-white moonstone trim.
* **Deep Sculk:** `Echo Shard` — Dark sculk trim with trailing sculk souls.

### 3. 📜 6 Motif Patterns
* **Royal Mandala (`Shears` to reset):** Dual Solar Crown & Celestial Lunar mandalas.
* **Celestial Galaxy (`Nether Star` / `Ender Eye`):** Nebula vortex & glowing constellation core.
* **Dragon Flame (`Fire Charge` / `Blaze Powder`):** Fiery dragon wings & ember jet exhausts.
* **Lotus Blossom (`Cherry Leaves` / `Pink Petals`):** Lotus flower seating & drifting petals.
* **Arcane Glyph (`Glowstone Dust`):** Ancient runic glyph rings.
* **Cyber Circuit (`Redstone`):** Neon geometric circuit matrix.

### 4. 🔮 Special Perks
* **Luminous Night Glow (`Glow Ink Sac`):** Makes the carpet runes and trim glow bright in pitch-black darkness.
* **Swiftweave (+25% Speed) (`Feather` / `Wind Charge`):** Permanently boosts flight speed and acceleration.

---

## 🧭 Controls

* **W / A / S / D:** Steer forward, backwards, and strafe
* **Spacebar:** Ascend / Gain altitude
* **Shift:** Descend / Glide down
* **Ctrl (Sprint):** Sonic Sprint Boost (Activates cometary particle exhaust)
* **Shift + Right-Click (Empty Hand):** Pick up carpet (Preserves all colors, trims, patterns, and perks!)

---

## 📜 Crafting Recipe

Crafted in a standard 3×3 Crafting Table:

* `[Wool]` `[String]` `[Wool]`
* `[String]` `[Phantom Membrane]` `[String]`
* `[Wool]` `[String]` `[Wool]`

*(Compatible with any wool color!)*

---

## 📥 Installation

1. Install **Fabric Loader** (1.21.4) and **Fabric API**.
2. Download `flycarpet-1.0.0.jar`.
3. Drop the `.jar` into your Minecraft `.minecraft/mods` folder.
4. Launch and fly!