音频光盘

🎵 自定义音频唱片

使用自定义音频唱片改造你的 Minecraft 音乐体验！从互联网上传任意音频文件到音乐唱片，并通过 Simple Voice Chat 享受空间音频播放。

❌小错误：

你听到的是原版唱片

✨ 功能

🎧 轻松上传音频

• 使用简单命令从任意 URL 上传音频
• 支持 MP3、OGG、WAV、M4A、WebM 等格式
• 需要时使用 FFmpeg 自动转换格式
• 下载过程中实时显示进度

🔊 沉浸式播放

• 通过 Simple Voice Chat 集成实现空间音频
• 所有玩家之间完美同步
• 标准唱片机范围（64 格）
• 可与原版音乐唱片同时使用

🛠️ 智能处理

• 自动检测并转换格式
• 文件大小验证（最高 50MB）
• 全面的错误处理
• 服务器重启后仍持久存储

🎮 对玩家友好

• 多语言支持（英语、俄语、德语、法语、西班牙语、中文）
• 显示音频元数据的丰富提示框
• 自定义唱片重命名
• 上传过程中的进度反馈

🔧 开发者 API

• 供附加组件开发者使用的事件系统
• 音频修改钩子
• 播放状态监控
• 全面的文档

📋 命令

命令	描述
/audiodisc upload <url>	从 URL 上传音频到手持唱片
/audiodisc youtube <url>	从 YouTube 下载音频（需要 yt-dlp）
/audiodisc rename <title>	重命名你的自定义唱片
/audiodisc info	显示音频信息
/audiodisc clear	从唱片中移除音频

🚀 快速开始

1. 手持一张音乐唱片
2. 运行命令：/audiodisc upload <audio_url>
3. 等待处理（进度会在聊天中显示）
4. 放入唱片机并享受！

📦 要求

• Minecraft 1.21+（Fabric）
• Fabric API
• Simple Voice Chat（用于音频播放）
• yt-dlp（可选，用于支持 YouTube）
• FFmpeg（可选，用于格式转换）

🎯 非常适合

• 想要自定义配乐的音乐服务器
• 为建筑增添氛围的创意建造者
• 播放自定义音频的活动组织者
• 拥有沉浸式音效设计的角色扮演服务器

🔧 技术特性

• 异步处理 - 不会造成服务器卡顿
• 内存高效 - 智能缓存系统
• 网络优化 - 连接池和超时设置
• 注重安全 - URL 验证和速率限制
• 无 Mixin 设计 - 最大兼容性

🌍 支持的格式

✅ 原生支持

• MP3 - 最常见格式
• OGG - Minecraft 首选格式
• WAV - 未压缩音频

🔄 自动转换（使用 FFmpeg）

• M4A - Apple 音频格式
• WebM - Web 音频格式
• AAC - 高级音频编解码器
• FLAC - 无损压缩

🛡️ 安全与保障

• URL 验证 - 仅允许 HTTP/HTTPS
• 文件大小限制 - 可配置的最大大小
• 速率限制 - 防止刷屏上传
• 内容验证 - 确保仅限音频文件
• 权限系统 - 管理员控制功能

📖 文档

提供全面的文档，包括：

• 安装指南
• 配置选项
• 面向开发者的 API 文档
• 故障排除指南
• 性能优化提示

---

今天就改造你的服务器音频体验！ 🎵

兼容大多数 Fabric 模组，并为最大服务器性能而设计。

---