Getting Started

How do I set up PlayerAnalytics on my server?
  1. Sign up at playeranalytics.org and start your free trial.
  2. In the dashboard, click Add Server — you'll get an API key (shown once, so copy it).
  3. Click Download Plugin and drop PlayerAnalytics.cs into your server's oxide/plugins/ folder.
  4. Open oxide/config/PlayerAnalytics.json, paste your key into the "SaaS — API key" field, and reload with oxide.reload PlayerAnalytics.
  5. Data starts flowing within a minute or two.
Do my players need to do anything?

No — tracking is automatic. Players can optionally sign in with Steam (free) to view their own stats, and link Steam↔Discord for rewards, but nothing is required of them for analytics to work.

Trial & Billing

How does the free trial work?

It's 14 days, free, on the monthly plan. You add a payment method at checkout, but you're not charged until the trial ends — cancel anytime before then and you pay nothing.

How much does it cost?

$9.99 / month per server. Prepay and save:

  • 3 months — $26.99 (~10% off)
  • 6 months — $49.99 (~17% off)
  • 12 months — $89.99 (~25% off — about 3 months free)

Prepaid plans bill up front and don't include the 14-day trial.

I run multiple servers — how am I billed?

Per server. Two servers on monthly = $19.98/mo, and so on. Monthly plans prorate instantly when you add or remove a server; prepaid plans lock your price for the term.

How do I change my plan or cancel?

From the Billing card in Account Settings → Manage Billing. You can switch between monthly and prepaid plans right from the dashboard — even during your trial — and cancel anytime.

Will I be warned before a renewal?

Yes. Prepaid plans get a reminder email about 7 days before they auto-renew, showing the upcoming amount.

The Plugin

Where do I download the plugin and get updates?

Use Download Plugin in the sidebar, or the plugin card in Account Settings. If a server is running an older version, you'll see a red Update Plugin badge on its card and a banner at the top of the dashboard.

I lost my API key — can I get it back?

No — for security we only ever store a scrambled (hashed) version, never the key itself. Just click Rotate Key on the server card to generate a new one, paste it into the plugin config, and reload. The old key stops working immediately.

My data isn't showing up — what's wrong?

Two quick checks:

  • If the plugin logs "Invalid API key" (401) — the key is wrong or was rotated. Repaste the current key and reload.
  • If there are no requests at all — your server can't reach api.playeranalytics.org (firewall/DNS).

Also confirm your subscription or trial is still active.

Features

When does my Server Health Score appear?

Once your server has logged about 30 player sessions and a few deaths — usually within the first day, faster on a busy server. Until then it shows "—" so it isn't misleading on thin data. It updates live, with no nightly batch to wait for.

Can I put my server stats on my own website?

Yes — generate a Stats Embed Key in Server Settings. It's read-only (the same stats a player sees, no admin metrics) and your developer pulls it from their back-end. Full guide: playeranalytics.org/stats-embed.

Can I moderate from the dashboard?

Yes — turn on Mod Mode and you get Warn / Mute / Kick / Ban on each player profile, with reason templates, auto-escalation, a Mod Log, and optional Discord mirroring.

How do I get a public page for my server?

Set a Custom URL in Server Settings (lowercase letters, numbers, and hyphens; 3–32 characters). Your page goes live at playeranalytics.org/s/your-slug with leaderboards, reviews, who's online, and your branding.

What Discord integrations are available?

Webhooks for chat mirror, wipe summaries, achievement unlocks, welcome-back, moderation, and server offline/online alerts — plus Steam↔Discord linking with auto-join and role/group rewards.

What happens to my data when I wipe?

The plugin detects the wipe and can reset per-server analytics so each wipe starts fresh (configurable). Your historical Wipe Summaries are preserved for players to look back on.

Team & Access

Can I add co-admins?

Yes — invite staff by email with the Members button. They get admin (or viewer) access and are never billed — they ride on your subscription.

Can my admins add servers or change billing?

No. Adding servers is owner-only, and billing is only visible and editable by the owner. Admins help run your existing servers — they can't create new ones or touch your plan.

Privacy

What data does the plugin collect?

Gameplay events — sessions, kills/deaths, activity, and server events — tied to Steam IDs, sent to PlayerAnalytics. See our Privacy Policy and Terms for full detail. Payment data never touches your game server; billing is handled entirely by Stripe.

Still stuck?

We're happy to help — reach out and we'll get you sorted.

Email Support