okya for MapleStory
日本語
English한국어日本語简体中文繁體中文EspañolPortuguêsไทยTiếng Việt
ガイドメニュー⌄
ホーム›製品ガイド

01 · 製品紹介

ローカル・デスクトップ自動化

メイプルストーリー Classic World 自動狩りツール

okya for MapleStoryは画面画像認識とローカルのキー操作を利用し、繰り返しの狩り、ファーム、レベル上げを自動化します。キャラクターとモンスターのテンプレートを作成し、マップに合った戦略を選択できます。

対応OS
Windows 10/11 · AppleシリコンMac
ゲーム画面
1366 × 768
処理方式
ローカル画像認識

繰り返しの狩りに合わせて設定できるツール#

デスクトップクライアントはアカウントのパスワードを求めず、表示中のゲーム画面を読み取ります。キャラクター、選択したモンスター、ミニマップ位置、HP/MP領域を認識し、保存済みの戦略とキー設定を実行します。テンプレートと通常設定は端末内に保存されます。

デスクトップクライアントで自動化できること#

最小構成で認識を確認し、実行ログを見ながらオプション機能を一つずつ有効にしてください。

キャラクターとモンスターの認識

キャラクターと対象モンスターの左右向き画像テンプレートを作成し、画面内の対象を検出します。

狩り・ファームルート

定位置攻撃、2地点往復、マップエディターで自作した多層マップルートを選択できます。

ポーションとバフの自動化

HP/MPしきい値、ポーションキー、クールダウン、最大5枠の定期バフを設定できます。

拾得と戦闘操作

攻撃、ジャンプ、アイテム拾得、方向転換、戦略ごとの動作間隔を一つの画面で設定します。

実行ログと起動チェック

戦略開始前にゲーム画面、ミニマップ、キャラクター、モンスター、HP/MPの認識結果を確認できます。

ローカル設定とルート

設定、ユーザーテンプレート、マップルートファイルを端末内に保存し、テストと調整を繰り返せます。

利用前の準備#

  • 64ビットWindows 10/11、またはAppleシリコン(Mシリーズ)Mac
  • ミニマップを表示した1366 × 768のメイプルストーリー画面
  • macOSの「アクセシビリティ」と「画面収録とシステムオーディオ録音」権限
  • 有効なライセンスと初回有効化時のネット接続
  • 実際に使用するOSとゲーム環境で取得したテンプレート

メイプルストーリー Classic World 自動狩りFAQ#

WindowsとmacOSに対応していますか?+

64ビットWindows 10/11とAppleシリコンMacに対応しています。現在のMac版はIntel Mac向けではありません。

なぜ1366 × 768が必要ですか?+

ゲーム画面、ミニマップ、HP/MPの認識領域を1366 × 768に合わせているため、他の解像度では起動チェックに失敗する場合があります。

メイプルストーリーのパスワードは必要ですか?+

必要ありません。表示中のゲーム画面とローカルのキー設定で動作します。パスワードやlicense.datをサポートへ送らないでください。

最初に試す戦略はどれですか?+

モンスターテンプレートを1種類だけ選び、オプション機能を無効にした「定位置攻撃」から始めてください。認識が安定してから他の機能を追加します。

WindowsとMacでテンプレートを共有できますか?+

設定とルートはバックアップできますが、OSごとに描画が異なる場合があります。使用先のOSでキャラクターとモンスターのテンプレートを再取得することを推奨します。

Botのマップルートを自分で作れますか?+

はい。ブラウザのマップエディターで足場、ノード、移動アクションを設定し、JSONルートをデスクトップクライアントへ読み込めます。同じマップと解像度で作成・テストしてください。

02

使用ガイド

ゲーム画面#

インストール・権限・ライセンス認証#

OS に合ったパッケージを導入し、プラットフォーム固有の確認を終えてから戦略を設定します。

Windows

64 ビット版 ZIP を固定フォルダーへ完全に展開し、ZIP のプレビュー内からは起動しないでください。管理者権限でプログラムを実行してください。

Apple silicon Mac

最初に App を「アプリケーション」へ移動し、「アクセシビリティ」と「画面収録とシステムオーディオ」を許可します。完全終了後に再起動してください。Intel Mac は対象外です。

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 とゲーム環境で、左右両方向を取得します。

キャラクター(固定 20 × 20 px)

プロフィールを作成して名前を付けます。左向きで頭部上側の安定した部分を取得し、右向きでもまったく同じ部位を選択します。両方のプレビューにキャラクターだけが含まれることを確認して保存・選択します。

モンスター(固定 10 × 10 px)

動きとフレーム数が少ない種類を優先します。安定したフレームで、頭頂部・角・目の周辺など同じ特徴部分を左右とも取得してください。最初は 1 種類、通常は 1~3 種類が安定します。

良いサンプルと悪いサンプル

良いペアは左右の位置が同じで対象のみを含みます。地面、足場の端、背景、名前、ダメージ、チャット、ペット、スキル効果、別のモンスターを含む場合は再取得してください。

再取得が必要なとき

ゲーム解像度、表示倍率、外見、エフェクト、ゲームクライアント、OS を変更した場合は、すべてのテンプレートを再取得してください。画像は実際に使用する解像度と完全に一致する必要があり、Windows と macOS ではピクセル表示も異なる場合があります。

初回セットアップ#

以下は実際のデスクトップクライアントと初回利用ガイドに基づく手順です。

  1. 1

    64ビットWindowsまたはAppleシリコンMac用の正しいパッケージをインストールします。macOSでは権限を付与する前にAppを「アプリケーション」へ移動します。

  2. 2

    ゲームを1366 × 768のウィンドウまたはボーダーレスウィンドウで表示し、主画面でミニマップとHP/MP領域をすべて見える状態にします。

  3. 3

    ライセンスを有効化し、実際のゲームサーバーを選択して対応するミニマップ色とHP/MP認識領域を使用します。

  4. 4

    キャラクターと対象モンスターの左右向きテンプレートをそれぞれ取得します。OS、表示倍率、外見、クライアントを変更した場合は再取得してください。

  5. 5

    最初のテストでは「定位置攻撃」を選び、キャラクター、モンスター1種類、攻撃キー、ジャンプキーだけを設定します。

  6. 6

    戦略を開始して実行ログを確認します。キャラクターとミニマップの認識が成功してから、ポーション、バフ、拾得を順に有効にします。

モード・戦闘・オプション設定#

一度に 1 項目だけ変更して保存し、ログで確認してから次を有効にします。

ゲーム画面と基本設定

メイン画面で 1366 × 768 のウィンドウまたはボーダーレス表示を使い、ミニマップを展開して HP/MP を既定位置に保ちます。実際のサーバー、保存済みキャラクター、モンスター 1 種類を選択し、嘘発見器アラートの音声テストを行ってください。

診断モード

認識のみでゲーム画面、キャラクター、モンスター、ミニマップ、HP/MP を確認します。移動のみで巡回やルートを検証し、両方が正常になってから完全実行を使用します。

戦闘と移動

攻撃・ジャンプキーをゲーム内設定と一致させます。別の足場を誤追跡しないよう、水平・垂直範囲は控えめな値から調整します。

ポーション・バフ・拾得

HP/MP は 50% と約 1 秒の待機時間から試し、0.1 秒未満にはしません。最大 5 枠のバフは 1 枠ずつ確認します。拾得は 0.45 秒が安定した開始値で、最小は 0.05 秒です。短すぎる間隔は戦闘を妨げます。

初回の完全実行

対象マップでミニマップと HP/MP を確認し、サーバー、解像度、キャラクター、モンスター、戦略、キーを保存します。安全な位置から開始し、App がゲームへフォーカスを戻すまで待って切り替えないでください。ログですべての起動確認が成功して初めて実行中です。

30 秒の起動前確認

正しいマップと安全位置、メイン画面の 1366 × 768、展開したミニマップ、正しいサーバー・プロフィール・モンスター・戦略、各キー、十分な消耗品と空き容量、聞こえるアラートを確認します。

3種類のマップ戦略#

マップ形状に合う戦略を選択してください。新しい設定では、オプション動作を加える前に移動だけをテストします。

定位置攻撃

初回テストと固定足場向けです。開始時のミニマップ位置を記録し、ノックバックやずれが生じた場合に元の位置への復帰を試みます。

2地点往復

ミニマップ上の水平A/B座標間を移動し、端点での待機時間や端点だけで攻撃するかを設定できます。

カスタムルート巡回

マップエディターで作成したノード、足場、動作に従います。ルートは現在のマップと一致する必要があります。

カスタムBotルートを作成して使う#

マップエディターでは、特定のマップをBotがどのように移動するかを定義できます。デスクトップクライアントで実際に使うマップとゲーム画面に合わせて作成してください。

3ステップでマップルートを作成

  1. 1
    実際に使用するマップを読み込む

    デスクトップクライアントで使うものと同じマップ、解像度、ウィンドウモード、ミニマップ配置でゲームを起動し、現在の画面を撮影します。エディターで「マップを読み込む」を選択してください。攻略サイトの画像、拡大縮小した画像、別環境のスクリーンショットは座標が一致しないため使用しないでください。

  2. 2
    左上のミニマップ範囲を切り抜く

    「切り抜き」を選び、表示中のミニマップの左上、右下の順にクリックして保存します。移動できる足場、ロープ、はしご、ポータルをすべて含め、ゲーム画面、チャット、クエスト通知などミニマップ外のUIは除外します。保存前にデスクトップクライアントが認識する範囲と一致しているか確認してください。

  3. 3
    ノードを配置してルートを作る

    「ノード」で方向転換、着地、ロープやはしごの入口、ポータルに点を置きます。必要に応じて足場を描き、隣接ノードを接続して歩行、ジャンプ、登り、下ジャンプ、テレポートを指定します。ルートを書き出して同じマップのデスクトップクライアントへ読み込み、戦闘や拾得の前に移動だけをテストします。

正しい順序でトラブルを切り分ける#

ログで最初に失敗した起動チェックから修正します。

ゲームウィンドウが見つからない

メイン画面で 1366 × 768 のウィンドウまたはボーダーレス表示にします。macOS は画面収録権限を確認して App を再起動します。

認識に失敗する

遮蔽物を除き、サーバーとテンプレートを確認し、ミニマップを展開して左右を再取得します。モンスターは 1 種類だけで試します。

HP/MP が 0.0% と表示される

自動補給を停止し、サーバー、1366 × 768、既定のゲーム UI、ウィンドウ位置、画面収録権限を確認してから再試行します。

モンスターを見逃す・誤認識する

1 種類だけを選び、安定したフレームで左右を再取得し、固有部分を使います。背景を含むテンプレートや別 OS からコピーしたものは削除して作り直してください。

認識するがキー入力がない

ゲームへフォーカスを戻し、キー設定と macOS のアクセシビリティを確認します。Windows では管理者権限でプログラムを実行してください。

macOS が権限を繰り返し要求する

旧版、テスト版、Python、Terminal、同名フォルダーの項目を削除し、「アプリケーション」内の現在の App を両方の権限へ追加して有効化し、Command-Q 後に再起動します。

巡回が端を越える

A/B を安全な内側へ移動し、移動のみで検証します。検出間隔と慣性により少し行き過ぎる場合があります。

更新・バックアップ・サポート#

確認済み設定を保存しつつ、端末に紐づくライセンス情報や機密情報は移動しません。

更新前

戦略を停止して終了し、config.json、templates、maps をバックアップします。更新後にバージョン、サーバー、テンプレート、キー、戦略を確認します。

別の端末へ移行

通常設定とルートは確認後に移行できますが、license.dat は移行しません。新しい端末で認証・権限設定・テンプレート再取得を行います。

サポートへ連絡

バージョン、OS とチップ、サーバー、解像度、表示モード、戦略、主要設定、最初の失敗までのログを添付し、ライセンスや端末 ID、アカウント名は削除してください。