Discy
一个用于自定义音乐唱片的 Minecraft 模组。在 DJ 台上传歌曲,在 唱片设计工作室设计唱片封面,将音轨刻录到空白唱片上,并在留声机、扬声器或兼容的模组中播放。
代码仓库: github.com/AlfieeLawrence/Discy-A-custom-Disc-mod-for-Minecraft-
功能特性
- DJ 台 — 浏览、搜索、上传并将自定义音频(OGG/MP3)刻录到空白唱片上
- 自定义唱片 — 每张唱片拥有独立的封面艺术,并通过 OpenAL 进行流式播放
- 唱片设计工作室 — 游戏内的像素级编辑器,用于绘制唱片纹理;支持画笔大小调整、涂抹、擦除、填充和拾色,具备撤销/重做功能,并可保存设计以便在刻录时应用
- 扬声器系统 — 将 扬声器 连接到 扬声器控制器,可在整个基地内同步播放同一音轨——非常适合环绕立体声或随时随地播放背景音乐
- 永久唱片 — 通过
data/discy/permanent_discs.json 添加内置唱片
- 可选兼容性 — Sophisticated Core 留声机升级以及 Let's Do Furniture 留声机(需单独安装这些模组)
唱片设计工作室
制作并放置 唱片设计工作室,然后右键点击以打开编辑器。
- 工具 — 涂抹、擦除、填充和拾色
- 画笔 — 可调节大小;支持拖拽或单像素模式
- 画布 — 最大 64×64 像素
- 颜色 — 色轮、亮度滑块、十六进制输入和快速调色板
- 工作流 — 撤销/重做、保存命名设计、加载现有文件或开始新的空白画布
- 保存的纹理会在刻录唱片时出现在 DJ 台中——无需外部图像编辑器
扬声器与扬声器控制器
在你的建筑周围放置 扬声器,并将它们连接到 扬声器控制器。插入自定义唱片,点击 播放,所有已链接的扬声器将同步播放同一首歌曲——每个扬声器均可独立调节音量和范围。
快速设置
- 放置 扬声器控制器 并插入一张 自定义唱片。
- 在你需要音频的位置放置 扬声器。
- 将每个扬声器链接到控制器(无线或有线——见下文)。
- 打开控制器并使用 播放 / 停止。
无线 — 碎片同步 (Shard Sync 物品)
- 手持 Shard Sync 右键点击 扬声器 — 它进入配对模式 30 秒。
- 在该扬声器处于范围内时,手持 Shard Sync 右键点击 扬声器控制器。
- 最近的未链接配对扬声器将连接(消耗一个 Shard Sync)。
有线 — 扬声器线
- 从控制器向每个扬声器铺设 扬声器线(点击相邻方块放置线缆)。
- 当线缆路径到达扬声器时,它会自动链接。
- 破坏路径的任何一段都会断开该扬声器的连接并移除线缆段。
单个扬声器控制 (在控制器 GUI 中)
| 控制项 |
操作 |
| − / + |
音量 ±10% |
| < / > |
范围 ±4 格 |
| x |
取消配对(退还扬声器线或 Shard Sync) |
每个扬声器行前缀为 B(无线 / Shard Sync)或 W(有线 / 扬声器线)。当配对多个扬声器时,使用鼠标滚轮滚动列表(每个控制器最多 16 个)。
连接距离
| 连接类型 |
物品 |
最大距离 |
| 无线 (Shard Sync) |
Speaker Link |
32 格 |
| 有线 (Speaker Wire) |
Speaker Wire |
64 格 |
无线范围是从控制器到扬声器的直线距离。有线范围是通过已放置的线缆方块的路径长度。
可选兼容模组
Discy 不捆绑这些模组。请根据各自模组的许可证,从 Modrinth 或 CurseForge 安装 官方发布版本:
用户上传内容
Discy 允许玩家在 DJ 台上传自己的歌曲和唱片纹理,或从唱片设计工作室保存设计。这些内容由玩家创建,并非随模组附带。
- 你需要确保对上传的任何音频或图像拥有合法权利。
- 未经权利人许可,请勿上传受版权保护的音樂或艺术作品。
- 服务器管理员可能希望制定关于玩家可以上传内容的规则。
Discy 将上传的内容存储在世界的 discy/ 文件夹中(歌曲、纹理、侧车文件)。在游戏中删除内容会同时删除服务器上的这些文件。
致谢与素材
本仓库中包含的艺术素材已获得创作者的许可:
| 素材 |
致谢 |
| 模组代码 |
Alfie Lawrence |
| 模组图标、DJ 台方块纹理、大部分物品纹理 |
Random Nautilus |
| 树苗纹理、UI 纹理、唱片设计工作室方块纹理 |
Mrdragonclaw |
仅运行时引用的原版 Minecraft 素材(例如由 DJ 台屏幕使用的发射器容器 GUI)未在此仓库中重新分发。
许可证
Discy 模组代码采用 MIT 许可证 — 请参阅 LICENSE。
其他条款摘要:
LICENSE、NOTICE 和 COPYING.LGPL 也打包在发布版 JAR 中。
第三方库(随 Discy JAR 分发)
Discy 捆绑了 JLayer (javazoom:jlayer:1.0.1) 用于 MP3 解码。
Discy 本身(不包括捆绑的第三方库)采用 MIT 许可证。
可选模组兼容性(未包含)
Discy 通过 mixins 和公共 API 提供与其他模组的可选集成。Discy 不会:
- 重新分发、修补或重新打包这些模组
- 分发它们的源代码、资源文件或 JAR 包
- 包含修改过的其文件版本
用户必须从其官方作者处安装兼容模组。当这些模组在运行时存在时,Discy 仅添加少量可选的 mixins 和 API 钩子。
- Sophisticated Core / Storage / Backpacks — 版权归 P3pp3rF1y 所有,保留所有权利。请仅从官方发布版安装。Discy 针对公共 API(
IDiscHandler、SoundHandler)进行注册,且不重新分发或修改 Sophisticated 相关文件。
- Let's Do Furniture — 版权归该家具模组作者所有。请仅从 官方发布版 安装,并遵循该模组自身的许可证。当安装了 Furniture 模组时,Discy 会通过 mixin 提供留声机可选集成,且不重新分发或修改 Furniture 相关文件。
如果您发布 Discy 的分支或衍生作品,请将这些模组作为单独的可选项运行时依赖项保留,并保留 JLayer 的 NOTICE 和 COPYING.LGPL 文件。
Discy
A Minecraft mod for custom music discs. Upload songs at the DJ Deck, design disc artwork in the Disc Design Studio, burn tracks onto blank discs, and play them in jukeboxes, Speakers, or compatible mods.
Repository: github.com/AlfieeLawrence/Discy-A-custom-Disc-mod-for-Minecraft-
Features
- DJ Deck — browse, search, upload, and burn custom audio (OGG/MP3) onto blank discs
- Custom discs — per-disc artwork and streaming playback via OpenAL
- Disc Design Studio — in-game pixel editor for disc textures; paint, erase, fill, and pick colors with brush sizes, undo/redo, and saved designs you can apply when burning
- Speaker system — wire up Speakers to a Speaker Controller and play the same track in sync across your whole base — great for surround sound or background music everywhere at once
- Permanent discs — add baked-in discs via
data/discy/permanent_discs.json
- Optional compatibility — Sophisticated Core jukebox upgrades and Let's Do Furniture gramophones (install those mods separately)
Disc Design Studio
Craft and place a Disc Design Studio, then right-click to open the editor.
- Tools — Paint, Erase, Fill, and Pick
- Brush — adjustable size; drag or single-pixel modes
- Canvas — up to 64×64 pixels
- Colors — wheel, brightness slider, hex input, and quick palette
- Workflow — undo/redo, save named designs, load existing files, or start a new blank
- Saved textures appear in the DJ Deck when burning discs — no external image editor required
Speakers & Speaker Controller
Place Speakers around your build and connect them to a Speaker Controller. Insert a custom disc, hit Play, and every linked speaker plays the same song in sync — with per-speaker volume and range.
Quick setup
- Place a Speaker Controller and insert a custom disc.
- Place Speakers where you want audio.
- Link each speaker to the controller (wireless or wired — see below).
- Open the controller and use Play / Stop.
Wireless — Shard Sync (Speaker Link item)
- Right-click a Speaker with Shard Sync — it enters pairing mode for 30 seconds.
- Right-click the Speaker Controller with Shard Sync while that speaker is in range.
- The nearest unlinked pairing speaker connects (consumes one Shard Sync).
Wired — Speaker Wire
- Run Speaker Wire from the controller toward each speaker (click adjacent blocks to place cable).
- When the cable path reaches the speaker, it links automatically.
- Breaking any segment of the path unlinks that speaker and removes the cable run.
Per-speaker controls (in the controller GUI)
| Control |
Action |
| − / + |
Volume ±10% |
| < / > |
Range ±4 blocks |
| x |
Unpair (refunds Speaker Wire or Shard Sync) |
Each speaker row is prefixed with B (wireless / Shard Sync) or W (wired / Speaker Wire). Scroll the list with the mouse wheel when many speakers are paired (up to 16 per controller).
Connection distance
| Connection type |
Item |
Max distance |
| Wireless (Shard Sync) |
Speaker Link |
32 blocks |
| Wired (Speaker Wire) |
Speaker Wire |
64 blocks |
Wireless range is a straight line from controller to speaker. Wired range is the length of the cable path through placed wire blocks.
Optional compatibility mods
Discy does not bundle these mods. Install official releases from Modrinth or CurseForge under each mod's own license:
User-uploaded content
Discy lets players upload their own songs and disc textures at the DJ Deck or save designs from the Disc Design Studio. That content is created by players, not shipped with the mod.
- You are responsible for having the rights to any audio or images you upload.
- Do not upload copyrighted music or artwork without permission from the rights holder.
- Server owners may wish to set rules for what players may upload.
Discy stores uploads in the world's discy/ folder (songs, textures, sidecars). Removing content in-game deletes those files on the server.
Credits & assets
Bundled art in this repository is included with the creators' permission:
| Assets |
Credit |
| Mod code |
Alfie Lawrence |
| Mod icon, DJ Deck block textures, most item textures |
Random Nautilus |
| Sap textures, UI textures, Disc Design Studio block textures |
Mrdragonclaw |
Runtime-only references to vanilla Minecraft assets (for example the dispenser container GUI used by the DJ Deck screen) are not redistributed in this repository.
License
Discy mod code is licensed under the MIT License — see LICENSE.
Summary of other terms:
| Component |
License |
Where |
| Discy source & mod code |
MIT |
LICENSE |
| JLayer (bundled in release JARs) |
LGPL 2.1 |
COPYING.LGPL |
| All third-party notices |
— |
NOTICE |
LICENSE, NOTICE, and COPYING.LGPL are also packaged inside release JARs.
Third-party libraries (shipped in Discy JARs)
Discy bundles JLayer (javazoom:jlayer:1.0.1) for MP3 decoding.
Discy itself (excluding bundled third-party libraries) is MIT-licensed.
Optional mod compatibility (not included)
Discy provides optional integration with other mods via mixins and public APIs. Discy does not:
- Redistribute, patch, or repackage those mods
- Ship their source code, assets, or JARs
- Include modified versions of their files
Users must install compatible mods from their official authors. Discy only adds small optional mixins and API hooks when those mods are present at runtime.
- Sophisticated Core / Storage / Backpacks — copyright P3pp3rF1y, All Rights Reserved. Install from official releases only. Discy registers against public APIs (
IDiscHandler, SoundHandler) and does not redistribute or modify Sophisticated files.
- Let's Do Furniture — copyright the Furniture mod authors. Install from official releases only, under that mod's own license. Discy provides optional gramophone integration via mixin when Furniture is installed and does not redistribute or modify Furniture files.
If you publish forks or derivatives of Discy, keep these mods as separate optional runtime dependencies and retain NOTICE and COPYING.LGPL for JLayer.
评论 0
登录后参与评分
还没有评论,来抢沙发吧