# MusicPlayer MCBE

**Repository Path**: ykxyx666_admin/music-player-mcbe

## Basic Information

- **Project Name**: MusicPlayer MCBE
- **Description**: 基岩版音乐播放器
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2024-10-21
- **Last Updated**: 2025-10-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MusicPlayer MCBE

![Requires](https://img.shields.io/badge/基于-SAPI_Pro-blue) ![Support](https://img.shields.io/badge/支持版本-MCBE1.21.9x+-green)

### 下载

[下载最新版](https://gitee.com/ykxyx666_admin/music-player-mcbe/releases/latest)

### 效果图

<img src="./image.png" width="350px">

### 介绍

一款基于 SAPI 和 JSONUI 的 MCBE 音乐播放器，可在游戏内播放音乐，有歌曲封面和歌词显示以及精美 UI，可通过 UI 菜单或指令添加和播放音乐，BDS 服务器可用。

### 实现原理

使用 scriptapi 来实现音乐菜单和播放器的主要功能，JSONUI 美化界面，使用 python 脚本及 ffmpeg 将 MP3 文件转码为 ogg 文件置于资源包内，并将专辑封面置于资源包内方便调用。通过行为包加资源包实现整体功能。

### 使用教程

视频教程: [视频链接](https://www.bilibili.com/video/BV1CTYweQEeF)  
文本教程: [使用说明](使用说明.txt)  
加载成功后可输入/musicplayer 或使用音乐书打开菜单

### 常见问题

1. 运行代码时报错：  
   首先建议用中文歌，英文歌和日语歌等由于我测试比较少不保证稳定性。  
   其次文件名不要太长，转码前一定要用音乐标签匹配一次歌曲的信息。

### 鸣谢

[RainbowPieUI](https://github.com/MintCoolMC/MCBE_RainbowPieUI2)：部分 UI 组件支持

### 基于

[SAPI-Pro](https://gitee.com/ykxyx666_admin/SAPI-Pro)：一款 SAPI 前置库