使用代码 FURQ 购买订单可享受 15% 的折扣!
# 💽 **唱片 (Vinyls)**
*通过自定义音乐唱片，提升你的 Minecraft 体验！*
---
## 🎧 **主要特性**
| 特性 | 描述 |
| --- | --- |
| **🎶 自定义音乐唱片** | 轻松将你自己的曲目添加到 Minecraft 中。 |
| **⚡ 性能优化** | 为确保服务器流畅运行而设计。 |
| **💡 易于使用** | 简单的命令用于重新加载配置和给予唱片给玩家。 |
| **⚙ 可配置** | 通过一个直观的 `discs.yml` 文件管理你的自定义唱片。 |
| **🎨 资源包生成** | 自动从你的配置生成资源包。 |
| **🔃 跨版本兼容** | 支持 Minecraft 版本从 `1.16.5` 到最新版本。 |
| **🔌 Fabric 支持** | 支持 Fabric 从版本 `1.20+` 到 `1.21.1`。 |
---
## 💻 **可用命令**
| 命令 | 描述 |
| --- | --- |
| **`/vinyls reload`** | 在不重启服务器的情况下重新加载插件的配置。 |
| **`/vinyls give <唱片名称> [玩家]`** | 向玩家赠送自定义音乐唱片。 |
---
## 🔒 **权限**
| 权限 | 描述 |
| --- | --- |
| **`vinyls.admin`** | 授予访问所有管理命令的权限。 |
---
## 📩 **安装步骤**
1. **[下载 Vinyls](https://modrinth.com/plugin/vinyls):** 从 Modrinth 获取最新版本。
2. **安装:**
- 将 `.jar` 文件放入服务器的 `plugins` 目录中。
- 示例:
```bash
/plugins/Vinyls-x.x.x.jar
```
3. **激活:**
- 重新启动你的服务器以加载插件。
4. **定制:**
- 编辑 `plugins/Vinyls/discs.yml` 中的 `discs.yml` 文件以添加你的自定义唱片。
- 示例:
```yaml
# 所有自定义唱片的根节点。每个唱片条目都嵌套在这个 "discs" 节点下。
discs:
# 每个唱片的唯一标识符。 确保标识符与 `source_files` 文件夹中的 OGG 和 PNG 文件一致。
# 在分发项目后修改此标识符将使先前
# 分发过的物品失效。
epic_disc:
# 唱片在游戏中显示的名称。你可以使用颜色代码
# 来自定义名称的外观。
display_name: "&b音乐唱片"
# 用于表示唱片在游戏中的材质类型。"PAPER" 用于此处，
# 但你可以选择任何适合你设计的材质。
material: "PAPER"
# 用于区分具有相同
# 材质的其他物品的自定义模型数据值。 这用于通过资源包应用独特的纹理。
custom_model_data: 1
# Lore 提供唱片附加的上下文或风味文字。 Lore 数组中的每一行将显示为物品 lore 中的单独一行。
lore:
- "&7Vinyls - Epic" # Lore 的第一行。
- "&8Vinyls 提供的史诗音乐！" # Lore 的第二行。
```
5. **加载资源包:**
- 将资源包上传到 [mc-packs.net](https://mc-packs.net)。
- 更新 `server.properties` 文件:
| 属性 | 值 |
| --- | --- |
| `resource-pack` | *资源包的 URL* |
| `resource-pack-sha1` | *资源包的 SHA1 哈希值* |
| `require-resource-pack` | `true` |
- **注意:** 如果你正在使用现有的资源包，请将其与 Vinyls 资源包合并。
---
## 📞 **支持**
如有需要，请访问 [GitHub 仓库](https://github.com/furq07/vinyls/issues) 或加入我们的 [Discord 服务器](https://discord.gg/XhZzmvzPDV)。
---
## 📜 **许可**
Vinyls 以 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) 发布。
---
## 🤝 **合作伙伴**