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.*