Blueprint Image Creator

A tool for creating blueprint-style images by overlaying your inventory item images onto a blueprint template. Perfect for crafting recipes that require blueprints.

Dependencies

Dependency	Description
Node.js	JavaScript runtime (v18 or higher recommended)
sharp	Image processing library (installed automatically)

Installation

1. Open a terminal/command prompt

2. Navigate to the tools folder:

   cd resources/[standalone]/sd-crafting/tools

3. Install dependencies:

   npm install

That's it! The tool is ready to use.

Quick Start

Create a blueprint for any item in your inventory:

node create-blueprint.js lockpick

This will:

1. Auto-detect your inventory system (ox_inventory, qb-inventory, etc.)

2. Find the lockpick.png image from your inventory

3. Create blueprint_lockpick.png in the output folder

Usage

Single Blueprint

node create-blueprint.js <item-name> [output-name] [options]

Examples:

# Basic usage - creates blueprint_lockpick.png
node create-blueprint.js lockpick

# Custom output name - creates schematic_thermite.png
node create-blueprint.js thermite schematic_thermite

# Use a different template
node create-blueprint.js armour --bg 2

# Apply a blue tint to the item
node create-blueprint.js pistol --tint #3b82f6

Batch Creation

Create multiple blueprints at once:

node batch-create.js <items-folder> [options]

C:\txData\QboxFramework_14B2CD.base\resources[standalone]\sd-crafting\tools\output\blueprint_armour.pngExamples:

# Create blueprints for all items in a folder
node batch-create.js C:/server/resources/ox_inventory/web/images

# Only process weapon images
node batch-create.js C:/server/resources/ox_inventory/web/images --filter "weapon_"

# Process a specific list of items
node batch-create.js --list lockpick.png thermite.png radio.png

Options

Option	Description	Default
--bg <name>	Select a template from the blueprints folder (e.g., --bg 2)	template
--template <path>	Use a custom template image (full path)	Built-in template
--size <WxH>	Output image dimensions	128x128
--item-scale <0-1>	Size of item relative to template	0.6
--tint <hex>	Apply a color tint to the item (e.g., #3b82f6)	None
--inventory <path>	Override auto-detected inventory images path	Auto-detected
--list-templates	Show available templates	-

Supported Inventories

The tool automatically detects and locates item images from these inventory systems:

• ox_inventory

• qb-inventory

• ps-inventory

• lj-inventory

• qs-inventory / qs-inventory-pro

• codem-inventory

Custom Templates

You can add your own blueprint templates:

1. Create a PNG image (recommended: 128x128 pixels)

2. Save it to the tools/blueprints folder as template_2.png, template_3.png, etc.

3. Use it with --bg 2 or --bg template_2

Output

All generated blueprints are saved to the tools/output folder with the naming format:

• Single: blueprint_<item-name>.png

• Batch: blueprint_<original-filename>.png

Copy these images to your inventory's images folder to use them in-game.

Troubleshooting

"Could not find item image"

• Ensure your inventory resource is in the resources folder

• Use --inventory <path> to manually specify the images folder

"No supported inventory system found"

• The tool searches up to 5 folder levels deep

• Make sure your inventory resource folder name matches exactly (e.g., ox_inventory)

Template not found

• Run node create-blueprint.js --list-templates to see available templates

• Ensure template files are in the tools/blueprints folder

Example Output Template 1

Example Output Template 2