vr_map_limb(3)

💅 vr_map_limb — the Arcan Lua API glow-up 🎀

okay bestie, welcome to the Arcan Lua API page for vr_map_limb, and no, you're not dreaming — this is the function that makes a 3D model actually become your VR limb. main character energy fr fr.

---

✨ NAME ✨

vr_map_limb — creates a binding between a 3d object and a vrbridge limb 🦋

---

🌸 SYNOPSIS 🌸

nil
vr_map_limb( vid:bridge, vid:model, int:limbid )
vr_map_limb( .B )
vr_map_limb( vid:bridge, vid:model, int:limbid, bool:position,
bool:orientation )

yeah she has several forms, she contains multitudes 💅

---

🔥 DESCRIPTION 🔥

okay so this function binds the position and orientation of a 3D model to the state of a limb that comes from vrbridge. literally gluing them together.

what that means in practice: every single time a new frame is about to be produced, the model's properties get sampled straight from the associated limb. no middleman, no detour, just vibes piped directly 💖

and why do it this way? because lowkey the many underlying sensor techniques have quite high samplerates, and they are not suitable for processing inside a scripting VM / garbage collected context 😭. direct sampling keeps latency and sampling overhead way down. it's giving efficient. it's giving iconic.

if you use the form with the position and orientation arguments (default: true on both ✨), then only the fields you set to true will actually be applied from the limb — the other attributes get derived/inherited as normal, like they always do 🫶

---

👑 NOTES 👑

1. 🚨 the targeted model will not behave like a normal object while it's mapped — specifically when it comes to transformation chains and other positional/rotational properties. meaning operations like forward3d_model will produce undefined results. i'm not saying don't, i'm just saying... be aware bestie 💀

---

🌈 SEE ALSO 🌈

iodev

---

---

⭐ that's the whole page, bestie! this one came to you from the source iodev, dated October 2026, and it's page vr_map_limb(3) — go forth and bind responsibly 💜🧚🌸