Checking authentication...

MapleMate MapleMate

User Manual

Welcome to MapleMate. This manual will help you get started.

🎁

Bring a friend? Get 5 days added to your license!

Write a review? Get 5 days added to your license!

1. Getting Started

Download all required files below and follow the installation order.

Step 1 β€” Main Application

Farmer-Beta 15_4 - up to date.zip

Also includes: additional files at same app folder.zip

Farmer data folder

Step 2 β€” Required System Files

Required 2 - place at C main directory.zip

Extract and place contents directly into C:\

C drive folder contents

Step 3 β€” Image Uploader & Driver

Image Uploader + Driver Installer.zip

Run the driver installer before launching the app

⚠ Generating a License β€” Skip if you already have a username and password

  1. Launch Image Uploader + Driver Installer
  2. Enter your desired username and password
  3. Enter the code you received
  4. Press Generate License
  5. From now on these credentials are your login info

Driver Installation β€” Inputs

If you are using a Raspberry Pi Pico:

Simply drag the firmware file provided to you onto the Pico drive. After a few seconds it will be fully usable.

If you are NOT using a Pico:

  1. Open Image Uploader + Driver Installer
  2. Check Enable Driver Installers
  3. Click Install Driver 2
  4. Verify it works: open the main app β†’ Settings tab β†’ click Test Keyboard at the bottom

⚠ Important

The main application must be started after the driver is installed β€” otherwise Driver 2 won't give any input.

If it doesn't alt-tab, install Driver 1 instead β€” it always works but is less stealthy.

GeForce NOW / remote desktop users should use Driver 1.

2. GeForce NOW Setup β€” Optional

Only relevant if you are playing MapleStory through GeForce NOW. Skip this section if you are running the game locally.

Step 1 β€” GeForce NOW Streaming Settings

In the GeForce NOW app go to Settings β†’ Gameplay and set:

  • Mode: Custom
  • Resolution: 1366 Γ— 768 (16:9)
  • Frame rate: 60 FPS
  • VSync: Adaptive
  • AI video filter: Off
  • HUD sharpness filter: Off
  • In-game graphics settings: Off
GeForce NOW streaming settings

Step 2 β€” Configure MapleMate

  1. In the bot app, set Server to Geforce Now
  2. Set resolution to 1366x768
  3. Press the Resize button β€” this resizes the app window to match GeForce NOW's stream
MapleMate app with Geforce Now server and Resize button

⚠ Driver Note

GeForce NOW users should use Driver 1 for inputs. See the Getting Started section for driver installation.

3. Auto Bot

Builder overview

Adding Platforms

1

Press Add Platform Start while standing on the left side of the platform.

2

Press Add Platform End while standing on the right side of the platform.

Adding Ropes

1

Press Add Rope Start while hanging on the bottom of the rope.

2

Press Add Rope End while standing on the platform the rope is connected to.

Adding Summons

Walk to the locations where you want to cast summons and press the summon button. You can set a cast direction per placement.

πŸ’‘ Tip

Avoid setting a direction unless necessary β€” it makes summon placement take longer.

Summons placement

In KeyBinds, enable each summon and set proper cooldowns.

KeyBinds summons settings

Avoided Locations

Walk to a location you want the bot to avoid and press the button. The bot will try to avoid it but may still use it occasionally. Useful for map portals.

Add Portals

1

Stand exactly in the center of the portal entrance and press Add Portal.

2

Go to the exit location and press Add Portal again.

⚠ Important

Be precise β€” if you're not standing exactly in the center of the portal your character will get stuck.

You can adjust portal behavior in the Settings tab.

Portal setup

Skill Actions & Classes

Choose one of the Global Classes or Low Server Classes. Other classes may cause issues (kept for users who have maps there).

Add skill node actions at the areas you want them activated. Each node will perform with the Direction and Jump Type you configure. If direction doesn't matter, leave it on Any.

Auto Bot keybinds

Routines

Routines 1 – 3  Β·  Farming with Shuffle

Build up to 3 farming routines. Enable Shuffle Mode to randomly rotate between them while farming. Activated from the Auto Bot tab.

Shuffle mode

Routines 4 – 6  Β·  Loot Cycle

Used for loot cycle β€” the bot walks to the locations you set, in order. Activated from the Settings tab. If more than one loot routine is created, shuffle between them is automatic.

Auto loot cycle

Save & Load

βœ“

Give the map a name and press Save. It will be bound to your account for the class you built it with. If you switch class you won't see the map.

β–Ά

Go to the Auto Bot tab, load the map, and press Start.

4. Dynamic Bot

Dynamic Bot builder

Adding Platforms

1

Press Add Platform Start while standing on the left side of the platform.

2

Press Add Platform End while standing on the right side of the platform.

Adding Ropes

1

Press Add Rope Start while hanging on the bottom of the rope.

2

Press Add Rope End while standing on the platform the rope is connected to.

Adding Summons

Walk to the locations where you want to cast summons and press the summon button. You can set a cast direction per placement.

πŸ’‘ Tip

Avoid setting a direction unless necessary β€” it makes summon placement take longer.

Dynamic Bot summons

In KeyBinds, enable each summon and set proper cooldowns.

Dynamic Bot summon keybinds

Avoided Locations

Walk to a location you want the bot to avoid and press the button. The bot will try to avoid it but may still use it occasionally.

Add Portals

1

Stand exactly in the center of the portal entrance and press Add Portal.

2

Go to the exit location and press Add Portal again.

⚠ Important

Be precise β€” if you're not standing exactly in the center of the portal your character will get stuck.

You can adjust portal behavior in the Settings tab.

Dynamic Bot portal setup

Set Checkpoints

Set Checkpoint skills in the builder. It doesn't matter which skill you assign β€” just place them as Checkpoint. The bot will move to checkpoints if it doesn't see visible monsters for the configured time.

Move to next location

Once done, give the map a name and Save. It will be bound to your account for the class you built it with. If you switch class you won't see the map.

Upload Player Tracker Images

Upload the player tracker images you'll use. Normally a Medal is more than enough.

Medal Image Example

Medal example

Image Uploader

Image uploader

πŸ’‘ Recommendation

If changing maps with different backgrounds, swap tracker images that are affected by the background β€” for example, half-transparent name tags and medals like shown in the image uploader.

Dynamic Bot Tab Settings

Use Option 3 or 4 β€” these are pure AI in action. 5+ detections per second are more than enough.

Dynamic Bot mode selection

Recommended Low Version Settings

Recommended low version settings

Recommended High Version Settings

Recommended high version settings 1
Recommended high version settings 2

Player Tracker Selection

Choose the player tracker images you uploaded and set the confidence %. Using too low a value can cause false positives when it doesn't find your character.

Player tracker selection

Loot Cycle

Routines 4 – 6  Β·  Loot Cycle

Used for loot cycle β€” the bot walks to the locations you set, in order. Activated from the Settings tab. If more than one loot routine is created, shuffle between them is automatic.

Dynamic Bot auto loot

Monster Detection

Configure the monster values. Normally the sweet spot is 4 V1 or 4 V2. Keep in mind Advanced AI is slower but more accurate β€” if non-Advanced AI works fine, stick to it.

Widget selection
1

Press Test Detection.

Detection test result

Play with the slider β€” go as low as you can without getting giant boxes.

❌ Bad Example β€” Giant Boxes

Bad detection example with giant boxes

Start

1

Press Apply & Close.

2

Load the map and press Start.

5. Static Configuration

Binding Game Window β€” Auto Bot Tab

MapleStory Worlds

Must be on 1280Γ—720 windowed mode. If you accidentally stretched the window with the mouse, change to another resolution and back to 1280Γ—720.

High Version Servers

Must be on 1366Γ—768. GeForce NOW or any remote desktop requires using the Resizer.

Server Selection

Choose the server you are playing β€” this identifies which game window to search for. Each server name has a specific Minimap type it will search for.

⚠ Desktop Scaling & HDR

Scaling OR HDR in desktop settings will break detection. Set Scale to 100% and HDR Off.

HDR and resolution settings

You can override the selected window by pressing the Scan button and choosing the game process.

Some servers need a Minimap override β€” go through the Minimap names in the box and press Refresh Map until the Minimap is captured.

If needed, override the Player Icon by changing it in the box.

Binding game window

Calibration

Press Refresh Map to calibrate the minimap. Every time the game client moves, recalibration is required.

Movement Settings

Identify which movement types the bot is allowed to use.

Other keybinds
  • β€’Set the Jump Key β€” without this the bot will not work.
  • β€’Set the other movements you want to use.
  • β€’If you use Rope Lift, Teleport, or Dash you must set the key.
Settings movement tab

Press the Configure button for each movement you want to use and focus the game.

  • β€’Max fall gap β€” recommended max (100) unless your server has issues with high platforms.
  • β€’Double Jump / Triple Jump / TP Left Right / Dash β€” be on a flat long platform.
  • β€’TP Up β€” be below a platform, or adjust Β±values from the builder player position coordinate.
  • β€’TP Down β€” be above a platform, or adjust Β±values from the builder player position coordinate.
  • β€’Rope Lift β€” be below a platform or adjust Β±values; typically set around 60.

You can also set values manually, or do the actions yourself and calculate gaps by watching the builder.

Movement accuracy β€” identifies how accurately the position is confirmed. Default / Low is normally what you want.

You have explanations in the info boxes.

Info icon

πŸ’Ύ Presets

You can save presets β€” it saves the entire Movement + Attacker area settings and you can load them for any class.

Rune Solver

  • β€’In the Settings tab, enable the rune solver.
  • β€’If your server does not have spinning runes, do NOT enable "Solve Spinning Runes".
  • β€’Set reasoning level to Minimal and enable the Optimizer.
Rune solver settings

In Keybinds set the Interact Key β€” otherwise the bot won't open the rune.

Keybinds interact key

You can override the rune color if you get false positives β€” this can happen when Rune By Time is enabled.

βœ… Good Configure

Good rune configure

❌ Bad Configure β€” Too much noise

Bad rune configure

Auto Consumables & Auto Buffs

Place the keys that will use your consumables / buffs. The first value is how frequently it casts (Cooldown), Cast Time is how long the buff animation takes to finish.

Auto Consumables and Auto Buffs

Summons

Place the keys for your summons. The first value is the Cooldown, Cast Time is the summon animation duration. Summon locations are set in the Builder tab.

Keybinds summons

Combo

Combo is a sequence of keys with no time jitters. The values you set are used exactly as entered β€” this is highly NOT recommended unless you know what you are doing.

Combo buff settings

Masking the App

Mask App makes the application invisible to screenshots and recordings, making it more secure from inspection.

Always enable "Use New Movement".

General settings

Auto Attacker Mode

Auto Attacker Mode casts skills while moving to set locations. You decide which movement type is used and how long after that movement the attack is cast.

Auto attacker settings

Attack is cast 0.01s after a Double Jump.

Attack is cast 0.2s after falling.

Attack is cast 0.2s after an up jump.

πŸ’‘ Mages

Always use at least 0.1s value. Do not enable "Keep moving while attacking".

The green dot should be on the skill used for the attacker mode action. You can assign different skills per movement type. No need to set anything in the builder.

Even if you aren't using these attack modes, the dots can stay β€” you only need to disable the Attacker Mode movement checkbox in the Settings tab.

Keybinds attacker

Custom Auto HP / Auto MP

Press the Set button in the Settings tab β€” the game window will pop up. Select the area of the HP / MP and confirm.

Confirm HP area Confirm MP area HP and MP settings

Play with the values until you see only the color of the HP / MP β€” the numbers should turn black, meaning white has been masked out.

Masked HP and MP

6. Notifications

Map Changed Notification

Map changed notification
1

Press Set Area.

2

Select the region to monitor.

Region map changed
3

Press OK.

Now activate the Map Changed feature β€” it also works as a DC detector. The setting is saved after login. Press View to confirm the area is correct.

Message Detected

Message detected notification
1

Press Set Area and select the area to scan for chat popups.

2

Select the minimum chat box size (to avoid false positives).

3

Select the maximum chat box size (to avoid false positives).

Map changed area selection
4

Press OK. Activate the notification. Press View to confirm the area is correct.

⚠ Sensitivity

This notification has a high false positive rate as it is very sensitive. You can control the sensitivity, but false positives cannot be fully eliminated.

Map change accuracy setting

Lie Detector Solver

Enable the solver by turning on the notification with "and Solve". For Ranmelle, the 5 second delay option from the combos is recommended.

You can configure the number of retries and an initial delay if the lie detector text takes time to load.

Character Stuck

This notification has a built-in feature that tries to release the character if it is actually stuck. Keep in mind it will also trigger if the character attacks at the exact same location for a long time.

Other Notifications

Other notifications are straightforward β€” keep in mind you may need to mask people colors using the override button ranges, just like the rune color override described in Static Configuration.

7. Auto Dailies

Setup

1

Configure a map with a routine for every map you are going to do a daily.

2

Fill the boxes with the maps you created for each daily.

Settings

World Map Key Shortcut

Set the World Map Key shortcut. For example W β€” if this is not set, Auto Dailies will not work.

Time to wait after teleport to next map

How long it waits before starting after the World Map teleport completes. A good starting point is 5 seconds β€” adjust to what fits your setup.

Skip teleport for first map

Avoids teleporting for the first daily. Enable this if you are already at the first map when you start.

Skip checkboxes

Use the Skip checkboxes to skip individual dailies. For example, if you stopped Auto Dailies and need to continue from daily 3, enable Skip for dailies 1 and 2. Or if you already farmed a map today (e.g. daily 4), skip it β€” the bot will continue to daily 5. The skip order doesn't matter.

Auto Dailies main page

⚠️ Important β€” Favorite Maps Order

  • The Favorite Maps order matters!
  • First daily must be at the top.
  • Second daily must be second from the top.
  • Third daily must be third from the top, and so on.
  • You can use up to 7 dailies.

When all dailies are complete, an alarm1 sound will play and a Telegram notification will be sent.

Favorite maps order

8. Recorder Mode

Recorder Mode has built-in explanations inside the application.

9. Script Mode

Script Mode has built-in explanations inside the application.

10. Telegram

Creating Your Bot Token

1

Open Telegram and search for BotFather.

2

Start a conversation with BotFather by typing /start.

3

Use the command /newbot to create a new bot.

4

Follow the prompts β€” name your bot (e.g. MyFarmBot) and choose a username ending in "bot" (e.g. MyFarmBot_Bot).

5

BotFather will give you a unique token β€” copy it and paste it into the bot settings.

6

Search for the bot you created in Telegram and press Start.

Bot creation via BotFather Search and start the bot

Getting Your User ID

1

Go to Telegram and search for @userinfobot.

2

Copy the ID it sends you and set it in the bot settings.

3

Set the HTTP API token from BotFather as well.

Telegram bot settings area

βœ… Test It

If configured properly, pressing the Test button should send you a message on Telegram.