# Playtime Points

### What Is the Playtime Tracker?

The Ragnarok Classic tracks how long you actively play the game. Your accumulated playtime serves as a **currency for the Autoattack feature** — when Autoattack is turned on, it **consumes** your banked playtime instead of earning it. This system rewards players who put in real effort before benefiting from automation.

Playtime is tracked at the **account level**, meaning it persists across all characters and survives character deletion.

***

### How Playtime Is Earned

The tracker updates every **60 seconds** for all online players. Each update checks your activity status using the client's idle timer:

| Status            | Condition                    | What Happens                                                                 |
| ----------------- | ---------------------------- | ---------------------------------------------------------------------------- |
| **Active**        | Idle for less than 2 minutes | Time is added to your **Active Playtime** pool. No cap.                      |
| **Idle**          | Idle for 2 minutes or more   | Time is added to your **Idle Playtime** pool. Capped at **2 hours** maximum. |
| **Autoattack On** | Autoattack is enabled        | Time is **deducted** from your total playtime instead of earned.             |

> A player is considered "idle" when they have not performed any input (movement, skill use, chat, etc.) for **120 seconds or more**.

***

### Playtime Pools

Your total tracked playtime is split into two separate pools:

| Pool                | Description                                                                                           |     Cap     |
| ------------------- | ----------------------------------------------------------------------------------------------------- | :---------: |
| **Active Playtime** | Time earned while actively playing (moving, attacking, chatting, etc.)                                |    No cap   |
| **Idle Playtime**   | Time earned while idle (AFK but still logged in)                                                      | 2 hours max |
| **Total Playtime**  | Active + Idle combined. This is what Autoattack consumes and what is checked for unlock requirements. |      —      |

***

### Autoattack System

Autoattack is a convenience feature that lets your character attack automatically. However, it comes with playtime restrictions to prevent abuse.

#### Requirements

| Requirement          | Details                                                                                            |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| **Minimum Playtime** | You must have at least **1 hour** (60 minutes) of total playtime before Autoattack can be enabled. |
| **Playtime Balance** | Autoattack will automatically **stop** if your total playtime reaches **0**.                       |

#### How Consumption Works

While Autoattack is active, every 60-second tracker cycle **deducts** elapsed time from your total playtime instead of adding to it:

1. **Active Playtime is consumed first.** Time is subtracted from this pool until it reaches 0.
2. **Idle Playtime is consumed second.** Once active playtime is depleted, the remaining cost is taken from idle playtime.
3. **Autoattack stops at 0.** When both pools are empty, Autoattack is automatically disabled and you'll receive a message to play manually.

#### Autoattack Status Check

The server checks every **5 seconds** whether each online player has Autoattack enabled. During each check:

* If Autoattack is on but total playtime is below 1 hour, it is **force-stopped** with a warning showing how many minutes remain until unlock.
* If Autoattack is on but total playtime has been fully consumed, it is **force-stopped** with a depletion message.

***

### Player Commands

#### @checkplaytime

Available to **all players**. Displays your full playtime status in the chat window.

**Output includes:**

| Field                  | Description                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------ |
| Account ID             | Your account identifier.                                                             |
| Char ID / Level        | Current character's ID and Base Level.                                               |
| Player Name            | Current character name.                                                              |
| Status                 | ONLINE or OFFLINE (database check).                                                  |
| Timer Type             | Shows your current idle time in seconds and whether it's counting as Active or Idle. |
| Auto Attack            | Whether Autoattack is currently ON (consuming time) or OFF.                          |
| Active Playtime        | Hours and minutes of active playtime banked.                                         |
| Idle Time              | Hours and minutes of idle time banked (max 2h).                                      |
| Total Time Tracked     | Combined active + idle time (this is what Autoattack consumes).                      |
| Autoattack Unlock      | Shows "UNLOCKED" if total time is 1 hour+, or how many minutes remain.               |
| Time Since Last Update | How long since the tracker last processed your account.                              |

***

### How It All Fits Together

Here is the typical flow for a new player:

| Step                   | What Happens                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------- |
| 1. Log in              | The tracker detects you and begins recording your playtime every 60 seconds.                |
| 2. Play actively       | Active playtime accumulates with no cap. Idle time accumulates separately (max 2 hours).    |
| 3. Reach 1 hour total  | Autoattack becomes available. Your total playtime (active + idle) has passed the threshold. |
| 4. Enable Autoattack   | Playtime stops increasing and starts **decreasing** every 60 seconds instead.               |
| 5. Playtime runs out   | Autoattack is automatically disabled. You must play manually to earn more time.             |
| 6. Play manually again | Active/idle playtime begins accumulating again, replenishing your Autoattack budget.        |

***

### Technical Details

| Detail                        | Value                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------- |
| Tracker update interval       | 60 seconds                                                                             |
| Autoattack check interval     | 5 seconds                                                                              |
| Idle threshold                | 120 seconds (2 minutes) of no input                                                    |
| Idle playtime cap             | 7,200 seconds (2 hours)                                                                |
| Autoattack unlock requirement | 3,600 seconds (1 hour) total playtime                                                  |
| Storage                       | Account-based (`acc_reg_num` table) — persists across characters                       |
| Autoattack flag               | Character-based (`char_reg_num` table) — per character                                 |
| Elapsed time sanity range     | 5–179 seconds accepted per cycle; gaps over 180 seconds are treated as offline periods |

***

{% hint style="info" %}
**Economy Note:** The Playtime Tracker ensures that Autoattack is a reward for active play, not a replacement for it. By requiring real playtime before enabling automation — and consuming that time while it's active — The Ragnarok Classic keeps manual players on equal footing and prevents unattended farming from dominating the economy.
{% endhint %}


---

# 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/playtime-points.md?ask=<question>
```

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.
