01 · 製品紹介
ローカル・デスクトップ自動化
メイプルストーリー Classic World 自動狩りツール
Global MapleStory Classic World向けに設定できる、Windows 10/11・AppleシリコンMac・Intel Mac用の自動狩りツールです。画面認識と指定したキー操作で狩り、回復薬、バフを自動化します。定点攻撃、2地点の巡回、自作ルートから選び、キャラクターとモンスターのテンプレートは実際に使うゲーム環境で撮影します。
- 対応OS
- Windows 10/11 · AppleシリコンMac / Intel Mac
- 処理方式
- ローカル画像認識
Classic Worldでの動作の仕組み#
デスクトップアプリが表示中のゲーム画面からキャラクター、対象モンスター、ミニマップ、HP/MPを認識し、保存した設定に従ってローカルのキー入力を送ります。ゲームのパスワードは不要です。ブラウザのマップエディターはルートファイルを作るためのもので、Botの実行はパソコン側で行います。更新や表示の変更で互換性が変わるため、購入前にサーバー、ゲームのバージョン、OSをサポートへ確認してください。
デスクトップクライアントで自動化できること#
最小構成で認識を確認し、実行ログを見ながらオプション機能を一つずつ有効にしてください。
キャラクターとモンスターの認識
キャラクターと対象モンスターの左右向き画像テンプレートを作成し、画面内の対象を検出します。
狩り・ファームルート
定位置攻撃、2地点往復、マップエディターで自作した多層マップルートを選択できます。
ポーションとバフの自動化
HP/MPしきい値、ポーションキー、クールダウン、最大5枠の定期バフを設定できます。
拾得と戦闘操作
攻撃、ジャンプ、アイテム拾得、方向転換、戦略ごとの動作間隔を一つの画面で設定します。
実行ログと起動チェック
戦略開始前にゲーム画面、ミニマップ、キャラクター、モンスター、HP/MPの認識結果を確認できます。
ローカル設定とルート
設定、ユーザーテンプレート、マップルートファイルを端末内に保存し、テストと調整を繰り返せます。
利用前の準備#
- 64ビットWindows 10/11、またはAppleシリコン(Mシリーズ、macOS 11以降)かIntel(macOS 12以降)のMac
- ミニマップを表示したメイプルストーリー画面
- macOSの「アクセシビリティ」と「画面収録とシステムオーディオ録音」権限
- 有効なライセンスと初回有効化時のネット接続
- 実際に使用するOSとゲーム環境で取得したテンプレート
メイプルストーリー Classic World 自動狩りFAQ#
WindowsとmacOSに対応していますか?+
64ビットWindows 10/11、AppleシリコンMac(macOS 11以降)、Intel Mac(macOS 12以降)に対応し、チップごとに別のMac用パッケージを提供しています。
購入前に確認するClassic Worldのバージョン情報は?+
本ガイドはGlobal MapleStory Classic Worldを中心に説明しています。互換性はサーバー、ゲームのバージョン、OS、現在のゲームUIによって異なります。購入前にこれらの情報をhi@okya.appへお知らせください。クラシック版という名称だけで、すべてのサーバーや更新後の環境に同じ設定が使えるとは限りません。
ブラウザで動くBotですか?インストールは必要ですか?+
Botは有料ライセンスが必要なデスクトップアプリで、WindowsまたはMac上で動作します。マップルートエディターは無料のブラウザツールです。画像を読み込み、ノードと移動アクションを設定してJSONを書き出し、アプリに取り込みます。エディター自体はゲームやBotを実行しません。
購入後、ライセンスとアプリはどこで受け取れますか?+
月間 $19 / 30日、四半期 $39 / 90日、年間 $99 / 365日。すべての自動化機能を含みます。永久版の販売は終了しました。 入金確認後、注文ページにライセンスキーとWindows用・AppleシリコンMac用のダウンロードボタンが表示されます。公式の注文ページからダウンロードし、以下の手順でインストールと初期設定を行ってください。
02
使用ガイド
ゲーム画面#
インストール・権限・ライセンス認証#
OS に合ったパッケージを導入し、プラットフォーム固有の確認を終えてから戦略を設定します。
Windows
64 ビット版 ZIP を固定フォルダーへ完全に展開し、ZIP のプレビュー内からは起動しないでください。管理者権限でプログラムを実行してください。
Macへのインストール
最初に App を「アプリケーション」へ移動し、「アクセシビリティ」と「画面収録とシステムオーディオ」を許可します。完全終了後に再起動してください。お使いのチップ(Apple siliconまたはIntel)に合うパッケージを使用してください。
macOS 権限の確認
「アクセシビリティ」はキー入力、「画面収録とシステムオーディオ」はゲーム画面・キャラクター・ミニマップ・HP/MP の読み取りに使います。Terminal、Python、旧版、同名フォルダーではなく「アプリケーション」内の正式 App を両方に追加し、有効化後に Command-Q で完全終了して再起動してください。
認証とローカルデータ
前後に空白を付けず完全なライセンスを入力し、オンライン認証の完了を待ちます。macOS のキーチェーン表示ではライセンスではなく Mac のログインパスワードを入力します。データは Windows の %LOCALAPPDATA%\Okya\、macOS の ~/Library/Application Support/Okya/ に保存されます。config.json、templates、maps のみをバックアップし、license.dat は移動しないでください。
安定した認識テンプレートを作る#
実際に使用する OS とゲーム環境で、左右両方向を取得します。
キャラクター(固定 15 × 15 px)
プロフィールを作成して名前を付けます。左向きで頭部上側の安定した部分を取得し、右向きでもまったく同じ部位を選択します。両方のプレビューにキャラクターだけが含まれることを確認して保存・選択します。
モンスター(固定 10 × 10 px)
動きとフレーム数が少ない種類を優先します。安定したフレームで、頭頂部・角・目の周辺など同じ特徴部分を左右とも取得してください。最初は 1 種類、通常は 1~3 種類が安定します。
良いサンプルと悪いサンプル
良いペアは左右の位置が同じで対象のみを含みます。地面、足場の端、背景、名前、ダメージ、チャット、ペット、スキル効果、別のモンスターを含む場合は再取得してください。
再取得が必要なとき
外見、エフェクト、ゲームクライアント、OS を変更した場合は、すべてのテンプレートを再取得してください。Windows と macOS ではピクセル表示も異なる場合があります。
初回セットアップ#
以下は実際のデスクトップクライアントと初回利用ガイドに基づく手順です。
- 1
64ビットWindows、AppleシリコンMac、Intel Mac用の正しいパッケージをインストールします。macOSでは権限を付与する前にAppを「アプリケーション」へ移動します。
- 2
ゲームをウィンドウまたはボーダーレスウィンドウで表示し、主画面でミニマップとHP/MP領域をすべて見える状態にします。
- 3
ライセンスを有効化し、実際のゲームサーバーを選択して対応するミニマップ色とHP/MP認識領域を使用します。
- 4
キャラクターと対象モンスターの左右向きテンプレートをそれぞれ取得します。OS、外見、クライアントを変更した場合は再取得してください。
- 5
最初のテストでは「定位置攻撃」を選び、キャラクター、モンスター1種類、攻撃キー、ジャンプキーだけを設定します。
- 6
戦略を開始して実行ログを確認します。キャラクターとミニマップの認識が成功してから、ポーション、バフ、拾得を順に有効にします。
モード・戦闘・オプション設定#
一度に 1 項目だけ変更して保存し、ログで確認してから次を有効にします。
ゲーム画面と基本設定
メイン画面でウィンドウまたはボーダーレス表示を使い、ミニマップを展開して HP/MP を既定位置に保ちます。実際のサーバー、保存済みキャラクター、モンスター 1 種類を選択し、嘘発見器アラートの音声テストを行ってください。
診断モード
認識のみでゲーム画面、キャラクター、モンスター、ミニマップ、HP/MP を確認します。移動のみで巡回やルートを検証し、両方が正常になってから完全実行を使用します。
戦闘と移動
攻撃・ジャンプキーをゲーム内設定と一致させます。別の足場を誤追跡しないよう、水平・垂直範囲は控えめな値から調整します。
ポーション・バフ・拾得
HP/MP は 50% と約 1 秒の待機時間から試し、0.1 秒未満にはしません。最大 5 枠のバフは 1 枠ずつ確認します。拾得は 0.45 秒が安定した開始値で、最小は 0.05 秒です。短すぎる間隔は戦闘を妨げます。
初回の完全実行
対象マップでミニマップと HP/MP を確認し、サーバー、キャラクター、モンスター、戦略、キーを保存します。安全な位置から開始し、App がゲームへフォーカスを戻すまで待って切り替えないでください。ログですべての起動確認が成功して初めて実行中です。
30 秒の起動前確認
正しいマップと安全位置、メイン画面のゲーム、展開したミニマップ、正しいサーバー・プロフィール・モンスター・戦略、各キー、十分な消耗品と空き容量、聞こえるアラートを確認します。
3種類のマップ戦略#
マップ形状に合う戦略を選択してください。新しい設定では、オプション動作を加える前に移動だけをテストします。
定位置攻撃
初回テストと固定足場向けです。開始時のミニマップ位置を記録し、ノックバックやずれが生じた場合に元の位置への復帰を試みます。
2地点往復
ミニマップ上の水平A/B座標間を移動し、端点での待機時間や端点だけで攻撃するかを設定できます。
カスタムルート巡回
マップエディターで作成したノード、足場、動作に従います。ルートは現在のマップと一致する必要があります。
カスタムBotルートを作成して使う#
マップエディターでは、特定のマップをBotがどのように移動するかを定義できます。デスクトップクライアントで実際に使うマップとゲーム画面に合わせて作成してください。
3ステップでマップルートを作成
- 1実際に使用するマップを読み込む
デスクトップクライアントで使うものと同じマップ、ウィンドウモード、ミニマップ配置でゲームを起動し、現在の画面を撮影します。エディターで「マップを読み込む」を選択してください。攻略サイトの画像、拡大縮小した画像、別環境のスクリーンショットは座標が一致しないため使用しないでください。
- 2左上のミニマップ範囲を切り抜く
「切り抜き」を選び、表示中のミニマップの左上、右下の順にクリックして保存します。移動できる足場、ロープ、はしご、ポータルをすべて含め、ゲーム画面、チャット、クエスト通知などミニマップ外のUIは除外します。保存前にデスクトップクライアントが認識する範囲と一致しているか確認してください。
- 3ノードを配置してルートを作る
「ノード」で方向転換、着地、ロープやはしごの入口、ポータルに点を置きます。必要に応じて足場を描き、隣接ノードを接続して歩行、ジャンプ、登り、下ジャンプ、テレポートを指定します。ルートを書き出して同じマップのデスクトップクライアントへ読み込み、戦闘や拾得の前に移動だけをテストします。
更新・バックアップ・サポート#
確認済み設定を保存しつつ、端末に紐づくライセンス情報や機密情報は移動しません。
更新前
戦略を停止して終了し、config.json、templates、maps をバックアップします。更新後にバージョン、サーバー、テンプレート、キー、戦略を確認します。
別の端末へ移行
通常設定とルートは確認後に移行できますが、license.dat は移行しません。新しい端末で認証・権限設定・テンプレート再取得を行います。
紐付けデバイスの変更
ライセンスは最初に認証したデバイスに紐付けられます。パソコンの買い替え、OS の再インストール、ハードウェア交換で紐付けを変更する場合は、注文番号を添えてサポート(hi@okya.app)へご連絡ください。license.dat を新しいデバイスへコピーしないでください。
サポートへ連絡
バージョン、OS とチップ、サーバー、表示モード、戦略、主要設定、最初の失敗までのログを添付し、ライセンスや端末 ID、アカウント名は削除してください。
03
トラブルシューティング
症状を見つけて手順どおりに対処し、解決したらそこで止めてください。個別の問題を調べる前に、まず基本設定を済ませてください。
正しい順序でトラブルを切り分ける#
ログで最初に失敗した起動チェックから修正します。
ゲームウィンドウが見つからない
メイン画面でウィンドウまたはボーダーレス表示にします。macOS は画面収録権限を確認して App を再起動します。
認識に失敗する
遮蔽物を除き、サーバーとテンプレートを確認し、ミニマップを展開して左右を再取得します。モンスターは 1 種類だけで試します。
HP/MP が 0.0% と表示される
自動補給を停止し、サーバー、既定のゲーム UI、ウィンドウ位置、画面収録権限を確認してから再試行します。
モンスターを見逃す・誤認識する
1 種類だけを選び、安定したフレームで左右を再取得し、固有部分を使います。背景を含むテンプレートや別 OS からコピーしたものは削除して作り直してください。
認識するがキー入力がない
ゲームへフォーカスを戻し、キー設定と macOS のアクセシビリティを確認します。Windows では管理者権限でプログラムを実行してください。
macOS が権限を繰り返し要求する
旧版、テスト版、Python、Terminal、同名フォルダーの項目を削除し、「アプリケーション」内の現在の App を両方の権限へ追加して有効化し、Command-Q 後に再起動します。
巡回が端を越える
A/B を安全な内側へ移動し、移動のみで検証します。検出間隔と慣性により少し行き過ぎる場合があります。
インストールと認証#
macOS で「開発元を確認できません」または「アプリが壊れている」と表示される+
まず、パッケージが公式のアドレスから完全にダウンロードされたものか、お使いのチップ(Apple silicon または Intel)に合っているかを確認してください。「壊れている」というメッセージだけでは本当の原因はわかりません。
入手元が信頼できる場合は、システム設定 → プライバシーとセキュリティで「このまま開く」を探してください。それでも開けない場合は、メッセージ全文、クライアントのバージョン、Mac のチップ、macOS のバージョンを添えてサポートへご連絡ください。
システムの再インストールやパソコンの変更後に、ライセンスがすでに紐付けられていると表示される+
ライセンスは 1 台のデバイスに紐付けられます。同じデバイスでゲームアカウントを切り替えることはできますが、複数のゲームの同時実行や、1 つのライセンスを複数のパソコンや仮想マシンで使うことはできません。
再インストールや新しいデバイスの後に紐付けのメッセージが出た場合は、注文番号を添えて hi@okya.app までご連絡ください。紐付けを確認して変更します。
他の人のライセンスを繰り返し試したり、ライセンスキー全体をフォーラムや公開スクリーンショットに載せたりしないでください。
ライセンス確認は通ったのに、なぜ起動しないのですか?+
「License check passed」はライセンスが有効という意味だけです。ゲームウィンドウ、キャラクター、ミニマップ、キャプチャソースがすべて認識されたという意味ではありません。
ログを読み進め、ウィンドウキャプチャ、キャラクター認識、ミニマップ認識のどこで失敗したかを確認し、下の該当する項目に従ってください。
セキュリティソフトがプログラムをブロックまたは警告する+
Windows では管理者として起動する必要があります。すべてのウイルス対策設定との互換性は保証できません。
警告の正確な内容とパッケージの入手先をサポートに送り、公式ファイルかどうか確認してもらってください。セキュリティソフトを無効にしたり除外設定を追加したりするのを、標準の対処にしないでください。
起動とウィンドウキャプチャ#
ゲームウィンドウが見つからない、または解像度が正しくない+
次の順に確認してください:
- 設定上の表示だけでなく、実際のゲームウィンドウが 1366 × 768 であることを確認します。
- ウィンドウモードを使い、ウィンドウ全体を表示します。最小化、最大化、他のウィンドウによる重なりは避けてください。
- お使いのバージョンでキャプチャソースを選べる場合は、実際のゲームウィンドウを選択します。
- 解像度を変えたら、実行を止めてもう一度開始します。必要ならクライアントを再起動してください。
- 解像度や表示サイズが変わるたびに、キャラクターとモンスターのテンプレートを撮り直してください。
Mac で権限をオンにしても、開始を押しても反応しない+
実際に動いているクライアントに対して、アクセシビリティと画面収録が有効になっているか確認し、起動ログ全体を読んでください。
権限の問題に見えて、実際はキャラクターやモンスターのテンプレート認識が原因だった例があります。1 つの警告だけで権限を何度も切り替えず、ウィンドウサイズ、ミニマップ、キャラクターテンプレート、キャプチャソースも確認してください。
解決しない場合は、権限の画面、クライアント設定、デスクトップ全体のスクリーンショット、起動ログを送ってください。
ログに「Game is not in the foreground」と表示される+
クライアントの設定画面やログ画面をクリックするとゲームのフォーカスが外れるため、そのときにこのメッセージが出るのは正常です。設定を変える前に実行を止め、再開したらゲームをクリックして前面に戻してください。
ゲームが確かに前面にあるのにメッセージが出続ける場合は、操作ミスと決めつけず、ログ全体と画面のレイアウトを送ってください。
ログに 0 × 0 のウィンドウまたは「minimap not detected」と表示される+
ウィンドウサイズ 0 × 0、メインディスプレイの全画面キャプチャへの切り替わり、「minimap not detected」が同時に出た報告があります。ゲームが最小化されていないこと、キャプチャ対象がゲームウィンドウであること、プレイヤーマーカーが見えるようミニマップが展開されていることを確認してください。
開始時はキャラクターを静止させ、戦闘中でない状態にしてください。それでも失敗する場合は、ログ全体とゲームウィンドウ全体のスクリーンショットを送ってください。
キャラクターとモンスターの認識#
キャラクターを何度も見失います。テンプレートはどう撮ればよいですか?+
攻撃を受けて点滅していない、普通に立っている状態のキャラクターを撮ってください。上半身、特に頭の近くのはっきりして安定した特徴を優先します。
- スキルの文字、ダメージ数字、背景の装飾、大きなエフェクトは含めないでください。
- 左向きと右向きを別々に撮り、保存してからプロファイルを選択します。
- 実行中もエフェクトがキャラクターを隠さないようにしてください。
- ゲームの解像度を変えたら撮り直してください。古いサイズのテンプレートを使い続けないでください。
モンスターのテンプレートを保存したのに認識されない+
まず次の項目(モンスターが攻撃範囲外のためカウントが 0)を除外してから、テンプレートを確認してください:
- 姿勢が安定していて特徴がはっきりしたモンスターを選びます。例:頭の上部や角。
- 左向きと右向きで、同じ特徴部分を撮ります。
- 背景、ダメージ数字、スキルエフェクトを避けます。
- 実際に実行する解像度で撮り直し、テンプレートが選択されていることを確認します。
- 原因を見つけやすいよう、モンスターを 1 種類だけ選んでテストします。
画面にモンスターがいるのに、ログでは 0 と表示される+
ログは画面上のすべてのモンスターではなく、設定した横方向の攻撃範囲内にいるモンスターだけを数えます。範囲外のモンスターで 0 になるのは正常です。
モンスターが範囲に入ったときに数が変わるか確認してください。範囲内にいるのに 0 のままのときだけ、テンプレートと認識設定を確認します。0 と出たという理由だけでテンプレートを撮り直さないでください。
ミニマップとキャラクター認識では何を確認すればよいですか?+
正しいサーバーが選ばれているか、プレイヤーマーカーが見えるようミニマップが完全に展開されているか、ゲームの解像度とウィンドウモードが正しいかを確認します。開始時は静止し、戦闘中でない状態にしてください。
ログで CHARACTER_RECOGNITION、MINIMAP_RECOGNITION、MARKER_COLOR_ABSENT を見て、キャラクターとミニマップを別々に確認します。キャラクター認識が成功しても、ミニマップが成功した証拠にはなりません。
戦闘と攻撃範囲#
行ったり来たりするだけで戦わない+
順に確認してください:キャラクターとミニマップが認識されているか、モンスターのテンプレートが選択されているか、モンスターが設定した攻撃範囲内にいるか、攻撃キーがゲームと一致しているか、スキルを習得済みか。
その場攻撃に戻して、基本の認識とキーを確認します。巡回モードを切り替えただけでは、直ったことにはなりません。
横方向の攻撃範囲はどう設定しますか?+
値はゲーム画面上のピクセル距離です。現在の表示設定でのキャラクターの実際の攻撃距離を基準にしてください。
選択範囲のサイズをピクセルで表示するスクリーンショットツールで測定できます。他の職業の数値をそのまま使わないでください。常に正しい値はありません。初心者用の短い短剣の近距離攻撃には、50 ピクセル以下を案内したことがありますが、これは近距離攻撃の例であり、すべての職業の標準値ではありません。
何もない地面を攻撃し続け、MP や消耗品が無駄になる+
攻撃範囲が大きすぎると、届かないモンスターを攻撃しようとすることがあり、テンプレートが不安定だと見逃しや誤認識が起こります。実際の攻撃距離、テンプレートの品質、現在の認識結果を確認してください。
空振りが続く場合は、資源の消耗を防ぐため実行を止め、攻撃設定、テンプレート、再現手順の簡単なメモをサポートに送ってください。モンスターがいないときに必ず攻撃を止めるスイッチはありません。
設定を変えたのに何も変わらないように見える+
変更は、すでに実行中のセッションには反映されません。順番に行ってください:実行を停止 → 保存 → もう一度開始。
攻撃範囲、スキルキー、数のしきい値、解像度を変えたら、実際の効果をもう一度確認してください。
巡回とマップエディター#
ルートはどうインポートしますか?サンプルマップはありますか?+
マップエディターにはサンプルマップがあります。「Load sample map」で構造を確認してから、自分のルートを作ってください。
インポートするには、カスタムルート巡回を選び、マップのドロップダウンの横にある Import を使って、エクスポートした JSON ファイルを選びます。バージョンによって名前が異なることがあります。見つからない場合は、存在しないボタンを推測せず、クライアントのスクリーンショットを送ってください。
エクスポート時、Map Name と Map ID には英字と数字だけを使ってください。
マップをエクスポートしたのに「Add to OKYA」が表示されない+
エディターがエクスポートした .json ファイルをダウンロードし、デスクトップクライアントのカスタムルート巡回で、マップ一覧の横にある Import を使ってください。成功するとマップがドロップダウンに表示されます。
assets/maps に手動でコピーする必要はありません。そのフォルダーは内蔵マップ用です。それでもインポートできない場合は、Map Name、Map ID、ファイル名を確認し、エクスポートした JSON とエラーのスクリーンショットをサポートに送ってください。インポートに失敗したからといって、ファイル形式が間違っていると決めつけないでください。
サポートに連絡するときに含める情報#
まとめて送っていただくと、やり取りの回数を減らせます。
- OS とバージョン。Mac の場合は Apple silicon か Intel かも記載してください。
- 正確なクライアントのバージョン番号。
- ゲーム名、サーバー、ウィンドウモード、解像度。
- 外部ディスプレイの使用有無と表示スケール。
- 行った手順、期待した結果、実際に起きたこと。
- 最後の 1 行だけでなく、ログ全体。
- ゲームとクライアント設定の両方が見えるデスクトップ全体のスクリーンショット。認識の問題では左向き・右向きのテンプレートも添付してください。
- キーの問題では、ゲーム側とクライアント側の両方のキー設定。
- 性能の問題では、実行時間と関連する監視データ。安全に撮影できる場合は短い動画も役立ちます。