🏀 AR Basketball Shooter
An Augmented Reality basketball game for Android.
- Scan your floor with the phone camera.
- Place a virtual hoop in your room.
- Flick the screen to shoot. Baskets score points with sound, confetti and an on-screen celebration.
Built with Unity 6, AR Foundation 6 and ARCore, as an Immersive Technologies project.
There is also a laptop / browser version (Stage 10) for demos without a phone. It uses a virtual court instead of the camera, with mouse and keyboard controls.
Screenshots from the Unity Editor's XR Simulation (a simulated room).
Features
| # | Feature | Highlights |
|---|
| 1 | AR plane detection | Horizontal surfaces only, a placement ring, tap to place, Reposition Hoop |
| 2 | Virtual hoop | Real-size rim (0.45 m) at 1.6 m height; backboard, 16-capsule rim, net; held in place by an AR anchor |
| 3 | Basketball | Real size and mass (0.24 m, 0.6 kg), procedural texture, Continuous Dynamic collisions, realistic bounce, auto-respawn, Reset Ball |
| 4 | Swipe shooting | Flick speed → power, sideways flick → aim, AddForce(ForceMode.Impulse) clamped to 1.5–5.4 N·s, backspin, one shot per swipe, adjustable aim assist |
| 5 | Scoring | A trigger zone inside the rim: a ball must enter from above and leave below. One point per basket, each ball scores at most once, rim/backboard touches and balls from below never count. |
| 6 | Game UI | Title screen, Start Game, Place Hoop and Aim & Shoot instructions, score / shots / accuracy, Pause/Resume (also the Back button), Restart, safe-area support |
| 7 | Audio & effects | Impact sounds by surface and speed (3D), swish and chime, whoosh, clicks; confetti burst, net stretch, vibration, button press animation |
| 8 | Delivery | One-click APK build with settings check, keep-screen-on, mobile performance settings, app icon |
| 9 | 60s Challenge & leaderboard | Countdown (runs only while playing), last-10-seconds warning, beeps and buzzer, 2 s buzzer-beater grace, results screen, local top-10 leaderboard saved on the phone, name entry |
| 10 | Laptop & browser version | Windows .exe and WebGL build with a virtual wooden court and walls. WASD to walk, right mouse button to look, click to place, drag up to shoot. Same game scripts; phone UI kept in a centred column; -autodemo self-test |
Technology
| Item | Version |
|---|
| Unity Editor | Unity 6 (6000.6.7f1) with Android Build Support (OpenJDK, SDK & NDK); Windows and Web build support for Stage 10 |
| Render pipeline | Universal Render Pipeline (URP) 17.6 |
| AR Foundation | 6.6.2 |
| Google ARCore XR Plugin | 6.6.2 (same major.minor as AR Foundation) |
| Input | Input System 1.20 (touch and mouse through Pointer) |
| UI | uGUI + TextMeshPro |
| Language | C# |
| Target | Android 8.0+ (API 26), target API 36, ARM64, ARCore-supported phones; Windows 10/11 64-bit; WebGL 2 browsers |
Quick start
- Create a Universal 3D project in Unity 6. Switch to Android, then install AR Foundation and Google ARCore XR Plugin.
- Copy this repository's
Assets/ folder into the project.
- Build the generated assets from the menu, in this order:
- Tools → AR Basketball → Create Hoop Prefab
- Tools → AR Basketball → Create Basketball Prefab
- Tools → AR Basketball → Create Basket Effect
- Set up the scene and settings by following
Docs/Stage1…Stage8 in order. Each guide lists the exact hierarchy, Inspector values and button wiring.
- Test in the Editor: enable XR Simulation (XR Plug-in Management → Desktop) and press Play.
- Hold the right mouse button and use WASD to move.
- Left-click to place the hoop. Drag up with the left mouse button to shoot.
- Build: run Tools → AR Basketball → Check Build Settings, then Build Android APK. The APK is saved to
Builds/.
- Laptop version: run Tools → AR Basketball → Build Windows App (.exe). It is saved to
Builds/Windows/ARBasketballShooter.exe (see Docs/Stage10_LaptopVersion.md).
- Browser version: run Tools → AR Basketball → Build Web Version (WebGL). It is saved to
Builds/WebGL/; serve that folder from any web server, for example GitHub Pages.
How to play
- Press FREE PLAY (no time limit) or 60s CHALLENGE.
- Point the phone at the floor and move it slowly until a grid appears. Tap to place the hoop. Stand 2–3 m in front of it.
- Flick up on the screen to shoot. A faster flick throws harder; flick a little left or right to aim.
- Score as many baskets as you can. Use II to pause, Reset Ball for a new ball, and Reposition Hoop to move the hoop.
- Challenge: the clock starts once the hoop is placed. A shot in the air at the buzzer still counts. A top-10 score asks for your name; see the board with LEADERBOARD on the title screen.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
