VRAM Killer

VRAM Killer

Minecraft Fabric mod for runtime VRAM optimization via RGB5_A1 texture format conversion.

License

CC0 1.0 Universal (Public Domain)

Dedicated to the public domain. Free to use, modify, distribute without restrictions.

Features

RGBA5551 Texture Conversion (Core Feature)

Converts textures with binary alpha (all pixels α=0 or α=255) to 16-bit RGB5_A1 format
50% VRAM savings per converted texture (32bpp → 16bpp)
Uses standard OpenGL GL_RGB5_A1 format — fully compatible with MC 1.21+ GpuDevice
Automatic binary-alpha detection — skips textures with semi-transparent pixels
Inline conversion during texture upload — no async pipeline needed

Supported Texture Types:

Block textures (atlas-based)
Item textures
Entity/Mob sprites (via SpriteContents.uploadFirstFrame() hook)
GUI elements with opaque/transparency-only regions
Environment textures (sky, end sky, etc.)
Particle textures

Excluded (correctly skipped):

Textures with gradient/semi-transparent alpha (e.g., glass, stained glass)
Font glyphs
UI icons with anti-aliased edges

Texture Caching System

Pre-upload pixel caching via TextureContentsMixin
Multi-point sampling validation (512 sample points, <2% non-zero threshold)
Smart zero-pixel detection for top-transparent UI icons (edition.png, minecraft.png)
Sprite pixel capture at correct timing (uploadFirstFrame for async-loaded entities)

Texture Scheduling

Hot/Warm/Cold zone classification for textures
Path-based zone assignment (blocks/items → Hot, entities → Warm)
Dynamic eviction thresholds based on VRAM pressure
Grace period for newly loaded textures (30s default)

VRAM Monitoring

NVIDIA GPU support via nvidia-smi (Windows API)
AMD GPU support via GL_ATI_meminfo
Background monitoring with failure backoff

Leak Detection

Tracks texture creation and destruction
Identifies orphaned textures
Configurable detection thresholds (default: 300s interval)

Debug Overlay

F3+V to toggle VRAM stats panel in F3 debug screen
Shows:
- Converted/Skipped texture counts
- Total VRAM saved (MB)
- Conversion statistics

Compatibility

✅ Sodium 0.8.9+ (automatic detection)
✅ Iris shaders (shadow resolution optimization)
✅ MC 1.21+ GpuDevice (Vulkan-like rendering pipeline)

Public domain (CC0). No restrictions.