🎮 G1axFixer

The ultimate performance and stability mod for Minecraft 1.21.11

G1axFixer eliminates lag spikes, freezes, and crashes caused by resource packs while providing powerful optimizations for smooth gameplay and combat.

✨ Features

🛡️ Resource Pack Protection

Corrupt ZIP Guard - Prevents crashes from broken resource pack archives
Atlas Overflow Fix - Handles oversized textures that exceed GPU limits
Missing Sprite Handler - Replaces missing textures with fallback instead of crashing
Sound Event Fixer - Silently skips missing or corrupt sound files
Model Load Protection - Substitutes broken models with fallback cube
Language File Sanitizer - Skips malformed translation files
Metadata Auto-Repair - Fixes or generates missing pack.mcmeta files

⚡ Performance Optimizations

Network Packet Batching - Reduces network overhead for smoother multiplayer
Particle Culling - Removes distant particles to boost FPS
Entity Render Optimization - Optimizes entity rendering at distance
Smart Entity Ticking - Reduces tick rate for distant entities
Block Entity Optimization - Improves performance with many tile entities

🔧 Advanced Features

Compatibility Checker - Detects incompatible mods before launch
Error Handler - Catches and logs errors without crashing
Configurable - Toggle any fix or optimization via config file
Debug Logging - Detailed logs for troubleshooting

📦 Installation

Install Fabric Loader (0.19.2 or newer)
Install Fabric API (required dependency)
Download G1axFixer from Modrinth or GitHub Releases
Place the .jar file in your .minecraft/mods folder
Launch the game!

⚙️ Configuration

Config file: .minecraft/config/g1axfixer.json

Resource Pack Fixes

{
  "fixCorruptZip": true,
  "fixAtlasStitch": true,
  "fixMissingSprite": true,
  "fixMissingSound": true,
  "fixBrokenModel": true,
  "fixLanguageJson": true,
  "fixPackMetadata": true,
  "fixReloadHang": true
}

Performance Optimizations

{
  "optimizeNetwork": true,
  "batchNetworkPackets": true,
  "packetBatchSize": 10,
  "compressLargePackets": true,
  "compressionThreshold": 256,
  
  "optimizeRendering": true,
  "cullDistantParticles": true,
  "particleCullDistance": 64,
  "optimizeEntityRender": true,
  "reduceParticleCount": true,
  
  "optimizeTicking": true,
  "optimizeEntityTick": true,
  "optimizeBlockEntityTick": true,
  "entityTickRange": 128
}

Logging

{
  "logFixedIssues": true,
  "logDebug": false
}

🎯 Use Cases

For Players

✅ Use multiple resource packs without crashes
✅ Eliminate lag spikes during resource pack loading
✅ Smoother gameplay with 100+ mods
✅ Better FPS in crowded multiplayer servers
✅ Stable combat without freezes

For Modpack Creators

✅ Prevent user crashes from bad resource packs
✅ Improve overall pack stability
✅ Reduce support tickets
✅ Compatible with performance mods (Sodium, Iris)

For Server Owners

✅ Reduce client-side crashes
✅ Better network performance
✅ Smoother player experience

🔄 Compatibility

✅ Compatible With

Fabric API
Sodium
Iris Shaders
Lithium
Phosphor
Most Fabric mods

❌ Incompatible With

OptiFabric
OptiFine (use Sodium + Iris instead)

📊 Performance Impact

Before G1axFixer:

Resource pack loading: 30-60 seconds with freezes
FPS drops: 60 → 20 FPS during particle effects
Crashes: 1-2 per hour with heavy resource packs

After G1axFixer:

Resource pack loading: 10-15 seconds, smooth
FPS stable: 60+ FPS maintained
Crashes: 0 (errors handled gracefully)

🐛 Troubleshooting

Game won't launch

Check you have Fabric API installed
Remove OptiFabric/OptiFine if present
Check logs for compatibility errors

Config not working

Delete config/g1axfixer.json to regenerate defaults
Ensure JSON syntax is valid

Still experiencing issues

Enable debug logging: "logDebug": true
Check latest.log for [G1axFixer] entries
Report on Discord or GitHub Issues

📈 Statistics

On game shutdown, G1axFixer prints a summary:

[G1axFixer] ── Fix Summary ──────────────────────
[G1axFixer]   Corrupt ZIP / resource pack archive : 3 fixed
[G1axFixer]   Missing or unresolvable sprite      : 12 fixed
[G1axFixer]   Missing sound event or OGG file     : 5 fixed
[G1axFixer]   TOTAL fixed this session            : 20
[G1axFixer] ─────────────────────────────────────

👥 Credits

Developers: AkaTriggered, G1ax
Discord: Join our community
GitHub: AkaTriggered

📜 License

MIT License - Free to use, modify, and distribute

🚀 Support the Project

⭐ Star on GitHub
💬 Join our Discord
🐛 Report bugs
💡 Suggest features
📢 Share with friends

Made with ❤️ for the Minecraft community

G1axFixer