How panzerdevorg/tessera works
Tessera is a client-side NeoForge mod that reduces texture-atlas VRAM by recompressing vanilla atlases into GPU-compressed BC formats. The principal flow starts after vanilla uploads an atlas: a mixin hands off to the atlas driver, which prepares mip levels, checks budget and cache, and delegates encoding before the compressed data is uploaded. Animated sprites are updated separately. Configuration, compatibility helpers, and F3 reporting support that flow. README statements document several runtime behaviors; source excerpts are incomplete, so uncertain internal links are omitted.
Main entry points: AtlasCompressionDriver.java Atlas compression · Tessera.java Mod bootstrap · CompressionPipeline.java Compression pipeline · TesseraRuntime.java Backend selection
Components 25
Game integration
- Atlas upload hook
src/main/java/com/panzer/mods/tessera/mixin/TextureAtlasUploadMixin.java - Sprite upload hook
src/main/java/com/panzer/mods/tessera/mixin/SpriteContentsUploadMixin.java - Mod bootstrap
src/main/java/com/panzer/mods/tessera/Tessera.java - Game compatibility
src/main/java/com/panzer/mods/tessera/compat/TesseraCompat.java - Compression events
src/main/java/com/panzer/mods/tessera/api/AtlasCompressEvent.java
Atlas processing
- Atlas compression
src/main/java/com/panzer/mods/tessera/atlas/AtlasCompressionDriver.java - Sprite family analysis
src/main/java/com/panzer/mods/tessera/atlas/SpriteFamilyAnalyzer.java - Mip-chain builder
src/main/java/com/panzer/mods/tessera/atlas/MipChainBuilder.java - Animation updates
src/main/java/com/panzer/mods/tessera/compress/CompressedAnimationUploader.java - Animation frame reader
src/main/java/com/panzer/mods/tessera/compress/AnimationReader.java - Atlas disk cache
src/main/java/com/panzer/mods/tessera/cache/AtlasCache.java
Compression
- Compression pipeline
src/main/java/com/panzer/mods/tessera/compress/CompressionPipeline.java - Backend selection
src/main/java/com/panzer/mods/tessera/compress/backend/TesseraRuntime.java - Compression backend
src/main/java/com/panzer/mods/tessera/compress/backend/CompressionBackend.java - Native encoder
src/main/java/com/panzer/mods/tessera/compress/backend/JniCompressionBackend.java - Software backend
src/main/java/com/panzer/mods/tessera/compress/backend/SoftwareCompressionBackend.java - Software BC7 encoder
src/main/java/com/panzer/mods/tessera/compress/software/SoftwareBc7Encoder.java - Software BC1 encoder
src/main/java/com/panzer/mods/tessera/compress/software/SoftwareBc1Encoder.java - Transparent texel cleanup
src/main/java/com/panzer/mods/tessera/compress/software/TransparentTexelBleed.java
Settings and reporting
- Client configuration
src/main/java/com/panzer/mods/tessera/config/Config.java - Reload rules
src/main/java/com/panzer/mods/tessera/config/RulesManager.java - VRAM budget
src/main/java/com/panzer/mods/tessera/vram/VramBudgetEngine.java - F3 VRAM overlay
src/main/java/com/panzer/mods/tessera/gui/DebugOverlay.java - Feature API
src/main/java/com/panzer/mods/tessera/api/TesseraFeatures.java
Other components
- Minecraft client
Connections 26
- Minecraft client → Atlas upload hook: uploads atlas
- Atlas upload hook → Atlas compression: dispatches compression
src/main/java/com/panzer/mods/tessera/mixin/TextureAtlasUploadMixin.java - Atlas compression → Mip-chain builder: builds mip chain
src/main/java/com/panzer/mods/tessera/atlas/AtlasCompressionDriver.java - Atlas compression → Atlas disk cache: checks and stores
src/main/java/com/panzer/mods/tessera/atlas/AtlasCompressionDriver.java - Atlas compression → Compression pipeline: requests encoding
src/main/java/com/panzer/mods/tessera/atlas/AtlasCompressionDriver.java - Atlas compression → VRAM budget: checks budget
src/main/java/com/panzer/mods/tessera/atlas/AtlasCompressionDriver.java - Atlas compression → Game compatibility: uses game helpers
src/main/java/com/panzer/mods/tessera/atlas/AtlasCompressionDriver.java - Atlas compression → Sprite family analysis: analyzes sprites
- Compression pipeline → Backend selection: selects backend
src/main/java/com/panzer/mods/tessera/compress/CompressionPipeline.java - Compression pipeline → Transparent texel cleanup: cleans texels
src/main/java/com/panzer/mods/tessera/compress/CompressionPipeline.java - Backend selection → Native encoder: probes native
src/main/java/com/panzer/mods/tessera/compress/backend/TesseraRuntime.java - Backend selection → Software backend: falls back to
src/main/java/com/panzer/mods/tessera/compress/backend/TesseraRuntime.java - Software backend → Software BC7 encoder: encodes BC7
src/main/java/com/panzer/mods/tessera/compress/backend/SoftwareCompressionBackend.java - Software backend → Software BC1 encoder: encodes BC1
src/main/java/com/panzer/mods/tessera/compress/backend/SoftwareCompressionBackend.java - Sprite upload hook → Animation updates: updates compressed sprites
src/main/java/com/panzer/mods/tessera/mixin/SpriteContentsUploadMixin.java - Animation updates → Animation frame reader: reads frames
src/main/java/com/panzer/mods/tessera/compress/CompressedAnimationUploader.java - Animation updates → Compression pipeline: encodes frames
src/main/java/com/panzer/mods/tessera/compress/CompressedAnimationUploader.java - Mod bootstrap → Client configuration: registers settings
src/main/java/com/panzer/mods/tessera/Tessera.java - Mod bootstrap → Backend selection: initializes backend
src/main/java/com/panzer/mods/tessera/Tessera.java - Mod bootstrap → Reload rules: registers reload listener
src/main/java/com/panzer/mods/tessera/Tessera.java - Mod bootstrap → VRAM budget: warms VRAM query
src/main/java/com/panzer/mods/tessera/Tessera.java - Mod bootstrap → F3 VRAM overlay: registers debug display
src/main/java/com/panzer/mods/tessera/Tessera.java - VRAM budget → Client configuration: uses fallback target
src/main/java/com/panzer/mods/tessera/vram/VramBudgetEngine.java - F3 VRAM overlay → VRAM budget: shows VRAM savings
src/main/java/com/panzer/mods/tessera/gui/DebugOverlay.java - Atlas compression → Compression events: fires lifecycle events
- Atlas compression → Minecraft client: uploads compressed atlas