#22 Sync Gumeng's Doc.

Fix Font Color I think.

docs/en/modpack/kubejs/1.20.1/KubeJSCourse/KubeJSBasic/Customs/ItemType/MusicDisc.md

@@ -1,51 +1,87 @@
 # 添加唱片
-在本章中会举例如何创建一个可以播放音乐的唱片，本章所有js代码都是在文件夹`startup_scripts`下
+
+在本章中会举例如何创建一个可以播放音乐的唱片，本章所有js代码将会存放于在文件夹`startup_scripts`和`server_scripts`下
+
 ## 添加声音
+
 在添加唱片之前，我们需要先添加声音，不然我们的唱片就是一个哑巴唱片，播放不了我们自己的音乐
+
 ```js
 StartupEvents.registry("sound_event", (event) => {
     event.create("meng:music.my_music")
 })
 ```
+
 只需要上面这一行就可以将音乐注册上去，参数为id
+
+### 注意：在 1.21.1+ 时
+
+在刚在注册音频的语句的基础上使用一下语句，将音频注册为唱片音频
+
+```js
+ServerEvents.registry('jukebox_song', (event) => {
+    event.create('<namespace>:music_id')
+         .song('<namespace>:music_id', time)
+})
+```
+
 ## 注册物品
+
 接下来我们就可以来注册唱片了
+
 ```js
 StartupEvents.registry("item", (event) => {
     event.create("meng:my_music_disc", "music_disc")
         .song("meng:music.my_music", 103)
         .tag("music_discs")
 })
 ```
+
 `.song()`里的第一个参数为 注册声音的id,第二个参数为 音乐的时长，这里是用秒计算
 
 `.tag("music_discs")` 这个是**一定要写**的，告诉游戏这个物品属于唱片tag，这样唱片机才能正常的被使用
 
+### 注意：在 1.21.1+ 使用以下语句
+
+```js
+StartupEvents.registry('item', (event) => {
+    event.create('<namespace>:music_id')
+         .jukeboxPlayable('<namespace>:music_id', true)
+})
+```
+
+因为自 Minecraft 1.20.5 开始, 使用了物品堆叠组件的缘故，基本上所有物品都可以注册为唱片（大概）
+
 ## 准备音乐
+
 在注册完唱片和声音后，我们需要开始将音乐添加进来了
 
 首先我们需要进入这个网站 [mp3->ogg](https://audio.online-convert.com/convert-to-ogg)
 
 我的世界的声音文件都是`.ogg`格式的，所以需要将mp3转换为ogg格式
 
 ### 创建声音文件夹
+
 之后我们需要创建文件夹将音乐存入进来
 
-将ogg文件存入路径为`kubejs/assets/${modid}/sounds`里，这里`${modid}`就是上面冒号前的字符，我这边是`meng`，所以实际路径为`kubejs/assets/meng/sounds`,如果没有写`${modid}`，那么路径则为`kubejs/assets/kubejs/sounds`
+将ogg文件存入路径为`kubejs/assets/<namespace>/sounds`里，这里`<namespace>`就是上面冒号前的字符，我这边是`meng`，所以实际路径为`kubejs/assets/meng/sounds`,如果没有写`<namespace>`，那么路径则为`kubejs/assets/kubejs/sounds`
 
 需要将文件重命名，这里最好是和音乐id的`music.`后面相同(当然这里可以自定义，但是不建议),所里这里我的文件名为`my_music.ogg`,完整路径为`kubejs/assets/meng/sounds/my_music.ogg`
+
 ### 编写寻找声音文件
-返回到路径为`kubejs/assets/${modid}`下，创建一个名为`sounds.json`的文件，打开进行编辑
+
+返回到路径为`kubejs/assets/<namespace>`下，创建一个名为`sounds.json`的文件，打开进行编辑
 
 [详细编写可以查看mcwiki](https://zh.minecraft.wiki/w/Sounds.json?variant=zh-cn)
+
 ```json
 {
     // 注册声音id
     "music.my_music": {
         // 固定格式
         "sounds": [
             {
-                // 创建声音的文件夹 也就是我们上面的 kubejs/assets/${modid}/sounds
+                // 创建声音的文件夹 也就是我们上面的 kubejs/assets/<namespace>/sounds
                 "name": "meng:my_music",
                 // 以声音流输出，建议填写true(唱片)
                 "stream": true
@@ -54,25 +90,34 @@ StartupEvents.registry("item", (event) => {
     },
 }
 ```
+
+### 注意：在 1.21.1+ 中
+
+在 1.21.1+ 中，可以直接将音频文件放于`./kubejs/assets/<namespace>/sounds/`下，kubejs会识别到
+
 [关于sounds.json的文件结构](../../../Digression/sounds-json)
 
 ## 本地化和材质
+
 接下来就是最简单的对物品进行汉化，让物品显示中文文本
 
-进入路径`kubejs/assets/${modid}/lang` 创建文件`zh_ch.json` (如果有直接打开就行)
+进入路径`kubejs/assets/<namespace>/lang` 创建文件`zh_ch.json` (如果有直接打开就行)
 
 编写或添加文本
+
 ```json
 {
     "item.meng.my_music": "音乐唱片",
     "item.meng.my_music.desc": "我的音乐 - 私人歌手"
 }
 ```
+
 第一个为唱片本身的文本信息
 
 第二个为唱片的音乐信息
 
-材质路径为`kubejs/assets/${modid}/textures/item` 将已经画好的唱片材质放在该路径下并命名为`my_music.png` 这里和物品id名称一样
+材质路径为`kubejs/assets/<namespace>/textures/item` 将已经画好的唱片材质放在该路径下并命名为`my_music.png` 这里和物品id名称一样
 
 ## 注意事项和音乐下载
-如果你上面做的都没问题，唱片也能成功放进唱片机，代码也没报错，但是就是没声音，建议先用孤梦[提供的音乐](https://cloud.mihono.cn/s/5WicT8yJcsA86Co/download/my_music.ogg) 如果链接打不开或者无法下载，在[哔哩哔哩私信孤梦](https://space.bilibili.com/16632546)
+
+如果你上面做的都没问题，唱片也能成功放进唱片机，代码也没报错，但是就是没声音，建议先用孤梦[提供的音乐](https://gitee.com/gumengmengs/kubejs-course/blob/main/files/my_music.ogg) 如果链接打不开或者无法下载，在[哔哩哔哩私信孤梦](https://space.bilibili.com/16632546)

docs/zh/modpack/kubejs/1.20.1/KubeJSCourse/KubeJSBasic/Customs/ItemType/MusicDisc.md

@@ -1,51 +1,87 @@
 # 添加唱片
-在本章中会举例如何创建一个可以播放音乐的唱片，本章所有js代码都是在文件夹`startup_scripts`下
+
+在本章中会举例如何创建一个可以播放音乐的唱片，本章所有js代码将会存放于在文件夹`startup_scripts`和`server_scripts`下
+
 ## 添加声音
+
 在添加唱片之前，我们需要先添加声音，不然我们的唱片就是一个哑巴唱片，播放不了我们自己的音乐
+
 ```js
 StartupEvents.registry("sound_event", (event) => {
     event.create("meng:music.my_music")
 })
 ```
+
 只需要上面这一行就可以将音乐注册上去，参数为id
+
+### 注意：在 1.21.1+ 时
+
+在刚在注册音频的语句的基础上使用一下语句，将音频注册为唱片音频
+
+```js
+ServerEvents.registry('jukebox_song', (event) => {
+    event.create('<namespace>:music_id')
+         .song('<namespace>:music_id', time)
+})
+```
+
 ## 注册物品
+
 接下来我们就可以来注册唱片了
+
 ```js
 StartupEvents.registry("item", (event) => {
     event.create("meng:my_music_disc", "music_disc")
         .song("meng:music.my_music", 103)
         .tag("music_discs")
 })
 ```
+
 `.song()`里的第一个参数为 注册声音的id,第二个参数为 音乐的时长，这里是用秒计算
 
 `.tag("music_discs")` 这个是**一定要写**的，告诉游戏这个物品属于唱片tag，这样唱片机才能正常的被使用
 
+### 注意：在 1.21.1+ 使用以下语句
+
+```js
+StartupEvents.registry('item', (event) => {
+    event.create('<namespace>:music_id')
+         .jukeboxPlayable('<namespace>:music_id', true)
+})
+```
+
+因为自 Minecraft 1.20.5 开始, 使用了物品堆叠组件的缘故，基本上所有物品都可以注册为唱片（大概）
+
 ## 准备音乐
+
 在注册完唱片和声音后，我们需要开始将音乐添加进来了
 
 首先我们需要进入这个网站 [mp3->ogg](https://audio.online-convert.com/convert-to-ogg)
 
 我的世界的声音文件都是`.ogg`格式的，所以需要将mp3转换为ogg格式
 
 ### 创建声音文件夹
+
 之后我们需要创建文件夹将音乐存入进来
 
-将ogg文件存入路径为`kubejs/assets/${modid}/sounds`里，这里`${modid}`就是上面冒号前的字符，我这边是`meng`，所以实际路径为`kubejs/assets/meng/sounds`,如果没有写`${modid}`，那么路径则为`kubejs/assets/kubejs/sounds`
+将ogg文件存入路径为`kubejs/assets/<namespace>/sounds`里，这里`<namespace>`就是上面冒号前的字符，我这边是`meng`，所以实际路径为`kubejs/assets/meng/sounds`,如果没有写`<namespace>`，那么路径则为`kubejs/assets/kubejs/sounds`
 
 需要将文件重命名，这里最好是和音乐id的`music.`后面相同(当然这里可以自定义，但是不建议),所里这里我的文件名为`my_music.ogg`,完整路径为`kubejs/assets/meng/sounds/my_music.ogg`
+
 ### 编写寻找声音文件
-返回到路径为`kubejs/assets/${modid}`下，创建一个名为`sounds.json`的文件，打开进行编辑
+
+返回到路径为`kubejs/assets/<namespace>`下，创建一个名为`sounds.json`的文件，打开进行编辑
 
 [详细编写可以查看mcwiki](https://zh.minecraft.wiki/w/Sounds.json?variant=zh-cn)
+
 ```json
 {
     // 注册声音id
     "music.my_music": {
         // 固定格式
         "sounds": [
             {
-                // 创建声音的文件夹 也就是我们上面的 kubejs/assets/${modid}/sounds
+                // 创建声音的文件夹 也就是我们上面的 kubejs/assets/<namespace>/sounds
                 "name": "meng:my_music",
                 // 以声音流输出，建议填写true(唱片)
                 "stream": true
@@ -54,25 +90,34 @@ StartupEvents.registry("item", (event) => {
     },
 }
 ```
+
+### 注意：在 1.21.1+ 中
+
+在 1.21.1+ 中，可以直接将音频文件放于`./kubejs/assets/<namespace>/sounds/`下，kubejs会识别到
+
 [关于sounds.json的文件结构](../../../Digression/sounds-json)
 
 ## 本地化和材质
+
 接下来就是最简单的对物品进行汉化，让物品显示中文文本
 
-进入路径`kubejs/assets/${modid}/lang` 创建文件`zh_ch.json` (如果有直接打开就行)
+进入路径`kubejs/assets/<namespace>/lang` 创建文件`zh_ch.json` (如果有直接打开就行)
 
 编写或添加文本
+
 ```json
 {
     "item.meng.my_music": "音乐唱片",
     "item.meng.my_music.desc": "我的音乐 - 私人歌手"
 }
 ```
+
 第一个为唱片本身的文本信息
 
 第二个为唱片的音乐信息
 
-材质路径为`kubejs/assets/${modid}/textures/item` 将已经画好的唱片材质放在该路径下并命名为`my_music.png` 这里和物品id名称一样
+材质路径为`kubejs/assets/<namespace>/textures/item` 将已经画好的唱片材质放在该路径下并命名为`my_music.png` 这里和物品id名称一样
 
 ## 注意事项和音乐下载
-如果你上面做的都没问题，唱片也能成功放进唱片机，代码也没报错，但是就是没声音，建议先用孤梦[提供的音乐](https://cloud.mihono.cn/s/5WicT8yJcsA86Co/download/my_music.ogg) 如果链接打不开或者无法下载，在[哔哩哔哩私信孤梦](https://space.bilibili.com/16632546)
+
+如果你上面做的都没问题，唱片也能成功放进唱片机，代码也没报错，但是就是没声音，建议先用孤梦[提供的音乐](https://gitee.com/gumengmengs/kubejs-course/blob/main/files/my_music.ogg) 如果链接打不开或者无法下载，在[哔哩哔哩私信孤梦](https://space.bilibili.com/16632546)