Guides
Integration Overview
Understanding FMOD APIs seamless integration with Minecraft
Minecraft Native Audio Integration
FMOD API provides seamless integration with Minecraft's built-in audio system, ensuring FMOD sounds behave exactly like native Minecraft sounds.
✨ Key Features
| Feature | Description | Performance |
|---|---|---|
| 🎯 Instant Pause | FMOD sounds pause when ESC menu opens | <1ms response |
| 🔊 Volume Sync | Respects all Minecraft volume sliders | Real-time updates |
| 🎮 Native Behavior | Acts like built-in Minecraft audio | Zero user setup |
| ⚡ Event-Driven | Uses direct Minecraft events | No polling overhead |
🎛️ Integration Architecture
Core Components
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Minecraft │ │ FMOD API │ │ FMOD Engine │
│ Audio System │◄──►│ Integration │◄──►│ Core System │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Integration Points
- Game State Monitoring - Tracks pause/resume states
- Volume Synchronization - Mirrors Minecraft volume settings
- 3D Listener Updates - Follows player position/orientation
- Resource Management - Automatic cleanup and optimization
🔄 Native Behavior Guarantee
Every FMOD sound automatically:
- ✅ Pauses when game is paused
- ✅ Respects volume sliders
- ✅ Follows 3D positioning rules
- ✅ Cleans up when no longer needed
- ✅ Optimizes performance automatically
No additional code required - it just works!
📋 What's Automatic vs Manual
✅ Automatic (Zero Code)
- Pause/resume behavior
- Volume synchronization
- 3D listener tracking
- Memory management
- Performance optimization
🔧 Manual (Your Control)
- Sound bank loading
- Event triggering
- Custom 3D positioning
- Advanced FMOD features
- Custom audio effects
🚀 Benefits for Developers
Development Speed
- Instant setup - Add dependency and go
- No configuration - Works out of the box
- Native feel - Users never notice integration
- Debug friendly - Clear logging and status
Performance
- Zero overhead when not in use
- Optimized updates - Only when needed
- Memory efficient - Automatic cleanup
- Thread safe - Proper synchronization
User Experience
- Seamless integration - Feels like vanilla Minecraft
- Consistent behavior - Matches user expectations
- No setup required - Install and use
- Performance optimized - No frame rate impact
Ready to dive deeper? Check out the specific integration features:
- Pause/Resume System - How instant pausing works
- Volume Synchronization - Volume slider integration
- 3D Audio System - Spatial audio positioning