Dependencies

2 min readUpdated 2 weeks ago

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 applying a skin is blocked with an 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.

  • The skin is stored in the weapon's item metadata and survives relog, drop and transfer. Inventories without item metadata block skin application to prevent losing the skin.
  • Inventories without metadata: Applying a custom skin is blocked with an 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

Inventories without metadata block custom skin application. Only inventories with metadata support can 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.