Skip to content

Latest commit

 

History

History
69 lines (44 loc) · 2.61 KB

README.md

File metadata and controls

69 lines (44 loc) · 2.61 KB


PlayerLoop Godot Plugin

Get bug reports from your players, fast. Improve your game, reward the community.

If your player thinks there is a bug, you have something to fix. A lot of these do not throw exceptions in your code. With PlayerLoop, you can easily implement a bug reporting feature inside your game. You also get an easy-to-use interface to check the reports and download the savegame files and the screenshots to figure out what the problem is.

We are currently in free closed Beta! You can join us here on Discord: Discord Chat

Getting started

If you did not do that already, head over playerloop.io and sign up for an account.

You can install this Godot plugin normally, either: a) Clone this repository or b) Download it from the Godot Asset Library

Now unzip what you downloaded. It will contain a addons/ folder. Paste that folder into your Godot root project (like you would for any Godot pluging).

After installing the Library, don't forget to activate it in your Project settings. Click on Project on the top main menu, then choose Project Settings and then switch to Plugins. Enable the library as follows:

Activate Library

Now you need to set up your secret. Go to playerloop.io/settings and copy your secret to the clipboard.

Now go back inside Godot and navigate to the file res://addons/playerloop/Playerloop/playerloop.gd

And add the secret to line 13. So if your secret is ghterereeesdfsdfsd, line 13 goes from:

"playerloopSecret": ""

to

"playerloopSecret": "ghterereeesdfsdfsd"

Save the file and you are ready to go!

Now you can call the Playerloop singleton from anywhere in your code. To upload a bug report, you can simply call:

Playerloop.request.post("I found a bug in your first level!")

To attach one or more savegame files together with the report, you can add an array of filepaths to the report function:

Playerloop.request.post("I found a bug in your first level!", ["user://savegamefile.gd"])

Example project

You can find an example Godot project with a simple implementation of this library here: COMING SOON

Full reference

Coming soon

Contributing

Make a PR :)