Installation & Configuration

First, you need to install the scripts required for Qubit 3D Printer to work. After installing these scripts, you can put qubit-3dprinter into your resources folder and run it.

• oxmysql / mysql-async

• xsound - Download here

• ox_lib - Download Here

• ox_target - Download Here

• bzZzi 3D Prop - Download Here

• Gizmo Object ( Optional ) - Download Here

1. Framework Configration

Qubit Vehicle Crafting supports ESX and QB frameworks. If you're using a different framework, unfortunately you won't be able to run Qubit Car Crafting.

Open the config.lua and fxmanifest.lua change framework setttings for your needs

QBCore Settings

If you're using the qbcore framework, you should configure the framework settings in the config as follows

Open config.lua and change these lines

Config.Framework = "QB" -- QB, oldESX, ESX
Config.CoreName = 'qb-core' -- qb-core, es_extended

ESX Settings

If you're using the qbcore framework, you should configure the framework settings in the config as follows

Open config.lua and change these lines

Config.Framework = "ESX" -- QB, oldESX, ESX
Config.CoreName = 'es_extended' -- qb-core, es_extended

3. Sound Setup

To set up the sound system, you need to have either the xSound or mx-surround script. Place the file below in the required location according to the structure of the script you are using, and follow the installation steps.

1MB

printersound.ogg

xSound Settings

If you're using the xsound, you should configure the sound settings in the config as follows

Move .ogg file to xsound/html/sounds/printersound.ogg

Open config.lua and change these lines

```lua
Config.SoundSystem = "xSound"
Config.SoundFileDirectory = "./sounds/printersound.ogg"
Config.VolumeSettings = 0.15
```

Mx Surrounding Settings

If you're using the mx-surround, you should configure the sound settings in the config as follows.

Move .ogg file to mx-surround/ui/sounds/printersound.ogg

Open config.lua and change these lines

```lua
Config.SoundSystem = "mx-surround"
Config.SoundFileDirectory = "/ui/sounds/printersound.ogg"
Config.VolumeSettings = 0.15
```

4. Defining Items

You can produce any item with a 3D Printer. All you need to do is add the item you want to produce to Config.PrintItems

Here is example 3D Print item definition

["weapon_pistol"] = { -- Item Name
    title = "9mm Pistol", -- Menu Name
    description = "Start process of 3D object", -- Menu Description
    visual_value = "w_pi_pistol", -- Object Name
    visual_value_type = "object",  -- "object" or "image"  (IT'S UNDER DEVELOPMENT, USE ONLY "OBJECT"),
    printingTime = 120, -- Printing Seconds
    batteryConsumeRate = 1.0, -- This value determines how much resources will be consumed in 5 seconds.
    resinConsumeRate = 1.0, -- This value determines how much resources will be consumed in 5 seconds.
},

5. Importing Items

To use the Qubit 3D Printer, you need to integrate the printer, battery, and resin items into your framework. Follow these steps to add the items

If you are using QBCore or OX, you don't need to import the SQL.

QBCore Item Configration

Go to the qb-core folder, open qb-core/shared/items.lua, and add the crafting items line at the bottom

['3d_printer'] 					 = {['name'] = '3d_printer', 			 	  	  	['label'] = '3D FX Printer', 	['weight'] = 0, 		['type'] = 'item', 		['image'] = '3d_printer.png', 				['unique'] = true, 	['useable'] = true, 	['shouldClose'] = true,   ['combinable'] = nil,   ['description'] = '3D Metal object printer.'},
['3d_resin'] 					 = {['name'] = '3d_resin', 			 	  	  	['label'] = '3D Printer Resin Mix', 	['weight'] = 0, 		['type'] = 'item', 		['image'] = '3d_resin.png', 				['unique'] = true, 	['useable'] = true, 	['shouldClose'] = true,   ['combinable'] = nil,   ['description'] = '3D FX Printer Resin.'},
['3d_battery'] 					 = {['name'] = '3d_battery', 			 	  	  	['label'] = '3D Printer Battery', 	['weight'] = 0, 		['type'] = 'item', 		['image'] = '3d_battery.png', 				['unique'] = true, 	['useable'] = true, 	['shouldClose'] = true,   ['combinable'] = nil,   ['description'] = '3D FX Printer Battery.'},

ESX Item Configration

Open your database and import these SQL lines for inventory.

INSERT INTO `items`(`name`, `label`, `weight`, `rare`, `can_remove`) VALUES ('3d_printer','3D FX Printer','1','1','1');
INSERT INTO `items`(`name`, `label`, `weight`, `rare`, `can_remove`) VALUES ('3d_resin','3D Printer Resin Mix','1','1','1');
INSERT INTO `items`(`name`, `label`, `weight`, `rare`, `can_remove`) VALUES ('3d_battery','3D Printer Battery','1','1','1');

OX Item Configration

Go to ox_inventory/data/items.lua and copy & paste these items in bottom

	["3d_printer"] = {
		label = "3D FX Printer",
		weight = 1,
		stack = true,
		close = true,
	},

	["3d_resin"] = {
		label = "3D Printer Resin Mix",
		weight = 1,
		stack = true,
		close = true,
	},
	
	["3d_battery"] = {
		label = "3D Printer Battery",
		weight = 1,
		stack = true,
		close = true,
	},

6. Setup Database

To run qubit-3dprinter you need to import the following SQL file.

870B

qubit_printers.sql

Setup Finished 🎉

After configuring your items, you can start using the 3D Printer. If you encounter any issues during the setup process, please visit our Discord for more comprehensive support.