Home/ Store/ Streetball Basketball
NEW
Gameplay· RR Interactive

Streetball Basketball

v1.0.0 Updated August 2026 Qbox / QBCore

Real streetball for your city — procedural dribbling, a skill-based shot meter, and a ball that actually bounces off the rim. Place hoops anywhere, run pickup games to 21, and climb the city leaderboard.

Streetball Basketball turns any corner of your map into a court. The ball isn’t glued to your hand — it’s simulated: it meets the floor in front of you, leads you when you run, and switches hands on a crossover. Shots aren’t a dice roll either: your release solves a real ballistic arc, then the ball is simulated against the rim, the backboard, and the floor. A shot that lands 4 cm off centre rattles the rim and decides for itself — and bank shots work because the backboard is really there.

Features

  • Procedural dribbling with real bounce cadence — every player on the server sees the same ball
  • Skill-based shot meter: the green window IS the correct power for your distance, and it shrinks with range, on the move, and when guarded
  • Real ball physics — rim, backboard, and floor collisions; bank shots and rim-rattlers are genuine
  • Passes with receiver leading, sprint dunks, and layups
  • Pickup games to 21 — 2s and 3s or streetball 1s and 2s, with heating up / on fire streaks
  • Place hoops anywhere with the live-preview admin placer — no hardcoded coordinates; two hoops sharing a court name make a full court
  • Persistent career stats and a city leaderboard (MySQL tables auto-created on first run)
  • Network-efficient: held balls cost zero bandwidth; shots broadcast once and every client runs the same deterministic sim

Before you install: remove any other basketball script

If you already run qbx_basketball — or anything else that adds an [E] prompt to the ball prop — delete or stop it first. Both scripts fight over the same ball and the other one wins the grab.

It is worth knowing the symptoms, because they look like bugs in this script rather than a conflict:

  • you shoot once, pick the ball back up, and the dribble no longer works
  • a different shot UI appears instead of this one’s meter
  • the shot does nothing — the other script doesn’t know about your hoops

All three are the same cause. If you see them, check for a second basketball resource before troubleshooting anything else.

ActivitiesFiveMQBCoreQboxSports

Procedural Dribbling

The ball is simulated, not attached — it leads you when you run, crosses over between hands, and everyone sees the same bounce.

Skill-Based Shot Meter

The green window is the correct power for your distance. Release inside it and it drops; early is short, late is long.

Real Ball Physics

Every shot is simulated against the rim, backboard, and floor. Bank shots are real and close misses rattle the rim.

Pickup Games to 21

Passes, sprint dunks, 2s and 3s or streetball scoring, plus heating up and on-fire make streaks.

Place Hoops Anywhere

Live-preview placer with snap-to-regulation height. No hardcoded coords — hoops sharing a court name form one court.

Stats & Leaderboard

Persistent career stats and a city leaderboard, stored in MySQL with tables created automatically.

Installation Steps

  1. IMPORTANT — remove or stop any other basketball script first (e.g. qbx_basketball). Two scripts competing for the same ball prop will break dribbling and shooting.
  2. Extract rr-basketball into your resources folder and add 'ensure rr-basketball' to server.cfg
  3. Start the server once — both MySQL tables are created automatically (sql/install.sql included if you prefer manual)
  4. Place your first hoop with /bballplacer — nothing works until at least one hoop exists
  5. Aim at the rim, press H to face the hoop toward the court, right-click to save with a court name
  6. Tune scoring, difficulty, and admin groups in config.lua

Dependencies

  • ox_lib
  • oxmysql
  • Not compatible with qbx_basketball or any other script that claims the ball prop — remove it first

Commands

CommandDescription
/bballOpen the basketball menu
/bballstatsView your career stats and the city leaderboard
/bballplacerAdmin: place, move, or remove hoops with a live preview