# Texture Optimization Guide for ATC25_KnaackJobsitePack

## Issues Found
- **2 oversized DDS files** (>12 MB limit)
- **4 PNG files** (should be DDS format)

## Quick Fix Options

### Option 1: Automated Script (Recommended)
1. Double-click `convert_textures.bat`
2. Follow the on-screen instructions
3. Use recommended tools below to complete conversion

### Option 2: Manual Conversion

#### A. Convert PNG to DDS

**Using Paint.NET (Free):**
1. Download Paint.NET + DDS plugin
2. Open PNG file → File → Save As → DDS
3. Choose DXT1 (no alpha) or DXT5 (with alpha)
4. Replace PNG with DDS in textures folder

**Using GIMP (Free):**
1. Install GIMP with DDS plugin
2. Open PNG → Export As → .dds
3. Select BC3/DXT5 compression
4. Save to textures folder

**Using texconv.exe (Command Line):**
```batch
texconv -f DXT5 -o textures textures\*.png
```

#### B. Reduce Oversized DDS Files

**Current Issues:**
- `ElectriciansHammer_albedo.dds` - 22.37 MB (4096x4096 estimated)
- `Tools_BaseColor.dds` - 22.37 MB (4096x4096 estimated)

**Solutions:**

1. **Re-export from source** (Best Quality):
   - Open original texture in your 3D software
   - Export at 2048x2048 with DXT1/DXT5 compression
   - Target: <12 MB per file

2. **Resize existing DDS**:
   - Use NVIDIA Texture Tools or Paint.NET
   - Resize to 2048x2048 or 1024x1024
   - Re-compress with DXT1/DXT5

3. **Use texconv.exe**:
   ```batch
   texconv -w 2048 -h 2048 -f DXT5 textures\ElectriciansHammer_albedo.dds
   texconv -w 2048 -h 2048 -f DXT5 textures\Tools_BaseColor.dds
   ```

## Recommended Tools

### Free Tools:
- **Paint.NET** - https://www.getpaint.net/
- **GIMP** - https://www.gimp.org/
- **NVIDIA Texture Tools** - https://developer.nvidia.com/texture-tools-exporter

### Command Line:
- **texconv.exe** (DirectXTex) - https://github.com/Microsoft/DirectXTex/releases

## Compression Guide

| Texture Type | Recommended Format |
|--------------|-------------------|
| Color/Albedo (no alpha) | DXT1 (BC1) |
| Color/Albedo (with alpha) | DXT5 (BC3) |
| Normal Maps | BC5 or DXT5 |
| Roughness/Metallic | DXT1 (BC1) |

## Resolution Guidelines

| Asset Size | Recommended Resolution |
|-----------|----------------------|
| Small props | 512x512 to 1024x1024 |
| Medium objects | 1024x1024 to 2048x2048 |
| Large objects | 2048x2048 (max 4096x4096) |

## Verification

After optimization, check:
- All DDS files < 12 MB
- No PNG files in textures folder
- Textures display correctly in-game
- Total mod size reduced

## Files to Convert

### PNG → DDS:
- [ ] 8539177_orig.png (173 KB)
- [ ] Decals.png (910 KB)
- [ ] Logo.png (105 KB)
- [ ] Piano89.png (904 KB)

### DDS to Resize:
- [ ] ElectriciansHammer_albedo.dds (22.37 MB → <12 MB)
- [ ] Tools_BaseColor.dds (22.37 MB → <12 MB)
