拡張機能のインポートと管理
管理ページは 設定 → 拡張機能 にあります。インポート直後の拡張機能は必ず無効なので、権限を確認してから有効化してください。
インポート
どちらの方法でも複数ファイルを一度に読み込めます。
| 方法 | 操作 | 備考 |
|---|---|---|
| ボタン | 「拡張機能をインポート」を押して複数選択 | .tmlext と .jar に対応 |
| ドラッグ＆ドロップ | ファイルをランチャーのウィンドウに落とす | 拡張機能ページでは両方の形式を受け付け、他のページでは .tmlext のみ処理（.jar は Mod として扱う） |
ページ上にドラッグすると「ここで離すと拡張を読み込みます」という全画面ヒントが出ます。一緒に落とした拡張機能以外のファイルは無視され、件数が表示されます。 管理者権限で起動している場合は別のドラッグ経路を通りますが、.tmlext は同じように拡張機能として読み込まれます。
TIP
インポートはデータフォルダの extensions/ に置くだけで、実行はされません。まず「詳細」で要求されている権限を確認しましょう。
画面の見方
上部にインストール数 / 有効数 / エラー数 / ランタイム不足の数が表示され、以下に拡張機能ごとのカードが並びます。
- 名前、バージョン、状態（有効 / 無効 / エラー / ランタイム不足）。
- 作者、ランタイム、パッケージ形式、展開済みかどうか。
- 説明、要求権限、購読イベント。
カードには 3 つのボタンがあります。
| ボタン | 動作 |
|---|---|
| 詳細 | 識別子・バージョン・作者・ランタイム・エントリ・対応プラットフォーム・権限・イベント・SHA-256・展開先・専用データ領域。エラー時はその内容も表示 |
| 有効化 / 無効化 | 有効化前に権限一覧を確認。無効化すると子プロセスを停止しますがファイルは残ります |
| アンインストール | 確認後にパッケージと専用データを削除 |
ページ上部に「更新」（extensions/ を再スキャン）と「フォルダを開く」もあります。
権限確認と自動起動
- 初回の有効化時に権限一覧が表示され、確認して初めて子プロセスが起動します。
- 一度確認したパッケージは記憶され、再度有効化しても確認は出ません。別のパッケージ、または内容が変わった場合（SHA-256 不一致）のみ再確認します。
- 前回終了時に有効だった拡張機能は、次回起動時に自動で開始されます。
- 有効状態と信頼情報は
extensions/trusted.jsonに記録されます。内容を書き換えると「拡張機能が変更されています」と表示され、読み込みが拒否されます。
うまくいかないとき
| 症状 | 対処 |
|---|---|
| ランタイム不足 | 対応する処理系を入れてから「更新」を押す。ランチャーは自動ダウンロードしません |
| 一覧に出ない | マニフェストの JSON エラー、または id の重複。logs/ext-*.log を確認 |
| 「エラー」と表示される | 「詳細」でエラー内容を確認 |
| ドロップしても何も起きない | 拡張子が .tmlext（拡張機能ページでは .jar も可）か、フォルダではなくファイルかを確認 |