Musix
⚠ 服务器专用模组 — 仅在 PlanetEarth Server (
planetearth.kr) 上有效。在其他服务器上无任何效果。
⚠ 서버 전용 모드 — PlanetEarth Server (
planetearth.kr) 에서만 작동합니다. 다른 서버에서는 아무 기능도 작동하지 않습니다.
English
Musix is a client-side Fabric mod that lets you play PlanetEarth's chest-GUI based instruments (악기 - 하프, 악기 - 베이스(드럼), ...) with your keyboard or a MIDI device. Press a key — the mod clicks the corresponding slot — the server plugin plays the note.
Features
- Keyboard input → slot click — auto-activates when the chest title starts with
음악or악기 - MIDI input support (v4.0.0) — connect any USB MIDI keyboard / pad device and play notes directly
- Statistics screen (v4.1.0) — live line chart of notes-per-minute (last 60 min), TOP 5 most-played notes, common vs drum preset ratio, session timer & total count
- Two presets, auto-selected by chest title
common— 49 notes (F#2 ~ F#6) for melodic instrumentsdrum— 12 notes (bass / hi-hat / snare / cymbal × low/mid/high) for(드럼)chests
- Auto-mapping — open a chest once, click "자동 매핑" in the menu → slots align to that chest's actual layout (item-name matching, falls back to index)
- Space + key modifier (v3.12.0) — natural notes on plain keys, sharps/flats on
Space + key(mirrors the user-exported default pattern) - In-game key rebinding — left-click row to capture next key, right-click to clear, ESC to restore default. Shift / Alt / Space combos supported
- Conflict detection with red flash on duplicates
- Key auto-repeat protection (v4.0.3) — holding a key only triggers one click, not a stream
- Persistent H2 storage — settings survive restarts, shaded into the jar so it works under Lunar Client / Ichor
- Korean + English locale
Usage
- Install the jar in your
mods/folder (Fabric 1.20.1 + Fabric API required) - Join PlanetEarth Server (
planetearth.kr) - Open a music chest (e.g.
악기 - 하프) — the mod silently caches its slot layout - Press
\(backslash, default menu key) — opens the Musix menu - Click "자동 매핑" → slots align to the current chest
- Reopen the chest and play with the default key layout (or rebind via left-click on any row)
- For statistics: menu → "통계" button. For MIDI: menu → "고급 설정" → "MIDI 입력"
Default key layout (common preset, 49 notes — natural + sharp)
| Row | Keys | Natural notes | Sharps (with Space) |
|---|---|---|---|
| 1 row | ` 1 2 3 |
G2 → B2 | F#2, G#2, A#2 |
| Q row | Q W E R U I O |
C3 → B3 | C#3, D#3, F#3, G#3, A#3 |
| A row | A S D F J K L |
C4 → B4 | C#4, D#4, F#4, G#4, A#4 |
| Z row | Z X C V M , . |
C5 → B5 | C#5, D#5, F#5, G#5, A#5 |
| extra | 7 8 9 0 |
C6 → F6 | C#6, D#6, F#6 |
Sharps and flats are played with
Space + key. Defaults follow the community export pattern; everything is rebindable in the menu.
Drum preset (auto when title contains (드럼))
12 notes / 4 rows. Slots auto-aligned on chest open via item-name matching.
1 2 3→ bass low / mid / highQ W E→ hi-hat low / mid / high (well, the row 2 keys — see in-game menu for the exact layout)A S D→ snare low / mid / highZ X C→ cymbal low / mid / high
Blocked slots (never mapped): 6, 19, 45, 53 — server GUI navigation slots.
MIDI input (v4.0.0+)
- Menu → 고급 설정 → MIDI 입력 — scans connected MIDI devices, click to connect
- Auto-reconnects on next launch if the device is still plugged in
- Async device scan / connection — won't freeze the client while LUA / scanners are slow
- Works alongside keyboard input — both feed the same slot-click pipeline
Statistics screen (v4.1.0+)
- Session info — start time, elapsed, total notes, average per minute, current-minute rate, last note played
- Line chart — notes-per-minute over the last 60 minutes (auto-scaling Y axis)
- TOP 5 notes — horizontal bar chart of your most-played notes
- Preset ratio — common vs drum percentage and absolute counts
- Reset button — clears all counters and restarts the session timer
Compatibility
- Minecraft 1.20.1 · Fabric Loader 0.15+ · Fabric API
- Lunar Client (Ichor) verified — H2 DB shaded into the jar to bypass ClassLoader isolation
- License: CC-BY-NC-SA-4.0
Source & Issues
- GitHub:
- Issues / suggestions: please file on GitHub
한국어
Musix 는 PlanetEarth 서버의 상자 GUI 기반 악기 (악기 - 하프, 악기 - 베이스(드럼) 등) 를 키보드 또는 MIDI 장치 로 연주할 수 있게 해주는 클라이언트용 Fabric 모드입니다. 키를 누르면 모드가 해당 슬롯을 클릭하고, 서버 플러그인이 음을 재생합니다.
주요 기능
- 键盘输入 → 槽位点击 — 当箱子标题以
音乐或乐器开头时自动生效 - 支持 MIDI 输入 (v4.0.0) — 连接 USB MIDI 键盘/打击垫设备,直接演奏
- 统计界面 (v4.1.0) — 每分钟输入折线图(最近 60 分钟)、TOP 5 音符、common vs drum preset 比例、会话计时器及总输入次数
- 2 个预设,根据箱子标题自动选择
common— 49 个音符 (F#2 ~ F#6) — 用于常规旋律乐器drum— 12 个音符 (低音/高音底鼓 / 踩镲 / 军鼓 / 钹 × 低中高) — 用于(drum)箱子
- 自动映射 — 打开箱子并在菜单中点击“自动映射” → 根据该箱子实际的槽位布局自动对齐(通过物品名称匹配,失败则回退到基于索引的匹配)
- Space + 键组合修饰符 (v3.12.0) — 白键仅按对应键,黑键为
Space + 相同键(遵循用户 export default 模式) - 游戏内重新设置按键 — 左键修改,右键取消设置,ESC 恢复默认。支持 Shift / Alt / Space 组合
- 冲突检测 + 红色高亮(拒绝重复按键)
- 防止按键自动重复 (v4.0.3) — 长按也仅触发一次点击
- H2 持久化存储 — 设置自动保存,通过 jar shade 处理实现与 Lunar Client / Ichor 兼容
- 支持 韩语 + 英语
使用方法
- 将 jar 安装至
mods/文件夹(需要 Fabric 1.20.1 + Fabric API) - 加入 PlanetEarth 服务器 (
planetearth.kr) - 打开音乐箱子(例如:
乐器的 - 竖琴)→ 模组会自动缓存槽位 - 按下
\(反斜杠,菜单默认键)→ 打开 Musix 菜单 - 点击 “自动映射” → 根据当前箱子对齐槽位
- 再次打开箱子,使用默认键位布局进行演奏(可在菜单中通过左键重新设置键位)
- 查看统计数据请点击菜单中的 “统计” 按钮。MIDI 设置请进入菜单 → “高级设置” → “MIDI 输入”
默认键位布局 (common preset, 49 音 — 本音 + 半音)
| 行 | 键 | 本音 (单独按键) | 半音 (Space + 键) |
|---|---|---|---|
| 第 1 行 | ` 1 2 3 |
G2 → B2 | F#2, G#2, A#2 |
| Q 行 | Q W E R U I O |
C3 → B3 | C#3, D#3, F#3, G#3, A#3 |
| A 行 | A S D F J K L |
C4 → B4 | C#4, D#4, F#4, G#4, A#4 |
| Z 行 | Z X C V M , . |
C5 → B5 | C#5, D#5, F#5, G#5, A#5 |
| 额外 | 7 8 9 0 |
C6 → F6 | C#6, D#6, F#6 |
半音 (
#) 通过Space + 相同键组合播放。所有键位均可在菜单中自由重新设置。
Drum preset (标题包含 (drum) 时自动激活)
12 个音符 / 4 行。打开箱子时通过物品名称匹配自动对齐槽位。
1 2 3→ 低音/中音/高音底鼓Q W E→ 低音/中音/高音踩镲(详细布局请参阅游戏内菜单)A S D→ 低音/中音/高音军鼓Z X C→ 低音/中音/高音钹
屏蔽槽位 (无映射): 6, 19, 45, 53 — 服务器 GUI 导航槽位。
MIDI 输入 (v4.0.0+)
- 菜单 → 高级设置 → MIDI 输入 — 扫描已连接的 MIDI 设备列表,点击即可连接
- 下次启动时若设备已连接,则自动重新连接
- 设备扫描/连接采用异步处理 — 防止因缓慢的 LUA/扫描器导致客户端卡死
- 可与键盘输入并行使用 — 两者均使用相同的槽位点击管道
统计界面 (v4.1.0+)
- 会话信息 — 开始时间、经过时间、总音符输入、每分钟平均值、当前分钟输入数、最后一个音符
- 折线图 — 最近 60 分钟每分钟输入趋势(Y 轴自动缩放)
- TOP 5 音符 — 最常按下的 5 个音符的条形图
- Preset 比例 — common vs drum 百分比及绝对数值
- 初始化按钮 — 重置所有计数器并重启会话计时器
兼容性
- Minecraft 1.20.1 · Fabric Loader 0.15+ · Fabric API
- Lunar Client (Ichor) 验证通过 — 通过 H2 DB shade 处理避免 ClassLoader 隔离问题
- 许可证: CC-BY-NC-SA-4.0
源代码与问题反馈
- GitHub:
- 问题/建议:请提交至 GitHub Issues
License
This work is licensed under CC BY-NC-SA 4.0. 本作品遵循 CC BY-NC-SA 4.0 许可证。
你是这个资源的作者?登录后可认领此资源。
相似资源
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
新增 50+ 个独特生物群系,为你的世界增添新树木、花卉等更多元素!
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
让你能够在世界中的任何位置定位结构。
添加睡袋和吊床,分别用于便携性和昼夜转换,同时不会设置新的出生点。共有16种颜色可选!
TerraFirmaCraft (TFC) 是一个全面转换模组,对生存模式进行了彻底的改造与重新设计。
评论 0
登录后参与评分
还没有评论,来抢沙发吧