Bonus · Debug class

Debug class for total beginners

This is the early primer shown before Lesson 01 on the scripts-from-zero path. Use it now for the error-reading habit, then revisit it later when exports, SQL, and framework errors become real in your own server. An error is a clue, not a verdict: Lua tried one specific thing, and one specific part was missing. You will build a tiny resource named qu_debug_class, break it on purpose, read the real error, and fix it with print(type(value), value).

You'll build: A calm way to read errors before you start changing random code.
Time: ~18 minutes
You need: No setup. Read it before your first Lua lesson, then keep it bookmarked for later builds.
You'll learn: Read the first error -> spot nil -> spot wrong-side calls -> spot broken exports -> debug in a clean order

BEFORE YOU START

Watch: debugging in action

Watch a real debugging pass first, reading the error, finding the line, and fixing one thing, then do the hands-on build below.

Reading errors and fixing scripts, step by step.

attempt to index a nil value -> you read thing.name on an empty thing attempt to call a nil value -> you ran thing() but thing is not a function attempt to concatenate a nil value -> you glued text onto an empty value attempt to perform arithmetic on nil -> you did math (+ - * /) on an empty value

RegisterCommand('debugclass', function() local player = nil print('[qu_debug_class] type check', type(player), player) print('[qu_debug_class] name is ' .. tostring(player and player.name)) end, true)

Symptom	Fix
`Resource qu_debug_class does not exist`	Check the folder is inside resources and the ensure line uses the exact same name.
`Could not load resource qu_debug_class`	Open fxmanifest.lua and fix the first quote, brace, or file name error the console reports. Do not add a lua54 line; it is deprecated and ignored.
`Failed to load script / unexpected symbol near '<eof>'`	A syntax error: a missing end, quote, or bracket. Open the file and line the console names and balance the quotes, parentheses, and ends.
`attempt to call a nil value (global 'GetPlayerEndpoint')`	That function is server-only. Read the file path in the error: a server name called from a client/ file is a wrong-side call.
`No such export in resource qb-core or ox_inventory`	Check the resource name, that it is started, and that you used the right framework snippet before rewriting any logic.
`The command prints nothing in F8`	This resource is a server_script, so its output goes to txAdmin Live Console, not F8. Read the right console.

Debug class for total beginners

Watch: debugging in action

Make the resource folder

Create the files

Write fxmanifest.lua

Break it on purpose

Start it and trigger the error

Translate the error into plain English

Confirm it with the fastest debug tool

Fix the one thing and test again

If something went wrong

What you can do now

Try it yourself