Crafting

Crafting lets players turn inventory materials into configured items through an animated, timed workbench. Players select their materials, choose a recipe, and complete the crafting timer to receive the output.

{:links-list}

INSTALLATION

  1. Open the downloaded ZIP file and copy the complete BigDaddy-Crafting resource folder into your server's resources folder.
  2. Add your product key from your Big Daddy Scripts account to key1 under [licensing] in settings.ini.
  3. Enable OneSync and start your framework, inventory, and their dependencies before BigDaddy-Crafting.
  4. Edit config.json to match your inventory item names and desired recipes. Every ingredient and output must exist in your inventory's item definitions.
  5. Add ensure BigDaddy-Crafting to your server.cfg after those dependencies.
  6. Restart the resource after changing its configuration. Join the server, load your character, and use /craft to open the workbench.

Keep the folder named BigDaddy-Crafting.

REQUIREMENTS

REQUIREMENT DETAILS
FiveM server GTA V server with OneSync enabled.
Licensing A valid Big Daddy Scripts product key. Crafting initializes after licensing succeeds.
Inventory ox_inventory or qb-inventory, including the selected inventory's own dependencies.
Framework Qbox, QBCore, or standalone mode with a working ox_inventory player inventory. See the combinations below.
Resource files Supplied client/server DLLs, runtime libraries, BigDaddy-NativeString.js, inventory.server.lua, settings.ini, config.json, and the complete html folder.
Item definitions All configured ingredients and outputs, including weapon items, must be registered in your inventory.

Crafting opens through a command. A targeting resource is not required, and there is no crafting-specific SQL import.

Framework and inventory selection

SETTING ACCEPTED VALUES AUTO SELECTION ORDER
framework auto, qbox, qbcore, standalone qbx_core, then qb-core, then standalone.
inventory auto, ox_inventory, qb-inventory ox_inventory, then qb-inventory.

The normal combinations are Qbox with ox_inventory and QBCore with qb-inventory. Other combinations require an inventory installation compatible with your framework. Selecting a provider does not install or configure its dependencies. qb-inventory requires a loaded QBCore or compatible Qbox character and access to the QB core/shared-item API.

standalone removes Crafting's framework requirement; it still requires a working ox_inventory player inventory. There is no ESX-specific integration.

Automatic selection checks running resources on each request. With an explicit selection, the selected resource must be running and the player's inventory must be loaded. A craft cannot complete against a different character or inventory provider from the one that started it.

CONFIGURATION

Use settings.ini for licensing, permissions, and diagnostics. Use config.json for the command, panel title, provider selection, and recipes. Restart BigDaddy-Crafting after editing either file. REFRESH only reloads player inventory quantities.

settings.ini

SECTION SETTING DEFAULT / VALUE DESCRIPTION
[licensing] key1 Your product key Get your key from your Big Daddy Scripts account.
[settings] UseAcePermissions false Set to true to restrict crafting to players with the configured ACE permission.
[settings] AcePermission command ACE object required when permission checks are enabled. You can choose a dedicated object such as bigdaddy.crafting.
[settings] debug false Enables additional diagnostic logging, including completion timing and inventory results.
[settings] DesyncKey Supplied value Leave the supplied synchronization value unchanged.

Restricting access

Crafting is available to all players by default. To restrict it, set these values in the existing [settings] section:

UseAcePermissions=true
AcePermission=bigdaddy.crafting

Then grant that same object to your chosen group in server.cfg, for example:

add_ace group.admin bigdaddy.crafting allow

Players must belong to the group you grant. Permission is checked when opening the workbench, starting a craft, and completing it. Licensing is required regardless of ACE access.

config.json

SETTING DEFAULT DESCRIPTION
command craft Command name without /. Players enter /craft with this default.
title CRAFTING Heading displayed in the workbench. Must not be empty.
framework auto Framework selection from the table above.
inventory auto Inventory selection from the table above.
recipes Supplied recipe list Must contain at least one valid recipe. Customize it for your server.

Recipe fields

FIELD DESCRIPTION
id Unique recipe identifier. Different recipes can share a display label, but each needs its own ID.
label Required recipe name displayed in the workbench.
description Description displayed on the recipe card.
ingredients Nonempty array of ingredient objects, each with item, label, and quantity. Do not repeat an item name within one recipe.
output One output object with item, label, and quantity. A recipe produces one item type.
durationMs Whole-number crafting duration from 1000 to 3600000 milliseconds. 20000 is 20 seconds. Defaults to 10000 when omitted.
animation.dictionary GTA animation dictionary. Defaults to amb@world_human_hammering@male@base when omitted.
animation.clip Animation clip in that dictionary. Defaults to base when omitted.

Command names, recipe IDs, and item names must contain 1 to 64 letters, numbers, underscores, or hyphens. Quantities must be whole numbers from 1 to 100000. Missing ingredient/output labels fall back to the item name. Invalid configuration prevents crafting initialization and logs the offending setting.

For unique qb-inventory outputs, use quantity: 1. Multiple unique items cannot be granted as one multi-count output stack.

Complete example configuration

This example replaces config.json with two recipes. Register carhood, metalscrap, oldtyre, and repairkit in your inventory, or change their names to your registered items.

{
  "command": "craft",
  "title": "CRAFTING",
  "framework": "auto",
  "inventory": "auto",
  "recipes": [
    {
      "id": "metal1",
      "label": "Metal Scrap",
      "description": "Turn car parts into usable scrap.",
      "ingredients": [
        { "item": "carhood", "label": "Car Hood", "quantity": 1 }
      ],
      "output": { "item": "metalscrap", "label": "Metal Scrap", "quantity": 4 },
      "durationMs": 20000,
      "animation": { "dictionary": "mini@repair", "clip": "fixing_a_ped" }
    },
    {
      "id": "repairkit",
      "label": "Repair Kit",
      "description": "Assemble a basic vehicle repair kit.",
      "ingredients": [
        { "item": "metalscrap", "label": "Metal Scrap", "quantity": 10 },
        { "item": "oldtyre", "label": "Rubber", "quantity": 3 }
      ],
      "output": { "item": "repairkit", "label": "Repair Kit", "quantity": 1 },
      "durationMs": 20000,
      "animation": { "dictionary": "mini@repair", "clip": "fixing_a_ped" }
    }
  ]
}

The first recipe exchanges one car hood for four metal scrap after 20 seconds. The second exchanges ten metal scrap and three oldtyre items for one repair kit after 20 seconds. Rubber is only the display label; the actual ingredient item name is oldtyre.

The supplied configuration also includes car-door scrap, saw-blade axe, and water-filter recipes. Review every recipe before enabling it: custom ingredients and weapon outputs must use the exact item names registered in your inventory.

Ingredients are matched by item name across inventory slots. Recipes do not filter ingredient metadata or copy it to the output. Use materials suitable for this behavior. Refunds preserve original ingredient slots and metadata.

HOW TO PLAY

  1. Be alive, on foot, and standing. Open /craft, or the command your server owner configured.
  2. Under YOUR MATERIALS, use the plus/minus buttons or quantity boxes to select materials. Only inventory items used by configured recipes appear here.
  3. Select enough of each ingredient for your chosen recipe. Its card will show READY TO CRAFT.
  4. Click the recipe card, then START CRAFTING.
  5. Stay in place while the animation plays and the progress bar completes. The ingredients are exchanged for the output at completion, and the panel closes.
  6. Open the command again to craft another item. Use REFRESH before starting if your inventory has changed.

Each start performs one recipe cycle. Selecting extra materials does not queue additional crafts; only the recipe's required quantities are consumed.

Canceling and interruptions

Press Escape, click the close button, or click CANCEL CRAFTING to cancel and close the panel. Canceling before the server completes the exchange consumes no ingredients.

Moving away, death, an interrupted animation, character changes, disconnects, dependency stops, and request timeouts can end a craft. Once the server has completed the exchange, closing or canceling cannot undo it. If a completion response times out, check your inventory before retrying.

Inventory exchange

Ingredients stay in your inventory during the timer. At completion, the server rechecks permissions, character identity, inventory provider, and ingredients. It removes the required materials, checks output capacity after freeing their space, and grants the output. Each player can have only one active craft.

If an inventory operation fails after ingredients are removed, the bridge attempts to refund them. An uncertain result or failed refund logs RECOVERY REQUIRED and blocks further crafting for that character until the resource restarts. An administrator must preserve the log and reconcile the character's inventory before restarting; restarting alone does not restore missing items. A server crash during an exchange requires recovery through your inventory provider and server records.

TROUBLESHOOTING

The command does not open the workbench

  • Confirm the complete resource is installed as BigDaddy-Crafting and OneSync is enabled.
  • Check licensing and server-console startup errors. Invalid recipe configuration prevents initialization.
  • Check command in config.json; enter it with / in chat.
  • Confirm your character and inventory are loaded, and that you are alive, standing, and outside a vehicle.
  • If ACE restrictions are enabled, grant the exact object configured in AcePermission.

No materials appear, or START CRAFTING is disabled

  • Only items used as recipe ingredients appear under YOUR MATERIALS.
  • Match the item values to your inventory's exact item names. Changing label changes display text only.
  • Click REFRESH after collecting materials, then select the quantities and a recipe card. Owning the items alone does not select them.
  • Each required ingredient must be both owned and selected in sufficient quantity.

The framework or inventory is unavailable

  • Start your framework, inventory, and their dependencies before Crafting.
  • Check framework and inventory against the supported values and combinations above.
  • With both inventories running, auto prefers ox_inventory. Choose an explicit provider if needed.
  • Let your character finish loading. If you switched characters or providers during crafting, reopen the workbench and start again.

The animation fails or crafting is interrupted

  • Verify that animation.dictionary and animation.clip name a valid, compatible GTA animation.
  • Stay in place and avoid actions that interrupt the crafting animation.
  • Restart after configuration edits and check the console for errors identifying the recipe.

Crafting finishes without an output

  • Confirm the output item is registered and that there is room for it after consuming the ingredients.
  • Confirm the ingredients were still available at completion. They are not reserved during the timer.
  • Use output quantity 1 for unique qb-inventory items.
  • Check your inventory before retrying after a timeout. Enable debug=true for completion timing and inventory diagnostics.
  • If the console reports RECOVERY REQUIRED, have an administrator reconcile the logged items and character before restarting the resource.