Godot SDK Setup Guide

✅ Automatic Detection

# The SDK automatically detects:
func _detect_multiplayer_mode():
    if not multiplayer.has_multiplayer_peer():
        return "Single Player"
    elif multiplayer.is_server():
        return "Multiplayer Host/Server"
    else:
        return "Multiplayer Client"

# Events are automatically filtered:
# - Host/Server: ✅ Tracks events
# - Client: ❌ Blocks events (prevents duplicates)

🔧 Force Client Events

# For client-specific events (UI, local actions)
func _on_ui_button_clicked():
    Tokebi.track_client_event("ui_interaction", {
        "button": "inventory",
        "screen": "main_menu"
    })

# Or use force parameter
func _on_local_event():
    Tokebi.track("local_action", {
        "action": "screenshot_taken"
    }, true)  # force_track = true

📊 Session Tracking

# Track complete game sessions
extends Node

var session_start_time: float
var areas_visited: Array = []
var actions_performed: int = 0

func _ready():
    session_start_time = Time.get_time_dict_from_system()
    Tokebi.track("session_started", {
        "platform": OS.get_name(),
        "screen_size": get_viewport().get_visible_rect().size,
        "language": OS.get_locale()
    })

func _exit_tree():
    var session_duration = Time.get_time_dict_from_system() - session_start_time
    Tokebi.track("session_ended", {
        "duration_seconds": session_duration,
        "areas_visited": areas_visited,
        "actions_performed": actions_performed,
        "reason": "game_exit"
    })

🎯 Custom Player Events

# Create reusable tracking functions
extends Node

func track_player_progression(level: int, xp: int):
    Tokebi.track("player_level_up", {
        "new_level": level,
        "total_xp": xp,
        "time_played": get_total_playtime(),
        "achievements_unlocked": get_achievement_count()
    })

func track_combat_event(enemy: String, outcome: String):
    Tokebi.track("combat_" + outcome, {
        "enemy_type": enemy,
        "player_level": get_player_level(),
        "weapon_used": get_current_weapon(),
        "damage_dealt": get_damage_dealt(),
        "health_remaining": get_player_health()
    })

✅ Console Output

# The SDK provides detailed logging:
[Tokebi] Initializing SDK...
[Tokebi] Player ID: player_1642123456_7834
[Tokebi] Mode: Single Player
[Tokebi] Game registered! ID: game_abc123
[Tokebi] Tracking: level_completed
[Tokebi] Event sent successfully

# Check the Output panel in Godot
# for real-time tracking feedback

🔍 Test Events

# Create a simple test script:
extends Node

func _ready():
    # Wait for SDK to initialize
    await get_tree().create_timer(1.0).timeout
    
    # Test basic tracking
    test_tracking()

func test_tracking():
    print("Testing Tokebi tracking...")
    
    Tokebi.track("test_event", {
        "test_data": "hello world",
        "timestamp": Time.get_time_dict_from_system()
    })
    
    print("Test event sent!")

✅ Good Payload Examples

# Simple values
{
  "level": 5,
  "score": 1250,
  "completed": true
}

# Nested dictionaries
{
  "player_stats": {
    "health": 100,
    "mana": 50
  },
  "location": "forest_area"
}

# Arrays
{
  "items_collected": ["sword", "potion", "key"],
  "enemy_types": ["goblin", "orc"]
}

# Mixed types
{
  "success": true,
  "attempts": 3,
  "time_taken": 45.7,
  "bonus_earned": "speed_bonus"
}

❌ Avoid These Patterns

# Don't include Godot objects
{
  "player_node": player_reference,  # ❌ Objects can't be serialized
  "scene": get_tree().current_scene  # ❌ Complex objects
}

# Don't use functions or callables
{
  "callback": my_function,  # ❌ Functions aren't serializable
  "signal": some_signal     # ❌ Signals aren't data
}

# Keep nesting simple (max 2-3 levels)
{
  "player_data": {
    "stats": {
      "nested_info": "this is getting complex"
    }
  }
}

# Better approach - flatten the structure
{
  "player_level": 5,
  "player_health": 100,
  "player_location": "forest_area"
}