Skip to content

MrNewb/MrNewbWeaponTints

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MrNewbWeaponTints

See my docs at https://mrnewbs-scrips.gitbook.io/guide

Professional FiveM Weapon Customization System - Advanced weapon tints and serial number management for enhanced roleplay servers.

GitHub Stars License Ox Inventory Framework

Discord Ko-fi Documentation


Overview

MrNewbWeaponTints provides a comprehensive weapon customization system for FiveM servers, featuring:

  • 7 Unique Weapon Tints - Green, Gold, Pink, Army, LSPD, Orange, and Platinum finishes
  • Serial Number Removal - Heavy File item for weapon anonymization
  • MK2 Weapon Support - Automatic detection and appropriate tint mapping
  • Ox Inventory Integration - Seamless item-based weapon customization
  • Multi-Framework Compatible - Works with ESX, QBCore, and Qbox
  • Community Bridge Support - Enhanced localization and notification system

Key Features

Weapon Tint System
  • 7 Professional Tint Options with unique visual styles
  • Automatic MK2 Detection for proper tint application
  • Item-Based Application through Ox Inventory integration
  • Server Monetization Ready - Enhance gameplay while generating revenue
  • Visual Enhancement for improved weapon aesthetics
Serial Number Management
  • Heavy File Item for removing weapon serial numbers
  • Enhanced Roleplay opportunities for criminal activities
  • Ox Inventory Integration with proper item consumption

Installation Guide

Step-by-Step Installation

1. Add Items to Ox Inventory

Add the following items to your ox_inventory/data/items.lua file:

['newbserialfile'] = { 
	label = 'Heavy File',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.newbserialfile'
	},
	consume = 0.50
},

['greentint'] = { 
	label = 'Green Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 1
	}
},

['goldtint'] = { 
	label = 'Gold Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 2
	}
},

['pinktint'] = { 
	label = 'Pink Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 3
	}
},

['armytint'] = { 
	label = 'Army Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 4
	}
},

['lspdtint'] = { 
	label = 'LSPD Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 5
	}
},

['orangetint'] = { 
	label = 'Orange Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 6
	}
},

['platinumtint'] = { 
	label = 'Platinum Weapon Tint',
	stack = false,
	close = true,
	allowArmed = true,
	weight = 10,
	server = {
		export = 'MrNewbWeaponTints.setweapontint',
		tint = 7
	}
},

2. Resource Installation

  1. Follow the guide here https://mrnewbs-scrips.gitbook.io/guide to install the resource.
  2. Ensure all dependencies are installed and configured correctly.

Dependencies

This resource requires the following dependencies:

  • Ox Inventory - For inventory management and weapon handling
  • Community Bridge - For locales and notifications (replaces the old ox_lib dependency)
  • Framework - ESX, QBCore, or Qbox (auto-detected)

Important Notes

  • Free Resource - This script is provided completely free of charge
  • No Reselling - Please respect the collaborative spirit and do not sell this resource
  • Community First - Built for the FiveM community with love and dedication
  • Regular Updates - Continuous improvements and feature additions

Requirements

  • Community Bridge
  • Compatible framework (ESX, QBCore, Qbox/QBX)
  • Ox Inventory

Support & Documentation

Community

Discord

Join our Discord for support, feature requests, and community feedback.


Special Thanks

Special appreciation to Decay Studios for creating the inventory icons used in this release.

[Decay Studios


About

Weapon Tints for ox_inventory

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages