Gameye + Unity Matchmaker

# Authenticate with UGS
ugs login

# Store Gameye token as a Cloud Code secret
ugs cloud-code secrets create GAMEYE_API_TOKEN   --value "your-gameye-api-token"   --project-id $UNITY_PROJECT_ID   --environment-name production

// Fetch available Gameye regions for your image
var locResp = await UnityWebRequest.Get(
    "https://api.gameye.io/available-location/your-image-name"
).SendWebRequest();
var locations = JsonUtility.FromJson<LocationList>(locResp.downloadHandler.text);

// Measure round-trip latency to each region's pingable IP
var latencies = new Dictionary<string, float>();
foreach (var loc in locations.items) {
    latencies[loc.location] = await PingAsync(loc.latencyIp); // ms
}

// Build ticket attributes — include Gameye latencies
var attributes = new Dictionary<string, object> {
    ["skill"]              = player.mmr,
    ["gameye_europe_ms"]   = latencies.GetValueOrDefault("europe",   9999f),
    ["gameye_useast_ms"]   = latencies.GetValueOrDefault("us-east",  9999f),
    ["gameye_asia_ms"]     = latencies.GetValueOrDefault("asia-east",9999f),
};

// Submit the ticket
await MatchmakerService.Instance.CreateTicketAsync(
    new List<Unity.Services.Matchmaker.Models.Player> {
        new(AuthenticationService.Instance.PlayerId, attributes)
    },
    new CreateTicketOptions { QueueName = "ranked-queue" }
);

// gameye-allocator/index.js
// Deploy with: ugs cloud-code modules deploy ./gameye-allocator/

module.exports = {
  async Allocate({ params, context, logger }) {
    const { matchId, teams } = params;
    const players = teams.flatMap(t => t.players);

    // Select region with lowest worst-case latency across all players
    const region = selectBestRegion(players);
    logger.info(`Starting Gameye session in ${region} for match ${matchId}`);

    const res = await fetch('https://api.gameye.io/session', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${context.secrets.GAMEYE_API_TOKEN}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        location: region,
        image:    'your-image-name',
        version:  context.projectConfig.GAME_VERSION,
        args:     ['-dedicatedServer', `-maxPlayers=${players.length}`],
        labels:   { match_id: matchId },
        ttl:      3600,
      }),
    });

    if (!res.ok) {
      throw new Error(`Gameye session API error: ${res.status}`);
    }

    const session = await res.json();
    // session.host  → IP address
    // session.ports → [{ type: 'udp', container: 7777, host: 34521 }]
    const port = session.ports.find(p => p.type === 'udp').host;

    // Return format expected by Unity Matchmaker
    return { ipv4Address: session.host, port: String(port) };
  }
};

function selectBestRegion(players) {
  const regions = {
    'europe':    'gameye_europe_ms',
    'us-east':   'gameye_useast_ms',
    'asia-east': 'gameye_asia_ms',
  };
  return Object.entries(regions)
    .map(([region, attr]) => ({
      region,
      worstMs: Math.max(...players.map(p => p.attributes?.[attr] ?? 9999))
    }))
    .sort((a, b) => a.worstMs - b.worstMs)[0].region;
}

# Deploy the module to your UGS project
ugs cloud-code modules deploy ./gameye-allocator/   --project-id $UNITY_PROJECT_ID   --environment-name production

# Confirm deployment
ugs cloud-code modules list   --project-id $UNITY_PROJECT_ID   --environment-name production

{
  "name": "ranked-queue",
  "defaultEscalationRules": [],
  "pools": [
    {
      "name": "default",
      "matchLogic": {
        "type": "Sequence",
        "rules": [
          { "type": "TeamCountRule", "min": 2, "max": 2 },
          { "type": "TeamSizeRule",  "min": 5, "max": 5 }
        ]
      },
      "teams": [
        { "name": "team-a", "minPlayers": 5, "maxPlayers": 5 },
        { "name": "team-b", "minPlayers": 5, "maxPlayers": 5 }
      ],
      "serverAllocation": {
        "type": "cloudCode",
        "cloudCodeConfig": {
          "moduleName": "gameye-allocator",
          "functionName": "Allocate"
        }
      }
    }
  ]
}

# Player connected
POST https://api.gameye.io/session/player/join
{ "sessionId": "session-id", "playerId": "player-id" }

# Player disconnected
POST https://api.gameye.io/session/player/leave
{ "sessionId": "session-id", "playerId": "player-id" }