Features

3D Printing

The 3D printer is the core manufacturing station. Players place a printer in the world, load blueprint USBs, feed it filament, and print individual weapon parts over time. Each printer persists across server restarts and tracks its own upgrade state and loaded blueprints.

Printing Process

1. Use a 3D Printer item from your inventory to enter placement mode
2. Position the ghost prop and confirm placement
3. Interact with the placed printer via ox_target
4. Load a Printer USB containing a weapon blueprint
5. Select a part from the blueprint to print
6. The printer consumes filament and begins printing with a real-time countdown
7. Collect the finished part when the print completes

Print Parameters

Each part in a blueprint has two key parameters:

• Filament Cost — How many filament items are consumed (1–5 per part depending on weapon tier)
• Print Time — Base duration in seconds (600s–3600s depending on weapon tier), reduced by nozzle upgrades

DUI Status Screen

The printer displays a live DUI screen showing:

• Currently loaded blueprint name
• Active print progress with countdown timer
• Printer status (idle, printing, complete)

USB Malfunction

When loading a USB into a printer, there is a chance the USB fails and is destroyed. The base malfunction chance is 25%, reduced by:

• Player level — Each level reduces the chance by 1.5%
• Cooling Fan upgrades — Mk I: -10%, Mk II: -20%, Mk III: -30%
• Minimum chance is 5% regardless of level and upgrades

Blueprint Storage

Printers have an internal storage drive that holds loaded blueprints. The base capacity is 1 slot, upgradeable to 8 with Storage Drive upgrades. Multiple blueprints can be stored simultaneously, and you can switch between them without needing to reload USBs.

---

Blueprints

Blueprints define which parts can be printed for each weapon. Each blueprint is stored on a Printer USB item with metadata identifying the weapon. Blueprints are organized by weapon category and gated behind progression levels.

Weapon Categories

Category	Weapons	Level Range
Pistols (Basic)	SNS Pistol, Vintage Pistol, Flare Gun, Pistol, SNS Mk II, Ceramic Pistol, Double-Action Revolver, Marksman Pistol, Machine Pistol	1
SMGs	Micro SMG, Mini SMG, SMG, SMG Mk II, Combat PDW, Assault SMG	2
Shotguns (Basic)	Pump Shotgun, Sawed-Off Shotgun, Double Barrel Shotgun, Sweeper Shotgun	2
Pistols (Advanced)	Combat Pistol, AP Pistol, Pistol Mk II, Heavy Pistol	3
Rifles (Standard)	Assault Rifle, Carbine Rifle, Special Carbine, Compact Rifle, Bullpup Rifle	4
Shotguns (Advanced)	Pump Shotgun Mk II, Bullpup Shotgun, Assault Shotgun	4
Rifles (Military)	Assault Rifle Mk II, Carbine Mk II, Special Carbine Mk II, Bullpup Mk II, Advanced Rifle, Military Rifle, Heavy Rifle	5
Shotguns (Heavy)	Heavy Shotgun	5
Pistols (Heavy)	Pistol .50, Heavy Revolver, Heavy Revolver Mk II, Navy Revolver	6
Snipers	Sniper Rifle, Marksman Rifle, Marksman Rifle Mk II	7
Machine Guns	MG, Combat MG, Combat MG Mk II	8
Snipers (Heavy)	Heavy Sniper, Heavy Sniper Mk II	8
Exotic	Perico Pistol	9

Part Types

Parts vary by weapon category. Common part types include:

Part	Used By
Pistol Slide	Pistols
Pistol Grip	Pistols
Pistol Magazine	Pistols
Compact Frame	Ceramic Pistol, Perico Pistol
Revolver Frame	Revolvers
Revolver Receiver	Revolvers
Trigger Group	Various (revolvers, shotguns, rifles, SMGs)
SMG Receiver	SMGs
SMG Barrel	SMGs
SMG Magazine	SMGs
Compact Barrel	Mini SMG, Machine Pistol, Compact Rifle
Folding Stock	Assault SMG
Rifle Upper	Rifles, Machine Guns
Rifle Lower	Rifles, Machine Guns
Rifle Barrel	Rifles, Machine Guns, Marksman Rifles
Rifle Handguard	Select Rifles
Rifle Magazine	Rifles
Rifle Stock	Rifles, Machine Guns, Marksman Rifles
Bullpup Chassis	Bullpup Rifle, Bullpup Shotgun
Shotgun Receiver	Shotguns
Shotgun Barrel	Shotguns
Shotgun Stock	Shotguns
Pump Handle	Pump Shotguns
Double Barrel Set	Sawed-Off, Double Barrel Shotgun
Sniper Receiver	Sniper Rifles
Sniper Barrel	Sniper Rifles
Sniper Magazine	Select Snipers, Marksman Rifles
Sniper Stock	Sniper Rifles
Long Scope	Heavy Snipers, Marksman Rifle Mk II
Drum Magazine	Machine Guns

---

Printer Upgrades

Each 3D printer can be upgraded independently with five upgrade categories. Upgrades are installed by having the upgrade item in your inventory and using the upgrade interface while interacting with the printer.

Nozzle

Reduces print time by increasing extrusion speed.

Tier	Item	Speed Multiplier	PSU Required	Level Required
0 (Stock)	—	1.0x	—	—
Mk I	printer_nozzle_mk1	0.85x (15% faster)	None	1
Mk II	printer_nozzle_mk2	0.7x (30% faster)	PSU Mk I	3
Mk III	printer_nozzle_mk3	0.55x (45% faster)	PSU Mk II	6

Storage Drive

Increases the number of blueprints a printer can hold simultaneously.

Tier	Item	Blueprint Slots	PSU Required	Level Required
0 (Stock)	—	1	—	—
Mk I	printer_storage_mk1	3	None	1
Mk II	printer_storage_mk2	5	PSU Mk I	3
Mk III	printer_storage_mk3	8	PSU Mk II	6

Cooling Fan

Reduces the chance of USB malfunction when loading blueprints.

Tier	Item	Malfunction Reduction	PSU Required	Level Required
0 (Stock)	—	0%	—	—
Mk I	printer_cooling_mk1	-10%	None	1
Mk II	printer_cooling_mk2	-20%	None	3
Mk III	printer_cooling_mk3	-30%	PSU Mk I	6

Build Plate

Increases the quality bonus applied to printed parts and assembled weapons.

Tier	Item	Quality Bonus	PSU Required	Level Required
0 (Stock)	—	+0%	—	—
Mk I	printer_buildplate_mk1	+3%	None	2
Mk II	printer_buildplate_mk2	+6%	PSU Mk I	4
Mk III	printer_buildplate_mk3	+10%	PSU Mk II	7

Power Supply (PSU)

Required to support higher-tier upgrades. The PSU has no direct gameplay effect but gates other upgrades.

Tier	Item	Level Required
Mk I	printer_psu_mk1	2
Mk II	printer_psu_mk2	5

PSU Dependency Chain

Higher-tier upgrades require a sufficient PSU installed first. Without the required PSU, the upgrade will fail with an error message. Plan your upgrade path:

1. Install PSU Mk I (level 2) to unlock Mk II upgrades for Nozzle, Storage, and Build Plate, and Mk III for Cooling
2. Install PSU Mk II (level 5) to unlock Mk III upgrades for Nozzle, Storage, and Build Plate

---

Weapon Assembly

The weapon bench is where printed parts are combined into finished weapons. Each weapon has a defined recipe specifying which parts and quantities are needed.

Assembly Process

1. Use a Weapon Bench item from inventory to enter placement mode
2. Place the bench and interact via ox_target
3. Select a weapon recipe from the assembly menu
4. The bench verifies you have all required parts in your inventory
5. Parts are consumed and a crafting animation plays
6. The finished weapon is added to your inventory with quality metadata

Assembly Recipes

Weapons require different combinations of printed parts. Examples:

Weapon	Parts Required	Craft Time
SNS Pistol	Slide + Grip + Magazine	20s
Pistol	Slide + Grip + Magazine	30s
AP Pistol	Slide + Grip + Magazine + Trigger Group	45s
Assault Rifle	Upper + Lower + Barrel + Magazine + Stock	60s
Heavy Sniper	Receiver + Barrel + Magazine + Stock + Long Scope	90s
Combat MG	Upper + Lower + Barrel + Drum Mag + Stock + Trigger Group	90s

Assembly recipes are gated behind the same level requirements as blueprints.

Weapon Preview

During the assembly interface, a 3D model of the selected weapon is displayed on the bench with a configurable offset, giving players a preview of what they are building.

---

Quality System

Assembled weapons receive a quality grade that affects their durability and displayed metadata. Quality is determined by a combination of player level and build plate upgrades.

Quality Grades

Grade	Quality Range	Level Gap
Poor	20–30%	Level matches recipe requirement
Decent	35–45%	1 level above requirement
Standard	50–60%	2 levels above requirement
Quality	65–75%	3 levels above requirement
Superior	80–90%	4+ levels above requirement

The "level gap" is the difference between your current level and the minimum level required for that weapon's assembly recipe. Building weapons well below your level produces higher quality results.

Experience Bonuses

Accumulated prints and assemblies grant progressive bonuses:

Metric	Threshold	Bonus
Total prints	Every 50 prints	+2% quality per milestone
Total assemblies	Every 25 assemblies	+3% quality per milestone
Maximum bonus	—	+20% (capped)

Bad Luck Protection

There is a 10% chance for a "bad luck" event during weapon assembly, which reduces the assembled weapon's quality by 15 percentage points (minimum 5%). Both the chance and penalty are configurable.

---

Weapon Durability

All 3D-printed weapons have a durability system. Weapons degrade with use and eventually break.

Degradation

Each shot fired reduces durability by 0.15% (configurable via Config.Durability.degradePerShot). At 0% durability, the weapon is destroyed and removed from inventory if Config.Durability.breakAtZero is enabled.

Weapon Jams

As durability decreases, the chance of a weapon jam increases:

Durability Range	Jam Chance
80–100%	0%
60–80%	2%
40–60%	5%
20–40%	10%
0–20%	20%

When a jam occurs, the player must perform an unjam animation lasting 3 seconds before the weapon can fire again.

Durability Display

The weapon's inventory tooltip shows the current durability and quality grade via a display metadata table:

3D Printed - Quality (72%) | Durability: 85%

---

Progression

The progression system tracks player XP and level, gating access to weapons, upgrades, and assembly recipes.

Levels and XP

Level	XP Required	Cumulative XP	Unlocks
1	0	0	Basic Pistols & Placement
2	200	200	SMGs & Shotguns
3	600	600	Mk II Upgrades
4	1,400	1,400	Standard Rifles
5	2,800	2,800	Military Weapons
6	5,000	5,000	Mk III Upgrades
7	8,500	8,500	Sniper Rifles
8	14,000	14,000	Heavy Weapons & MGs
9	22,000	22,000	Exotic Weapons
10	35,000	35,000	Master Printer

XP Rewards

Action	XP Earned
Loading a USB into a printer	5
Completing a part print	15
Assembling a weapon	30

Metadata Storage

Progression data is stored in player metadata under the weaponprinting key via community_bridge. The data includes:

• level — Current level
• xp — Current XP total
• totalPrints — Lifetime print count
• totalAssembled — Lifetime assembly count

---

Placeable Equipment

3D Printer

• Item: 3d_printer
• Model: Custom prop_3d_printer
• Max per player: 3 (configurable)
• Interaction: ox_target with 1.5m distance
• Persistence: Saved to database with coordinates, rotation, routing bucket, owner, name, and metadata

Weapon Bench

• Item: weapon_bench
• Model: gr_prop_gr_bench_04b
• Max per player: 2 (configurable)
• Interaction: ox_target with 1.5m distance
• Persistence: Saved to database with coordinates, rotation, routing bucket, owner, name, and metadata

Placeable Table

• Item: placeable_table
• Model: bkr_prop_weed_table_01b
• Max per player: 5 (configurable)
• Interaction: None (decoration/organization only)
• Persistence: Saved to database with coordinates, rotation, routing bucket, and owner

Ownership

When Config.RequireOwnership is true (default), only the player who placed a piece of equipment can pick it up. Equipment is returned to inventory on pickup.

---

Ghost Gunner's Handbook

The Ghost Gunner's Handbook (printer_manual) is a usable in-game guide item that opens an interactive book-style NUI. It provides players with a complete reference for the weapon printing system without needing to check external documentation.

Contents

The handbook is organized into 8 two-page spreads (16 pages total):

Spread	Left Page	Right Page
1	Cover / Welcome	Getting Started
2	Blueprint USBs	Loading & Storage
3	Printing Parts	Print Tips
4	Printer Upgrades	Upgrade Tiers
5	Weapon Assembly	Assembly Tips
6	Quality & Durability	Jam Mechanics
7	Progression & XP	Level Chart
8	Pro Tips	Back Cover

Usage

• Use the printer_manual item from your inventory to open the handbook
• Navigate between pages using A (previous) and D (next) keys
• Press ESC to close
• Item images for all parts, upgrades, and equipment are displayed inline

---

Floating Labels

Printers and benches display floating 3D labels above them showing status information. Labels are toggled with a configurable key (default: J / key code 74).

Setting	Default	Description
Toggle Key	J (74)	Key to toggle label visibility
Max Distance	5.0m	Maximum distance to see labels
Height Offset	1.2m	Height above equipment
Data Refresh	2000ms	How often label data refreshes

---

Safe Zones

Safe zones are configurable polygon areas where equipment placement is blocked. Define zones in Config.SafeZones as arrays of 2D points. Any attempt to place a printer, bench, or table inside a safe zone is rejected server-side.

Config.SafeZones = {
    {
        points = {
            vec2(x1, y1),
            vec2(x2, y2),
            vec2(x3, y3),
            vec2(x4, y4),
        },
    },
}