PEMusix

模组

· 作者 MNT

按键盘按键以点击服务器端音乐箱中的槽位——为“Musix”/“악기”图形界面提供即时键盘播放功能。自动检测槽位布局,提供独立的鼓/乐器预设,以及每个音符的使用计数器。

0 本站下载 0 关注 更新于 1 个月前

最新 5.6.1 · 1.20.4 · Fabric

一键开服(送7天)

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 instruments
    • drum — 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

  1. Install the jar in your mods/ folder (Fabric 1.20.1 + Fabric API required)
  2. Join PlanetEarth Server (planetearth.kr)
  3. Open a music chest (e.g. 악기 - 하프) — the mod silently caches its slot layout
  4. Press \ (backslash, default menu key) — opens the Musix menu
  5. Click "자동 매핑" → slots align to the current chest
  6. Reopen the chest and play with the default key layout (or rebind via left-click on any row)
  7. 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 / high
  • Q 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 / high
  • Z 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 兼容
  • 支持 韩语 + 英语

使用方法

  1. 将 jar 安装至 mods/ 文件夹(需要 Fabric 1.20.1 + Fabric API)
  2. 加入 PlanetEarth 服务器 (planetearth.kr)
  3. 打开音乐箱子(例如:乐器的 - 竖琴)→ 模组会自动缓存槽位
  4. 按下 \(反斜杠,菜单默认键)→ 打开 Musix 菜单
  5. 点击 “自动映射” → 根据当前箱子对齐槽位
  6. 再次打开箱子,使用默认键位布局进行演奏(可在菜单中通过左键重新设置键位)
  7. 查看统计数据请点击菜单中的 “统计” 按钮。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 许可证。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源