Install TunedLoop in 5 Minutes

Grab the latest release from GitHub — no build step, no package manager.

Or clone it directly:

git clone https://github.com/kikusiowo-hash/tunedloop-godot-sdk

Copy the addons/tuned_loop/ folder into your Godot project's addons/ directory.

your-game/
└── addons/
    └── tuned_loop/      ← copy this folder here
        ├── plugin.cfg
        ├── tuned_loop.gd
        └── icon.png

If your project doesn't have an addons/ folder yet, create it at the project root.

Open your project in Godot and enable TunedLoop in Project Settings:

Call initialize() with your API key as early as possible — typically in your game manager or main scene's _ready() function.

func _ready():
    TunedLoop.initialize("YOUR_API_KEY")

Replace YOUR_API_KEY with the key from your TunedLoop dashboard. Get yours free below. ↓

Fire track_event() at meaningful moments in your game loop. The more context you pass, the smarter the adjustments.

TunedLoop.track_event("player_died", {
    "level": current_level,
    "cause": "spike"
})

TunedLoop.track_event("level_completed", {
    "level": current_level,
    "time": completion_time
})

Good events to track: deaths, stalls, restarts, completions, skips, rage-quits.

Connect to the difficulty_adjusted signal and apply the modifier to your game parameters. TunedLoop does the math — you just wire it up.

func _ready():
    TunedLoop.difficulty_adjusted.connect(_on_difficulty_change)

func _on_difficulty_change(modifier: float):
    enemy_speed *= modifier
    spawn_rate *= modifier