Volleyball Script
Volleyball as a real feature of your server, not a minigame prop. vs-volleyball gives you 1v1, 2v2 and 3v3 matches on courts you build anywhere in the world, a server-authoritative ball that cannot be faked or desynced, a three-stage serve minigame, six coached training lessons, player-owned teams with hand-painted banners, a career leaderboard, and a casual beach circle that needs no court at all.
It runs on ox_lib and oxmysql. No framework required; it works the same on ESX, QBCore, Qbox or a server with no framework at all.
What is in it
- Matches that play like volleyball. Where the ball is decides what you can play, three touches a side, nobody twice in a row, rally scoring. Six actions (spike, set, overhead, step, bump and dig), each with its own trajectory and its own mocap clip, plus a spike on its own key and its own timed window.
- A serve that is a skill. Pick a serve type off a panel that shows what it costs you, line up on the serve line, aim a target circle from a broadcast camera, then stop the power bar on the green. See Serving.
- Six coached lessons. Movement, passing, setting, serving, spiking and blocking, each walked through by a coach on your own court and graded out of three stars. See Training.
- Courts you build in the world. Six court floors (1v1 / 2v2 / 3v3, sand or concrete) that arrive with net and poles, a measuring tool so the painted lines and the played lines agree, a decoration catalogue, and a way to clear the map objects standing where the court has to go. See Courts & the builder.
- Teams that belong to the players. Create one, invite people, paint a 16×12 banner cell by cell or point it at an image, and that flag flies over your half of the net. See Teams.
- A career. Matches, wins, win rate, rally points, sets, current and best streak, ranked on a server leaderboard, with matches against AI counted but never ranked. See Leaderboard & profile.
- The beach circle. Use a volleyball from your inventory and invite anybody standing nearby, up to six people. Two modes, a passing circle and the knockout Five Smash. No court, no referee, no lobby. See Beach circle & drinks.
- Everyone standing there sees it. Anyone within 100 m of a live match sees the ball, the players and the score, so a court with people around it has a real audience rather than scenery.
- Its own sound. A custom audio bank: hits, grunts, the net, the ball on sand, and a crowd that goes quiet for the serve and reacts to the point.
At a glance
| Resource name | vs-volleyball |
| Required | ox_lib · oxmysql |
| Optional | ox_target (referee prompt) · ox_inventory (the ball item and the drinks) |
| Framework | none needed: ESX, QBCore, Qbox or standalone |
| Formats | 1v1 · 2v2 · 3v3, per court |
| Single player | full scored match vs AI, and six training lessons |
| Database | its own tables, created automatically on first boot |
| Admin | the vsvb.admin ace: per player, enforced server-side |
| Localisation | locales/en.json through the ox_lib locale system |
Two things have to happen before anyone can play: grant yourself the vsvb.admin ace, and build a court with a referee desk on it. The script ships with no courts, because a court belongs where your map has room for one. Both steps are on the Installation page and take about five minutes.
Quick links
- Installation
- Dependencies & compatibility
- How to play: controls & shots
- Serving
- Rules, stamina & the AI
- Training: the six lessons
- Beach circle, ball carts & drinks
- Teams & banners
- Leaderboard & profile
- Courts & the builder
- Configuration
- How it works: netcode & authority
- Admin & commands
- Compatibility
- Troubleshooting & FAQ
- Changelog
Get it: Volleyball Script on the store. Questions? Open a ticket on Discord.