> ## Documentation Index > Fetch the complete documentation index at: https://mania.bot/docs/llms.txt > Use this file to discover all available pages before exploring further. # Modern > Keybinds, maps, and routines for modern MapleStory. > [!TIP] > > Keybinds, maps, and routines sync to the cloud automatically. Access from any device. ## Setup Video [MANIA Setup Guide](https://www.youtube.com/embed/VPl9diZndbw) > [!TIP] > > To translate, open the video directly on [YouTube](https://www.youtube.com/watch?v=VPl9diZndbw). From there, click **Settings → Subtitles/CC → Auto-translate** and select your language. ## Keybinds Your keybinds in MANIA need to match your in-game MapleStory keybinds. ### Movement Set keybinds for your movement abilities. Travel distances are learned automatically. ### Buffs Buffs are kept active automatically. This is enabled by default in **Settings → General → Auto Buff**. Attack skills can also be added here if you just want them pressed off cooldown. A buff without a cooldown will be skipped. | Setting | Description | | - | - | | Cooldown | Time between casts in seconds. Match your buff duration. | | Cast Time | Delay after casting before the next action. Accounts for animation lock. | > [!NOTE] > > Buff not casting? The previous buff's cast time may be too short, causing the following key press to be absorbed. Check **Input → Events** to confirm timing. ### Skills Set your attack skills here. All skills can be assigned to specific **points** in your routine to cast at certain locations. | Setting | Description | | - | - | | Hold | **Skill 1** only. Holds the key while moving. | | Move Attack | **Skills 1–6** only. Probability of being selected while move attacking. | | Cooldown | Minimum time between uses in seconds. | | Cast Time | Delay after casting before the next action. | > [!NOTE] > > A skill will not be pressed until its cooldown expires. For charge-based skills like Sol Janus, set cooldown to 0. #### Hold Hold is for jobs that can **attack while moving**, like Ren, Wild Hunter, and Mechanic. Classes that can't Flash Jump while attacking (like Wind Archer and other archers) won't work with Hold. ## Maps Maps organize your routines by location. The right routines load automatically based on where you are in-game. ### Creating Maps Travel to the location in-game and click **+ New Map**. The minimap must be expanded with the map name visible. > [!NOTE] > > Adding maps is disabled if minimap dimensions match an existing map or the bot is running. ### Map Editor Double-click a map, or right-click it → **Edit**, to link it to the game's own map data: platforms, ropes, portals, and mob spawns. Most maps link automatically. Otherwise, click **Set game map...** and pick the **Suggested** map, search by name, area, or ID, or browse the World Map. A linked map adds: * Rope and ladder climbing between points * [Hyper Teleport](https://mania.bot/docs/navigation.md#hypertp-setup) without a bookmark (GMS only) * **Show platforms and mobs** in the Routine Editor > [!NOTE] > > You can't start the bot while the Map Editor is open. ## Routines Routines are sequences of points with commands that automate gameplay. ### Points Points tell MANIA where to go. Your character needs to show as a **green circle** on the minimap before you can add points. If it doesn't, see [Capture](https://mania.bot/docs/capture.md). Move to a spot in-game and press the **Start/Stop** keybind to place a point. > [!NOTE] > > **Hotkeys not working?** Try a different hotkey, or right-click MANIA → **Run as administrator**. | Setting | Description | | - | - | | Position | X,Y coordinates on the minimap | | Radius | Detection radius in pixels. Larger values allow more positioning tolerance. | | Probability | Chance this point is executed (0-100%) | Each point has settings you can customize. Right-click a point → **Edit** to adjust position, radius, or probability, or drag points directly on the minimap. Most maps work well with **5-8 points** per routine. > [!TIP] > > If the map is [linked to a game map](#map-editor), turn on **Show platforms and mobs** in the Routine Editor to see platforms, ropes, portals, and mob spawns on the minimap. ### Commands Commands execute when the bot reaches a point. Each command has parameters that control its behavior. Hover over any command or parameter in MANIA to see what it does. > [tab] Enter Portal > > Set this command in the middle of the portal for highest reliability. > > | Parameter | What it controls | > | - | - | > | Duration | Timeout for entering the portal in seconds. Increase if entry is unreliable. Default 2.0 s. | > [tab] Skill > > Casts a specific skill when the bot reaches a point. > > | Parameter | What it controls | > | - | - | > | Direction | Face left, right, up, or down before casting. | > | Hold | Hold duration in seconds. Set to 0 to tap. | > | Repetitions | Number of casts. Tap mode only. | > | Jumps | Jump this many times before casting. | > | Place | Use the `PLACE` keybind after pressing the skill. | > | Aim | Direction to hold while casting. | > | Aim Hold | How long to hold the aim direction in seconds. | > | Wait Cooldown | When off, skips the cast if on cooldown. When on, pauses until the cooldown expires before casting. | > | Wait Grounded | Wait until the character lands before casting. | > [tab] Combo Keys > > Presses two skills near-simultaneously. For skills that need a modifier key input, like Mercedes combos. > > | Parameter | What it controls | > | - | - | > | Direction | Face a direction before casting. | > | First Skill | The first skill to press. | > | Second Skill | The second skill, pressed 100 ms after the first. | > | Hold | Hold duration for both skills. Set to 0 to use each skill's Cast Time from [Keybinds](#skills). | > [tab] Random Attack > > Spreads a set number of attacks across a duration at a single point. > > | Parameter | What it controls | > | - | - | > | Direction | Initial facing direction (left or right). | > | Switch After | Switches direction after approximately this many attacks. | > | Min/Max Attacks | Number of skill presses spread across the duration. | > | Min/Max Hold | Hold time per individual press, in seconds. Set to 0 to use the skill's Cast Time from [Keybinds](#skills). | > | Min/Max Duration | Total time spent attacking at the point, in seconds. | ### Move Attack vs Skill Commands vs Random Attack MANIA gives you three ways to attack while running a routine: | Method | What it does | | - | - | | Move Attack | Fires a random skill after each jump between points. Weights set on Skills 1–6 in [Keybinds](#skills). | | Skill commands | Added to a specific point in the Routine Editor. Casts that skill when the bot arrives. | | Random Attack | Stands in place at a point and attacks for a set duration, cycling through multiple skills randomly. | Use **Move Attack** for general attack-while-moving coverage. Use **skill commands** for pinpoint casts like summons or portal entry. Use **Random Attack** for stationary attack phases. ### Loops Loops keep MANIA on a section of points for a set duration. Click **Set Loop** to pick which points to repeat. Your routine already loops as a whole, so only loop specific sections when you need them. Duration is measured in **time**, not iterations — set it to the amount of time you want and MANIA handles the rest. Make your routine loop slightly longer than your longest cooldown so skills are naturally ready each time the bot returns. ### Putting It Together **1. Place your summons** Create a point for each summon and add the summon as a command. **2. Attack until summons expire** **Lazy farm:** Hold a skill at a spot with **Add Command → Skill → Hold**, or cycle between different skills with **Add Command → Random Attack**. **Active farm:** Set two points in a **Loop** and [move attack](#move-attack-vs-skill-commands-vs-random-attack) between them. **3. Add variance** Add points with probability (**Empty**, **Skill**, or **Random Attack**) to mix things up. ### Routine Selection **Settings → General → Routine Selection** controls which routine runs when you have multiple routines on the same map. The default is **Random**. | Mode | Behavior | | - | - | | Fixed | Runs one selected routine on repeat. | | Cycle | Runs all routines top to bottom in order, then repeats. | | Random | Picks a random routine each loop. | Right-click a routine → **Duplicate** to copy it. Create two or three variations of the same route and use **Cycle** or **Random** to vary your movement patterns. See [Adding Variance](https://mania.bot/docs/best-practices.md#adding-variance) for more. ### Tips and Tricks * Prevent falling between platforms by setting a point just in front of the gap. MANIA won't use **Flash Jump** or **Teleport** if it's close to its destination. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.