frameserver_debugstall(3)

💅 frameserver_debugstall — Arcan Lua API

okay so bestie, welcome to frameserver_debugstall(3), one of those pages that's like, extremely niche but also kind of iconic if you're the kind of person who debugs frameservers for fun (and honestly? respect). 🫶

---

✨ NAME ✨

frameserver_debugstall — change the global delay before a frameserver executes

---

🦋 SYNOPSIS 🦋

nil
frameserver_debugstall( time )

---

🌸 DESCRIPTION 🌸

so like, first thing you need to know: this function is only exposed in debug builds of the engine. not regular builds, bestie — debug builds only. the vibe is that in debug builds you can just assume all the other relevant instrumentation is already in place, so this one gets to come out and play. no cap. 💀

what it does: it changes the inherited environment variable ARCAN_FRAMESERVER_DEBUGSTALL=time, where time is >= 0 — and yes, 0 clears it. that variable is the thing controlling how long newly spawned frameservers should delay before continuing execution.

why would anyone want that? because it gives the developer a safe spot to attach to the process, so they can set breakpoints or control stepping. literally that's the whole point. it's giving "hold still for a sec so I can look at you" energy. 🔥

heads up: if you're on a non-debug build, this function just isn't there. don't come for me about it, that's just how it is. 🙈

---

🎀 EXAMPLE 🎀

function frameserver_debugstall0()
      if (frameserver_debugstall) then
            frameserver_debugstall(10);
            launch_avfeed();
      end
end

see how it checks if (frameserver_debugstall) first? that's the guard so you don't blow up on builds where it doesn't exist. very mindful, very demure. then it stalls for 10, then launches the avfeed. slay. ⭐

---

🌈 SEE ALSO 🌈

• system

---

and that's the whole page, bestie! this lil masterpiece comes to you from the Arcan Lua API, dated October 2026 — go forth and debug responsibly, mwah 💜💅