ak4y Football / Soccer Script

Football matches and team lobbies

ak4y Football is a football (soccer) minigame for FiveM on QBCore. Players create a match at the football NPC, choose a duration, join a position on the red or blue team and play with outfield and goalkeeper controls. Spectators can bet on the result, and player statistics are stored in the database.

Features

• Match lobby with six positions per team: goalkeeper, three defenders and two forwards
• Match durations of 5, 10, 15 or 20 minutes
• Match creation fee and bets with configurable minimum and maximum
• Scoring: points for goals, shots and saves, minus points for own goals
• Controls: shoot high (E) or low (Q), slide (F), rainbow flick (G), scoreboard (CAPS); goalkeepers dive, hold, throw and drop the ball on the numpad and N/M
• Firework effect after a goal (can be turned off)
• Leaderboard, MVP screen and win, lose or draw screens
• Team jerseys set by clothing numbers in the config
• Map blip, football NPC and pitch location are all configurable

Requirements

• QBCore (AK4Y.Framework: qb or oldqb); the manifest also contains commented lines for ESX
• PolyZone
• oxmysql (ghmattimysql or mysql-async are possible after changing the config and fxmanifest)

Installation

• Copy the ak4y-football folder into your resources.
• Import ak4y-football.sql into your database.
• Set the pitch coordinates, fees, bets and jersey numbers in config.lua. The interface texts in AK4Y.Language are in Turkish by default, so translate them for your server.
• Add ensure ak4y-football to your server.cfg after PolyZone and oxmysql.