Admin Tools

Admin commands for testing and managing the Oxide 3D Weapon Printing system including kit commands, blueprint distribution, and progression management.

Commands Overview

CommandDescriptionPermission
/printer_kitGive yourself filament and a pistol blueprint USBcommand ACE
/bench_kitGive yourself a weapon benchcommand ACE
/table_kitGive yourself 3 placeable tablescommand ACE
/upgrade_kitGive yourself all printer upgrade itemscommand ACE
/give_parts [name]Give yourself all parts for a weapon recipecommand ACE
/givewepblueprint [id] [name] [amount]Give a blueprint USB to a playercommand ACE
/wp_setlevel [level]Set your weapon printing levelcommand ACE
/wp_setxp [amount]Set your weapon printing XPcommand ACE
/wp_infoShow your weapon printing progressioncommand ACE
/wp_testkitGive yourself items matching your current levelcommand 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.

Usage:

/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.

Usage:

/bench_kit

Items Given:

  • 1x Weapon Bench

/table_kit

Adds placeable tables to your inventory.

Usage:

/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.

Usage:

/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.

Usage:

/give_parts [name]

Parameters:

ParameterTypeRequiredDescription
namestringYesAssembly 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.

Usage:

/givewepblueprint [id] [name] [amount]

Parameters:

ParameterTypeRequiredDescription
idnumberYesTarget player's server ID
namestringYesBlueprint key (e.g., pistol, smg, sniper_rifle)
amountnumberNoNumber 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

Output:

  • 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:

ParameterTypeRequiredDescription
levelnumberYesTarget 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:

ParameterTypeRequiredDescription
amountnumberYesXP 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_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.

Usage:

/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

Output:

  • Success: "Level [X] test kit: 20 filament, [count] USBs, all craftable parts"

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 in QBCore
-- typically have 'command' ACE permission already configured

ESX:

-- Add to your ACE permissions config for admin groups
-- ESX admin groups should already have 'command' ACE permission

If your admin system does not grant the command ACE permission, you can add it specifically:

add_ace group.admin command allow
add_ace group.superadmin command allow

Next Steps