Asset Optimizer

🎞️ Using the Asset Optimizer

The Asset Optimizer helps you reduce file sizes and convert supported media into more launcher-friendly formats. It works with a selected input folder and writes the processed results to a separate output folder, leaving your original source files untouched.

🚀 Opening the Asset Optimizer

Accessing the tool

Open the main editor menu and select Asset Optimizer. The optimizer window will open with options for images, audio, and video, along with a live output console and progress bar.

What you need before starting

• An Input Folder containing the media files you want to process
• An Output Folder where the optimized files will be written

📂 Step-by-Step Workflow

1. Select your input folder

Click the Input Folder field and choose the folder containing the media you want to optimize.

2. Select your output folder

Click the Output Folder field and choose where the processed files should be saved.

3. Choose your optimization settings

You can enable or disable conversions for images, audio, and video before starting. The available settings are:

• BMP to JPG
• Convert to WebP
• Quality slider for image compression
• WAV to MP3
• WAV to OGG
• MP3 to OGG
• Enable H.264 Compression for supported video files
• Compression Level (CRF) slider for video quality

4. Start optimization

Click Start Media Optimization to begin processing. The console will show live progress, the progress bar will update, and a summary will appear when the job is complete.

🖼️ Image Optimization

Supported image types

The optimizer can process common image formats including JPG, JPEG, PNG, BMP, WebP, and GIF.

BMP to JPG

Enable this option if you want BMP images converted into JPG files. This is useful because BMP files are often far larger than necessary.

Convert to WebP

Enable this option if you want supported image files converted to WebP. This can provide strong size savings while keeping visual quality high.

Quality setting

The Quality slider controls image compression strength.

• Higher values preserve more visual quality but usually produce larger files
• Lower values reduce file size further but may introduce more visible compression

[info]A quality setting around 80% is a solid general-purpose starting point for most launcher assets.

🔊 Audio Optimization

WAV to MP3

Use this to convert WAV audio into MP3. This is useful when your source audio is uncompressed and much larger than needed.

WAV to OGG

Use this to convert WAV audio into OGG format.

MP3 to OGG

Use this if you already have MP3 files and want OGG output instead.

Important note about WAV conversion

You should choose either WAV to MP3 or WAV to OGG for a single pass. These two options are treated as alternatives, so enabling one will switch off the other.

🎬 Video Optimization

Supported video types

The optimizer provides video compression options for supported video files such as MP4 and WEBM.

Enable H.264 Compression

Turn this on if you want supported video files compressed to reduce file size.

Compression Level (CRF)

The CRF slider controls video compression quality.

• Lower CRF values produce higher quality and larger files
• Higher CRF values produce smaller files with more compression

[info]A CRF setting around 28 is a practical default for balancing size and quality.

🧾 Understanding the Output

Engine Output console

The console displays live messages while files are being processed. This includes startup messages, file-by-file activity, and live media progress for longer conversions.

Progress bar and summary

The progress bar shows how far the overall batch has progressed. When the job is finished, the summary area shows the total space saved.

When optimized files are larger

If an attempted optimization results in a file that is larger than the original, the optimizer keeps the more sensible result instead of forcing a worse output.

🛠️ First Run Behaviour

Why the first run may take longer

On first use, the optimizer may need to initialize its media processing components. This can make the first run slower than usual.

[info]If the tool appears to pause briefly the first time you run it, that is normal.

If audio or video processing is unavailable

If the required media components cannot be initialized, image optimization can still continue, but audio and video processing may be unavailable until the issue is resolved.

💡 Best Practices

• Keep a backup of your original files before running a large batch
• Use a fresh output folder for each pass
• Test optimized audio and video in your launcher before publishing
• Start with the default quality settings, then adjust if needed
• Use WebP and compressed audio where possible to reduce launcher size

❓ Troubleshooting

Start button does nothing

Make sure both an input folder and output folder have been selected before starting.

Processing seems stuck

Check the console output and give it a moment, especially on first run or when processing larger video files.

Some files were not converted

Not every file type is converted in the same way. Unsupported files may simply be copied through, while some formats depend on which options you enabled before starting.

Output looks worse than expected

Try increasing image quality or lowering the video CRF value, then run the batch again into a new output folder for comparison.

Audio or video options are not working

If media processing components could not be initialized successfully, audio and video compression may not run correctly. Restart the application and try again.