！注：本文本使用双语以便读者阅读。
!Note: this is a bilingual text file for the readers' convenience.

> 使用遇到困难时，请善用 Minecraft Wiki 解决问题: https://minecraft.fandom.com/zh/wiki/Minecraft_Wiki
> When having trouble in using this pack, please actively search on Minecraft Wiki to solve your proble: https://minecraft.fandom.com/wiki/Minecraft_Wiki

-----------------------------------------------------------------------

初始指南：
- 解压压缩包，将 Custom Discs Data Pack 放入 .minecraft/saves/<你的世界名称>/datapacks 中，将 Custom Discs Resource Pack 放入 .minecraft/resourcepacks 中
- 进入游戏主菜单，点击 选项->资源包，将 Custom Discs Resource Pack 拉入右侧使之加载
- 进入世界，手持任意原版唱片输入/trigger disc-sample
- 将获得的唱片放入唱片机，你会听到不属于 Minecraft 本体的音乐（这首音乐来自https://freepd.com/epic.php，一个遵循 CC 协议提供免费音乐的网站）

Starters' Tutorial:
- Unzip the pack, put Custom Discs Data Pack into .minecraft/saves/<World Name>/datapacks, put Custom Discs Resource Pack into .minecraft/resourcepacks
- Enter game menu, click Options...->Resouce Packs..., make Custom Discs Resource Pack move to the right side so that it can be loaded
- Enter the world, Hold any kind of vanilla music disc in your mainhand and input /trigger disc-sample
- Put the new disc you get into the juke box, then you will hear a non-vanilla music (it came from https://freepd.com/epic.php, a free music website following CC license)

-----------------------------------------------------------------------

# 游戏中使用指南：
# In-game Tutorial:

- 主手手持原版任意唱片，输入指令 /trigger disc-<你的自定义唱片名>
- Hold any kind of vanilla music disc in your mainhand, use command /trigger disc-< your custom disc name> to transform your normal disc into your own custom disc.

- 示例：/trigger disc-sample
- Instance: /trigger disc-sample

- 将唱片插入唱片机，享受你的唱片吧！
- Put the disc into jukebox and enjoy your music!

- 每次加入新唱片后应在游戏中运行 /reload 并重载数据包（F3+T）以加载最新内容。
- Every time you add new disc into your world, remember to use /reload to update data pack and reload your resource pack (F3+T).

===============
>相关链接：https://minecraft.fandom.com/zh/wiki/%E5%91%BD%E4%BB%A4/reload
>Links: https://minecraft.fandom.com/wiki/Commands/reload
===============

-----------------------------------------------------------------------

# 资源包自定义指南：
# Custom Resource Pack Tutorial:

- 示例唱片原型为音乐唱片：C418 - Far（模型文件为 music_disc_far.json），通过资源包可自行更改不同 CustomModelData 下的物品材质。
- Sample disc is the override of C418 - Far (the model file is music_disc_far.json), you can use resource pack to change the textures under different CustomModelData.

- 建议使用单声道音频（可以用 Audition 软件来编辑），否则唱片的音量可能不会随距离衰减。
- It is recommended to use monaural audio (you can achieve this by Audition), otherwise the volume may not decay by distance.

===============
>相关链接：https://minecraft.fandom.com/zh/wiki/%E6%95%99%E7%A8%8B/%E5%88%B6%E4%BD%9C%E8%B5%84%E6%BA%90%E5%8C%85
>Links: https://minecraft.fandom.com/wiki/Tutorials/Creating_a_resource_pack
===============

-----------------------------------------------------------------------

# 数据包自定义指南:
# Custom Data Pack Tutorial:

- 只需按照提示，修改 discs/functions/custom 中的文件即可。需要修改的部分前注释中会标有 [CUSTOM REALM]。
- Just follow the hint. You only need to edit the files in discs/functions/custom directory. The parts which should be edited are maked as [CUSTOM REALM].

>在数据包中增添内容时，建议使用 Visual Studio Code 并安装 Data-pack Helper Plus 拓展。
>When adding new lines into datapack, it is recommended to use Visual Studio Code with  Data-pack Helper Plus extension.

- 编辑时善用复制粘贴，仅修改特定部分内容即可。
- When editing, make good use of copying and pasting. You just need to modify a few words to make your own music work.

- 以下是文件功能详解：
- The details about the aforementioned function files are as follows:

>get/score：加入 trigger 型的记分，以便玩家在游戏中通过 /trigger 获得自定义的唱片。自行添加唱片时建议采用
>get/score: adding trigger type score so that players can get their custom discs in the game by using command /trigger.

>get/enable：确保玩家有使用 /trigger 的权限。
>get/enable: make sure the play get the permission to use /trigger.

>get/give：给予玩家唱片。唱片的 display:[{}] 部分可自定义物品描述和名称。
>get/give: give disc to the player, you can edit item lores and names in display[{}] part as you wish.

>title：自定义的字幕，用于覆写原版唱片播放时的字幕（如“正在播放：C418 - ...”）。
>title: custom titles to overwrite vanilla disc titles (like "Now Playing: C418 - ...").

>play：播放音乐的函数文件，应为不同的唱片分配不同的 CustomModelData，不同的唱片播放不同的音乐（示例中为 record.sample）
>play: music playing function, remeber to change CustomModelData and make different discs play different musics (the sample is record.sample)

===============
>相关链接：https://minecraft.fandom.com/zh/wiki/%E6%95%99%E7%A8%8B/%E5%88%B6%E4%BD%9C%E6%95%B0%E6%8D%AE%E5%8C%85
>Links: https://minecraft.fandom.com/wiki/Tutorials/Creating_a_data_pack
===============

-----------------------------------------------------------------------

# 2.0 新增内容
# 2.0 Updates

> 便携唱片机，随时随地畅享音乐世界
> Portable Jukebox, for enjoying music anywhere as you wish

> 放在主手输入 /trigger  disc-<name> 以播放指定音乐，将便携唱片机放到副手可立刻停止播放
> input /trigger disc-<name> when the portable jukebox is in your mainhand to play the corresponding music and put it in your offhand to immediately stop the sound 

> 修改方式在文件中均有提示，且与前述内容相似，遇到困难请参考 Minecraft Wiki
> The editing work is same as the texts aforementioned, and there are also hints in the files, it would be great if you can turn to Minecraft Wiki for help when in trouble

> 分设 A 版和 B 版，A 版所有语言（名称、描述、字幕等）均使用英文，B 版支持在资源包的 lang 文件夹中自主通过 .json 文件翻译内容（默认已有简体中文和英文）
> Dividing into version A and version B. In version A, all the texts (names, descriptions, titles etc.) are in English, while version B supports the translation work for .json files in lang folder (default languages are Simplified Chinese and English)

> 相比之下 B 版增加了修改的工作量，你可以按需取用 A 版或 B 版
> The editing work of version B is harder than version A, and you can choose A or B, whatever floats your boat