build_3dbox(3)

🎀 build_3dbox(3) — the Arcan Lua API one 💅

okay so bestie, gather round, because this is the glow-up page for build_3dbox from the Arcan Lua API and honestly? it's giving cube. it's giving geometry. it's giving "why is my skybox suddenly a box" (iykyk). let's get into it ✨

---

🌈 SYNOPSIS

vid
build_3dbox( float:width, float:height, float:depth )
build_3dbox( .B )
build_3dbox( float:width, float:height, float:depth, int:nmaps )
build_3dbox( .B )
build_3dbox( float:width, float:height, float:depth, int:nmaps,
bool:split )

like, pick your fighter fr fr 👑 — you can go bare-bones with just dimensions, or serve the extra nmaps, or go full main-character with split too 🦋

---

✨ DESCRIPTION ✨

so what does it do? this bad boy builds a mesh and binds it to a new 3d model that is then finalized 💖 periodt. that's the whole vibe.

the classic uses, ngl? skyboxes and debug geometry — the two icons of "i need a thing to exist in 3D space right now" 🌸

here's the part you actually need to memorize, bestie, because the numbers matter:

• the mesh values will range from -(width/2)..+(width/2) 🌈
• ...and -(height/2)..+(height/2) 🎀
• ...and -(depth/2)..+(depth/2) 🦋

so it's centered, okay? it's not off doing its own thing at the origin corner, it's centered. iconic behaviour honestly 💅

optionally — like, if you feel like it, no pressure 🫶 — the model will have nmaps texturing slots allocated to it.

and then there's the split argument: if you provide it and set it to true, the model gets split into one submesh for each side, with each submesh consuming nmaps textures. it's giving "six little besties, each with their own outfits" 💀✨

---

💜 NOTES

1. ⚠️ if the split option is set, the number of actual textures needed in the frameset defined on the output vid should be nmaps multiplied by 6 — because each face will consume nmaps textures. yes, six faces. yes, that's a lot of textures. no, you cannot skip this math, bestie, i'm sorry 😭

real talk: that ×6 is the classic gotcha. six sides, nmaps each, and the frameset on your output vid has to have room for all of them or you're gonna have a bad time 🙈

---

👀 SEE ALSO:

• build_3dplane(3) — the flat friend, for when a whole cube is simply too much 🎀

---

and that's the page!! 💖 written under the 3d section, dated October 2026 — stay cubey, bestie, and remember: build_3dbox(3), six faces, nmaps × 6 textures, no cap 🌈👑💅