Admin Tools
Admin commands for testing and managing the Oxide 3D Weapon Printing system including kit commands, blueprint distribution, and progression management.
Commands Overview
All commands are typed in the in-game chat. They do not work from the server console (the console will print "Cannot use from console") because they give items to the player running them.
| Command | Description | Permission |
|---|---|---|
/printer_kit | Give yourself filament, a pistol blueprint USB, and the handbook | Admin |
/bench_kit | Give yourself a weapon bench | Admin |
/table_kit | Give yourself 3 placeable tables | Admin |
/upgrade_kit | Give yourself all printer upgrade items | Admin |
/give_parts [name] | Give yourself all parts for a weapon recipe | Admin |
/givewepblueprint [id] [name] [amount] | Give a blueprint USB to a player | Admin |
/wp_setlevel [level] | Set your weapon printing level | Admin |
/wp_setxp [amount] | Set your weapon printing XP | Admin |
/wp_info | Show your weapon printing progression | Admin |
/wp_testkit | Give yourself items matching your current level | Admin |
Command Details
/printer_kit
Adds a basic printing starter kit to your inventory: 10 filament, 1 pistol blueprint USB, and 1 Ghost Gunner's Handbook.
Usage:
/printer_kitItems Given:
- 10x Printer Filament
- 1x Printer USB (pistol blueprint)
- 1x The Ghost Gunner's Handbook
/bench_kit
Adds a weapon bench to your inventory.
Usage:
/bench_kitItems Given:
- 1x Weapon Bench
/table_kit
Adds placeable tables to your inventory.
Usage:
/table_kitItems Given:
- 3x Placeable Table
/upgrade_kit
Adds one of every printer upgrade item to your inventory — all nozzle, storage, cooling, build plate, and PSU tiers.
Usage:
/upgrade_kitItems Given:
- 1x Nozzle Mk I, Mk II, Mk III
- 1x Storage Drive Mk I, Mk II, Mk III
- 1x Cooling Fan Mk I, Mk II, Mk III
- 1x Build Plate Mk I, Mk II, Mk III
- 1x Power Supply Mk I, Mk II
/give_parts
Gives yourself all the printed parts required to assemble a specific weapon on the weapon bench.
Usage:
/give_parts [name]Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Assembly recipe key (e.g., pistol, ap_pistol, assault_rifle) |
Examples:
/give_parts pistol -- Gives: Pistol Slide, Pistol Grip, Magazine
/give_parts assault_rifle -- Gives: Rifle Upper, Lower, Barrel, Magazine, Stock
/give_parts heavy_sniper -- Gives: Sniper Receiver, Barrel, Magazine, Stock, Long ScopeOutput:
- Success: "Gave parts for [weapon name]"
- Missing name: Lists all available recipe keys
- Invalid name: "Recipe [name] not found"
/givewepblueprint
Gives a blueprint USB to a specific player by server ID. The USB will carry the specified blueprint. This works with both weapon blueprint keys (Config.Blueprints) and item print keys (Config.ItemPrints, such as lockpick).
Usage:
/givewepblueprint [id] [name] [amount]Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | number | Yes | Target player's server ID |
| name | string | Yes | Blueprint key (e.g., pistol, smg, sniper_rifle) |
| amount | number | No | Number of USBs to give (default: 1) |
Examples:
/givewepblueprint 1 pistol -- Give 1 pistol USB to player 1
/givewepblueprint 3 assault_rifle 5 -- Give 5 assault rifle USBs to player 3Output:
- Success: "Gave [amount]x [label] USB to player [id]"
- Target also receives: "Received [amount]x [label] blueprint"
- Missing name: Lists all available blueprint keys
- Invalid player: "Player [id] not found"
/wp_setlevel
Sets your weapon printing progression level directly. XP is set to the minimum required for that level.
Usage:
/wp_setlevel [level]Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| level | number | Yes | Target level (1-10) |
Examples:
/wp_setlevel 1 -- Reset to level 1 (0 XP)
/wp_setlevel 5 -- Set to level 5 (2800 XP)
/wp_setlevel 10 -- Set to level 10 (35000 XP)Output:
- Success: "Level set to [level] (XP: [xp])"
- Invalid level: "Usage: /wp_setlevel [1-10]"
/wp_setxp
Sets your weapon printing XP to a specific value. Your level is automatically recalculated.
Usage:
/wp_setxp [amount]Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | number | Yes | XP amount to set |
Examples:
/wp_setxp 0 -- Reset XP to 0 (level 1)
/wp_setxp 5000 -- Set to 5000 XP (level 6)
/wp_setxp 35000 -- Set to 35000 XP (level 10)Output:
- Success: "XP set to [amount] (Level [level])"
- Missing amount: "Usage: /wp_setxp [amount]"
/wp_info
Displays your current weapon printing progression in chat.
Usage:
/wp_infoOutput:
- "Level [X] | XP [current]/[next] | Prints: [count] | Assembled: [count]"
/wp_testkit
Gives yourself a comprehensive test kit tailored to your current level. Includes filament, all blueprint USBs you have access to, and all parts for weapons you can assemble.
Usage:
/wp_testkitItems Given:
- 20x Printer Filament
- 1x USB for each blueprint at or below your level
- All parts for each weapon recipe at or below your level
Output:
- Success: "Level [X] test kit: 20 filament, [count] USBs, all craftable parts"
Permissions
All admin commands are restricted to admins and must be run in-game (they do not work from the server console). The check goes through o-link, so it follows whatever admin setup your framework already uses. A player who is not an admin gets an on-screen error notification ("No permission").
If you're already running QBCore, QBX, or ESX with admins set up, those admins pass automatically — no extra setup is needed.
To make someone an admin, add them to the admin group and grant that group the admin ace in your server.cfg:
add_principal identifier.license:<their-license> group.admin
add_ace group.admin admin allowReplace <their-license> with the player's license identifier.
Next Steps
Features
Complete overview of all Oxide 3D Weapon Printing features including printing, blueprints, upgrades, assembly, quality, durability, and progression.
API Reference
Internal callbacks and events for the Oxide 3D Weapon Printing system, plus integration guidance for reading progression data from other resources.