Unturned Images Generator
An in-game Unturned client module that renders clean, transparent icons of items and vehicles
An in-game Unturned client module that renders clean, transparent icons of items and
vehicles (vanilla and workshop) straight to PNG files — with a live in-game editor (press
F10) where you pose the model, tune lighting and post-processing, and see exactly what will be
exported.
🍴 A fork of SilksPlugins/UnturnedImages —
reworked from the CDN / URL-resolver plugin into a standalone in-game icon generator.
Link to this repo by Sarshane
Features
- Renders items and vehicles to PNG with a transparent background.
- Live WYSIWYG preview — the preview uses the exact same render path as the export, so what you
see is what you get. - Stable bounding-sphere framing — the model always fits the frame at any size and never jitters
while you rotate it. - Adjustable per export:
- rotation (X / Y / Z) for both vehicles and items, camera zoom;
- key and rim light position, intensity and color;
- point or directional key light (size-independent lighting for huge vehicles);
- soft shadow catcher and supersampling (1×–4×) for crisp edges;
- optional transparent-margin trim (auto-crop to a fixed padding);
- optional solid background color instead of transparency.
- Items export as a 3D render or as the exact vanilla UI icon.
- File naming by asset ID or GUID.
- Filters for official vs workshop assets, plus one-click export of a single workshop mod.
- Cancel button to stop a running export.
- Headless console command for scripted/batch export without the menu.
- Maintains one paste-ready
_Overrides/overrides.yamlwith the exported ID ranges of every mod,
in both the SAR.Czarek.Market / SAR.Garage and the upstream UnturnedImages config format.
Installation
- Download
UnturnedImages.zipfrom the latest release. - Extract it into your Unturned
Modulesfolder, so you end up with:…/steamapps/common/Unturned/Modules/UnturnedImages/UnturnedImages.module …/steamapps/common/Unturned/Modules/UnturnedImages/UnturnedImages.Module.dll …/steamapps/common/Unturned/Modules/UnturnedImages/ (+ the other .dll files) - Launch Unturned without BattlEye — in the Steam launch dialog pick the Play without BattlEye
option (BattlEye blocks third-party modules from loading). - Press F10 in the main menu or in-game to open the generator.
It is a client module (it renders on your machine), not a server plugin.
Quick start
- Press F10 to open Unturned Images Generator.
- In Preview, type an asset ID into Preview ID and use Mode: vehicle / Mode: item to
switch between vehicle and item preview. - Tune the pose/lighting in the middle and right columns — the preview updates live.
- Click an export button (right column): Export: Items, Export: Vehicles, or
Export workshop mod. - Find your PNGs under
Unturned/Extras/UnturnedImagesGenerator/…(see below).
Menu reference
Preview
| Control | Meaning |
|---|---|
Preview ID | Asset ID shown in the preview. |
Mode: vehicle / Mode: item | Toggle vehicle ↔ item preview/export target. |
Render PNG preview | Render a full-size preview into the preview box. |
Pose & camera
| Control | Meaning |
|---|---|
Rotation X / Y / Z | Rotation of the model (works for vehicles and items). |
Zoom | Camera zoom (0.5×–2.5×). |
Light
| Control | Meaning |
|---|---|
Key X / Y / Z | Key (main) light position. |
Rim X / Y / Z | Rim (back) light position. |
Key: … / Rim: … | Cycle the key/rim light color. |
Directional light | Use a size-independent directional key light. |
Image
| Control | Meaning |
|---|---|
PNG size | Output resolution (64–4096). |
Supersampling: N× | Supersampling (1/2/4×) — renders bigger then downscales. |
Name: ID / Name: GUID | File name = asset ID or GUID. |
Item: 3D / Item: icon | Item export mode: custom 3D render or exact vanilla UI icon. |
Shadow | Soft shadow catcher under the model. |
Trim + Padding | Auto-crop transparent margins to a fixed padding. |
Background + Bg: … | Fill the background with a solid color (incl. chroma-key green). |
Export
| Control | Meaning |
|---|---|
Official / Workshop | Include official / workshop assets. |
Workshop ID | Filter to a single workshop mod (used by the workshop export button). |
Export: Items / Export: Vehicles | Export all items / all vehicles (per filters). |
Export workshop mod | Export items + vehicles of the Workshop ID mod. |
Cancel export | Cancel the running export. |
Output & settings
Exported files:
Unturned/Extras/UnturnedImagesGenerator/{Items|Vehicles}/{Official|Workshop/<modId>}/<name>.png
Settings persist in Unturned/Extras/UnturnedImagesGenerator/settings.json. A few options are
only available there:
OutputDirectoryOverride— export somewhere other than the default path (empty = default).ItemSkinId, exact light intensities/colors, background RGB, etc.
Credits
- Forked from the original Unturned Images project by
SilK / SilksPlugins. - Bootstrapper / hotloader: OpenMod.
- In-game UI toolkit: DanielWillett/UnturnedUITools.
- Link to this repo by Sarshane
Unturned Images Generator
Latest Changes
v1.0.2