mirror of
https://github.com/babalae/bettergi-scripts-list.git
synced 2026-11-17 04:17:45 +00:00
| Filename | Latest commit message | Latest commit date |
|---|---|---|
* Create mask-send.js * Create gridview.css * Add iconfont.css for icon font styles * Add iconfont.ttf * Add iconfont.woff * Add iconfont.woff2 * Add gridview.js,stately.js * Add index.html * Update YuanQinAssistant to v1.0.3 * Fix inline css in index.html * Remove font-size from iconfont class Removed font-size property from iconfont class. * Refactor gridview.css by removing unused styles Removed search row and button styles, updated file grid styles. * Update gridview.js The suggestion from coderabbitai will not work * Update README.md * Update settings.json |
||
| .. | ||
| assets | ||
| main.js | ||
| manifest.json | ||
| README.md | ||
| settings.json | ||
YuanQinAssistant
原琴助手BGI版是用于游戏中自动弹奏的脚本,使用gs2格式的曲谱,并提供方便的midi转谱工具。
内容清单
快速开始
- 在“全自动-调度器”中新建配置组,并添加此脚本。
- 点击运行即启动脚本,当游戏中进入演奏画面时,将自动弹出UI。通过隐藏按钮(眼睛图形)可以暂时隐藏UI,从其他界面再次切换到演奏画面时,UI将自动恢复显示。
- 曲谱文件保存在
assets/score/文件夹中,如果此文件夹中的内容发生变动,需要重新运行脚本后才能在列表中看到变化后的文件。
曲谱格式说明
脚本使用指令式的文本曲谱,每一行都代表一个指令,以“!xx/something”的形式出现。不符合此格式的行会被忽略,因此可以利用此特性在曲谱中插入注释文本。
- 文件头
!v/2
- 曲谱第一行固定为此内容。
- 说明性指令
!ti/标题
!au/发布人
!cp/作曲人
!ar/制谙人
- 说明曲谱文件的版权信息,非必须。这些指令不存在时会使用缺省值。
- 演奏参数指令
!gi/乐器编号
!di/四分音符的tick数
- 乐器编号用于说明曲谱适用的乐器,从0开始,非必须,缺省值为0,表示风物之诗琴。此指令在脚本中并无实际作用,是为手机端适配不同乐器而预留的。
- di指令用于指定MIDI规范中的division值,非必需,缺省值为480。改变此值相当于改变BPM,但需要和轨道事件中的变速事件结合,才能最终确定每个音符的时长。
- 轨道指令
!tr/事件序列
- 可以同时存在多个轨道指令,本脚本通过多个轨道事件的同步,来实现和弦功能。
- 事件序列由一串形如 1000n60 的文本组成,并以竖线
|分隔。其中1000表示此事件之前经过的时间,以tick数计算,具体可查询MIDI文件规范,此处不作讲解。n是事件类型,60是此事件的参数。 - 目前支持三种事件,分别为:
- n 按下音符,参数表示音符的音高(60即为C4)
- u 松开音符,参数含义同 n
- s 变速,参数表示接下来的microtempo值,单位是微秒
MIDI转谱
您完全可以通过文本编辑器来手动编辑一个gs2格式的曲谱文件,但并不建议这么做。本质上,gs2格式是因为BGI不支持二进制文件的读取,而不得不做的一个折中方案。使用现有的专业工具制作出mid格式文件,再使用我提供的转谱工具生成对应的gs2文件(工具放置于 assets/tool/ 文件夹下),是更直观且更安全的做法。
您需要注意的是,为了简化处理逻辑,转谱工具对mid文件的内容作了一些限制,比如不能使用异步多轨的格式,必须是C大调,导出midi文件时不要包含RPN和NRPN相关指令等等,更详细的会在之后用视频教程进行演示,普通用户完全不了解这些内容也不影响使用。
更新日志
v1.0.3 新增UI界面,不再需要通过配置组中的设置选择曲谱。支持播放/暂停、隐藏UI、退出按钮。支持曲谱搜索。不再支持半音修正。
v1.0.2 演奏开始后,自动将鼠标移动到右下角;增加乐器界面判定,只有在乐器演奏界面才会演奏曲谱;新增曲谱文件“此去半生”。
v1.0.1 修复音符B5的按键映射错误;修复脚本中止时,按键没有释放的问题;新增曲谱文件“枕边童话”“丝柯克小曲”;新增曲谱制作教程视频地址。
v1.0.0 发布原琴助手BGI版。