Everything you need to know

Air Hockey

Bring a complete air hockey experience to your FiveM server with DL Air Hockey, a server-authoritative minigame featuring competitive player-versus-player challenges, solo matches against AI and a free practice mode.

The resource includes custom table, puck and striker models, synchronized gameplay, a physical world-space scoreboard, multiple camera angles, modern menus, configurable economy support and an immersive character system that keeps each player's hand positioned on the striker.

Three Game Modes

Versus Player

Create a public challenge at a table and wait for another player to accept it. The host selects the red or blue side, puck limit, time limit and optional stake.

When betting is enabled, the accepting player matches the challenger's stake. Both amounts are secured by the server and the winner receives the complete pot. A tie or an early cancellation refunds both participants.

Versus AI

Start an immediate solo match against a configurable AI opponent. The server remains authoritative for AI striker movement and puck physics, while nearby players can see the visual NPC and follow the match.

AI difficulty can be selected from the menu. Stakes are always disabled for AI matches, regardless of client input.

Practice

Play alone with the puck and improve your control without an opponent paddle. Practice mode has no player stake and is ideal for learning the cameras, sensitivity and table physics.

Each mode can be enabled or disabled individually in the configuration.

Server-Authoritative Physics

Puck movement, striker limits, collisions, goals, scores and match state are controlled by the server. Player input is validated and each striker is restricted to its own half of the table.

Configurable physics include puck speed, striker acceleration, collision damping, substeps, safety speed limits and input rates. The local player's striker follows their input immediately, while remote movement and the puck are synchronized for the opponent and nearby spectators.

Betting & Economy

PvP challenges can use real framework money:

• The challenger selects a stake
• The accepting player pays the same amount
• Both stakes are held when the match begins
• The winner receives the complete pot
• A tie refunds both players
• Leaving, moving too far away or an expired challenge triggers a full refund
• AI and Practice stakes are forced to zero by the server

Tables can also charge a configurable entry price in every mode.

Supported economy integrations:

• ESX Legacy
• QBCore
• Qbox
• ND Core
• Official vRP 2
• Explicit standalone mode with a simple JSON wallet

Automatic framework detection locks the selected integration for the resource session. If the active framework stops, paid joins fail safely instead of switching wallets.

Custom Table & Live Scoreboard

The package includes custom models for:

• Air hockey table
• Puck
• Red striker
• Blue striker

The raised scoreboard on the physical table displays the live HOME score, remaining time and AWAY score through a world-space digital screen. It is visible to players and nearby spectators rather than being limited to the two participants.

Goals, striker hits and rail impacts use included audio effects that fade with camera distance.

Automatic Table Discovery

Every streamed prop_airhockey_01 placed through a map, YMAP or MLO can be detected automatically. Tables can also be spawned at custom coordinates through Config.Tables.

Mapped tables can receive individual price and ownership settings without creating a duplicate model. Automatically discovered tables use configurable default settings.

Important: Config.Tables is empty by default, so server owners must use a mapped table or add their own locations before playing.

Player Animation & Hand IK

Each character keeps their right hand positioned on the striker using arm IK. Players shuffle along the end of the table and blend into a forward-leaning pose when reaching farther across the playfield.

The AI opponent also uses animated lateral footwork. Character movement remains cosmetic and does not change the server-authoritative striker position or gameplay result. Nearby spectators see the same hand placement and footwork.

Six Camera Angles

• Behind
• Elevated
• Top Down
• Side Profile
• Corner
• Over Shoulder

The last selected camera is remembered. Mouse aiming works in every view, while controller movement remains screen-relative.

Targets & Interaction

Table interaction is selected automatically from:

• ox_target
• qb-target
• qtarget
• bt-target
• Native E prompt when no target system is running

Supported target resources can be started or restarted without permanently losing table interactions.

Table Management

Configured owner-managed tables can expose an in-game settings panel for:

• Entry price
• Open or closed status

Management is protected by the airhockeyv.manage ACE permission. Only configured tables marked as owned display the settings option.

Modern UI & Player Settings

The menu lets players select the mode, side, puck limit, time limit, AI difficulty, PvP stake and mouse or controller sensitivity. Sensitivity is stored separately for each player.

The join menu, result panel and in-match HUD scale automatically for 1080p, 1440p and 4K resolutions. The physical scoreboard remains a separate world-space display.

11 Included Languages

• English
• Polish
• German
• French
• Spanish
• Brazilian Portuguese
• Italian
• Dutch
• Turkish
• Czech
• Russian

Missing locale entries automatically fall back to English.

Default Controls

Controls are registered through FiveM key mappings and can be rebound by each player.

Key Features

• PvP challenges with optional server-secured stakes
• Solo matches against configurable AI
• Free Practice mode
• Server-authoritative puck physics and scoring
• Automatic refunds for ties and cancelled matches
• Entry prices and owner-managed table settings
• Custom table, puck and striker models included
• Live physical scoreboard visible to spectators
• Distance-based hit, rail and goal sounds
• Animated hand IK, player footwork and AI footwork
• Six switchable camera presets
• Mouse and controller support
• Per-player sensitivity settings
• Automatic mapped-table discovery
• Custom table placement through configuration
• ESX, QBCore, Qbox, ND Core, vRP 2 and standalone support
• Automatic target integration with native fallback
• Modern resolution-aware UI
• 11 included languages

Important Information

• Config.Tables is empty by default
• Add table coordinates or use a map/MLO containing prop_airhockey_01
• VORP is not supported because this is a FiveM/GTA V resource
• Standalone mode uses a basic JSON wallet; servers requiring production-grade standalone persistence should connect their own economy storage

Need help? Join the ShopFusion Discord.