Godot Analytics

Know what players actually do in your game. Track events, measure engagement, collect feedback. All without tying yourself to a single analytics platform.

Pure GDScript, zero dependencies. Drop it in your project and you're good to go.

---

Why this plugin?

Most analytics SDKs lock you into one service. This one lets you write your tracking code once and swap providers whenever you want, just by editing a config file. Start with PostHog, move to your own backend later. Your game code stays the same.

Built by an indie studio for indie studios. We use it on our own party game to track player activities.

Features

🔌 Provider-agnostic. Ships with PostHog, a generic HTTP endpoint, and a console logger. Want something else? Swap providers without changing a single line of game code.

⏱️ Timed events. Measure how long players spend on a level, a menu, a match. One line to start, one line to stop. The plugin handles the math.

📦 Smart batching. Events pile up in a queue and get sent together. Your framerate won't notice a thing.

💾 Works offline. Lost connection mid-session? No problem. Events get saved to disk and sent automatically when the network comes back.

🔑 Anonymous by default. A device ID is generated and stored locally. No account required, no PII collected. You can optionally call identify() if you need to link events to a known player.

🧩 Easy to extend. Adding your own provider takes about 10 lines of GDScript. Just implement send_batch() and you're done.

Quick start

1. Copy addons/analytics/ into your project
2. Enable the plugin in Project → Plugins
3. Edit analytics.cfg with your provider and API key

That's it !

Usage

# Track an event
Analytics.capture("level_completed", {"level": "tutorial", "score": 1200})
# Timed event (auto-calculates duration_ms)
var stop = Analytics.start_timed("match_played", {"map": "volcano"})
# ... gameplay ...
stop.call({"winner": "player_2"})

Included providers

🖥️ Console prints events straight to Godot's output. Great for development.

🌐 HTTP does a plain JSON POST to any URL you give it. Hook it up to your own backend, Mixpanel, Countly, whatever works for you.

Want more providers ? Here's a list of the currents providers that we sell :

- Posthog

Requirements

• Godot 4.x (tested on 4.3+)
• GDScript only, no C# or GDExtension needed

License

PolyForm Shield 1.0.0

You can use it in your games (commercial or not) and modify it for your needs. You just can't redistribute or resell the plugin itself. Full terms in LICENSE.md.

Links

• 🌐 titangstudio.fr
• 💬 Got questions? Open a topic in the Community tab