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.
POPULAR LINKS
- MY ACCOUNT Get your Big Daddy Scripts product key
- TROUBLESHOOTING Help with installing and running your resource
- PERMISSIONS Help with ACE permissions
{:links-list}
INSTALLATION
- Open the downloaded ZIP file and copy the complete
BigDaddy-Craftingresource folder into your server's resources folder. - Add your product key from your Big Daddy Scripts account to
key1under[licensing]insettings.ini. - Enable OneSync and start your framework, inventory, and their dependencies before BigDaddy-Crafting.
- Edit
config.jsonto match your inventory item names and desired recipes. Every ingredient and output must exist in your inventory's item definitions. - Add
ensure BigDaddy-Craftingto yourserver.cfgafter those dependencies. - Restart the resource after changing its configuration. Join the server, load your character, and use
/craftto 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
- Be alive, on foot, and standing. Open
/craft, or the command your server owner configured. - Under YOUR MATERIALS, use the plus/minus buttons or quantity boxes to select materials. Only inventory items used by configured recipes appear here.
- Select enough of each ingredient for your chosen recipe. Its card will show READY TO CRAFT.
- Click the recipe card, then START CRAFTING.
- 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.
- 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-Craftingand OneSync is enabled. - Check licensing and server-console startup errors. Invalid recipe configuration prevents initialization.
- Check
commandinconfig.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
itemvalues to your inventory's exact item names. Changinglabelchanges 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
frameworkandinventoryagainst the supported values and combinations above. - With both inventories running,
autoprefers 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.dictionaryandanimation.clipname 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
1for unique qb-inventory items. - Check your inventory before retrying after a timeout. Enable
debug=truefor completion timing and inventory diagnostics. - If the console reports
RECOVERY REQUIRED, have an administrator reconcile the logged items and character before restarting the resource.