Plugin Guide

プラグイン作成ガイド

MonoFlick のプラグインは、ゲームやアプリ向けの「キーの配置」を 1 つのファイル(.monoflickplugin)にしたものです。このページを AI(ChatGPT・Claude など)に渡すと、書式どおりのプラグインを作ってもらえます。自分で書くときの説明書としても使えます。

使い方(人向け)

  1. 下の「ガイドを全文コピー」を押し、AI との会話に貼り付けます。AI がウェブを読めるなら、このページの URL を渡すだけでもかまいません。
  2. 続けて、どのゲーム・アプリで、どんな操作を片手でしたいかを AI に伝えます(例:「Photoshop でブラシの大きさを変える・取り消す・手のひらツールを片手で」)。
  3. AI が出した JSON をファイルに保存し、名前の最後を .monoflickplugin にします(例: photoshop-1.0.0.monoflickplugin)。iPhone に AirDrop するか、iCloud Drive に置いて、ファイル App から「MonoFlick で開く」で入れます(MonoFlick 1.3.0 以降)。入れたものは設定の「プラグイン」から削除できます。
次のガイドに従って、MonoFlick(左手の iPhone で Mac に入力するアプリ)のプラグインを作ってください。
分からないこと(ゲームのキーの割り当て、よく使う操作、片手の持ち方など)は推測せず、先に私に質問してください。
最後に、プラグインの JSON を 1 つのコードブロックで出し、ファイル名の案(〜.monoflickplugin)も添えてください。

作りたいもの:
- (ここに、ゲーム・アプリの名前と、片手でしたい操作を書く)
  例: Photoshop で、ブラシの大きさ・取り消し・やり直し・手のひらツール・拡大縮小
  例: マインクラフト(Java 版)で、建築によく使う操作

MonoFlick のプラグインを作る AI へのガイド

このガイドは、MonoFlick のプラグインを初めて作る AI アシスタント向けです。利用者の代わりに、プラグインのファイル(JSON)を書くための書式と規則をまとめています。これは MonoFlick 1.3.0 の仕様です(出典: https://foo-tec.com/monoflick/plugin-guide.html)。

1. MonoFlick のプラグインとは

MonoFlick は、左手に持った iPhone から、Mac の前面のアプリへキーとマウスの操作を送るアプリです。iPhone の画面に並んだボタンを押すと、Mac でそのキーが押されます。

2. 利用者に確かめること

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 章)

言語ごとの名前(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:right
1 回で 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:releaseAlllatch: で押したままにしたキーをすべて離す
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 に、方向ごとに送るキーを書く。書かなかった方向は何もしない。動きは、斜めを割り当てたかどうかで変わる。

項目書き方内容
up down left right{"identifier": "w", "modifiers": 0}上下左右。1 つのキー
upLeft upRight downLeft downRight[{"identifier": "w", "modifiers": 0}, {"identifier": "a", "modifiers": 0}]斜め。配列で、並べたキーを同時に押す(W+A で斜め移動など)
tapModetrue / 省略8 方向のボタンで true にすると、押したままにせず、方向に入ったときに 1 回押して離す(F3+G のような同時押しを 1 回だけ送るとき)
repeatModetrue / 省略8 方向のボタンで true にすると、指を置いているあいだ繰り返し押す(矢印でカーソルを動かすなど)。tapMode より優先

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 でそのアプリが開きます。押した順に並び替わり、長押しで上に固定(ピン留め)できます。

項目必須内容
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. 出す前のチェックリスト

9. 利用者に伝える入れ方

  1. JSON をファイルに保存し、名前の最後を .monoflickplugin にする(例: photoshop-1.0.0.monoflickplugin)。
  2. iPhone に送る(AirDrop、または iCloud Drive に置く)。
  3. iPhone のファイル App でファイルを開き、共有から「MonoFlick」を選ぶ(または MonoFlick の設定 →「プラグイン」→「ファイルから追加」)。
  4. 確認の画面で「追加」。category に書いたカテゴリ(省略時はキーの配置が「Gamepad」、ランチャーのセットが「アプリ」)に並ぶ。新しいカテゴリなら上の段の後ろに増える。
  5. 直すときは、同じ id で packVersion を上げて入れ直すと置き換わる。

MonoFlick 1.3.0 以降が必要です。プラグインは iPhone の中だけに保存され、MonoFlick がインターネットに送ることはありません。