电台播放器

📻 Fabric Radio Mod

一个功能完备的客户端侧 Fabric（1.21.4）互联网电台模组。无需任何外部软件，即可在游戏中直接收听数以千计的真实电台！

✨ 功能特性

• 实时电台搜索： 由免费的 Radio Browser API 驱动，让你访问全球数千个电台。
• 后台音频引擎： 在独立的后台线程中无缝播放 MP3 流，绝不会导致游戏卡顿或掉帧！
• 高级筛选： 通过内置下拉菜单，轻松按国家或音乐流派对电台进行排序。
• 收藏夹系统： 一键（★）保存你喜欢的电台以便快速访问。支持以 JSON 文件格式导出和导入收藏夹。
• 专辑封面： 通过 iTunes API 自动获取并显示当前歌曲的专辑封面 —— 同时在通知和主菜单中展示。
• 交互式元数据通知： 在优雅的可调整大小的角落弹窗（小 / 中 / 大）中查看当前播放的歌曲。点击 ⛔ 按钮可永久屏蔽烦人的歌曲或广告。
• 播放历史： 在专用界面中浏览最近播放的 20 首歌曲。点击任意条目即可复制到剪贴板。
• 动态图标： 自动下载并显示电台标志 —— 支持 PNG、JPEG、WEBP 和 ICO 格式。
• 高度可定制： ModMenu 集成可让你调整音量、通知大小、弹窗持续时间，并管理你的通知黑名单。

⚙️ 安装与要求

这是一个仅客户端模组，无需在服务器上安装。

1. 安装 Fabric Loader。
2. 下载 radio-mod-1.2.0.jar 并将其放入你的 .minecraft/mods 文件夹中。
3. 必需： Fabric API
4. 推荐： ModMenu（用于访问设置界面）。

🎮 控制方式

• 在游戏中按R（默认键位）打开电台主菜单。
• 使用菜单中的滑块可独立于游戏主音量调整电台音量。

🌐 语言支持

该模组会自动适配你的 Minecraft 语言设置！

• 英语（默认）
• 波兰语（Polski） - CZYTAJ PO POLSKU (README_pl.md)

📝 更新日志

v1.2.0

• 新增： 自动从 iTunes API 获取专辑封面 —— 显示在通知和主菜单中
• 新增： 播放历史界面（最近 20 首歌曲）—— 点击任意条目可复制到剪贴板
• 新增： 设置中的通知尺寸选择器（小 / 中 / 大）
• 新增： 以 JSON 格式导出和导入收藏夹（config/radiomod_favorites_export.json）
• 修复： 电台图标现已支持 JPEG、WEBP 和 ICO 格式（之前仅支持 PNG）
• 修复： 图标下载失败时的崩溃问题（空指针异常）
• 改进： 主菜单按钮布局 —— 间距均匀且对齐

v1.0.0

• 初始版本

📝 致谢

• 由 AnonBOT 开发。
• 使用 MP3SPI / JLayer 进行音频解码。
• 电台数据库由 Radio Browser 提供。
• 专辑封面由 iTunes Search API 提供。