## 🎥 **[Watch the trailer](https://youtu.be/7Ghz84Gbews)**
---
## 🎾 **Why k0sseK Squash?**
**kossek_squash** is a squash minigame for FiveM: 1v1 matches and solo practice on a real squash court, with support for **ESX**, **QBCore**, **QBox** and **Standalone** mode. Players walk onto a court, open the squash panel, set a stake and play — with a serve power meter, shots aimed with the camera, Elo rankings, and a four-court venue at Vespucci Beach that comes with the script.
The server referees every rally on a ball simulation that every player sees the same way. Clients never report a result.
---
## ✨ **Features**
- **Matches and Practice** — 1v1 matches to 11 points (win by 2), a single game or best of 3 / 5. Solo practice records your longest rally.
- **Hard and Touch Shots** — Aim with the camera: drives on one key, drops and lobs on the other. The better your timing, the faster and straighter the ball, and a readout shows the speed and how clean the hit was.
- **Serve Power Meter** — Stop the bar in the sweet spot. Real service boxes: change boxes while you hold serve.
- **Server-Side Referee** — In, out, tin, double bounce, service faults, the ball hitting a player, and let appeals on a key, all ruled on the server.
- **Wagers** — The player who opens the match sets a stake, the challenger sees it before accepting, the winner takes the pot. Optional house fee. Stakes are refunded when a match cannot be played.
- **Elo Rankings** — Ratings per character, a rating leaderboard and a longest-rally leaderboard. The database table is created for you.
- **Four Courts Included** — A full-size squash venue at Vespucci Beach: painted walls and lines, glass back walls with doors, lights at night. Squash racket and ball models included.
- **Live Scoreboards** — A screen over every court shows who is waiting, the score and the result. Spectators follow the match there.
- **Courts Anywhere** — `/squashcourt add` builds a court where you stand, lines it up with the walls of a room, and prints the config line for a permanent one. `/squashcourt board` hangs a scoreboard for it.
- **Multi-Framework Bridge** — ESX, QBCore, QBox and Standalone through an open bridge: character names, money and stats per character.
- **Multi-Target Support** — ox_target, qb-target, or a built-in [E] prompt with a marker. Works without any target resource.
- **Customizable** — Open config, bridge, notifications and locales (EN and PL), a theme file that restyles the HUD, the panel and the scoreboards, and a HUD editor for every player (`/squashhud`).
- **Server Event** — `kossek_squash:matchFinished` for your logs, rewards or webhooks.
---
## 📋 **Requirements**
ox_lib, oxmysql, OneSync, server build 16276 or newer. Optional: ESX, QBCore or QBox (names, wagers, stats per character), ox_target or qb-target.
The venue replaces the handball courts next to the outdoor gym at Vespucci Beach and streams edited copies of nine of the game's files for that block. If another map of yours changes the same spot, run the script without the venue and place courts with `/squashcourt add`.
---
## 🔧 **Coming in the next updates**
1.0.0 has three things we already know about and are working on:
- Holding the touch-shot key (right mouse by default) can switch the camera to the game's aim view. A short press plays the shot normally.
- The referee is strict on let appeals and will be tuned: today most appeals are answered "no let".
- A court camera that keeps the whole court in view. Today the game's follow camera gets pushed in by the walls.
---
## 📞 **Support & Community**
Need help? Read the **[documentation](https://k0ssek-scripts.gitbook.io/docs/scripts/squash)** or join our **[Discord](https://discord.gg/eZN5ycvPVs)** for fast support and updates.
🎟️ Get **-20% OFF** on your first order — claim your code on Discord.
