Pycolytics Godot Client - Event Analytics

A Godot plugin for interfacing with pycolytics, a tiny, open source event logging webservice. It provides anonymized event logging with as little as a single function call.

Requires Godot 4.4 or higher.

Getting Started

• Install this plugin from the asset library, or by copying the addons folder from this repository into your project root folder.
• Enable the plugin (pycolytics-godot) under ProjectSettings/Plugins.
• Install pycolytics
• Use the PycoLog autoload, for example PycoLog.log_event(...) to log your events.

For more examples, see examples/example.gd, or open up example.tscn in Godot!

Key Features

• Events are resources: You can export them, reuse them, set them from the editor!
• Automatic user-id and session-id generation, without requiring persistent storage.
• Automatic batched submission: Minimal performance impact.
• Autoload included: For convenient logging.
• Built-in startup and shutdown events. With customizable callbacks.

Configuration for Production

To log to a remote server, set addons/pycolytics/server_url and addons/pycolytics/api_key under project settings.

Contributing

Open an issue if you wish to contribute, or buy me a coffee if you find my work useful.

License

This project is licensed under the MIT License - see the LICENSE file for details.