> For the complete documentation index, see [llms.txt](https://docs.ragnasync.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ragnasync.com/account/usage-and-billing.md).

# Usage & Billing

How event usage is counted, and how to manage your plan and credits

RagnaSync meters how many **events** your server sends to Discord each month and checks them against your plan. This page explains how that counting works, where to watch it, and how to manage your subscription and top up with credits.

New to the plans themselves? Start with [Pricing](/account/pricing.md) for the tiers and prices.

***

## What counts as an event

Every message RagnaSync delivers to Discord on your behalf is **one event**. That includes channel chat, drop and kill announcements, `@command` and `@request` logs, custom NPC messages, WoE events, and server-status reports from the [monitoring tool](/monitoring/server-monitoring.md).

A few housekeeping actions are **free** and never count toward your limit:

| Free (uncounted)                     | Why                                         |
| ------------------------------------ | ------------------------------------------- |
| Login / logout tracking              | Background bookkeeping, not an announcement |
| Character updates                    | Keeps avatars/names fresh                   |
| System heartbeats & connection pings | Health signals, not messages                |
| WoE setup handshakes                 | Preparation, not the scored events          |

{% hint style="info" %}
Counting is **eventually consistent** — usage is tallied continuously and reconciled a few times an hour, so the number you see is accurate to within a short window rather than to the exact second.
{% endhint %}

***

## Your monthly limit

Your limit comes from your plan:

| Plan      | Monthly events |
| --------- | -------------- |
| Free      | 50,000         |
| Pro       | 300,000        |
| Unlimited | No limit       |

The counter **resets at the start of each month** — a new month starts you fresh at zero. On the Unlimited plan there's nothing to track; events never gate.

### When you get close

On a paid plan, RagnaSync warns you before you run out:

| At       | What happens                                                                                    |
| -------- | ----------------------------------------------------------------------------------------------- |
| **80%**  | "Approaching limit" notification                                                                |
| **95%**  | "Critical usage" notification                                                                   |
| **100%** | "Limit reached" — counted events are paused until you add credits, upgrade, or the month resets |

These arrive both as dashboard [notifications](/monitoring/server-monitoring/issues-notifications.md) and as emails to your billing address (no more than one of each per day, so you're never spammed). Free events keep flowing even at the limit — only counted events pause.

***

## Topping up with credits

Need a bit more headroom without changing plans? Buy a **credit pack**. Credits are added on top of your monthly limit and, unlike the monthly allowance, **don't expire at month's end** — they sit in your balance until used.

| Pack               | Credits | Price  |
| ------------------ | ------- | ------ |
| 50K Event Credits  | 50,000  | €1.99  |
| 150K Event Credits | 150,000 | €4.99  |
| 500K Event Credits | 500,000 | €14.99 |

Buy them from the **Subscription** page (see below). Your available total is always *monthly limit + remaining credits*.

***

## Managing your subscription

Open **RagnaSync → Subscription** in your dashboard to:

* **Upgrade or downgrade** between Free, Pro and Unlimited.
* **Buy credit packs.**
* **Update payment details** or open the billing portal.
* **Cancel or resume** — cancelling keeps your paid plan until the end of the current period, then drops you to Free automatically.

{% hint style="info" %}
Make sure your **billing email** is set on this page — it's where usage warnings and issue alerts are sent.
{% endhint %}

***

## Usage history

**RagnaSync → Usage History** lists individual recorded events so you can see what's consuming your allowance. Each row is tagged by source:

| Source       | Where it came from                                    |
| ------------ | ----------------------------------------------------- |
| **Ragnarok** | A script running on your game server                  |
| **Discord**  | A message relayed from Discord into the game          |
| **API**      | A direct API call, such as a monitoring/status report |

If a month's usage looks higher than expected, this is the place to find out which feature is driving it.