gfx-tabu

Info

Dependencies

Installation

1. Copy the resource

Place the gfx-tabu folder into your server's resources directory.

2. Install Node dependencies

cd resources/gfx-tabu
npm install

3. Add to server.cfg

ensure gfx-tabu

4. Configure framework

Edit config.lua and set Config.Framework to match your framework (esx, oldesx, qbcore, or oldqbcore).

5. (Optional) Profile pictures

• Steam avatars (default): Set the steam_webApiKey convar in your server.cfg.
• Discord avatars: Set showDiscordPP = true and provide a valid Discord bot token in svconfig.lua.

Configuration

config.lua

Config.Locales

Config.Words

An array of word entries. Each entry defines a word to guess, its point value, and a list of taboo (forbidden) words.

{
    word = "Water",     -- The word to be guessed
    point = 100,        -- Points awarded for a correct guess (or deducted for taboo violation)
    taboo = {           -- Words the narrator cannot say
        "Drink",
        "Thirst",
        "Ocean",
        "Sea",
    }
}

Default words included: Water, Car, House, Dog, Cat, Tree, Phone, Computer, Table, Chair, Bed, Door, Window.

svconfig.lua

Exports

Server Exports

GetConfig

Returns the full Config table.

local config = exports['gfx-tabu']:GetConfig()

Returns: table -- The Config table containing all settings, locales, and words.

GetIdentifier

Returns a specific identifier for a player (e.g., steam, discord, license).

local identifier = exports['gfx-tabu']:GetIdentifier(source, type)

Returns: string or nil -- The matching identifier string, or nil if not found.

GrabDiscordPP

Fetches a player's Discord profile picture URL. Defined in sv_discord.js.

local avatarUrl = exports['gfx-tabu']:GrabDiscordPP(source)

Returns: string or nil -- The Discord avatar URL, or nil if unavailable.

GrabSteamPP

Fetches a player's Steam profile picture URL (large size). Defined in sv_discord.js.

local avatarUrl = exports['gfx-tabu']:GrabSteamPP(source)

Returns: string or nil -- The Steam avatar URL, or nil if unavailable.

Events

No public API events. All events in this script are internal (used for client-server communication within the resource).

Commands

Features

• Team-based word guessing game -- Two teams (Team A and Team B) compete to reach the win point threshold first.
• Lobby system -- Players create or join lobbies based on proximity. Auto-balances teams on join.
• Turn rotation -- Narrators alternate between teams. Within each team, members take turns as the narrator.
• Pass mechanic -- Each player gets 3 passes per game to skip difficult words.
• Taboo violation -- If the narrator uses a forbidden word, points are deducted from their team.
• Timed rounds -- Each narrator has a configurable time limit per turn.
• Configurable rewards -- Winning team members receive money and/or items.
• Profile pictures -- Supports both Steam and Discord avatars in the UI.
• Multi-framework support -- Works with ESX, QBCore, and their legacy versions.
• NUI-based interface -- Full web-based UI for the game board, teams, and scoring.
• Customizable word list -- Add, remove, or modify words and their taboo terms in config.lua.
• Localization support -- Notification messages are configurable via Config.Locales.

Troubleshooting