VRRW RD32 Atlas Fix
====================

ACHTUNG, Stand 15.08.2026 - dieser Filter loest das OOM-Problem NICHT MEHR:

  1. Ein "filter" in pack.mcmeta blockiert nur Dateien aus Paketen UNTERHALB
     des filternden Pakets. Dieses Paket wird als Mod-Resourcepack unter die
     Nutzer-ZIPs einsortiert, siehe Reihenfolge in latest.log:
       ... vrrw_rd32_atlas_fix, OBJanim Gold, Overworld Gold, VRRW Vanilla X 1024
     Es kann diese vier also gar nicht erreichen. Nachweis: danelion1.png steht
     im Filtermuster und liegt trotzdem mit 6,5 MB im Atlas.
  2. Selbst wenn er griffe, brachte er nichts. Der Atlas faellt erst auf
     16384x16384, wenn weniger als 268,4 Mio Pixel belegt sind. Gemessen sind es
     ueber 711 Mio (Overworld Gold 421,2 + Vanilla X 1024 290,0). Nach Abzug
     aller 135,3 Mio verwaisten Pixel blieben ueber 576 Mio - der Atlas bliebe
     32768x32768 und die VRAM-Belegung exakt gleich. Dateien zu entfernen spart
     nur dann Speicher, wenn dadurch eine Zweierpotenz unterschritten wird.

Der wirksame Fix ist jetzt AtlasTextureCompressionMixin: der Atlas wird als BC7
abgelegt, gleiche Aufloesung, ein Viertel des Speichers. Abschaltbar mit
-Dvrrw.atlasBc7=false

Der Rest dieser Datei beschreibt den urspruenglichen Ansatz und bleibt als
Begruendung fuer die Dateiauswahl erhalten.

Dieser Filter entfernt 33 aktuell verwaiste High-Resolution-Dateien aus dem
Minecraft-Blockatlas. Er verändert keine verwendete Textur und überschreibt
den Original-Pack "Overworld Gold V.1.1.zip" nicht.

Warum: Der ungefilterte Lauf erzwingt einen 32768 x 32768 RGBA-Atlas und endet
nach dem RD32-Streaming mit GL_OUT_OF_MEMORY. Die 33 Dateien belegen zusammen
135.266.304 Quellpixel, obwohl sie im aktiven src/main weder von Modellen noch
von Java, Shadern oder MTL-Dateien referenziert werden.

Wichtig: Historische Backups bzw. ein alter vrrw_overworld-1.5.jar enthielten
Modelle für 31 dieser Namen. Wenn solche alten Modelle wieder importiert
werden, diesen Filter deaktivieren oder die betreffenden Namen aus pack.mcmeta
entfernen. Der aktuelle Quellstand und ein daraus neu gebautes JAR benötigen
sie nicht.

Zusatz fuer die sieben Entity-Farbatlanten: 166 Dateien mit dem Suffix
"_n.png" sind Normalmaps, wurden von den pauschalen Vanilla-Verzeichnisquellen
aber nochmals als Farbsprites gestitcht. Die JSON-Filter unter
assets/minecraft/atlases entfernen nur diese falschen Farb-Sprite-Eintraege.
Die PNG-Dateien selbst bleiben im ResourceManager erhalten und koennen von
Iris/PBR weiterhin als Normalmaps gelesen werden. Albedo, neue Vanilla-Muster,
Christmas-Chests und der Shulker-Spark bleiben unveraendert.
