面向 Minecraft 模组的专业级 3D 空间音频 API
通过行业标准 FMOD Studio 集成,提升你的 Minecraft 音频体验。
这个集中式 API 消除了音频模组之间的冲突,同时提供了先进的 3D
空间音频功能。
? 主要特性
? 集中式音频管理
- 无冲突:多个模组可同时使用 FMOD 而不会产生冲突
- 资源共享:一个 FMOD 实例服务于所有音频模组
- 自动清理:防止内存泄漏和资源耗尽
? 原生 Minecraft 集成
- 自动暂停/恢复:打开菜单时 FMOD 音效会自动暂停
- 音量同步:遵循 Minecraft 的音频设置
- 3D 听众追踪:自动追踪玩家位置以实现空间音频效果
⚙️ 灵活安装
- 自动检测:从标准安装中查找 FMOD Engine
- 自定义路径:配置非标准的 FMOD 位置
- 递归扫描:在最多 4 层文件夹中搜索库文件
- OpenAL 回退:即使没有 FMOD 也能正常工作
?️ 面向模组开发者
简单集成
// 检查可用性并播放 3D 音频
if (FMODAPI.isAvailable()) {
FMODAPI.playEventSimple("event:/mymod/explosion", x, y, z);
} else {
// 你的 OpenAL 备用方案
playOGGSound("explosion.ogg");
}
高级功能
- Bank 加载:FMODAPI.registerBank(MyMod.class, "/assets/mymod/sounds/master.bank")
- 3D 定位:支持手动覆盖的自动听众追踪
- 音量控制:FMODAPI.setMasterVolume() 及单个实例控制
- 暂停管理:FMODAPI.pauseAllSounds() / resumeAllSounds()
---
? 安装
步骤 1:安装模组
仅从官方来源下载 FMOD API:
- ✅ Modrinth(本页面)
- ✅ CurseForge
- ❌ 禁止第三方重新分发
步骤 2:安装 FMOD Engine
1. 从以下地址下载 FMOD Engine 2.02.16:https://www.fmod.com/download#fmodengine
2. 运行安装程序(非商业用途免费)
3. FMOD API 将自动检测你的安装
步骤 3:自定义设置(可选)
对于非标准安装:
1. 打开 Mods → FMOD API → Config
2. 将 "Custom FMOD Path" 设置为你的安装目录
3. 模组将递归扫描以查找所需的 DLL 文件
---
? 音频功能
3D 空间音频
- 距离衰减:声音随距离自然减弱
- 方向性音频:从正确的方向听到声音
- 多普勒效应:移动声源会真实地改变音调
- 环境音频:支持混响和遮挡效果
性能优化
- 可配置实例数:32-4096 个并发声音(默认:512)
- 自动清理:完成的声音在 1 秒内清理
- 智能缓存:Bank 加载一次,所有模组共享
- 极小开销:正常运行期间 CPU 影响 <2%
---
? 配置选项
| 设置项 | 描述 | 默认值 |
|-------------------------|--------------------------------------|-------------|
| Enable FMOD Audio | 在 FMOD 和 OpenAL 之间切换 | ✅ Enabled |
| Debug Logging | 用于故障排除的详细日志记录 | ❌ Disabled |
| Maximum Sound Instances | 并发音频限制 (32-4096) | 512 |
| Custom FMOD Path | 非标准安装路径 | Auto-detect |
---
? 多语言支持
- English: 完整的文档和界面
- Polish: 包含技术细节的完整翻译
- Expandable: 已准备好支持其他语言
---
?️ 可靠性与安全性
容错架构
- 永不崩溃:所有异常均被捕获并优雅处理
- 优雅降级:如果 FMOD 不可用,则回退到 OpenAL
- 无单点故障:单个声音故障不会导致系统崩溃
法律合规
- 不重新分发 FMOD:用户需单独安装 FMOD Engine
- 适当许可:明确的商业使用指南
- 整合包安全:整合包创建者无需担心许可问题
---
? 面向终端用户
增强的音频体验
- 沉浸式 3D 音频:让你真正融入世界
- 自动集成:与启用 FMOD 的模组无缝配合
- 无需配置:安装即可使用
- 始终兼容:如有需要,可回退到标准音频
调试工具
- /fmodstatus 命令:实时音频系统信息
- 详细日志记录:全面的故障排除信息
- 性能监控:跟踪活动声音实例和使用情况
---
? 技术要求
- NeoForge: 1.21.1+
- Java: 21+
- FMOD Engine: 2.02.16+(需单独下载)
- Platform: Windows(已安装 FMOD Engine)
---
? 为什么选择 FMOD API?
对于玩家
- 更好的音频:行业标准的 3D 空间音频
- 模组兼容性:多个音频模组协同工作
- 自动运行:无需复杂设置
对于模组开发者
- 易于集成:简单的 API 附带全面示例
- 无冲突:与其他模组无资源竞争
- 专业效果:以最小努力获得工业级音频
对于整合包创建者
- 法律安全:无重新分发许可问题
- 可靠:优雅的回退确保整合包始终可用
- 性能:共享资源减少内存占用
---
? 链接与资源
- ? Documentation: 包含完整的 API 参考和指南
- ? Issues: https://github.com/alexiokay/fmod-API/issues
- ? Support: 使用 GitHub issues 获取技术支持
- ? FMOD Engine: https://www.fmod.com/download#fmodengine
Professional-grade 3D spatial audio API for Minecraft mods
Transform your Minecraft audio experience with industry-standard FMOD Studio integration.
This centralized API eliminates conflicts between audio mods while providing advanced 3D
spatial audio capabilities.
? Key Features
? Centralized Audio Management
- Conflict-free: Multiple mods can use FMOD without conflicts
- Shared resources: One FMOD instance serves all audio mods
- Automatic cleanup: Prevents memory leaks and resource exhaustion
? Native Minecraft Integration
- Automatic pause/resume: FMOD sounds pause when you open menus
- Volume synchronization: Respects Minecraft's audio settings
- 3D listener tracking: Player position automatically tracked for spatial audio
⚙️ Flexible Installation
- Auto-detection: Finds FMOD Engine from standard installations
- Custom paths: Configure non-standard FMOD locations
- Recursive scanning: Searches up to 4 folder levels for libraries
- OpenAL fallback: Always works even without FMOD
?️ For Mod Developers
Simple Integration
// Check availability and play 3D audio
if (FMODAPI.isAvailable()) {
FMODAPI.playEventSimple("event:/mymod/explosion", x, y, z);
} else {
// Your OpenAL fallback
playOGGSound("explosion.ogg");
}
Advanced Features
- Bank loading: FMODAPI.registerBank(MyMod.class, "/assets/mymod/sounds/master.bank")
- 3D positioning: Automatic listener tracking with manual override support
- Volume control: FMODAPI.setMasterVolume() and per-instance control
- Pause management: FMODAPI.pauseAllSounds() / resumeAllSounds()
---
? Installation
Step 1: Install the Mod
Download FMOD API from official sources only:
- ✅ Modrinth (this page)
- ✅ CurseForge
- ❌ Third-party redistribution prohibited
Step 2: Install FMOD Engine
1. Download FMOD Engine 2.02.16 from: https://www.fmod.com/download#fmodengine
2. Run the installer (free for non-commercial use)
3. FMOD API will automatically detect your installation
Step 3: Custom Setup (Optional)
For non-standard installations:
1. Open Mods → FMOD API → Config
2. Set "Custom FMOD Path" to your installation directory
3. The mod scans recursively to find the required DLLs
---
? Audio Features
3D Spatial Audio
- Distance attenuation: Sounds fade naturally with distance
- Directional audio: Hear sounds from the correct direction
- Doppler effects: Moving sound sources shift pitch realistically
- Environmental audio: Support for reverb and occlusion effects
Performance Optimized
- Configurable instances: 32-4096 concurrent sounds (default: 512)
- Automatic cleanup: Finished sounds cleaned up within 1 second
- Smart caching: Banks loaded once, shared across all mods
- Minimal overhead: <2% CPU impact during normal operation
---
? Configuration Options
| Setting | Description | Default |
|-------------------------|--------------------------------------|-------------|
| Enable FMOD Audio | Toggle between FMOD and OpenAL | ✅ Enabled |
| Debug Logging | Detailed logging for troubleshooting | ❌ Disabled |
| Maximum Sound Instances | Concurrent audio limit (32-4096) | 512 |
| Custom FMOD Path | Non-standard installation path | Auto-detect |
---
? Multi-Language Support
- English: Complete documentation and interface
- Polish: Full translation with technical details
- Expandable: Ready for additional languages
---
?️ Reliability & Safety
Fail-Safe Architecture
- Never crashes: All exceptions caught and handled gracefully
- Graceful degradation: Falls back to OpenAL if FMOD unavailable
- Zero single points of failure: Individual sound failures don't break the system
Legal Compliance
- No FMOD redistribution: Users install FMOD Engine separately
- Proper licensing: Clear guidelines for commercial use
- Safe for modpacks: No licensing concerns for pack creators
---
? For End Users
Enhanced Audio Experience
- Immersive 3D audio: Feel like you're really in the world
- Automatic integration: Works seamlessly with FMOD-enabled mods
- No configuration needed: Install and it just works
- Always compatible: Falls back to standard audio if needed
Debug Tools
- /fmodstatus command: Real-time audio system information
- Detailed logging: Comprehensive troubleshooting information
- Performance monitoring: Track active sound instances and usage
---
? Technical Requirements
- NeoForge: 1.21.1+
- Java: 21+
- FMOD Engine: 2.02.16+ (separate download)
- Platform: Windows (with FMOD Engine installed)
---
? Why Choose FMOD API?
For Players
- Better audio: Industry-standard 3D spatial audio
- Mod compatibility: Multiple audio mods work together
- Automatic operation: No complex setup required
For Mod Developers
- Easy integration: Simple API with comprehensive examples
- Conflict-free: No resource competition with other mods
- Professional results: Industry-grade audio with minimal effort
For Modpack Creators
- Legal safety: No redistribution licensing issues
- Reliable: Graceful fallbacks ensure modpacks always work
- Performance: Shared resources reduce memory usage
---
? Links & Resources
- ? Documentation: Complete API reference and guides included
- ? Issues: https://github.com/alexiokay/fmod-API/issues
- ? Support: Use GitHub issues for technical support
- ? FMOD Engine: https://www.fmod.com/download#fmodengine
评论 0
登录后参与评分
还没有评论,来抢沙发吧