⚠️ FAQ

⚠️ FAQ & Troubleshooting

A curated list of the most common questions and fixes for Syntax Craft. Use this page to quickly diagnose issues before opening a ticket.

---

✅ Quick checks

• Is the folder name exactly Syntax_Craft?

• Did you import syntax_craft_complete.sql?

• Are oxmysql, your framework (qb-core/es_extended), and ox_lib started before this resource?

• Are you in one of the admin groups defined in Config.AdminGroups?

• Did you restart the resource after editing shared/config.lua?

ensure oxmysql
ensure ox_lib
ensure qb-core        # or es_extended if using ESX
ensure Syntax_Craft

---

📦 Installation & startup

• The resource does not start / throws errors

  • Verify dependency order in server.cfg (see snippet above)

  • Check server console for missing exports (oxmysql / framework / ox_lib)

  • Make sure the folder name is Syntax_Craft

• SQL import warnings

  • The shipped SQL includes only essential tables; if upgrading, back up first

  • Align custom columns you may have added previously

---

🔐 Admin access (panel no abre)

• The /craftadmin command does nothing

  • Confirm your identifier belongs to a group in:

-- shared/config.lua
Config.AdminGroups = { 'admin', 'superadmin', 'mod', 'moderator', 'owner', 'developer' }

• Check server console/logs for blocked permissions

• Ensure the resource is running and not erroring during initialization

---

🧭 Framework mismatch

• Notifications or interactions behave wrong

  • Set the correct framework and enable only that block:

Config.Framework = "QBCore"  -- or "ESX"

Config.ESX = { enabled = false, resource = 'es_extended', sharedObject = 'esx:getSharedObject' }
Config.QBCore = { enabled = true, resource = 'qb-core', sharedObject = 'QBCore:GetObject' }

• Do not enable both at the same time

---

🗂️ Categories not showing

• In the recipe creator the category list is empty

  • Ensure Config.Categories contains entries and unique string IDs

  • Restart the resource after editing shared/config.lua

  • If you use custom categories, keep their id stable (used for filtering)

---

🧭 Blips (map icons)

• Blip toggle resets after restart

  • Confirm blip columns exist in syntax_crafting_tables (enabled, sprite, color, scale, display)

  • Ensure values are saved as the correct types (boolean/number)

• I don't see any blips

  • Global toggle: Config.ShowBlips = true

  • Per-table toggle and settings are in the admin UI (no Config.Blip block)

---

🍳 Recipes: not visible or can't craft

• A recipe doesn't appear in the list

  • Check its category exists in Config.Categories

  • Validate job/grade restrictions on the table

  • Ensure the item name (ID) is correct and matches your inventory resource

• "Missing materials" even when I have items

  • Verify ingredient item IDs match your inventory definitions exactly (case-sensitive)

  • For ox_inventory, confirm items exist in its registry

  • For qb-inventory, ensure shared items are defined in QBCore

• Level requirement blocks crafting

  • Compare Config.Leveling settings and the player's current profile (XP/Level)

---

🖼️ Inventory images (qb-inventory / ox_inventory)

• Items render without images or names

  • Ensure items are properly defined in your inventory resource

  • Keep the same internal IDs between recipes and inventory definitions

---

🖥️ NUI doesn't open / blank UI

• Nothing happens when interacting

  • Confirm ox_lib is installed and running

  • Check for NUI errors in the client F8 console (HTML/JS errors)

  • Verify no resource conflict overrides the same keybinds or menus

---

🗄️ Database & migrations

• Where is data stored?

  • Tables: syntax_crafting_tables (coords, prop, job, distance, blips)

  • Profiles: syntax_craft_profiles (player XP/Level)

• I need to add missing blip columns

  • Back up, then add columns consistent with your server build (sprite/color/scale/display + enabled)

• Reset all crafting data

  • Wipe tables with caution:

DELETE FROM syntax_craft_profiles;
DELETE FROM syntax_crafting_tables;

Always create a backup before destructive operations.

---

🎮 Positioning & controls

• Change height controls

  • The recommended setup uses Shift for both up/down with arrows:

Config.PositioningKeys = {
  heightUp = 21,
  heightDown = 21
}

• If you prefer Alt for down: heightDown = 19

---

🚀 Performance tips

• Keep interaction distances reasonable (e.g., 2.0–2.5)

• Avoid enabling blips for every single table; focus on key locations

• Prefer fewer, well-designed recipes per table for readability

---

🧰 Debugging

• Check server and client console logs for stack traces

• Temporarily enable any available debug flags in your version (e.g., Config.Debug = true) to surface extra logs

• Reproduce with minimal other resources to rule out conflicts

---

📎 Useful references

• Installation Guide: docs/installation.md

• What is Crafting Creator?: docs/what-is-crafting-creator.md

• Configuration: shared/config.lua

• SQL schema: syntax_craft_complete.sql

---

🆘 Need help?

Add your Discord invite or support channel here. Provide screenshots of errors (server console and F8), your server.cfg ordering, and any custom config you changed.