Browse docs

Image Creator

Create transparent FiveM images through a searchable menu, quick commands, batch generation, and automatic CDN, Discord, or local exports.

Overview

Image Creator generates clean, transparent PNG images of GTA V models directly in FiveM. Use the visual menu to search and preview models, create a single image with a command, or process an entire catalog category as a batch.

The included catalog supports:

Vehicles
Weapons
Props
Peds
Inventory items with custom model mappings

Every completed image is uploaded to the Sky-Systems CDN. Depending on your configuration, the PNG can also be posted to Discord and saved inside the resource on your server.

Already looking for a specific image? Check the Image Gallery before creating it again.

Open the Image Creator

Use either command to open the searchable Image Creator menu:

/image

/imagemenu

The menu provides a complete creation workflow:

Select a category.
Search by model name or item label.
Select a model to load the live preview.
Generate the current image, select multiple entries, or start a complete category batch.
Follow the queue progress and export status directly in the menu.

Category	Rendered content
Vehicles	GTA and add-on vehicle models
Weapons	Weapon models such as `weapon_pistol`
Props	World objects and custom prop models
Peds	Player and NPC models
Items	Inventory items mapped to a suitable prop model

Commands

Command	Description
`/image`	Opens the Image Creator menu.
`/imagemenu`	Opens the Image Creator menu directly.
`/image [model]`	Detects the model type and creates one image.
`/image [type] [model]`	Creates one image using the specified render type.
`/imagebatch [category]`	Generates every catalog entry in a category.
`/imagecancel`	Stops a running batch after the current upload finishes.

Supported command values

The direct /image [type] [model] command accepts these types:

vehicle
weapon
prop
ped

The /imagebatch [category] command accepts these categories:

vehicles
weapons
props
peds
items

Examples

Open the menu:

/image

Create an image and detect its type automatically:

/image adder

Create a vehicle using the backwards-compatible command syntax:

/image vehicle adder

Create a weapon:

/image weapon weapon_pistol

Generate every vehicle in the catalog:

/imagebatch vehicles

Cancel the active batch:

/imagecancel

ACE permissions

All Image Creator commands are restricted commands. Grant only trusted staff access to the commands they need:

add_ace group.admin command.image allow
add_ace group.admin command.imagemenu allow
add_ace group.admin command.imagebatch allow
add_ace group.admin command.imagecancel allow

Batch generation

The menu can generate selected entries or a complete category. During a batch, the progress panel shows the current model and the number of completed, skipped, and failed jobs.

Existing CDN images are skipped instead of uploaded again.
Images are processed sequentially for reliable model loading and uploads.
/imagecancel stops the queue after the currently running upload.
Config.ImageCreator.MaxBatchSize limits how many entries can be queued at once.

Large categories can take a long time to complete. Keep the FiveM client connected and leave the resource running until the queue has finished.

Model catalog

The searchable model list is stored in config/catalog.json. Vehicle, weapon, prop, and ped entries can be simple model-name strings.

Inventory item names do not always match a GTA model. Map those entries to a suitable prop:

{
  "name": "repairkit",
  "label": "Repair kit",
  "model": "prop_tool_box_04",
  "filename": "repairkit",
  "renderType": "prop"
}

Field	Purpose
`name`	Internal item name used for search and identification.
`label`	Human-readable name shown in the menu.
`model`	GTA model rendered for the image.
`filename`	Output filename without the `.png` extension.
`renderType`	Rendering method; inventory items normally use `prop`.

Run the catalog builder from the repository root to restore the bundled GTA model lists:

node tools/build-catalog.mjs

Back up custom item mappings before rebuilding the catalog. The builder replaces config/catalog.json.

Image exports

Sky-Systems CDN and gallery

Every generated image is uploaded to the configured CDN. The legacy direct command opens the resulting URL automatically by default. Images are also available through the Image Gallery.

Discord

Add a complete Discord webhook URL to config/webhooks.lua:

Webhooks = {
    image_created = "https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN"
}

WebhookOptions.mode controls how the image is posted:

attachment downloads the PNG from the CDN and uploads it to Discord.
embed posts an image preview and CDN download link without duplicating the file.

Discord exports are queued, respect rate limits, and retry failed requests. When fallbackToEmbed is enabled, a failed attachment upload falls back to an embed.

Local files

Enable local exports in config/config.lua:

LocalExport = {
    Enabled = true,
    Folder = "exported_images",
}

Generated files are saved by category:

sky_imagecreator/exported_images/<category>/<filename>.png

If you change the export folder, create the vehicles, weapons, props, peds, and items subfolders before starting the resource.

Main configuration

The main settings are located in config/config.lua under Config.ImageCreator.

Setting	Description
`Position`	Isolated world position used by the capture studio.
`SingleCaptureDelay`	Model loading delay for a single image.
`BatchCaptureDelay`	Model loading delay between batch jobs.
`UploadTimeout`	Maximum time allowed for one CDN upload.
`MaxBatchSize`	Maximum number of entries accepted for one batch.
`CatalogFile`	Path to the searchable model catalog.
`OpenLegacyImageAfterCreate`	Opens images created with the legacy direct command.
`OpenMenuImageAfterCreate`	Opens images created through the menu.
`DiscordExport`	Enables or disables Discord exports.
`LocalExport`	Configures local PNG storage.

Best results

Set the game's graphics settings as high as practical.
Use a high-resolution display for sharper source captures.
Wait until notifications and other overlays have disappeared.
Disable scripts that modify the weather, time, minimap, camera, or visual effects while capturing.
Load large add-on models once before starting a long batch.

Known issues and solutions

The background does not spawn or vehicles fall through the map

Cause: Fiveguard Anticheat can block the studio background and related objects from spawning.

Fix: Update the Fiveguard configuration:

EntityDetection.AntiWeirdObjectsSpawn = false

Gym

This documentation provides details on how to configure and use our gym script for your FiveM Server.