QBX Configuration

This guide covers the necessary code adjustments to route the QBX framework's native spawn logic through the Boyraz Spawn Selector.

Important: Always create a backup of your qbx_core files before making any modifications.

---

🔧 Required Core Modifications

To ensure full compatibility, you must replace the default spawn resource references in your QBX core files with our script identifier.

Target File: qbx_core > client > character.lua

---

Modification 1: Resource Missing Detection

Line: ~345

Locate the resource state validation check and update the target name:

-- Replace this line:
if GetResourceState('qbx_spawn') == 'missing' then

-- With this line:
if GetResourceState('uz_SpawnSelector-2') == 'missing' then

---

Modification 2: Resource Started Detection

Line: ~442

Update the conditional check for the active resource state:

-- Replace this line:
elseif GetResourceState('qbx_spawn'):find('start') then

-- With this line:
elseif GetResourceState('uz_SpawnSelector-2'):find('start') then

---

💡 Global Search Tip

Use your code editor's global search (VS Code: Ctrl + Shift + F or Cmd + Shift + F) to find all instances of qbx_spawn across your installation to ensure no references are missed.

---

✅ Verification Steps

1. Save character.lua.

2. Restart your FiveM server.

3. Monitor Console for script initialization errors.

4. Test In-Game by creating a new character or forcing a respawn.

Setup Complete: Your Qbox framework is now routing spawns through the Boyraz UI.

---

⚠️ Maintenance Note

Future Updates: Updating qbx_core will overwrite these changes. Remember to reapply these modifications to character.lua after any framework updates.

🆘 Troubleshooting

Spawn selector not appearing?

• Verify both code changes were applied correctly

• Check console for errors

• Ensure uz_SpawnSelector-2 is started after QBX core

Getting errors in console?

• Double-check the resource name is exactly uz_SpawnSelector-2

• Verify the resource is properly installed in your resources folder

• Make sure you saved all changes to the character.lua file