MonoFlick のプラグインを作る AI へのガイド
このガイドは、MonoFlick のプラグインを初めて作る AI アシスタント向けです。利用者の代わりに、プラグインのファイル(JSON)を書くための書式と規則をまとめています。これは MonoFlick 1.3.0 の仕様です(出典: https://foo-tec.com/monoflick/plugin-guide.html)。
1. MonoFlick のプラグインとは
MonoFlick は、左手に持った iPhone から、Mac の前面のアプリへキーとマウスの操作を送るアプリです。iPhone の画面に並んだボタンを押すと、Mac でそのキーが押されます。
- プラグインは、iPhone の「Gamepad」の切り替えに並ぶ 1 枚の画面です。ボタンが横 3 列で、
bindingsの順に左上から右へ並びます(3 つで次の行)。 - 1 つのボタンは、押す(タップ・長押し)と、上下左右と斜めの 8 方向へのフリックに、それぞれ別のキーを割り当てられます。
- できること: キーを押す・同時に押す(⌘S などの修飾キーつき、複数のキー)・押したままにする・マウスのボタン・ポインタを画面の位置へ動かす。
- できないこと: 文字列をまとめて打つ(マクロ)・時間を置いた連続操作・条件分岐・プログラムの実行。プラグインに入るのはキーとポインタの操作だけです。
- Mac のキー配置は US 配列の位置で考えます(記号の名前は US 配列のキーの位置を指します)。
- もう 1 種類、Mac のアプリを開くボタンを並べる「ランチャーのセット」も作れます(7 章。iPhone の「アプリ」に並ぶ)。
2. 利用者に確かめること
- どのゲーム・アプリで使うか。ゲームなら版(例: マインクラフトは Java 版か統合版か。統合版はキーの割り当てが違う)。
- キーの割り当てを変えているか(既定のままか)。
- 片手でしたい操作と、よく使う順。ボタンは 3 列で、1 画面に 12 個(4 行)くらいが押しやすい。
- 押したままにしたい操作(しゃがみ・ダッシュ・ドラッグなど)があるか。
- 英語の画面でも使うか(使うなら
localizationsのenを入れる)。
3. ファイルの書式
中身は UTF-8 の JSON です。ファイル名の最後は .monoflickplugin。
トップレベル
| 項目 | 必須 | 内容 |
|---|---|---|
version | 必須 | 2 と書く(書式の版) |
kind | 必須 | "pack" と書く |
title | 必須 | 名前(切り替えに出る)。短く |
description | 必須 | 説明。入れる前の確認の画面と、画面の「説明」に出る。改行(\n)可。どのボタンが何をするかを書くとよい |
id | 推奨 | プラグインを見分ける文字列(例: com.example.monoflick.plugin.photoshop)。同じ id を入れ直すと置き換わる。省くと中身から決まる |
category | 任意 | 並ぶカテゴリ(iPhone の上の段)。"gamepad"(省略時)・"apps"(アプリ)・"keybinds"(KeyBinds)か、新しいカテゴリの ID(英小文字・数字・-・_・.、40 文字まで。例: "design")。"keyboard"・"launcher"・"group" は使えない |
categoryName | 新しいカテゴリでは必須 | 新しいカテゴリの名前(上の段に出る)。同じ category の ID を書いたプラグインは 1 つのカテゴリにまとまる |
categoryIcon | 任意 | 新しいカテゴリのアイコン(SF Symbols の名前) |
icon | 任意 | SF Symbols の名前(例: "cube.fill") |
packVersion | 任意 | プラグインの版(例: "1.0.0")。ファイル名にも入れる |
localizations | 任意 | 言語ごとの名前(下記) |
bindings | 必須 | ボタンの並び(1〜60 個) |
groups | 必須 | 空の配列 [] でよい(プラグインでは使わない) |
ボタン(bindings の 1 つ)
| 項目 | 必須 | 内容 |
|---|---|---|
packLocalId | 必須 | 1 から振る番号(ファイルの中で重ならない)。localizations の名前の鍵になる |
name | 必須 | ボタンの名前(空 "" でもよい。アイコンだけになる) |
icon | 必須 | SF Symbols の名前(空 "" でもよい) |
key | 必須 | 押したときに送るキーの名前(一覧)。空 "" なら押しても何も送らない(フリックだけのボタン) |
modifiers | 必須 | 修飾キーの数(一覧の最後)。無ければ 0 |
additionalKeystrokes | 任意 | key と同時に押すキーの配列([{"identifier": "w", "modifiers": 0}]) |
flickAssignments | 任意 | フリックの割り当て(5 章) |
- 空き:
keyとiconがどちらも空で、フリックも無いボタンは、配置のための空き(見えない枠)になる。列をそろえるのに使う。 nameKeyという項目はプラグインでは使えない(アプリの中の翻訳を引く仕組みのため)。名前はnameとlocalizationsに書く。
言語ごとの名前(localizations)
言語("en"・"ja" など)ごとに、title・description・names(packLocalId を文字列にしたもの → ボタンの名前)・categoryName(新しいカテゴリの名前)を書く。どれも省略できる。端末とアプリの言語に合うものが使われ、無ければ本体の title・name が出る。
"localizations": {
"en": {
"title": "Editor Basics",
"description": "Save, undo, redo and find with one hand.",
"names": { "1": "Save", "2": "Undo" }
}
}
4. キーの名前の一覧
この一覧は MonoFlick のコードから作っています(monoflick-key-names/1)。ここに無い名前は、読み込むときに断られます。
そのまま使える名前
| 種類 | 名前 |
|---|---|
| 英字 Letters | a b c d e f g h i j k l m n o p q r s t u v w x y z小文字だけ。大文字は modifiers に shift(8)を足す |
| 数字 Digits | 0 1 2 3 4 5 6 7 8 9 |
| 記号(US 配列の位置) Punctuation (US layout) | minus equal leftBracket rightBracket semicolon quote backtick comma period slash backslash |
| 移動・編集 Navigation and editing | tab escape return space delete forwardDelete home end pageUp pageDown arrowLeft arrowRight arrowDown arrowUp |
| ファンクションキー Function keys | f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12 |
| 修飾キー単独 Modifier keys alone | shiftKey commandKey optionKey controlKey修飾キーだけを押す(しゃがみなど)。押したままにするなら toggle:shiftKey など |
| マウスのボタン Mouse buttons | mouseLeft mouseMiddle mouseRight押しているあいだボタンを押したまま、離すと離す |
| 画面ジャンプ(ポインタを画面の位置へ) Pointer jump | pointerWarp:topLeft pointerWarp:topCenter pointerWarp:topRight pointerWarp:middleLeft pointerWarp:center pointerWarp:middleRight pointerWarp:bottomLeft pointerWarp:bottomCenter pointerWarp:bottomRight |
| ポインタを少し動かす Pointer nudge | pointerNudge:up pointerNudge:down pointerNudge:left pointerNudge:right1 回で 48 px |
名前の前に付けて使う形
| 形 | 動き | 例 |
|---|---|---|
toggle:<キー> | 押すとそのキー(またはマウスのボタン)を押したままにし、もう一度押すと離す Press to hold the key (or mouse button); press again to release | toggle:shiftKey toggle:space toggle:mouseLeft |
latch:<キー> | 押すとそのキーを押したままにする。離すのは latch:releaseAll Press to hold the key; release with latch:releaseAll | latch:shiftKey latch:mouseLeft |
latch:releaseAll | latch: で押したままにしたキーをすべて離す Release every key held with latch: | latch:releaseAll |
doubleTap:<キー> | 1 回たたいてから押したままにする(W の 2 回押しでダッシュ、など) Tap once, then hold (e.g. double-tap W to sprint) | doubleTap:w |
修飾キー(modifiers)
足し合わせた数を書く: command = 1, option = 2, control = 4, shift = 8。例: ⌘⇧ は 1 + 8 = 9。
5. フリックの割り当て
flickAssignments に、方向ごとに送るキーを書く。書かなかった方向は何もしない。動きは、斜めを割り当てたかどうかで変わる。
- 上下左右だけのボタン: フリックすると、そのキーを 1 回押して離す。
- 斜めを 1 つでも割り当てたボタン(8 方向のボタン): 指を滑らせた方向のキーを、指を置いているあいだ押したままにする(方向を変えると切り替わる)。移動(WASD と斜め)に向く。
| 項目 | 書き方 | 内容 |
|---|---|---|
up down left right | {"identifier": "w", "modifiers": 0} | 上下左右。1 つのキー |
upLeft upRight downLeft downRight | [{"identifier": "w", "modifiers": 0}, {"identifier": "a", "modifiers": 0}] | 斜め。配列で、並べたキーを同時に押す(W+A で斜め移動など) |
tapMode | true / 省略 | 8 方向のボタンで true にすると、押したままにせず、方向に入ったときに 1 回押して離す(F3+G のような同時押しを 1 回だけ送るとき) |
repeatMode | true / 省略 | 8 方向のボタンで true にすると、指を置いているあいだ繰り返し押す(矢印でカーソルを動かすなど)。tapMode より優先 |
- ボタンの中央を押したときは
keyが送られる。押したままにすると、指を離すまで押したまま。 - F3+G のような「キーを押しながら別のキー」は、斜めの配列に 2 つ並べ、
tapMode: trueにする。
6. 例
最小の例(エディタの基本)
⌘S・⌘Z(上フリックで ⌘⇧Z)・⌘F の 3 つのボタン。
{
"version": 2,
"kind": "pack",
"id": "com.example.monoflick.plugin.editor",
"category": "gamepad",
"title": "エディタの基本",
"description": "保存・取り消し・やり直し・検索を片手で。",
"icon": "pencil.and.outline",
"packVersion": "1.0.0",
"localizations": {
"en": {
"title": "Editor Basics",
"description": "Save, undo, redo and find with one hand.",
"names": {
"1": "Save",
"2": "Undo",
"3": "Find"
}
}
},
"bindings": [
{
"packLocalId": 1,
"name": "保存",
"icon": "square.and.arrow.down",
"key": "s",
"modifiers": 1
},
{
"packLocalId": 2,
"name": "取り消し",
"icon": "arrow.uturn.backward",
"key": "z",
"modifiers": 1,
"flickAssignments": {
"up": {
"identifier": "z",
"modifiers": 9
}
}
},
{
"packLocalId": 3,
"name": "検索",
"icon": "magnifyingglass",
"key": "f",
"modifiers": 1
}
],
"groups": []
}
基本のショートカット
アプリに最初から入っているキーバインド 8 個を、そのままプラグインにしたものです(basic-shortcuts-1.0.0.monoflickplugin、category: "keybinds")。ファンクションキーの 8 方向フリック、押したままで繰り返す矢印(repeatMode)、⌘ や ⇧ を組み合わせた編集の操作の書き方の見本になります。
マインクラフト(Java 版)の全文
foo-tec.com で配っているプラグインそのものです(minecraft-1.0.0.monoflickplugin)。移動(WASD と斜め)・ジャンプ・しゃがみ(押したまま)・ホットバー・インベントリ・左右クリック・F3 のデバッグ操作。
{
"version": 2,
"kind": "pack",
"id": "dev.foo.monoflick.plugin.minecraft",
"category": "gamepad",
"title": "マイクラ",
"description": "Minecraft の操作に最適化されたキーバインドです(Java Edition のデフォルトキー割当を前提)。3×4 グリッドの 10 セル(+ 透明枠 2 つ)に移動・ホットバー切替・デバッグ・インタラクション・toggle latch・通常マウスクリックを集約し、片手フリック入力で本格プレイができるよう設計されています。\n\n※ Bedrock Edition(統合版 / 家庭用機 / モバイル)はキー割当 / 内部実装が大きく異なるため非対応です。\n\n● F3(上段・左)— タップで F3 デバッグ画面。↑=プレイヤー一覧(Tab)、↓=視点切替(F5)、斜めフリックで F3+G チャンク / F3+B エンティティ / F3+P 一時停止 / F3+T リソース再読込。\n\n● 5(上段・中央)— ホットバー 1〜9 のスロット切替。中央タップで 5、周囲 8 方向は電卓配置(↖=1, ↑=2, ... , ↘=9)。\n\n● 中断(上段・右)— Esc(メニューを開く)。\n\n● 持物(中段・中央)— タップでインベントリ(E)、↓=アイテム投棄(Q)、←=持ち替え(F)、→=チャット(T)。\n\n● 3 つの toggle latch — Shift(中段・左、しゃがみ継続)/ 左クリック(中段・右、採掘・攻撃継続)/ Space(下段・左、ジャンプ継続)。タップで latch、もう一度タップで解除。指を離してもキーが保持されるので「ジャンプしながら移動」「shift 状態のまま視点操作」などの並列操作ができます。\n\n● 跳(下段・中央)— タップでジャンプ(Space)、上下左右と斜めのフリックで WASD 移動 + 斜め歩行。\n\n● 左クリック / 右クリック(最下段の中央・右)— 通常のマウスクリック。タップで 1 回クリック、長押し中は押し続け、指を離した瞬間に解放。ブロック設置 / 盾構え / クラフト UI 操作 / インベントリ内アイテム移動など、latch せず瞬間操作したい場面に使います。",
"icon": "cube.fill",
"packVersion": "1.0.0",
"localizations": {
"en": {
"title": "Minecraft",
"description": "A keybind layout optimized for Minecraft (designed for the Java Edition's default key bindings). Ten cells in a 3×4 grid (plus two empty placeholder slots) bundle movement, hotbar switching, debug, interaction, toggle latches, and regular mouse clicks — designed for serious one-handed flick-input play.\n\nNote: Bedrock Edition (Windows 10 / consoles / mobile) uses different key bindings and internals and is not supported by this layout.\n\n● F3 (top row, left) — Tap toggles the F3 debug overlay. ↑ = player list (Tab), ↓ = camera angle (F5), diagonal flicks send F3+G chunks / F3+B entities / F3+P auto-pause / F3+T reload resources.\n\n● 5 (top row, center) — Switch hotbar slots 1–9. Center tap selects slot 5; the 8 flick directions follow a numpad layout (↖=1, ↑=2, …, ↘=9).\n\n● Esc (top row, right) — Esc (open the menu).\n\n● Inventory (middle row, center) — Tap to open inventory (E). ↓ = drop item (Q), ← = swap hand (F), → = chat (T).\n\n● Three toggle latches — Shift (middle-left, continuous sneak), left-click (middle-right, continuous mining / attack), and Space (bottom-left, continuous jumping). Tap to latch; tap again to release. Because the key stays held after you lift your finger, you can run parallel actions like “jumping while moving” or “looking around while shift is held.”\n\n● Jump (bottom row, center) — Tap for Jump (Space). Cardinal and diagonal flicks send WASD movement plus diagonal walking.\n\n● Left-click / Right-click (last row, center and right) — Regular mouse clicks. Tap for a single click, hold to keep pressed, release on lift. Use them for placing blocks, raising the shield, crafting UI, or moving items in the inventory — single-shot actions that don't need a latch.",
"names": {
"3": "Pause",
"11": "Left",
"12": "Right"
},
"groupNames": {
"1": "Minecraft"
}
}
},
"bindings": [
{
"packLocalId": 1,
"name": "",
"icon": "ladybug",
"key": "f3",
"modifiers": 0,
"flickAssignments": {
"up": {
"identifier": "tab",
"modifiers": 0
},
"down": {
"identifier": "f5",
"modifiers": 0
},
"upLeft": [
{
"identifier": "f3",
"modifiers": 0
},
{
"identifier": "g",
"modifiers": 0
}
],
"upRight": [
{
"identifier": "f3",
"modifiers": 0
},
{
"identifier": "b",
"modifiers": 0
}
],
"downLeft": [
{
"identifier": "f3",
"modifiers": 0
},
{
"identifier": "p",
"modifiers": 0
}
],
"downRight": [
{
"identifier": "f3",
"modifiers": 0
},
{
"identifier": "t",
"modifiers": 0
}
],
"tapMode": true
}
},
{
"packLocalId": 2,
"name": "",
"icon": "5.square",
"key": "5",
"modifiers": 0,
"flickAssignments": {
"up": {
"identifier": "2",
"modifiers": 0
},
"down": {
"identifier": "8",
"modifiers": 0
},
"left": {
"identifier": "4",
"modifiers": 0
},
"right": {
"identifier": "6",
"modifiers": 0
},
"upLeft": [
{
"identifier": "1",
"modifiers": 0
}
],
"upRight": [
{
"identifier": "3",
"modifiers": 0
}
],
"downLeft": [
{
"identifier": "7",
"modifiers": 0
}
],
"downRight": [
{
"identifier": "9",
"modifiers": 0
}
]
}
},
{
"packLocalId": 3,
"name": "中断",
"icon": "escape",
"key": "escape",
"modifiers": 0
},
{
"packLocalId": 4,
"name": "",
"icon": "shift",
"key": "toggle:shiftKey",
"modifiers": 0
},
{
"packLocalId": 5,
"name": "",
"icon": "bag",
"key": "e",
"modifiers": 0,
"flickAssignments": {
"up": {
"identifier": "e",
"modifiers": 0
},
"down": {
"identifier": "q",
"modifiers": 0
},
"left": {
"identifier": "f",
"modifiers": 0
},
"right": {
"identifier": "t",
"modifiers": 0
}
}
},
{
"packLocalId": 6,
"name": "",
"icon": "cursorarrow.click",
"key": "toggle:mouseLeft",
"modifiers": 0
},
{
"packLocalId": 7,
"name": "",
"icon": "space",
"key": "toggle:space",
"modifiers": 0
},
{
"packLocalId": 8,
"name": "",
"icon": "space",
"key": "space",
"modifiers": 0,
"flickAssignments": {
"up": {
"identifier": "w",
"modifiers": 0
},
"down": {
"identifier": "s",
"modifiers": 0
},
"left": {
"identifier": "a",
"modifiers": 0
},
"right": {
"identifier": "d",
"modifiers": 0
},
"upLeft": [
{
"identifier": "w",
"modifiers": 0
},
{
"identifier": "a",
"modifiers": 0
}
],
"upRight": [
{
"identifier": "w",
"modifiers": 0
},
{
"identifier": "d",
"modifiers": 0
}
],
"downLeft": [
{
"identifier": "s",
"modifiers": 0
},
{
"identifier": "a",
"modifiers": 0
}
],
"downRight": [
{
"identifier": "s",
"modifiers": 0
},
{
"identifier": "d",
"modifiers": 0
}
]
}
},
{
"packLocalId": 9,
"name": "",
"icon": "",
"key": "",
"modifiers": 0
},
{
"packLocalId": 10,
"name": "",
"icon": "",
"key": "",
"modifiers": 0
},
{
"packLocalId": 11,
"name": "左",
"icon": "cursorarrow.click",
"key": "mouseLeft",
"modifiers": 0
},
{
"packLocalId": 12,
"name": "右",
"icon": "cursorarrow.click",
"key": "mouseRight",
"modifiers": 0
}
],
"groups": [
{
"packLocalId": 1,
"name": "マイクラ",
"icon": "cube.fill",
"bindingPackLocalIds": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12
]
}
]
}
7. ランチャーのセット(アプリを開くプラグイン)
Mac のアプリを開くボタンを並べたプラグインです。iPhone の「アプリ」の切り替えに 1 つの画面として並び、ボタンを押すと Mac でそのアプリが開きます。押した順に並び替わり、長押しで上に固定(ピン留め)できます。
- アプリは Bundle ID で指定します。Mac のターミナルで
osascript -e 'id of app "Xcode"'と打つと調べられます(例:com.apple.dt.Xcode)。推測で書かず、利用者に調べてもらってください。 - 書けないもの: アプリのファイルの場所(
path)と起動引数(arguments)。書いてあると読み込みを断ります。必要なら、利用者が MonoFlick の設定の「ランチャー」に自分で登録します。
| 項目 | 必須 | 内容 |
|---|---|---|
kind | 必須 | "launcher" と書く |
v | 必須 | 1 と書く(書式の版) |
name | 必須 | 名前(切り替えに出る) |
id | 推奨 | 見分ける文字列。同じ id を入れ直すと置き換わる。キーの配置のプラグインと同じ id は使えない |
description | 任意 | 説明(確認の画面と「説明」に出る) |
icon | 任意 | SF Symbols の名前 |
version | 任意 | セットの版(例: "1.0.0") |
localizations | 任意 | 言語ごとの name・description・categoryName |
category / categoryName / categoryIcon | 任意 | 並ぶカテゴリ。キーの配置と同じ書き方で、省略時は "apps"(アプリ) |
entries | 必須 | アプリの並び(1〜60 個)。1 つは name(必須)・bundleID(必須)・icon(任意、SF Symbols)・localizations(任意、言語ごとの name)。同じ bundleID は 1 回だけ |
{
"kind": "launcher",
"v": 1,
"id": "com.example.monoflick.launcher.dev",
"name": "開発",
"version": "1.0.0",
"localizations": { "en": { "name": "Dev" } },
"entries": [
{ "name": "Xcode", "icon": "hammer", "bundleID": "com.apple.dt.Xcode" },
{ "name": "ターミナル", "icon": "terminal", "bundleID": "com.apple.Terminal",
"localizations": { "en": { "name": "Terminal" } } }
]
}
ランチャーのセットのファイル名も、最後を .monoflickplugin にします(例: dev-1.0.0.monoflickplugin)。
8. 出す前のチェックリスト
- JSON として正しい(カンマの過不足・引用符)。
versionは2、kindは"pack"、groupsは[]。 - すべてのキーの名前が一覧にある(
key・additionalKeystrokes・flickAssignmentsの中も)。大文字は使わず、modifiersに shift(8)を足す。 packLocalIdが 1 から重ならずに振られている。ボタンは 60 個まで、ファイルは 256 KB まで。- 3 列で並ぶことを考えて、よく使うボタンを押しやすい位置(下の方・親指の届く側)に置いた。列をそろえるのに空きを使った。
- ⌘Q(アプリの終了)など、間違えて押すと困る操作を入れるなら、利用者に確かめた(入れるときに注意が出る)。
- 英語でも使うなら
localizations.enにtitle・description・namesを入れた。 descriptionに、どのボタンが何をするかを書いた(画面の「説明」に出る)。- 新しいカテゴリを作るなら、
categoryの ID が英小文字・数字・-・_・.だけで、categoryNameがある。 - ランチャーのセットなら:
kindは"launcher"、vは1。bundleIDは利用者に調べてもらった値で、重なりが無い。path・argumentsは書いていない。
9. 利用者に伝える入れ方
- JSON をファイルに保存し、名前の最後を
.monoflickpluginにする(例:photoshop-1.0.0.monoflickplugin)。 - iPhone に送る(AirDrop、または iCloud Drive に置く)。
- iPhone のファイル App でファイルを開き、共有から「MonoFlick」を選ぶ(または MonoFlick の設定 →「プラグイン」→「ファイルから追加」)。
- 確認の画面で「追加」。
categoryに書いたカテゴリ(省略時はキーの配置が「Gamepad」、ランチャーのセットが「アプリ」)に並ぶ。新しいカテゴリなら上の段の後ろに増える。 - 直すときは、同じ
idでpackVersionを上げて入れ直すと置き換わる。
MonoFlick 1.3.0 以降が必要です。プラグインは iPhone の中だけに保存され、MonoFlick がインターネットに送ることはありません。