启动器

用于启动游戏，支持原版核心以及各种 Mod 加载器

支持自动解压游戏文件，补全游戏文件

命名空间 StarLight_Core.Launch

构造函数

public MinecraftLauncher(LaunchConfig launchConfig)
{
    GameWindowConfig = launchConfig.GameWindowConfig;
    GameCoreConfig = launchConfig.GameCoreConfig;
    JavaConfig = launchConfig.JavaConfig;
    BaseAccount = launchConfig.Account.BaseAccount;
}

参数	类型	描述
launchConfig	LaunchConfig	启动参数

参数讲解

详细 LaunchConfig 定义

public class LaunchConfig
{
    public Account Account { get; set; } // 账户类型
    
    public GameWindowConfig GameWindowConfig { get; set; } // 游戏窗口配置
    
    public GameCoreConfig GameCoreConfig { get; set; } // 游戏核心配置
    
    public JavaConfig JavaConfig { get; set; } // Java 配置
}

参数	类型	描述
Account	Account	账户类型
GameWindowConfig	GameWindowConfig	游戏窗口配置
GameCoreConfig	GameCoreConfig	游戏核心配置
JavaConfig	JavaConfig	Java 配置

GameWindowConfig 游戏窗口配置

public class GameWindowConfig
{
    public int Height { get; set; } = 480; // 窗口高度

    public int Width { get; set; } = 854; // 窗口宽度
        
    public bool IsFullScreen { get; set; } = false; // 启用全屏,自动忽略上面的参数
}

GameCoreConfig 游戏核心配置

public class GameCoreConfig
{
    public string Root { get; set; } = ".minecraft"; // 游戏目录(可以是绝对的也可以是相对的,自动判断)
    
    public string Version { get; set; } // 启动的版本
    
    public bool IsVersionIsolation { get; set; } = true; // 版本隔离
    
    public string Ip { get; set; } // 自动进入服务器的 IP
    
    public string Port { get; set; } // 自动进入服务器的端口
    
    public string UnifiedPassServerId { get; set; } // 统一通行证服务器 ID 只有统一通行证需要
    
    public string Nide8authPath { get; set; } // 统一通行证 Nide8auth 路径 只有统一通行证需要
    
    public IEnumerable<string> GameArguments { get; set; } // 附加启动参数
}

JavaConfig Java 配置

public class JavaConfig
{
    public string JavaPath { get; set; }  // Java 路径 (完整路径到 Java 可执行文件)

    public int MaxMemory { get; set; } = 2048; // 最大内存

    public int MinMemory { get; set; } = 256; // 最小内存
    
    public bool DisabledOptimizationAdvancedArgs { get; set; } = false; // 启用默认优化参数
    
    public bool DisabledOptimizationGcArgs { get; set; } = false; // 启用默认 GC 优化参数
    
    public IEnumerable<string> AdvancedArguments { get; set; } // 附加 Java 参数
    
    public IEnumerable<string> GCArguments { get; set; } // 附加 GC 参数
}

方法参考

LaunchAsync 异步启动方法

public async Task<LaunchResponse> LaunchAsync(Action<ProgressReport> onProgressChanged)

参数	类型	描述
onProgressChanged	Action<ProgressReport>	启动进度报告

控制台示例

TIP

控制台示例只是为了更加方便的了解如何使用, 不建议直接复制

LaunchConfig args = new() // 配置启动参数
{
    Account = new()
    {
        BaseAccount = account // 账户
    },
    GameCoreConfig = new()
    {
        Root = ".minecraft", // 游戏根目录(可以是绝对的也可以是相对的,自动判断)
        Version = "1.18.2", // 启动的版本
        IsVersionIsolation = true, //版本隔离
        Nide8authPath = ".minecraft\\nide8auth.jar", // 只有统一通行证需要
        UnifiedPassServerId = "xxxxxxxxxxxxxxxxxx" // 同上
    },
    JavaConfig = new()
    {
        JavaPath = "xxxxxxxxxxxxxxxxxxx", // Java 路径(绝对路径)
        MaxMemory = 16384,
        MinMemory = 1000
    }
};
var launch = new MinecraftLauncher(args); // 实例化启动器
var la = await launch.LaunchAsync(ReportProgress); // 启动
                
// 日志输出
la.ErrorReceived += (output) => Console.WriteLine($"{output}");
la.OutputReceived += (output) => Console.WriteLine($"{output}");
                
if (la.Status == Status.Succeeded)
{
    // 启动成功执行操作
}