🎮 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

1. Install Fabric Loader (0.19.2 or newer)
2. Install Fabric API (required dependency)
3. Download G1axFixer from Modrinth or GitHub Releases
4. Place the .jar file in your .minecraft/mods folder
5. 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