Soccer Nicktale

# ⚽ Soccer Nicktale (Nicktale Soccer)

Welcome to **Soccer Nicktale**, the ultimate soccer experience built for modern Minecraft! Whether you are playing casual matches with friends or hosting an organized tournament on your server, this mod provides realistic ball physics, instant stadiums, custom audio, referee tools, and automatic match management.

---

## 🌟 Key Features

### ⚽ 1. Realistic 3D Soccer Ball & Physics
- **Fully Segmented 3D Model:** Classic black and white pentagonal design with smooth roll rotation.
- **Accurate Physics:** Calibrated gravity, realistic grass friction, air drag, and wall/crossbar bouncing.
- **Kicking Mechanics:**
  - **Regular Kick / Pass:** Standard left-click hit.
  - **Power Shot (Sprint + Hit):** Blasts the ball forward with critical hit particles!
  - **Chip / Lob (Sneak + Hit):** Lifts the ball into a high, weighted arc.
  - **Dribble:** Walking or sprinting into the ball nudges it forward naturally with your feet.
- **Pickup Options:** 
  - **Right-click** the ball with an empty hand to pick it up.
  - **Sneak-walk (Shift)** over the ball to grab it directly off the ground.

---

### 🏟 2. Instant Stadium Generator (`Instant Soccer Pitch`)
- Right-click the ground with the **Instant Soccer Pitch** item to instantly generate:
  - Full-size regulation green pitch with white boundary lines, center circle, and penalty boxes.
  - Two realistic **stadium goals (7x3x2 blocks)** made with solid net blocks and metal crossbars.
  - **Spectator Grandstands:** 2-tiered bleachers with quartz stairs facing the field on both sidelines.
  - Team locker chest stocked with jerseys, extra balls, referee gear, and cold beers.
  - Automated **3D Holographic Scoreboard**.

---

### 🥅 3. Solid Goals & Smart Detection
- Real goal-mouth detection: The mod verifies that the ball has **physically crossed the goal line into the goal cavity**.
- Post and crossbar deflections: The net and frame are solid—the ball bounces back into play instead of flying through the back.
- **Stadium Celebration:** Custom crowd cheer audio, celebratory chat announcements, and ball auto-reset to the center spot.

---

### ⏱ 4. 3D Holographic Scoreboard & Match Timer
- **Spectator-Friendly 3D Display:** Floating holographic score and timer visible from anywhere around the pitch.
- **Local Pitch Audio & HUD:** Match timer, action-bar HUD, and announcements are tuned to the stadium area (~80 blocks) so other server players are not disturbed.
- **Interactive Controls:**
  - **Right-Click:** Start / Pause match and countdown timer.
  - **Right-Click with a Clock:** Cycle duration (3, 5, 10, or 15 minutes).
  - **Shift + Right-Click:** Reset score to 0-0 and reset clock with whistle sound.

---

### 👕 5. Official Wearable Team Jerseys
- **Red Team Jersey** & **Blue Team Jersey**:
  - Modern equipment layer rendering: Displays directly on your player's body and skin!
  - Features white collars, striped sleeves, and the iconic number **#10** on the back.
  - Equip via the chestplate slot or right-click from hand.

---

### 🟨🟥 6. Referee Kit
- **Referee Whistle:** Crisp, authentic whistle audio audible across the pitch with a cooldown.
- **Yellow Card:** Blows the whistle, plays sound, inflicts slowness, and announces a warning in chat to the targeted player.
- **Red Card:** Blows double whistle, summons particles, and publicly ejects the player to the locker room!

---

### 🍺 7. Cold Beer
- Grab a drink with your teammates after the match! Custom drinking animation, burp sound, and speed/strength boosts.

---

## 🛠 Installation & Requirements

- **Platform:** NeoForge
- **Minecraft Version:** 26.2
- Just drop `nicktalesoccer-1.0.0.jar` into your `.minecraft/mods` folder and enjoy!