MuseScoreプラグイン開発ガイド

MuseScore 4.x 向けレガシー QML プラグインについて、環境構築・API・フォント・国際化をまとめています。

開発環境

VSCode での編集、Plugins フォルダへの配置、UI と動作のソース分割、終了・設定・フォント検査などの落とし穴を整理しています。

スコア操作・設定永続化・ログなど、4.4+ 向け JS ユーティリティ musescore-plugin-lib を紹介します。

OS インストール前提で、楽譜上に独自文字・記号を載せる手順と TTF/OTF の扱いを解説します。

数字譜向けの譜線非表示、改行、小節幅、音符のテキスト置換と位置補正を対応ごとにまとめます。

qsTr / qsTranslate、本体コンテキスト一覧、ts/qm コンパイルと GitHub Actions までを扱います。

ソース分割・musescore-plugin-lib・日本語 i18n を入れた雛形を GitHub からダウンロードできます。

ページ	内容
プラグイン開発の概要	拡張の種類、インストール、Hello World、単位系、編集パターン
API リファレンス	主要クラス・メソッド・列挙
開発ノウハウ	VSCode 環境、UI、ソース分割、import、実務の落とし穴
譜表・記譜操作	数字譜・譜線／記号非表示・改行・小節幅・テキスト置換
共有ライブラリ	musescore-plugin-lib（4.4+ 専用）
プラグインテンプレート	分割＋lib＋日本語の雛形（ZIP）
独自フォント開発	OS インストール、楽譜への記号、形式
国際化（i18n）開発	Linguist / lupdate / lrelease、4.x の注意
本体翻訳コンテキスト一覧	`qsTranslate` 用コンテキスト名
翻訳コンパイル自動化	スクリプトと GitHub Actions

本サイトの手順は、現時点で主流の MuseScore Studio 4.x（レガシー QML プラグイン）を主な対象としています。
参照ソースには MuseScore Studio 5.x（prerelease）も含まれます。5.x の Extensions（manifest.json + JS）については概要を参照してください。