Mcid Connect

A Dart package for Minecraft authentication that simplifies the process of logging into Minecraft services using Microsoft accounts.

Features

Microsoft account authentication
Xbox Live authentication
Minecraft account validation
Profile information retrieval
Token management

Installation

Add this package to your pubspec.yaml:

dependencies:
  mcid_connect: ^0.0.1

Then run:

flutter pub get

Usage

Basic Authentication Flow

The authentication process involves several steps through Microsoft, Xbox Live, and Minecraft services. The AuthService class handles this flow for you:

import 'package:mcid_connect/mcid_connect.dart';

// Initialize the auth service
final authService = AuthService(
  clientId: 'your-microsoft-client-id',
  redirectUri: 'http://localhost:3000',
  scopes: ['XboxLive.signin', 'offline_access'],
  onGetDeviceCode: (deviceCodeResponse) {
    // Show verification URL and user code to the user
    print('Please visit: ${deviceCodeResponse.verificationUri}');
    print('And enter this code: ${deviceCodeResponse.userCode}');
  },
);

// Start the authentication process
Future<void> login() async {
  try {
    // Will trigger the onGetDeviceCode callback with instructions for the user
    final success = await authService.startAuthenticationFlow(useDeviceCode: true);
    
    if (success) {
      // Check if the user has a Minecraft profile
      final hasProfile = await authService.hasMinecraftProfile();
      
      if (hasProfile) {
        final profile = await authService.getMinecraftProfile();
        if (profile != null) {
          print('Successfully logged in as: ${profile.name}');
          print('UUID: ${profile.id}');
        }
      } else {
        print('Authentication successful but no Minecraft profile found');
      }
    } else {
      print('Authentication failed');
    }
  } catch (e) {
    print('Authentication failed: $e');
  }
}

Saving and Restoring Sessions

You can save and restore authentication sessions to avoid requiring users to log in repeatedly:

// Save session after successful login
Future<void> saveSession() async {
  final session = await authService.getAuthenticationData();
  // Store session data securely (e.g., using flutter_secure_storage)
}

// Restore session on app startup
Future<void> restoreSession(Map<String, dynamic> sessionData) async {
  final success = await authService.restoreAuthentication(sessionData);
  if (success) {
    final profile = authService.minecraftProfile;
    print('Session restored for: ${profile?.name}');
  } else {
    print('Session expired or invalid, new login required');
  }
}

Advanced Usage: Direct Service Access

You can also use the individual services directly for more control:

// Microsoft authentication
final microsoftAuthService = MicrosoftAuthService(
  clientId: 'your-microsoft-client-id',
  redirectUri: 'http://localhost:8080',
);

// Xbox authentication
final xboxAuthService = XboxAuthService();

// Minecraft authentication
final minecraftAuthService = MinecraftAuthService(
  clientId: 'your-client-id',
);

// Manual authentication flow
Future<void> manualAuthentication() async {
  // 1. Get Microsoft token
  final microsoftAccount = await microsoftAuthService.authenticateWithDeviceCode(
    (deviceCode) => print('Visit ${deviceCode.verificationUri} and enter ${deviceCode.userCode}'),
  );
  
  // 2. Get Xbox token using Microsoft token
  final xboxAccount = await xboxAuthService.authenticate(microsoftAccount.accessToken);
  
  // 3. Get Minecraft token using Xbox token
  final minecraftProfile = await minecraftAuthService.authenticate(xboxAccount.xstsToken);
  
  print('Logged in as: ${minecraftProfile.name}');
}

Environment Variables

For security, you can use environment variables for sensitive information:

// Create a .env file in your project root:
// MICROSOFT_CLIENT_ID=your-client-id
// REDIRECT_URI=http://localhost:8080

// Then load it in your code:
import 'package:dotenv/dotenv.dart';

void main() {
  final env = DotEnv()..load();
  
  final authService = AuthService(
    clientId: env['MICROSOFT_CLIENT_ID'] ?? '',
    redirectUri: env['REDIRECT_URI'] ?? '',
    scopes: ['XboxLive.signin', 'XboxLive.offline_access'],
    // ...
  );
}

License

This package is available under the MIT License.