Basketball (AR and Non-AR) — Unity Asset

Basketball (AR and Non-AR) — cross-platform Unity Asset in the sport arcade genre with realistic physics of basketball net & ring, ring growing & hoop movement, advanced scoring & audio systems.

During an encounter with the Basketball Hoop, a player may throw the ball by:

• clicking/tapping any point on the screen (by default);
• flicking/swiping the object from the bottom of the screen up toward the target.

Both modes form different speed and throw direction based on the last position of finger or mouse cursor, what makes the game even more interesting. Throw Diligently and Try to Get the Best Score without touching the Ground!

Game Modes: AR and Non-AR

You can choose Game Mode on the Demo Scene before the start:

1. Non-AR Mode (all tested platforms support it) with 3 Camera Control Modes:
   • 2 for Desktop: WASD Keys or Right Mouse Button.
   • 1 for Mobiles: Sensor Camera (docs).
2. AR Mode (if it’s available, user can see a button to activate it) with the next features using the AR Foundation (ARCore, ARKit) — Augmented Reality engine:
   • Real Plane Detection (includes tutorial, visual plane confirmation/resetting, placing the game around the player).
   • AR Safe Zone. The player needs to stay in the Safe Zone to avoid accidents during the game and continue the game itself! The player will be notified when leaving the Safe Zone.
   • AR Onboarding UX with Transparent Video Manuals & AR States.
   • AR Shadows & Light Estimation: estimates light data in the real world and applies it to game space.

---

Package Contains

• Unified Demo Scene for Both Modes (AR and Non-AR).
• Throw Control (docs).
• Sensor Camera (docs).
• Menu Scene.
• Permission Scene with Camera Permission Request using free Native Camera.
• Loading Screen to switch scenes seamlessly.

Check the Map of Unity Assets to choose the product that best suits your needs.

---

Features of Basketball Game 3D

Throw like a Pro with your amazing Game or App:

• 2 Bonuses: Ring Growing (Big Ring), Hoop Movement.
• 2 Throwing Modes with Throw Control (docs): “Click” (Easy) & “Flick/Swipe” (Hard).
• 100+ Customizable Parameters (Points, Throwing, Bonuses, Sounds, Delays, etc.).
• Super Realistic Physics of a Basketball Net & Ring:
  Bank Shot, Toilet Bowl Shot, Rimshot, Net Shot, Clear Shot…
• Dissolving (Fading) VFX for All Game Objects.
• Dynamic Sound System: play Sounds based on speed, pitch, and volume factors of the Ball when it collides with Ring, Basketball Net, Backboard, Floor, Pole.
• Directional Arrow that points to the Current Target.
• Advanced Scoring System with Combos & Accounting Distance to Basket.
• UI Animations and Sounds: Clear Ball, Best Score, Current Score, Fail.
• Simulation of Player Breathing (Desktop).
• Mobile Optimizations:
  • Object Pool for Throwing Objects to manage the memory.
  • Caching for Visible Game Objects before Game Start.
  • TextMesh PRO for Texts to update them when really needed.

Bonuses

You can get a bonus with 1 scored ball or with combo. Balls Count in Combo can be set in Unity Editor.

Ring Growing (Big Ring)

Ring Growing happens when the player scores 1 Clear Ball (without touching of Ring). When the Limit of Goals with Big Ring will be reached then the basket will be returned to the Normal Size.

---

Hoop Movement

Hoop Movement happens when the player scores 2 Normal Balls (not clear) and shows VFX with Explosion & Hoop Dissolving (Meshes & Shadows).

Movement contains 2 independent parts:

• Rotation Around Camera (Player) by target Angles.
• Changing of local Z Position by target step.

---

Basketball Net Demo

Video Demo below of Basketball Net is just an example of an Interactive and fully Touchable Basketball Net with 2 holes, using the Cloth component & the Skinned Mesh Renderer to provide a physics-based solution for simulating fabric.

At the same time, the complete AR Basketball project provides AR Safe Zone and the player will be given a warning about leaving the safe zone, the screen will be darkened and throws will be blocked.

---

Tutorial

This tutorial is relevant for Basketball Game 5.0+.
Tutorial for the previous version can be found only in the asset folder.

Getting Started with Basketball Game 3D

Folders & Files in the package by default:

• Makaka Games;
• XR.

Steps

If you have any issues with the first launch then just Reach Support with Invoice Number and Get Help.

If you read this tutorial from PDF, first check the latest docs online to get actual information.

1. Create a New Unity Project with Unity 2022.3.20 & “3D” Template.
2. File > Build Settings > Windows, Mac, Android, iOS, WebGL > Switch Platform.
3. Next Packages must be manually installed with Git & Unity Package Manager:
   • Native Camera 1.4.3.
4. Download and import Basketball Game into Unity.
   1. Warning Windows:
      1. Click “Import” to overwrite the Project Settings with predefined ones.
      2. Click “Install/Upgrade” for Package Manager Dependencies.
      3. Click “No” when enabling the backends for the new input system.
5. Next Packages are provided with Unity Package Manager, and they are already installed for this Asset by default. If packages are missing (Warning Window did not appear) then install them again with Package Manager (advanced settings enabled: “Pre-release Packages”):
   1. TextMesh Pro 3.0.8:
      1. Always Required: Window > TextMeshPro > Import TMP Essential Resources.
   2. AR Foundation 5.1.3;
   3. Apple ARKit XR Plugin 5.1.3;
   4. Google ARCore XR Plugin 5.1.3;
   5. Input System 1.7.0.
6. Reopen Unity Project.
7. Open Scene: Makaka Games > Basketball > Scenes > Demo.
8. Test in the Unity Editor or Build.

Each Unity Asset included in Basketball Game 3D has its own documentation in the target folder or on the website (the latest docs).

“$” Game Object

It’s a Game Controller. Here you can find the main control scripts.

How to Set Balls Count & Throwing Mode?

All the information about throwing you can find in the “Throw Control” Documentation.

3rd Party 3D Basketball Environment (Option)

Basketball Game 3D (Unity Asset) is not related to the next optional assets, and it doesn’t include them and support is provided only by their publishers. The next assets are recommendations as additional stuff to inspiration and application in your unique game:

• HQ Abandoned School (Modular): 2 basketball areas (street playground & school gym).
• Basketball Essentials: collections of hoops and balls.
• School Gym: common school gym with basketball stuff.

Testing and Building

 All tested platforms support Non-AR Mode.
If AR Mode is available, user can see a button to activate AR Mode on the Demo Scene before the start.

iOS, Android: AR & Non-AR

Test in the Unity Editor with AR Foundation > XR Simulation.

---

macOS, Windows: Non-AR

You can test immediately in the Unity Editor from the box, but to Make a Build, you need to Uncheck the Next Flags in the Edit > Project Settings > XR Plug-in Management > Windows/Mac settings:

• Initialize XR on Startup.

---

WebGL: Non-AR

Learn the Article called WebGL and Unity about Building and Testing Unity games and apps for WebGL.

---

Tested with Devices

1. Mobile Platforms:
   • AR & Non-AR: iOS on iPhone XS Max;
   • AR & Non-AR: Android on Samsung Galaxy A71;
   • Non-AR: WebGL in Google Chrome.
2. Desktop Platforms (Non-AR):
   • Windows;
   • macOS;
   • WebGL in Google Chrome.

Support

First, read the latest docs online.
If it didn’t help, get the support.

Changelog

Check the current version of Basketball Game 3D on Asset Store.
The latest version will be added as soon as possible.

5.0 (Merging this Unity Asset with AR version into 1 Scene: AR and Non-AR):

Features:

• AR Mode for iOS & Android: AR Foundation (ARCore, ARKit) + Plane Detection (includes tutorial, visual plane confirmation/resetting, placing the game around the player):
  • AR Safe Zone. The player needs to stay in the Safe Zone to avoid accidents during the game and continue the game itself! The player will be notified when leaving the Safe Zone.
  • AR Onboarding UX with Transparent Video Manuals & AR States.
  • AR Shadows & Light Estimation: estimates light data in the real world and applies it to game space.
  • Editor Testing with AR Foundation > XR Simulation.
• “Select Mode” Panel (on the Demo Scene before the start, you can choose Game Mode):
  • AR Mode (if it’s available, user can see a button to activate it),
  • Non-AR Mode (all tested platforms support it).
• Using of Native Camera to check Camera Permission before the main scene.

Improvements:

• Unity 2022.3.20.
• Throw Control 6.0 (docs).
• Sensor Camera 2.1 (docs).
• Cashing of Game Objects to avoid freezes at the very 1st start of the game.

4.1:

Improvements:

• Unity 2022.3.18.

Fixes:

• Lighting in Graphics Settings for iOS & WebGL.

4.0 (Mobile WebGL Support):

Features:

• WebGL Support via HTTPS for Mobiles: Android.
  • Check information about iOS in the Limitations section of Sensor Camera.

Improvements:

• Unity 2022.3.7.
• Sensor Camera 2.0 (docs).

DevLog v4.0 — English. You can also watch here in Russian.

---

3.0:

Features:

• Support for Mobile Platforms (iOS & Android) using Sensor Camera 1.0 (docs):
  without Simulation of Player Breathing.

2.4:

Improvements:

• Unity 2021.3.21.
• Throw Object 3D 5.2 (docs).

Fixes:

• Camera Rotation Sensitivity with Mouse for Different FPS and Platforms.

2.3:

Improvements:

• Unity 2021.3.4;
• Throw Object 3D 5.1 (docs).

2.2:

Improvements:

• Unity 2021.2.16.
• Modern Standards of Project Settings (based on New Unity Project).
• Throw Object 3D 5.0 (docs).
• Unified UI Layout to match different resolutions.
• Soaring Style for HUD UI with Black Outline: no black panel behind anymore.
• Loading Animation for Start Button.

2.1:

• New Platform: WebGL Support (Tested in Google Chrome).
• Unity 2021.1.12.
• Throw Object 3D 4.3 (docs).

2.0 (Completely Rewritten Project & New Features):

• Throw Object 3D 4.0 (docs);
• TextMesh Pro;
• Hoop Movement;
• Dissolving (Fading) VFX;
• Shadow for Basketball Net;
• New Camera Control Mode: Right Mouse Button;
• Improved Basketball Physics Material.