GFX Crafting ATY

A feature-rich crafting system with a modern NUI interface, supporting multiple crafting tables, leveling/experience progression, weapon attachment management, coin/boost economy, and Tebex integration.

Info

Dependencies

• QBCore (qb-core) or ESX (es_extended) -- depending on framework choice
• MySQL -- one of: oxmysql, mysql-async, or ghmattimysql
• Discord Bot Token -- required for player avatar fetching (configured in server/serverconfig.lua)

Installation

1. Import SQL

Run the data.sql file in your database to create the required tables:

• crafting_data -- stores player experience, coins, and boosts
• crafting_codes -- stores redeemable coin codes (generated via Tebex purchases)

2. Add Items to Your Inventory System

QBCore: Add the entries from items/qb.txt to your qb-core/shared/items.lua:

• clip_attachment
• flashlight_attachment
• suppressor_attachment
• grip_attachment
• smallscope_attachment

ESX: Run the SQL from items/esx.sql to insert the items into your items table.

You also need to add any crafting ingredient items (e.g., cloth, iron, wood) and craftable output items (e.g., bandage, weapon_pistol) that you define in your config.

3. Copy Resource

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

4. Configure

Edit config.lua to set your framework, MySQL driver, crafting tables, recipes, levels, and attachments. Edit server/serverconfig.lua to set your Discord bot token.

5. server.cfg

ensure gfx-crafting_aty

Configuration

Configuration is done in config.lua. Key options:

Crafting Tables

Defined in Config.CraftingTables. Each table entry is a keyed table with:

Craftable Item Recipe

Each item in a crafting table's Items array:

Levels

Defined in Config.Levels. A table mapping level number to the required cumulative experience:

Levels = {
    [1] = { exp = 0 },
    [2] = { exp = 50 },
    [3] = { exp = 100 },
    -- ... up to [15] = { exp = 4000 }
}

Weapon Attachments

Config.AttachmentItems maps attachment slot names to inventory item codes:

Config.Attachments defines which weapon supports which attachment components (with GTA hash keys). Supported weapons include pistols, SMGs, rifles, shotguns, and snipers.

Server Config

In server/serverconfig.lua:

Exports

Client Exports

OpenCraftingTable

Opens a specific crafting table UI by its config key.

exports['gfx-crafting_aty']:OpenCraftingTable(id)

CloseCraftingTable

Closes the crafting table UI.

exports['gfx-crafting_aty']:CloseCraftingTable()

No parameters.

Events

Client Events

aty_crafting:client:updatePlayerData

Triggered from the server to update the player's experience and level in the UI after crafting completes.

-- Triggered by the server, listened on the client
TriggerClientEvent("aty_crafting:client:updatePlayerData", source, newExp)

Server Events

aty_crafting:server:craftEnded

Triggered by the client when a crafting queue item finishes. Awards the crafted item and experience to the player.

-- Triggered from client
TriggerServerEvent("aty_crafting:server:craftEnded", item)

Commands

Features

• Multiple Crafting Tables -- Define unlimited crafting stations at different locations, each with their own recipes and categories
• Job & Grade Restrictions -- Lock crafting tables behind specific jobs and minimum grades, or set to "all" for public access
• Leveling System -- Players earn experience from crafting and unlock higher-level recipes as they progress (up to 15 levels)
• Category Filtering -- Items in each crafting table are organized into categories (weapons, consumables, attachments, etc.) with an "all" view and search functionality
• Crafting Queue -- Players can queue multiple items for crafting; progress persists across menu open/close during the session
• Batch Crafting -- Craft multiple quantities of an item at once (duration and ingredient costs scale accordingly)
• Coin & Boost Economy -- Players earn coins (via Tebex codes) that can be spent on crafting boosts to reduce crafting time by a configurable percentage
• Weapon Attachment System -- Add/remove weapon attachments (clips, silencers, flashlights, scopes, grips) directly from the crafting UI when holding a weapon; consumes/returns attachment items from inventory
• Tebex Integration -- Coin purchase codes are generated via a console command triggered by Tebex webhooks; players redeem codes in the UI
• Map Blips -- Optional configurable blips for each crafting table that respect job restrictions
• Player Avatars -- Fetches Discord avatars for display in the crafting UI
• Multi-Framework -- Supports QBCore, ESX, and OldESX with configurable MySQL driver
• NUI Interface -- Modern web-based UI with localization support
• Localization -- All UI text is configurable through locales.lua

Troubleshooting