Dependencies

2 min readUpdated Aug 18, 2026

Required

  • ml_bridge: Framework and inventory abstraction. All player, item, money, and metadata calls go through it.
  • ox_lib: Callbacks, commands, cache, and rate-limit helpers.
  • oxmysql: Database layer. The 9 tables are created on first start.
Metadata Inventory Required for Custom Skins

Custom skins are stored in weapon item metadata. The active inventory must support metadata, checked at runtime via Bridge.SupportsMetadata(). On an inventory without metadata the apply is refused with a clear error.

Framework

server.cfg
1ensure qb-core
2ensure oxmysql
3ensure ox_lib
4ensure ml_bridge
5ensure ml_weaponskins
server.cfg
1ensure qbx_core
2ensure oxmysql
3ensure ox_lib
4ensure ml_bridge
5ensure ml_weaponskins
server.cfg
1ensure es_extended
2ensure oxmysql
3ensure ox_lib
4ensure ml_bridge
5ensure ml_weaponskins
server.cfg
1ensure oxmysql
2ensure ox_lib
3ensure ml_bridge
4ensure ml_weaponskins
Auto Detection

ml_bridge detects your framework automatically. No manual setup.

Inventory Support

Skins live in weapon item metadata, so inventory metadata support determines what works.

  • Any inventory that stores item data works: the skin lives in the weapon's own metadata, so it survives relog, drop and transfer. On an inventory without item metadata the apply is refused cleanly instead of silently losing the skin.
  • Graceful degradation: Inventories without metadata are detected; applying a skin is blocked with a clean error. The customizer still opens and native tints/camos still work, but custom skins cannot be saved to an item.
Custom Skins Require a Metadata Inventory

Non-metadata inventories degrade to apply-blocked. Only metadata-capable inventories store custom skins.

Optional

Cross-Player Custom Skin Sync

  • ml_weaponskins_stream: GTA V slot models (ydr/ytd) that make custom-painted skins visible to nearby players in overlay mode. ~1.3 GB on disk, shipped as a separate resource.

- Required only when Config.Custom.syncMode = 'overlay' (default).

- Without it, set Config.Custom.syncMode = 'local'; custom skins render owner-only.

- Native tints and MK2 camos are synced for everyone regardless, they use GTA's variant system, not this stream.

server.cfg
1ensure ml_weaponskins
2ensure ml_weaponskins_stream

Image Hosting

  • FiveManage / fmsdk: Optional image host for URL/draw layers. Not a code dependency. Only relevant if you point image layers at FiveManage URLs; the FiveManage hosts are already in Config.AllowedImageHosts. Any allowed https host works (imgur, Discord CDN, ibb, etc.).

Tebex Delivery

  • ml_tebex: Required only if Config.Payment.source uses Tebex donation credits or you sell Config.SkinPacks. Packages register automatically and deliver through the OnTebexPackage / OnTebexRefund exports. Not needed for free, in-game money, or item-currency models.