ZhongLv-12ET

Features

Pure client-side mod.
Note Recognition: This mod can identify notes played in Minecraft, whether from note blocks, commands, or plugins; the recognized note directly displays in player chat hud. It is only applicable to the twelve-tone equal temperament. When processing microtones, it will be approximated to the nearest equal temperament.

Installation

Install Minecraft and Fabric Mod Loader;
Download Fabric API;
Download the mod;
Place the mod in mods folder.

Motivation

The inspiration for "ZhongLv-12ET" comes from a Boss mechanic in a DLC dungeon based on a DLC pack of PAN-GU CONTINENT server, where players need to accurately identify note names to complete challenges.

This mechanic sparked the idea to develop a client-side mod that automatically recognizes and displays note information, making it easier for players to handle note-related tasks in the game.

Sample

sample-en

References

When writing language files and calculating the pitch of notes, the following content is used:

[1] Wikipedia contributors. “Shi’er lü.” Wikipedia, 1 Sept. 2024, en.wikipedia.org/wiki/Shi%27er_l%C3%BC.

[2] Wikipedia contributors. “12 equal temperament.” Wikipedia, 4 June 2024, en.wikipedia.org/wiki/12_equal_temperament.

[3] Wikipedia contributors. “Chinese musicology.” Wikipedia, 7 July 2024, en.wikipedia.org/wiki/Chinese_musicology#Scale_and_tonality.

钟吕十二律

功能

纯粹的客户端 mod；
音符识别：该模组可以识别音符盒、命令和插件播放的音符，并将音符名称和音色直接显示在聊天区域中。仅适用于十二平均律，处理微分音时会近似到最近的平均律上。

安装

安装 Minecraft 本体和 Fabric Mod 加载器；
安装 Fabric API；
下载 .jar 模组文件；
将模组放进 mods 文件夹即可启用。

创作动机

我受到一个基于梦回盘灵（盘灵古域 DLC）的 DLC 副本机制的启发。该副本机制名为「钟吕符音」，意在使玩家辨认出音符并击杀对应怪物。

因为有很多玩家不具有识别具体音符的能力，拥有这个模组之后玩家可以知道到底播放了什么音符，可以更轻松的应对该机制。

使用效果

sample-h

参考资料

在撰写语言文件、计算音符音高中，使用到了以下内容：

[1] 维基媒体项目贡献者. “十二律.” 维基百科，自由的百科全书, 5 Aug. 2024, zh.wikipedia.org/wiki/%E5%8D%81%E4%BA%8C%E5%BE%8B.

[2] 维基媒体项目贡献者. “十二平均律.” 维基百科，自由的百科全书, 10 Apr. 2023, zh.wikipedia.org/wiki/%E5%8D%81%E4%BA%8C%E5%B9%B3%E5%9D%87%E5%BE%8B.

[3] 维基媒体项目贡献者. “中国五声音阶.” 维基百科，自由的百科全书, 3 July 2024, zh.wikipedia.org/zh-cn/%E4%B8%AD%E5%9C%8B%E4%BA%94%E8%81%B2%E9%9F%B3%E9%9A%8E.