# zmusic-server

**Repository Path**: zmusic-dev/zmusic-server

## Basic Information

- **Project Name**: zmusic-server
- **Description**: 全功能Minecraft点歌插件
- **Primary Language**: Kotlin
- **License**: GPL-3.0
- **Default Branch**: v4
- **Homepage**: https://zmusic.zhenxin.me
- **GVP Project**: No

## Statistics

- **Stars**: 53
- **Forks**: 1
- **Created**: 2020-02-19
- **Last Updated**: 2025-12-25

## Categories & Tags

**Categories**: multimedia

**Tags**: Minecraft, minecraft-plugin, Bukkit, bungeecord, velocity

## README

<!--suppress HtmlDeprecatedAttribute -->
<div align="center">

![][banner]

![][build-status]
![][codefactor]
![][language]
![][last-commit]

![][releases]
![][downloads]
![][license]

![][tested-versions]
![][players]
![][servers]

[文档][docs-link] | [QQ 群][qq-group-link] | [Discord][discord-link]

简体中文 | [English](README_EN.md) | [繁體中文](README_ZH-TW.md) | [日本語](README_JP.md)

</div>

## 简介

这是一个功能强大的音乐系统，支持以下功能。

* 全服点歌
* 单独播放
* 歌词显示
* 歌词翻译显示
* 多搜索源
* 关键词搜索
* 个人歌单
* 全服歌单
* 歌单播放
* 音量调节
* 支持BungeeCord

## 文档

[点击查看使用文档][docs-link]

## 开源协议

本项目使用 [GPL-3.0](LICENSE) 协议开放源代码

```text
ZMusic - Powerful Music System
Copyright (C) 2025 ZhenXin
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.
```

## 鸣谢

### 核心技术

* [Kotlin](https://kotlinlang.org/) - 现代化的 JVM 编程语言
* [Gradle](https://gradle.org/) - 强大的构建自动化工具

### 主要依赖

* [Hutool](https://hutool.cn/) - 全面、强大的 Java 工具类库
* [Night Config](https://github.com/TheElectronWill/night-config) - 轻量级的配置库
* [Kyori Adventure](https://github.com/KyoriPowered/adventure) - Minecraft 文本组件库
* [Apache Maven Resolver](https://maven.apache.org/resolver/) - 依赖解析引擎
* [Netty](https://netty.io/) - 高性能网络应用框架
* [bStats](https://bstats.org/) - 插件统计服务

### 特别感谢

* [TabooLib](https://github.com/TabooLib/taboolib) - 依赖动态加载机制的灵感来源

## 贡献者

[![][contrib]](https://github.com/zmusic-dev/zmusic-server/graphs/contributors)

[banner]: https://socialify.git.ci/zmusic-dev/zmusic-server/image?description=1&forks=1&issues=1&language=1&name=1&pulls=1&stargazers=1&theme=Auto

[build-status]: https://img.shields.io/github/actions/workflow/status/zmusic-dev/zmusic-server/dev.yml?branch=v4&style=for-the-badge

[codefactor]: https://img.shields.io/codefactor/grade/github/zmusic-dev/zmusic-server/v4?style=for-the-badge

[language]: https://img.shields.io/github/languages/top/zmusic-dev/zmusic-server?style=for-the-badge

[last-commit]: https://img.shields.io/github/last-commit/zmusic-dev/zmusic-server?style=for-the-badge

[license]: https://img.shields.io/github/license/zmusic-dev/zmusic-server?style=for-the-badge

[players]: https://img.shields.io/bstats/players/7291?label=players&style=for-the-badge

[servers]: https://img.shields.io/bstats/servers/7291?label=servers&style=for-the-badge

[tested-versions]: https://img.shields.io/spiget/tested-versions/83027?style=for-the-badge

[releases]: https://img.shields.io/github/v/release/zmusic-dev/zmusic-server?style=for-the-badge

[downloads]: https://img.shields.io/github/downloads/zmusic-dev/zmusic-server/total?style=for-the-badge

[contrib]: https://contrib.rocks/image?repo=zmusic-dev/zmusic-server

[docs-link]: https://zmusic.zhenxin.me

[qq-group-link]: https://jq.qq.com/?_wv=1027&k=9Xs1RMt5

[discord-link]: https://discord.gg/twQgJNufYn