Docs/ORB WeaponSkins/Overview

ORB WeaponSkins

Animated video weapon skins for FiveM. A video plays directly on the weapon — the body, the magazine, the stock, the scope — turning any gun into a living, moving skin.

Admins curate a library of skins from any YouTube link or direct video URL. Players open one menu, pick a skin, and it lands on whatever weapon they are holding.

Key Features

  • Any video — paste a YouTube link or a direct .mp4 / .webm. Nothing to install on the server, nothing to host.
  • Admin curated library — you publish the skins, players choose from them. Players cannot create or import their own.
  • Applies to the weapon in hand — no weapon list to scroll, no menus to dig through.
  • Full weapon coverage — body, magazines, stocks, scopes, grips and suppressors, not just the frame.
  • Five presets included — ready to publish on first boot.
  • Multi-framework — auto-detects QBox, QBCore, ESX or runs standalone.
  • EN / ES / DE — every string localized, with full parity and easy extensibility.
  • Server authoritative — every action is re-checked server side, and hidden skins are never sent to a player's client.

How it works

The video is rendered into a live texture and swapped onto the weapon's own texture dictionary. It is a real video surface, not a pre-baked animation, so anything that plays in a browser can become a skin.

Because it is one shared surface reused across weapons, changing the video does not rebuild anything: there is a single render target for the whole resource, no matter how many players are using it.