GFX Arena

Team-based PvP arena system where players create or join lobbies, bet money, and compete in round-based team deathmatch across multiple maps with full profile tracking, leaderboards, and match history.

Info

Dependencies

Installation

1. Copy the gfx-arena folder into your server's resources directory.
2. Import arena.sql into your database. This creates two tables:
   • gfxarena_profile -- Stores player stats (kills, deaths, wins, losses)
   • gfxarena_history -- Stores match history per player
3. Add the resource to your server.cfg:

   ensure gfx-arena
   

4. Configure config.lua to match your framework and SQL wrapper (see Configuration below).
5. (Recommended) Set your Steam Web API key as a convar in server.cfg:

   set steam_webApiKey "YOUR_STEAM_API_KEY_HERE"
   

Configuration

config.lua

Map Configuration

Each entry in Config.Maps has the following structure:

locale.lua

All user-facing notification strings are defined in locale.lua and can be freely edited for localization.

Exports

Client Exports

IsPlayerInMatch

Returns whether the local player is currently in an active arena match.

Returns: boolean -- true if the player is currently in a match, false otherwise.

local inMatch = exports['gfx-arena']:IsPlayerInMatch()
if inMatch then
    print("Player is in an arena match")
end

Events

No public API events. All events in this script are internal (used between the client and server of the resource itself) and are not intended for external use.

Commands

Features

• Team-based PvP arena with 2 teams per match
• Lobby system: create, join, leave, and configure lobbies
• Configurable bet system using in-game cash (winners receive 2x the bet)
• Round-based matches with configurable round count
• Multiple maps with per-team spawn points (4 maps included by default)
• Weapon selection phase at the start of each round via gfx-gunmenu
• Friendly fire protection using relationship groups (teammates cannot damage each other)
• Player profile tracking: kills, deaths, wins, losses, K/D ratio, and win rate
• Rank system based on win rate: Noob, Beginner, Rookie, Pro, Master
• Leaderboard sorted by kills and win/loss ratio (top 5)
• Match history per player (last 4 matches stored)
• Steam profile picture integration for player avatars
• Spectator mode: eliminated players can spectate remaining teammates (left/right arrow to switch)
• Cinematic end-match camera showing winning team
• NPC interaction point to open the arena menu (configurable model and location)
• Automatic lobby cleanup when players disconnect mid-match
• Routing bucket isolation: active matches are placed in separate routing buckets to prevent interference
• Full NUI-based user interface

Troubleshooting