The ultimate performance control suite for VulkanMod. Turn off what you don't need, keep what you love, and squeeze every last frame out of your Minecraft experience.
VulkanMod Extra extends VulkanMod with granular control over every visual effect in Minecraft. Built on a modern modular architecture, it seamlessly integrates into VulkanMod's settings GUI while providing unprecedented optimization capabilities.
Think of it as having a professional audio mixing board, but for Minecraft's graphics. Every slider, every toggle, every option is there to help you create your perfect balance between visual quality and raw performance.
Fine-tune which textures animate and which stay static. Every animation type can be toggled independently:
- Master Toggle - Disable all animations with one switch
- Fluids - Water (still/flowing), Lava (still/flowing) animations
- Environmental - Fire, Portal swirls, Sculk sensor pulses
- Blocks - All other animated block textures
Control over 80+ individual particle types. From rain splashes to enchantment glimmers, you decide what renders:
- Master Toggle - One switch to rule them all
- Weather Effects - Rain splashes, snow particles, cloud formations
- Block Interactions - Breaking particles, dust, debris
- Entity Effects - Villager emotions, mob particles, player effects
- Environmental - Bubbles, smoke, ash, cherry leaves
- Special Effects - Portal particles, enchantments, explosions
Deep control over Minecraft's rendering pipeline:
- Entity Rendering - Item frames, armor stands, paintings
- Lighting System - Dynamic light updates optimization
- Beacon Beams - Height limiting for performance
- Fog Effects - Per-environment fog control with detailed multipliers
- Name Tags - Toggle for players and entities
Customize your world's atmosphere:
- Sky Elements - Sun, moon, stars, sky color
- Weather Visuals - Rain/snow rendering separate from mechanics
- Biome Colors - Toggle biome-specific coloring
- Cloud Settings - Height and render distance controls
Enhanced display features:
- FPS Counter - Basic or extended metrics display
- Coordinates - Real-time position tracking
- Toast Notifications - Control achievement/recipe popups
- Debug Info - Steady refresh rate for F3 screen
Based on community testing and feedback:
| Feature Disabled | Average FPS Gain | Notes |
|---|---|---|
| All Animations | +15-25 FPS | Most impact on lower-end GPUs |
| All Particles | +10-20 FPS | Scales with particle density |
| Weather Effects | +5-10 FPS | During rain/snow |
| Fog Rendering | Not tested yet | Likely helps in water/lava |
| Entity Extras | +2-5 FPS | Item frames, armor stands |
Results vary based on hardware, world complexity, and other mods installed. These are estimates from user reports - your results may differ.
- Minecraft: 1.21.1 - 1.21.5
- Mod Loader: Fabric Loader 0.17.2+
- Dependencies:
- Fabric API (Latest for your MC version)
- VulkanMod 0.5.3+
- Install Fabric Loader for your Minecraft version
- Download VulkanMod and place in
modsfolder - Download VulkanMod Extra and place in
modsfolder - Launch Minecraft
- Open Video Settings → VulkanMod tab to access all features
VulkanMod Extra supports multiple Minecraft versions through our intelligent override system:
- 1.21.1 (Stable)
- 1.21.2 (Stable)
- 1.21.3 (Stable)
- 1.21.4 (Stable)
- 1.21.5 (Beta)
Download the version matching your Minecraft installation from our releases page.
Settings are stored in .minecraft/config/vulkanmod-extra-options.json and can be edited manually or through the in-game GUI.
{
"coreSettings": {
"enableMod": true,
"enableGuiIntegration": true,
"enableDebugLogging": false
},
"animationSettings": {
// Individual animation toggles
},
"particleSettings": {
// 80+ particle type toggles
},
"renderSettings": {
// Rendering optimizations
},
"detailSettings": {
// World detail controls
},
"extraSettings": {
// HUD and interface options
}
}We're working on one-click optimization profiles:
- Potato - Maximum FPS, minimum visuals
- Balanced - Smart compromises for most systems
- Quality - Minor optimizations, preserve aesthetics
- Ultra - All features enabled
VulkanMod Extra uses a modern modular architecture designed for performance and maintainability:
- Feature Registry System - Plugin-like architecture with dependency management
- Event-Driven Design - Loosely coupled components communicate via EventBus
- Error Recovery - Automatic error handling with multiple recovery strategies
- Dependency Graph - Topological sorting ensures correct initialization order
- Configuration Manager - JSON-based config with atomic saves and validation
- Hybrid Integration - Event-based VulkanMod integration with reflection fallback
- Multi-Version Support - Shared core with version-specific overrides
📖 Read the full Architecture Documentation →
Multi-version support through Gradle:
# Build for specific version
./gradlew build -Pminecraft_version=1.21.4
# Or build the default version for the branch
./gradlew build📚 See CLAUDE.md for detailed build instructions →
- Startup Impact: < 100ms - Fast initialization with lazy loading
- Memory Usage: Minimal - Efficient config system and feature caching
- Runtime Overhead: Negligible when features disabled, < 1ms/tick when enabled
- Config System: Fast JSON serialization with atomic writes
- Fabric API (Required)
- VulkanMod (Required)
- ModMenu (Recommended)
- Most optimization mods
- Sodium/Iris (Use VulkanMod instead)
- OptiFine (Incompatible with VulkanMod)
- Canvas Renderer (Different rendering pipeline)
VulkanMod Extra options don't appear
- Ensure VulkanMod is installed and working
- Check that GUI integration is enabled in config
- Verify you're using compatible versions
Settings not saving
- Ensure valid JSON syntax if editing manually
- Try deleting config file to regenerate
- Check write permissions for config folder
Performance degradation
- Some features may impact FPS when enabled
- Start with all features disabled, enable gradually
- Check for mod conflicts
Crashes on startup
- Verify VulkanMod is functioning correctly
- Check log files in
.minecraft/logs - Ensure Vulkan drivers are installed
We welcome contributions from everyone! Whether you're a developer, translator, or just passionate about performance:
- 🐛 Bug Reports & Fixes - Help us squash bugs
- ✨ Feature Development - Implement new optimizations
- 🌍 Translations - 16 languages supported, more welcome!
- 📚 Documentation - Improve guides and tutorials
- 🧪 Testing - Benchmark and verify performance claims
🎯 Read CONTRIBUTING.md for complete guidelines →
- Fork the repository
- Read ARCHITECTURE.md to understand the codebase
- Check open issues for tasks
- Create a feature branch and make your changes
- Submit a pull request!
All contributors are credited in our CHANGELOG!
Comprehensive documentation to help you understand, use, and contribute to VulkanMod Extra:
| Document | Purpose | Audience |
|---|---|---|
| README.md | Project overview, features, installation | Everyone |
| CONTRIBUTING.md | Contribution guidelines, code style, PR process | Contributors |
| ARCHITECTURE.md | System design, core systems, data flow diagrams | Developers |
| CLAUDE.md | Build system, development setup, internal guidelines | Developers |
| CHANGELOG.md | Version history, changes, release notes | Everyone |
| lang/README.md | Translation guide, language support | Translators |
- ✅ Master toggle controls
- ✅ Enhanced GUI integration
- ✅ Multi-version support
- 🔄 Performance preset system
- Chunk rendering optimizations
- Advanced culling algorithms
- Memory usage profiler
- Custom shader support hooks
- Complete GUI redesign
- Advanced LOD system
- Dynamic performance scaling
- Cloud-based preset sharing
Need help or want to share your experience?
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Discord: Join the VulkanMod community
- Wiki: Documentation
- xCollateral - Creator of VulkanMod
- FlashyReese - Inspiration from Sodium Extra
- Fabric Team - Amazing modding platform
- Contributors - Everyone who's helped improve the mod
- Community - For testing, feedback, and support
VulkanMod Extra is licensed under the MIT License.
You're free to:
- Use the mod in any modpack
- Modify and redistribute
- Use commercially
- Just please give credit!
Built with care for the Minecraft community
Making Minecraft run better, one frame at a time