# Scripts Overview

Scripts are the primary automation tools in Polar Client. Unlike modules (which provide toggleable features), scripts are full automation sequences that control your character to perform complex tasks like mining, completing commissions, farming powder, and more.

{% hint style="info" %}
Only one script can be active at a time. Enabling a new script will disable any currently running script.
{% endhint %}

***

## 🎬 Preview

{% hint style="success" %}
**Tip:** Use the **Script Overlay** module to monitor your active script's status, current action, runtime, and earnings in real time.
{% endhint %}

***

## ⚡ How Scripts Work

When a script is enabled, it takes control of your character's movement, rotations, and interactions. Scripts use the client's **pathfinding engine** for navigation, the **rotation system** for looking at targets, and various **helpers** for background tasks like selling, refueling, and defending against mobs.

### Shared Capabilities

All scripts include the following built-in features:

| Feature                      | Description                                                            |
| ---------------------------- | ---------------------------------------------------------------------- |
| 🗺️ **Pathfinding**          | Smart navigation with walking, jumping, falling, and Etherwarp support |
| 🛡️ **Failsafe Integration** | Automatic detection and response to admin checks                       |
| 🔄 **Helper Support**        | Background selling, refueling, mob killing, and purchasing             |
| 📈 **Statistics Tracking**   | Runtime tracking of items mined, coins earned, and other metrics       |
| 📊 **Script Overlay**        | Real-time status display showing current action and stats              |
| ⌨️ **Keybind Toggle**        | Each script can be assigned a keybind for quick toggling               |

***

## ⛏️ Mining Scripts

| Script                                                                                                                   | Description                                                    |
| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |
| [**⛏️ Mining Bot**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/mining-bot)                             | General-purpose mining with dynamic, routed, and static modes  |
| [**📋 Dwarven Commission Macro**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/dwarven-commission-macro) | Automated commission completion in the Dwarven Mines           |
| [**🧊 Glacite Commission Macro**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/glacite-commission-macro) | Automated commission completion in the Glacite Tunnels         |
| [**💎 Gemstone Macro**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/gemstone-macro)                     | Route-based gemstone mining in the Crystal Hollows             |
| [**💠 Powder Macro**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/powder-macro)                         | Gemstone powder farming via hardstone mining and chest opening |

***

## ⚔️ Combat Scripts

| Script                                                                                           | Description                                                    |
| ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------- |
| [**⚔️ Combat Macro**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/combat-macro) | Customizable mob combat automation with smart weapon detection |

{% hint style="warning" %}
**Requires Polar+** — The Combat Macro is available exclusively to Polar+ subscribers.
{% endhint %}

***

## 🛠️ Utility Scripts

| Script                                                                                                   | Description                                              |
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| [**🏃 Anti-AFK**](https://docs.polarclient.lol/polar/polar-client-v3.2/miscellaneous/anti-afk)           | Idle on your island to prevent disconnection             |
| [**🏗️ Excavator Macro**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/excavator-macro)  | Automated Excavator minigame completion                  |
| [**🔄 Lobby Hopper**](https://docs.polarclient.lol/polar/polar-client-v3.2/quality-of-life/lobby-hopper) | Find Crystal Hollows lobbies meeting specific conditions |
| [**📝 Route Editor**](https://docs.polarclient.lol/polar/polar-client-v3.2/scripts/route-editor)         | Interactive route creation and editing tool              |
