Python编写的Minecraft启动器启动失败，返回代码0求助

问题背景 #

使用以下Python代码启动Minecraft 1.18.2时，进程返回代码0但无法正常运行游戏：

import json
import os
import subprocess
# Function to find the Java executable
def find_java_executable():
    try:
        result = subprocess.run(["where", "java"], capture_output=True, text=True, check=True)
        output = result.stdout.strip()
        java_path = output.split("\n")[0]
        return java_path
    except subprocess.CalledProcessError:
        print("Java executable not found.")
        return None

# Function to launch Minecraft
def launch_minecraft(username, max_memory):
    java_path = find_java_executable()
    if not java_path:
        return

    minecraft_jar_path = "versions/1.18.2/1.18.2.jar"
    memory_option = f"-Xmx{max_memory}M"

    subprocess.Popen([java_path, memory_option, "-jar", minecraft_jar_path, "--username", username])

# Open config.json and nickname.json files located one level above the current directory
config_path = "../data/config.json"
nickname_path = "../data/nickname.json"

with open(config_path, 'r') as f:
    max_mem = json.load(f)
with open(nickname_path, 'r') as f:
    nickname = json.load(f)

max_memory = max_mem["ram"]
username = nickname["nickname"]

# Launch Minecraft
launch_minecraft(username, max_memory)

核心问题分析 #

返回代码0仅表示进程正常退出，但Minecraft启动失败的原因通常包括：

• 启动参数不完整：官方Minecraft需要依赖库、本地库路径、资产目录等多个参数，仅传--username无法满足启动要求
• Java版本不兼容：Minecraft 1.18.2要求Java 17，现有代码未检查Java版本
• 路径问题：相对路径可能因工作目录不对导致找不到jar或依赖文件
• 未捕获错误输出：无法得知启动过程中具体的报错信息

解决步骤 #

1. 捕获启动错误输出，定位具体问题 #

修改launch_minecraft函数，添加错误捕获和输出打印：

def launch_minecraft(username, max_memory):
    java_path = find_java_executable()
    if not java_path:
        return

    minecraft_jar_path = "versions/1.18.2/1.18.2.jar"
    # 先验证jar文件是否存在
    if not os.path.exists(minecraft_jar_path):
        print(f"错误：找不到Minecraft jar文件，路径：{os.path.abspath(minecraft_jar_path)}")
        return

    memory_option = f"-Xmx{max_memory}M"
    # 用subprocess.run替代Popen，捕获输出
    try:
        result = subprocess.run(
            [java_path, memory_option, "-jar", minecraft_jar_path, "--username", username],
            capture_output=True,
            text=True,
            check=True
        )
        print("启动日志：", result.stdout)
    except subprocess.CalledProcessError as e:
        print("启动失败，错误日志：")
        print(e.stderr)
        print(f"返回码：{e.returncode}")

2. 确保使用兼容的Java版本 #

修改find_java_executable函数，筛选Java 17版本：

def find_java_executable():
    try:
        result = subprocess.run(["where", "java"], capture_output=True, text=True, check=True)
        output = result.stdout.strip()
        java_paths = output.split("\n")
        
        # 遍历所有找到的Java路径，筛选Java 17
        for java_path in java_paths:
            try:
                version_result = subprocess.run([java_path, "-version"], capture_output=True, text=True)
                # Java版本信息在stderr输出中
                if "17" in version_result.stderr:
                    print(f"找到兼容的Java路径：{java_path}")
                    return java_path
            except Exception:
                continue
        
        print("错误：未找到Java 17版本，请安装对应版本后重试")
        return None
    except subprocess.CalledProcessError:
        print("错误：未找到Java可执行文件，请确保Java已添加到系统环境变量")
        return None

3. 使用完整的官方启动参数 #

Minecraft需要依赖库、本地库、资产目录等参数才能正常启动，参考官方启动器的参数格式修改代码：

def launch_minecraft(username, max_memory):
    java_path = find_java_executable()
    if not java_path:
        return

    # 定义游戏核心路径
    game_root = os.path.abspath(".")
    version_dir = os.path.join(game_root, "versions", "1.18.2")
    minecraft_jar = os.path.join(version_dir, "1.18.2.jar")
    version_json = os.path.join(version_dir, "1.18.2.json")

    # 验证必要文件是否存在
    for file_path in [minecraft_jar, version_json]:
        if not os.path.exists(file_path):
            print(f"错误：缺少必要文件：{file_path}")
            return

    # 读取版本信息，获取主类和依赖库
    with open(version_json, 'r', encoding='utf-8') as f:
        version_data = json.load(f)
    main_class = version_data["mainClass"]
    # 构建类路径（所有依赖库 + Minecraft jar）
    classpath = []
    for lib in version_data["libraries"]:
        lib_path = os.path.join(game_root, "libraries", lib["downloads"]["artifact"]["path"])
        classpath.append(lib_path)
    classpath.append(minecraft_jar)
    classpath_str = os.pathsep.join(classpath)

    # 构建完整启动参数
    args = [
        java_path,
        f"-Xmx{max_memory}M",
        f"-Djava.library.path={os.path.join(version_dir, '1.18.2-natives')}",  # 本地库路径
        "-cp", classpath_str,
        main_class,
        "--username", username,
        "--gameDir", game_root,
        "--assetsDir", os.path.join(game_root, "assets"),
        "--versionType", "release"
    ]

    # 启动游戏并捕获输出
    try:
        # 使用Popen保持后台运行，同时打印输出
        process = subprocess.Popen(args, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True)
        for line in process.stdout:
            print(line.strip())
    except Exception as e:
        print(f"启动异常：{str(e)}")

4. 验证文件结构完整性 #

确保游戏目录结构和官方启动器下载的一致，至少包含：

• libraries/：所有依赖库文件
• assets/：游戏资源文件
• versions/1.18.2/：包含1.18.2.jar和1.18.2.json
• versions/1.18.2/1.18.2-natives/：解压后的本地库文件（可通过官方启动器自动生成）

内容的提问来源于stack exchange，提问作者HLNikNiky