# Limited Auto Attack
#### Overview
The **Auto Attack** system allows players to automatically hunt monsters on the current map. When enabled, your character will roam the map, find and attack monsters, use skills, consume potions, apply buffs, and cure status ailments — all automatically.
Auto Attack is designed as a convenience feature with **built-in penalties** to keep gameplay balanced.
***
#### How to Use
Type `@autoattack` or click the icon on top right near Mini Map to open the Auto Attack menu. From the menu, configure your settings, then select **Start** to begin.
**Chat commands:** `@autoattack` (menu), `@autoattack start`, `@autoattack stop`, `@autoattack teleport [on|off]`, `@autoattack skills [on|off]`, `@autoattack attack [on|off]`, `@autoattack boss [on|off]`.
While Auto Attack is active, your character name will display as **\[ Auto ] YourName** to other players.
***
#### Requirements
| Requirement | Details |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Minimum Playtime** | At least **60 seconds** of total stored playtime (`playtime_active` + `playtime_idle` on the account). Enforced by the playtime tracker while Auto Attack is running. |
| **Playtime earning** | **No daily cap** — active and idle playtime accumulate without a per-day limit (see **Playtime System** below). |
| **Map Restriction** | Cannot be used on **town** maps, **GvG / WoE** maps, **battleground** maps, or **indoor** maps matching `*_in` / `*_in##` naming. Auto-stops if you enter a blocked map. |
| **Weight Limit** | Stops automatically at **90%** or more of your weight capacity. |
| **Job Restriction** | **None** in map-server logic — any class may use Auto Attack where maps allow. |
| **Ammo** | Stops if you use a bow/gun-class weapon and have **no valid ammo** in the ammo slot. |
***
#### Penalties & Restrictions
| Penalty | Description |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **EXP** | Base and Job EXP are reduced by **`autoattack_exp_penalty`** (default **20%**) for kills while Auto Attack is on. |
| **Item Drops** | With `autoattack_no_drops` enabled, kills while Auto Attack is on normally **drop no items**. If you have **Auto Drop** (`SC_INSPIRATION`, e.g. consumable buff), **non-rare** drops can still roll; rare drops remain suppressed in that mode. |
| **Auto-Loot** | Automated pickup only runs when **Auto Drop** is active. Optional **Loot Filter** can skip specific item IDs. Rare items on the ground are still skipped by loot logic. |
| **Party EXP Exclusion** | Auto Attack players are **excluded** from Party Even Share EXP distribution. |
| **Playtime Consumption** | While Auto Attack is on, your **stored** playtime is **consumed** instead of increased. |
| **Events** | Some custom events refuse players in Auto Attack (`isautoattack()`); check each event NPC. |
| **Anti-Bot** | Auto Attack players are skipped by the Anti-Bot detector NPC. |
| **Rogue** | **Snatcher (Gank)** does not proc while Auto Attack is active. |
***
#### Auto-Stop Conditions
Auto Attack will **automatically stop** when any of these occur:
* You enter a **blocked map** (town, GvG/WoE, battleground, or disallowed indoor map)
* You reach **90%** overweight
* Your **stored playtime** (`active` + `idle`) **depletes to 0** (enforced by the playtime tracker)
* **Death**
* **Teleport becomes unavailable** when the server would send you to save (no Fly Wing and no Teleport skill) — *boss flee* teleport tries not to burn Auto Attack if wings are missing
* **Out of ammo** (bow / firearm with empty ammo slot)
***
#### Menu System
Open the menu with `@autoattack`. Options appear in this **exact order**:
**Main Menu**
| # | Option | Description |
| -- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 1 | **Start** | Begin Auto Attack (only on allowed field/dungeon maps). |
| 2 | **Enable Teleport \[ON/OFF]** | Fly Wing / Teleport skill to roam when no targets (when enabled). |
| 3 | **Skills \[ON/OFF]** | Use offensive skills from Skill Bar 2 Row 1. |
| 4 | **HP Potion \[ON/OFF …]** | HP autopot: pick item (or “best”) and threshold **10–100%** (10% steps). Opens sub-menus. |
| 5 | **SP Potion \[ON/OFF …]** | Same for SP. |
| 6 | **Buffs \[ON/OFF]** | Buff skills and consumable buffs from Skill Bar 2 Rows 2–3. |
| 7 | **Select Monster** | Mob filter: **\[All]** or only selected mob types on the map. |
| 8 | **Boss flee \[ON/OFF]** | When **ON** (default), random teleport if an **MVP / mini-boss / boss** is **nearby** (within \~14 cells), not merely on the same map. |
| 9 | **Normal attack \[ON/OFF]** | When **OFF**, disables melee/ranged normal attacks — useful for casters (e.g. Sage + Free Cast). |
| 10 | **Loot Filter** | Lists possible mob drops on the **current map**; toggle filter **ON/OFF** and exclude specific items from autopickup (requires Auto Drop for pickup to run). |
| 11 | **Use Offline \[ON/OFF]** | Next **Start** uses offline Auto Attack (no client), if your setup allows it. |
**HP / SP Potion Sub-Menus**
1. Choose **OFF**, or pick a **specific consumable** from eligible inventory, or **best** (highest item-DB priority).
2. Set threshold **10%**–**100%** in **10%** steps. When HP or SP falls **below** the threshold, a potion is used (subject to cooldowns).
**Eligible items** are defined in the **item database** (`autoattack_heal_mask`, `autoattack_heal_hp_prio` / `autoattack_heal_sp_prio`), not a fixed wiki table. Inventory stacks must be **tradable per item DB** (`itemdb_cantrade`); rental timers are allowed.
**Monster Filter Sub-Menu**
* Lists **unique mob types** currently on the map.
* Each mob: **ON** = allowed to target, **OFF** = ignored.
* Empty selection = **attack all** (default).
* **8 monsters per page.** Clear-all resets the filter.
**Loot Filter Sub-Menu**
* Built from **mob drop tables** on the current map (including MVP table entries listed on mobs).
* **10 items per page.**
* Turn **Loot filter** **ON**, then mark items to **exclude** from autopickup; **Pick up all (clear)** removes exclusions.
* Pickup behavior still requires **Auto Drop** (`SC_INSPIRATION`) for automated looting to run.
***
#### Skill Bar 2 Layout
Auto Attack reads skills and items from **Skill Bar 2** (the second hotkey tab). The slots are organized as follows:
**Row 1 — Offensive Skills (Slots 1–9)**
Place your **damage skills** here. Auto Attack will use them against your current target.
**Skill type rules:**
| Skill Type | Behavior |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Single-target damage skills | Used normally against the target |
| AoE / Splash damage skills | **Prioritized** when 3+ monsters are within 2 cells of your character |
| Ground-target AoE skills | **Prioritized** when 3+ monsters are within 2 cells of your character |
| `Heal` (AL\_HEAL) | Used **offensively** against Undead-element / Undead-race monsters only; level is capped to your **learned** level (includes Heal from cards / equipment) |
| `Grand Cross` (CR\_GRANDCROSS) | Cast on **self** as AoE — prioritized when 3+ monsters are within 2 cells |
> **Note:** Only damage-type and ground-target skills work in offensive slots. Support/buff skills placed here will be ignored.
**Rows 2–3 — Buff Skills & Items (Slots 10–27)**
Place your **buff skills** and **consumable buff items** here. Auto Attack will automatically reapply buffs when they expire.
**Special Heal behavior in buff slots:**
| Condition | Behavior |
| ------------------------------------------------- | ------------------------------------------------------------------------------------- |
| HP Potion is **disabled** (e.g. Acolyte / Priest) | Heal is used to **fully restore HP** — starts when HP ≤ 20%, keeps healing until 100% |
| HP Potion is **enabled** | Heal is used **once** when HP drops to ≤ 20% |
**Supported consumable buffs include:**
* Awakening Potion, Berserk Potion, Concentration Potion
* Blessing Scroll, Increase AGI Scroll, Aspersio Scroll
* Assumptio Scroll, Wind Walk Scroll, Adrenaline Rush Scroll
* All stat foods (STR/AGI/VIT/INT/DEX/LUK foods and cash variants)
**Slots 37–38 — Status Cure Items**
Place **curative items** here (server uses hotkey indices **36–37** for the two cure slots). Auto Attack will automatically use them when you're afflicted by a matching status.
| Item | Cures |
| ------------ | ------------------------------------------------------- |
| Green Potion | Poison, Silence, Blind |
| Panacea | Poison, Silence, Blind, Confusion, Curse, Hallucination |
| Royal Jelly | Poison, Silence, Blind, Confusion, Curse, Hallucination |
| Holy Water | Curse |
***
#### Available Offensive Skills by Job
Any **damage skill** (single-target, splash, or ground-target AoE) placed in Skill Bar 2 Row 1 (Slots 1–9) will be used by Auto Attack. Below are the common skills per job class:
**Novice**
| Skill | Type | Notes |
| --------------------- | ---- | ----------------------------- |
| *(Basic Attack only)* | — | No offensive skills available |
**Swordsman**
| Skill | Type | Notes |
| ------------ | ------------- | ---------------------- |
| Bash | Single-target | |
| Magnum Break | Splash AoE | Prioritized at 3+ mobs |
**Mage**
| Skill | Type | Notes |
| -------------- | ------------- | ---------------------- |
| Fire Bolt | Single-target | |
| Cold Bolt | Single-target | |
| Lightning Bolt | Single-target | |
| Soul Strike | Single-target | |
| Napalm Beat | Splash AoE | Prioritized at 3+ mobs |
| Fire Ball | Splash AoE | Prioritized at 3+ mobs |
| Thunderstorm | Ground AoE | Prioritized at 3+ mobs |
| Fire Wall | Ground AoE | Prioritized at 3+ mobs |
**Archer**
| Skill | Type | Notes |
| ------------- | ------------------- | ---------------------- |
| Double Strafe | Single-target | |
| Arrow Shower | Splash / Ground AoE | Prioritized at 3+ mobs |
**Acolyte**
| Skill | Type | Notes |
| ---------- | ------------- | ------------------------------- |
| Holy Light | Single-target | |
| Heal | Offensive | Only damages **Undead** targets |
**Merchant**
| Skill | Type | Notes |
| --------------- | ------------- | ---------------------- |
| Mammonite | Single-target | |
| Cart Revolution | Splash AoE | Prioritized at 3+ mobs |
**Thief**
| Skill | Type | Notes |
| ------- | ------------- | ----- |
| Envenom | Single-target | |
**Knight**
| Skill | Type | Notes |
| --------------- | ---------------------- | ---------------------- |
| Pierce | Single-target | |
| Spear Boomerang | Single-target (ranged) | |
| Brandish Spear | Splash AoE | Prioritized at 3+ mobs |
| Bowling Bash | Splash AoE | Prioritized at 3+ mobs |
**Crusader**
| Skill | Type | Notes |
| ---------------- | ---------------------- | ----------------------------------------------- |
| Holy Cross | Single-target | |
| Shield Boomerang | Single-target (ranged) | |
| Shield Chain | Single-target | |
| Grand Cross | Self-cast AoE | Prioritized at 3+ mobs; cast centered on player |
**Wizard**
| Skill | Type | Notes |
| ----------------- | ------------- | ---------------------- |
| Jupitel Thunder | Single-target | |
| Water Ball | Single-target | |
| Heaven's Drive | Ground AoE | Prioritized at 3+ mobs |
| Storm Gust | Ground AoE | Prioritized at 3+ mobs |
| Lord of Vermilion | Ground AoE | Prioritized at 3+ mobs |
| Meteor Storm | Ground AoE | Prioritized at 3+ mobs |
**Sage**
| Skill | Type | Notes |
| ----------------------- | ------------- | --------------------------------- |
| *Inherited Bolt skills* | Single-target | Bolts learned via Study/Free Cast |
**Priest**
| Skill | Type | Notes |
| ----------------- | ------------- | ------------------------------- |
| Holy Light | Single-target | |
| Heal | Offensive | Only damages **Undead** targets |
| Turn Undead | Single-target | |
| Magnus Exorcismus | Ground AoE | Prioritized at 3+ mobs |
**Monk**
| Skill | Type | Notes |
| -------------- | ------------- | ------------- |
| No Skill | Normal Attack | Triple Attack |
| Acolyte Skills | Single-target | |
**Hunter**
| Skill | Type | Notes |
| ------------- | ------------------- | ---------------------- |
| Double Strafe | Single-target | |
| Arrow Shower | Splash / Ground AoE | Prioritized at 3+ mobs |
| Blitz Beat | Single-target | |
**Assassin**
| Skill | Type | Notes |
| ---------- | ------------- | ---------------------- |
| Sonic Blow | Single-target | |
| Grimtooth | Splash AoE | Prioritized at 3+ mobs |
**Rogue**
| Skill | Type | Notes |
| -------- | ------------- | ----- |
| Backstab | Single-target | |
**Blacksmith**
| Skill | Type | Notes |
| --------------- | ------------- | ---------------------- |
| Mammonite | Single-target | |
| Cart Revolution | Splash AoE | Prioritized at 3+ mobs |
| Hammer Fall | Single-target | |
**Alchemist**
| Skill | Type | Notes |
| --------------- | ------------- | ---------------------- |
| Acid Terror | Single-target | |
| Demonstration | Ground AoE | Prioritized at 3+ mobs |
| Cart Revolution | Splash AoE | Prioritized at 3+ mobs |
**Bard**
| Skill | Type | Notes |
| ------------- | ------------------- | --------------------- |
| Double Strafe | Single-target | Inherited from Archer |
| Arrow Shower | Splash / Ground AoE | Inherited from Archer |
**Dancer**
| Skill | Type | Notes |
| ------------- | ------------------- | --------------------- |
| Double Strafe | Single-target | Inherited from Archer |
| Arrow Shower | Splash / Ground AoE | Inherited from Archer |
***
#### Common Buff Skills (Rows 2–3)
Place these in Skill Bar 2 **Slots 10–27**. They will be auto-cast when the buff expires:
| Skill | Class |
| --------------------- | ------------------------------------------------------ |
| Increase AGI | Acolyte / Priest |
| Blessing | Acolyte / Priest |
| Angelus | Acolyte / Priest |
| Heal (self) | Acolyte / Priest (any job with Heal learned / granted) |
| Impositio Manus | Priest |
| Suffragium | Priest |
| Gloria | Priest |
| Magnificat | Priest |
| Endure | Swordsman / Knight / Crusader |
| Two-Hand Quicken | Knight |
| Attention Concentrate | Archer / Hunter |
| Adrenaline Rush | Blacksmith |
| Weapon Perfection | Blacksmith |
| Over Thrust | Blacksmith |
| Maximum Power Thrust | Blacksmith |
| Loud Exclamation | Monk |
> **Tip:** You can also place **consumable buff items** (stat foods, ASPD potions, scrolls) in the buff slots — they will be used automatically when the buff runs out.
***
#### Playtime System
Auto Attack interacts with the **Playtime Tracker** (`npc/custom/playtime_points.txt`):
* **Minimum 60 seconds** of total stored playtime (`playtime_active` + `playtime_idle`) is required while Auto Attack is active; otherwise Auto Attack is stopped with a message.
* While Auto Attack is running, the tracker **consumes** stored playtime (active first, then idle when tied).
* If total stored playtime reaches **0**, Auto Attack stops automatically.
* Playtime **does not increase** while Auto Attack is on — you only spend banked time.
* **No daily cap** on how much active or idle playtime you can **earn** in a day (no 3-hour-per-day limit in this system).
To earn playtime, play with Auto Attack **off** (walking, combat, chat, quests, etc., per tracker rules).
**Check your status** with `@checkplaytime` (output depends on current script strings).
***
#### Quick Reference
| Feature | Value |
| ------------------------------- | ------------------------------------------------------------------------------- |
| Command | `@autoattack` (+ `start` / `stop` / `teleport` / `skills` / `attack` / `boss`) |
| EXP Penalty | Default **20%** reduction (`autoattack_exp_penalty`) |
| Item Drops | Disabled for autoattack kills unless **Auto Drop** buff — then non-rare allowed |
| Automated Loot | Requires **Auto Drop**; optional **Loot Filter** exclusions |
| Party Even Share | Excluded |
| AoE Skill Threshold | 3+ monsters within 2 cells |
| Self-Heal (buff Heal) Threshold | ≤ 20% HP |
| Overweight Limit | 90% |
| Boss Flee | **ON** by default; \~14 cell radius |
| Minimum Stored Playtime | 60 seconds (while AA is enforced) |
| Daily playtime earning cap | **None** |
| Name Display | `[ Auto ] PlayerName` |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://the-ragnarok-classic-1.gitbook.io/wiki/server-features/limited-auto-attack.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
