Blueprint Learning — Unlock Recipes

Description

A working QBCore blueprint learning system: a player consumes a one-time blueprint item and the matching recipe is permanently taught to that specific character. The server checks the item, removes it once, and records the unlock per citizenid so it persists and can gate any craft. This is the simplest, most legacy-friendly progression hook a crafting server can sell.

Prompt Template

You are writing a FiveM resource for qb-core (exports['qb-core']:GetCoreObject()).

Expected Output

The reference Lua lives at content/expected-outputs/crafting/09-blueprint-learning-unlock.lua. It implements a read anim on item use, a server-side blueprint table, a per-citizenid learned set with…

Known Failure Modes & Corrective Prompt

• Client-trusted unlocks — Claude stores learned recipes locally; a modder marks everything known. Keep the learned set and item consumption on the server.
• Anim before load — TaskPlayAnim no-ops if the dict is not loaded; always RequestAnimDict + while not HasAnimDictLoaded(dict) do Wait(0) end.
• One-sided net event — defining blueprint:learnResult on only one side breaks the confirmation; both client and server use RegisterNetEvent + AddEventHandler.

Corrective re-prompt: "Move the learned set to the server keyed by citizenid: verify the blueprint item with GetItemByName, RemoveItem exactly once, then record the unlock, and expose a server callback so other crafts can check knowledge. The client only triggers the learn event."

Framework Integration

• ESX: swap to exports['es_extended']:getSharedObject(), key learned by xPlayer.identifier, consume with xPlayer.removeInventoryItem(item, 1), and register the usable item via ESX.RegisterUsableItem.
• QBCore: as written — Player.Functions.GetItemByName / RemoveItem, learned keyed by citizenid, plus a QBCore.Functions.CreateCallback.
• QBox: use exports.qbx_core:GetPlayer(src) with ox_inventory item removal; the learned set and callback logic are identical.

Profit Potential

$200–$2400/mo on Tebex (expected ~$650). [INFERRED] priced inside the $50-389 script band against the signal-scraper tebex_snapshot corpus (n=100, median seller $11.85K/mo); a rising but simple progression pattern with broad legacy compatibility.

Trend Signal

↗ rising — inferred: blueprint-gated recipe unlocks are a rising progression pattern across crafting servers; simple and legacy-friendly.

Sales Angle

The cheapest progression hook any crafting server can drop in — consume a blueprint, learn a recipe forever, gate the good stuff behind it. Recommended Tebex price $89.

Difficulty & Ship Time

beginner · ships in 2-3h.