Coroutine Basics

Coroutines enable cooperative multitasking within a single script. Unlike parallel execution, only one coroutine runs at a time — they yield control voluntarily.

Creating coroutines:

• coroutine.create(func) — returns thread object
• coroutine.wrap(func) — returns a function that resumes the coroutine

Controlling coroutines:

• coroutine.resume(thread, ...) — start or continue execution
• coroutine.yield(...) — pause and return values to resumer
• coroutine.status(thread) — check state

Thread states:

• "suspended" — created or yielded (not running)
• "running" — currently executing
• "dead" — finished or errored
• "normal" — resumed another coroutine

Passing data:

• Arguments to resume() become the return values of yield() inside
• Arguments to yield() become the return values of resume() outside

Error handling: coroutine.resume returns: true, values on success OR false, errorMessage on error Errors don't crash the main thread — they stop the coroutine.