A/B Testing SDK

import net.analyse.api.Analyse;

// Get the player's assigned variant
String variant = Analyse.getVariant(player.getUniqueId(), "welcome-rewards");

// Show the appropriate experience
switch (variant) {
    case "control":
        give(player, new ItemStack(Material.BREAD, 16));
        break;
    case "diamonds":
        give(player, new ItemStack(Material.DIAMOND, 5));
        break;
    case "tools":
        giveStarterTools(player);
        break;
}

// Track when they convert
Analyse.trackConversion(
    player.getUniqueId(),
    player.getName(),
    "welcome-rewards",
    "played_one_hour"
);

String variant = Analyse.getVariant(player.getUniqueId(), "experiment-key");

// First call
String variant1 = Analyse.getVariant(uuid, "my-test");  // "control"

// Second call (same player, any time later)
String variant2 = Analyse.getVariant(uuid, "my-test");  // "control"

// Always the same!
assert variant1.equals(variant2);

String variant = Analyse.getVariant(player.getUniqueId(), "spawn-location");
if (variant == null) {
    variant = "default";  // Fallback
}

switch (variant) {
    case "spawn-a":
        teleport(player, spawnA);
        break;
    case "spawn-b":
        teleport(player, spawnB);
        break;
    default:
        teleport(player, defaultSpawn);
}

Analyse.trackConversion(
    player.getUniqueId(),
    player.getName(),
    "experiment-key",
    "conversion-event-name"
);

// In your purchase handler
@EventHandler
public void onPurchase(PlayerPurchaseEvent event) {
    Player player = event.getPlayer();
    
    // Track conversion for active experiments
    Analyse.trackConversion(
        player.getUniqueId(),
        player.getName(),
        "welcome-rewards",
        "first_purchase"
    );
}

// When player reaches 1 hour playtime
public void onOneHourPlayed(Player player) {
    Analyse.trackConversion(
        player.getUniqueId(),
        player.getName(),
        "onboarding-flow",
        "played_one_hour"
    );
}

if (Analyse.isTestActive("my-experiment")) {
    // Apply experiment logic
} else {
    // Use default behavior
}

ABTest test = Analyse.getTest("welcome-rewards");
if (test != null) {
    System.out.println("Test: " + test.getName());
    System.out.println("Status: " + test.getStatus());
    System.out.println("Variants: " + test.getVariants().size());
}

List<? extends ABTest> activeTests = Analyse.getActiveTests();
for (ABTest test : activeTests) {
    System.out.println(test.getKey() + " - " + test.getName());
}

public class WelcomeListener implements Listener {

    @EventHandler
    public void onPlayerJoin(PlayerJoinEvent event) {
        Player player = event.getPlayer();
        
        // Skip if not a new player
        if (player.hasPlayedBefore()) {
            return;
        }
        
        // Get variant assignment
        String variant = Analyse.getVariant(player.getUniqueId(), "new-player-kit");
        if (variant == null) {
            variant = "basic";  // Default if test inactive
        }
        
        // Apply the variant
        switch (variant) {
            case "basic":
                giveBasicKit(player);
                player.sendMessage("Welcome! Here's a starter kit.");
                break;
            case "premium":
                givePremiumKit(player);
                player.sendMessage("Welcome! Enjoy this premium starter kit!");
                break;
            case "guided":
                giveBasicKit(player);
                startTutorial(player);
                player.sendMessage("Welcome! Let me show you around.");
                break;
        }
    }
    
    // Track conversion when player reaches level 10
    @EventHandler
    public void onLevelUp(PlayerLevelUpEvent event) {
        if (event.getNewLevel() == 10) {
            Player player = event.getPlayer();
            Analyse.trackConversion(
                player.getUniqueId(),
                player.getName(),
                "new-player-kit",
                "reached_level_10"
            );
        }
    }
}

ABTestManager manager = Analyse.abTests();

// Get all active tests
List<? extends ABTest> tests = manager.getActiveTests();

// Get specific test
ABTest test = manager.getTest("my-test");

// Get variant for player
String variant = manager.getVariant(uuid, "my-test");

// Track conversion
manager.trackConversion(uuid, username, "my-test", "purchased");

ABTest test = Analyse.getTest("my-test");
if (test.matchesTrigger(ABTest.Trigger.FIRST_JOIN)) {
    // Only apply on first join
}

String variant = Analyse.getVariant(uuid, "test");
if (variant == null) {
    // Test not active - use default behavior
    return;
}

// ✅ Good - one variable
String color = Analyse.getVariant(uuid, "button-color");
// "red", "blue", or "green"

// ❌ Bad - multiple variables in one test
String combo = Analyse.getVariant(uuid, "ui-changes");
// "red-large-animated" - hard to know what's working

// ✅ Good - clear business value
Analyse.trackConversion(uuid, name, "onboarding", "made_purchase");
Analyse.trackConversion(uuid, name, "onboarding", "returned_day_2");

// ❌ Bad - vanity metric
Analyse.trackConversion(uuid, name, "onboarding", "clicked_button");

// ✅ Good - store variant
String variant = Analyse.getVariant(uuid, "shop-layout");
playerData.setShopVariant(variant);

// Later, use stored value
openShop(player, playerData.getShopVariant());