MapleStory Classic Bot

Character and monster recognition

Create left- and right-facing image templates for your character and target monsters. The client uses them to locate visible targets.

Grinding and farming routes

Attack from one position, patrol between two minimap coordinates, or build a route for a multi-platform map in the free browser editor. Export the JSON route and import it into the desktop client.

Automatic potions and buffs

Set HP/MP thresholds, potion keys, cooldowns, and up to five timed buff slots to match your in-game shortcuts.

Pickup and combat controls

Configure attack, jump, pickup, directional behavior, and strategy-specific timing from one desktop control panel.

Runtime logs and startup checks

Review window, minimap, character, monster, and vital-stat detection before leaving a strategy running.

Local profiles and routes

Save configuration, custom templates, and map-route files locally so each setup can be tested and adjusted.

Mac installation

Move the app to Applications before opening it. Grant both Accessibility and Screen & System Audio Recording in Privacy & Security, then quit the app completely and reopen it. Use the package that matches your chip: Apple silicon or Intel.

Verify macOS permissions

Accessibility lets the app send movement, combat, and recovery keys. Screen & System Audio Recording lets it read the game window, character, minimap, and HP/MP. Add the installed app—not Terminal, Python, an old build, or a folder—to both lists, enable both switches, then quit with Command-Q and reopen it.

Activate the license

Enter the complete license without leading or trailing spaces, activate it while connected to the Internet, and wait for the success state before returning to the main screen. If macOS asks for Keychain access, use the current Mac login password, not the license code.

Local data and backups

Windows data is stored under %LOCALAPPDATA%\Okya\; macOS data is under ~/Library/Application Support/Okya/. Back up config.json, templates, and maps only. Never copy license.dat to another computer; activate the new device separately.

Character templates (15 × 15 px)

Create a named character profile, face left, and capture the stable area near the top of the head. Face right and select exactly the same body region. Confirm that both previews contain only the character, then save and select the profile.

Good and bad samples

A good pair uses the same position in both directions and contains only the target. Recapture samples containing ground, platform edges, background, names, damage numbers, chat text, pets, skill effects, or another monster.

When to capture again

Recreate every template after changing outfits, visual effects, game clients, or operating systems. Windows and macOS may render pixels differently.

Game window and basic settings

Use a window or borderless window on the primary display. Keep the minimap fully expanded and the default HP/MP area visible. Select the real server because it affects minimap colors and HP/MP regions, select the saved character, and begin with one monster. Keep the lie-detector alert enabled and test its sound.

Use diagnostic modes first

Recognition-only verifies the game window, character, monsters, minimap, and HP/MP without sending combat input. Movement-only validates a patrol or preset route. Full execution should be enabled only after both checks pass.

Combat and movement

Match attack and jump keys to the game shortcuts. Begin with conservative horizontal and vertical detection ranges; ranges that are too large can make the client react to targets on another platform.

HP and MP recovery

Enable HP and MP separately. A 50% threshold and about a one-second cooldown are practical test values; cooldowns must not be below 0.1 seconds. If the log shows HP or MP as 0.0%, disable recovery and first verify the server, window position, UI, and screen-recording permission.

Buffs and item pickup

Up to five timed buff slots are available. Test one slot first; every enabled slot needs a key and a period greater than zero. For pickup, 0.45 seconds is a stable starting interval and the minimum is 0.05 seconds. Very frequent pickup can interrupt combat and queue inputs.

First complete run

Enter the target map, expand the minimap, confirm HP/MP, save the server, character, monster, strategy, and keys, then start from a safe position. Wait for the app to return focus to the game and do not switch applications. The strategy is running only after the log confirms the game window, character, minimap, and startup checks.

30-second preflight check

Confirm the correct map and safe position, the game on the primary display, expanded minimap, correct server/profile/monster/strategy, matching attack/jump/potion/buff/pickup keys, sufficient supplies and inventory space, and an audible lie-detector alert.

Stationary Attack

Recommended for the first test and fixed platforms. The client records the starting minimap position and can attempt to return after knockback or drift.

Two-Point Patrol

Moves between horizontal A and B coordinates on the minimap, with configurable pauses and optional attacks at the endpoints.

Custom Route Patrol

Follows a route file you build in the map editor with nodes, platforms, and actions. Routes must match the current map.

Build a route in three steps

1. 1
   Import the map you actually use

   Take a screenshot from the game while it is running with the same map, window mode, and minimap layout you will use with the desktop client. Open the map editor and choose Import map. Avoid guide-site images, resized pictures, or screenshots from another setup because their coordinates may not match.

2. 2
   Crop the minimap in the upper-left

   Choose Crop, click the upper-left corner of the visible minimap, then its lower-right corner, and save the crop. Keep the complete traversable minimap inside the selection while excluding the game world, chat, quests, and other UI. Confirm that the cropped area matches the minimap the desktop client will recognize.

3. 3
   Place nodes and build the route

   Choose Node and place points at turns, landing positions, ropes, ladders, and portals. Mark platforms when they help describe the terrain, connect neighboring nodes, and assign the correct walk, jump, climb, drop, or teleport action. Export the route, import it for the matching map in the desktop client, and test movement before enabling combat or pickup.

Before an update

Stop the strategy, quit the app, and back up config.json, templates, and maps. Install the new version separately, then verify the version, selected templates, server, shortcuts, and strategy settings.

Moving to another computer

Regular configuration and route files can be reviewed and migrated. Do not migrate license.dat. Activate the new device, grant its permissions, and recapture character and monster templates on the target system.

Change the bound device

A license is bound to the device where it was first activated. After switching computers, reinstalling the system, or replacing hardware, contact support at hi@okya.app with your order ID so the binding can be changed. Do not copy license.dat to the new device.

When contacting support

Include the app version, operating system and chip, server, window mode, strategy, relevant parameters, and the complete log from startup parameters to the first failure. Remove license keys, device identifiers, account names, and other secrets.

Game window not found

Confirm the game is open on the primary display in windowed or borderless mode. On macOS, recheck Screen & System Audio Recording and restart the app after changing permission.

Character, monster, or minimap not recognized

Remove visual obstructions, verify the selected server and template, expand the minimap, and recapture both directions in the current environment. Test with only one monster selected.

HP and MP both read 0.0%

Turn off automatic recovery first. Verify the selected server, default game UI, window position, and screen-recording permission before testing again.

Monsters are missed or misidentified

Select only one monster, capture both directions on a stable animation frame, and use a distinctive target-only region. Delete and recreate templates that include background or were copied from another operating system.

Recognized but no keys are sent

Return focus to the game, confirm configured shortcuts, and check Accessibility on macOS. On Windows, run the program as administrator.

macOS still asks for permission

Remove entries for an old build, test build, Python, Terminal, or a same-named folder. Add the current app from Applications to both privacy lists, enable both switches, quit with Command-Q, and reopen it.

Patrol crosses an edge

Move the A and B endpoints farther inside the safe platform and validate them in movement-only mode. Detection intervals and character inertia can cause a brief overshoot.