Yeet a Mole 🐹🕳️🥊

Cindy Wei, Zhexu Luo, Joshua Zhang

Development Period: 2025.11.12 – 2025.12.11

---

📚 Table of Contents

1. Overview
2. Gameplay Preview
3. Full Gameplay Video
4. Key Features
5. Enemies & Boss
6. Tutorial Rooms
7. Gameplay Summary
8. How to Play
9. Setup & Configuration
10. Technical Issues Encountered
11. Assets & Plugins Used

---

📌 Overview

Yeet-a-Mole is a fast-paced VR wave-survival action game built in Unity for Meta Quest 3. Players defend their farm from invading moles and monsters by turning moles into weapons through a physics-driven combat loop:

Whack → Bounce → Yeet

Using three tools—Bat, Shovel, and Racket—players convert different mole types into mole-balls, bounce them to charge, and “Yeet” them back at incoming enemies.

The game features three enemy types—Walkers, Spitters, and Tanks—followed by a multi-phase Final Boss with teleportation, arena-control attacks, and minion summons.

mole_spawning.mp4

---

🕹️ Full Gameplay Video

---

🎮 Key Features

Three-Tool Combat System

• Bat – Whack regular moles into mole-balls
• Shovel – Safely dig up explosive moles
• Racket – Yeet charged mole-balls at enemies

VR Physicality

• Physics-driven combat using real-world motion
• Full arm-swing interactions
• Natural throwing, batting, and digging

---

👾 Enemies & Boss

Enemy Roster

Walker	Spitter
Moderate speed Weak to knockback	Ranged enemy Parry-able projectiles

Tank	Final Boss
Armored Explosive damage only	Multi-phase boss Arena-control mechanics

Final Boss Abilities

• Non-redirectable boulder throws
• Explosive mole ring summon
• Minion waves (Walkers, Spitters, Tanks)

---

🧪 Tutorial Rooms

Before entering the main level, players complete four guided tutorial rooms:

ROOM1: Bat & Regular Moles – Whack brown moles into normal ammo

202512152320.mp4

ROOM2: Explosive Moles & Shovel – Learn safe handling of red moles

202512152320.1.mp4

ROOM3: Mole-Balls & Racket – Bounce and Yeet charged balls

202512152320.2.mp4

ROOM4: Projectile Parrying – Reflect enemy projectiles

202512152320.4.mp4

Each room must be completed before progressing.

---

📝 Gameplay Summary

• Whack → normal mole-ball
• Dig → explosive mole-ball
• Bounce → charged (yellow)
• Yeet → damage enemies

Enemies crossing the fence reduce HP.
HP reaches 0 → Game Over.

---

📖 How to Play

Objective

Survive enemy waves and defeat the final boss by mastering the Whack → Bounce → Yeet loop.

Controls (Meta Quest 3)

Left Hand

• Trigger (Hold): Pick up mole-ball
• Trigger (Release): Throw
• Button X: Next tutorial room

Right Hand

• Button A: Cycle tools
• Trigger: Confirm usage

---

⚙️ Setup & Configuration

• Platform: Meta Quest 3
• Installation: Sideload via MQDH or SideQuest
• Unity Version: Unity 6 (6000.0.x)
• XR: OpenXR enabled

---

🛠️ Technical Issues Encountered

High-Velocity Collision (Tunneling)
Solved using continuous dynamic collision checks.

Difficulty Balancing
Enemy pacing and explosive mole frequency adjusted.

Physics Predictability
Edge cases remain with multi-collision frames.

---

📦 Assets & Plugins Used

• Unity XR Interaction Toolkit
• ProBuilder
• Fantasy Skybox FREE
• Poly Haven / AmbientCG
• Kenney Assets
• TextMeshPro

Models & Audio

• Practice Dummy
• Stylized Shovel
• Baseball Bat
• Tennis Racket
• Mole Models
• Sound Effects Pack