Admin Tools
Admin commands for testing and managing the Oxide 3D Weapon Printing system including kit commands, blueprint distribution, and progression management.
Commands Overview
| Command | Description | Permission |
|---|---|---|
/printer_kit | Give yourself filament and a pistol blueprint USB | command ACE |
/bench_kit | Give yourself a weapon bench | command ACE |
/table_kit | Give yourself 3 placeable tables | command ACE |
/upgrade_kit | Give yourself all printer upgrade items | command ACE |
/give_parts [name] | Give yourself all parts for a weapon recipe | command ACE |
/givewepblueprint [id] [name] [amount] | Give a blueprint USB to a player | command ACE |
/wp_setlevel [level] | Set your weapon printing level | command ACE |
/wp_setxp [amount] | Set your weapon printing XP | command ACE |
/wp_info | Show your weapon printing progression | command ACE |
/wp_testkit | Give yourself items matching your current level | command ACE |
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.
/printer_kit
Items Given:
- 10x Printer Filament
- 1x Printer USB (pistol blueprint)
- 1x The Ghost Gunner's Handbook
/bench_kit
Adds a weapon bench to your inventory.
/bench_kit
Items Given:
- 1x Weapon Bench
/table_kit
Adds placeable tables to your inventory.
/table_kit
Items 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.
/upgrade_kit
Items 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.
/give_parts [name]
| 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 Scope
Output:
- 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 contain the specified weapon blueprint in its metadata.
/givewepblueprint [id] [name] [amount]
| 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 3
/wp_setlevel
Sets your weapon printing progression level directly. XP is set to the minimum required for that level.
/wp_setlevel [level]
| 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)
/wp_setxp
Sets your weapon printing XP to a specific value. Your level is automatically recalculated.
/wp_setxp [amount]
| 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)
/wp_info
Displays your current weapon printing progression in chat.
/wp_info
Output: "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.
/wp_testkit
Items 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
Permissions
All admin commands use FiveM's built-in ACE permission system via IsPlayerAceAllowed(source, 'command'). Any player with the command ACE permission can use these commands.
ACE Permissions
# Grant admin commands to the admin group
add_ace group.admin command allow
# Grant to a specific player (by license)
add_principal identifier.license:abc123 group.admin
Framework Permissions
QBCore: Players with the god or admin permission level typically have command ACE permission already configured.
ESX: Admin groups should already have command ACE permission. If not:
add_ace group.admin command allow
add_ace group.superadmin command allow