baka-mc-example 0.0.1__tar.gz

baka_mc_example-0.0.1/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.3
+Name: baka-mc-example
+Version: 0.0.1
+Summary: BakaMCExample-Python
+Author: HHCL233
+Author-email: HHCL233 <XINGTAISHIJIAOXIQU@outlook.com>
+Requires-Dist: aiofiles>=25.1.0
+Requires-Dist: dotenv>=0.9.9
+Requires-Dist: pydantic>=2.13.4
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# mc-python-example
+
+使用 Python 启动、~~管理~~你的 Minecaft 实例。

baka_mc_example-0.0.1/README.md

@@ -0,0 +1,3 @@
+# mc-python-example
+
+使用 Python 启动、~~管理~~你的 Minecaft 实例。

baka_mc_example-0.0.1/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "baka-mc-example"
+version = "0.0.1"
+description = "BakaMCExample-Python"
+readme = "README.md"
+authors = [
+    { name = "HHCL233", email = "XINGTAISHIJIAOXIQU@outlook.com" }
+]
+requires-python = ">=3.10"
+dependencies = [
+    "aiofiles>=25.1.0",
+    "dotenv>=0.9.9",
+    "pydantic>=2.13.4",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.3,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.3.1",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.16.4",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

baka_mc_example-0.0.1/src/baka_mc_example/__init__.py

@@ -0,0 +1,4 @@
+from .game_instance import launch_game_instance
+from .tools import get_mc_offline_uuid
+
+__all__ = ["get_mc_offline_uuid", "launch_game_instance"]

baka_mc_example-0.0.1/src/baka_mc_example/game_instance.py

@@ -0,0 +1,220 @@
+import json
+import platform
+import sys
+from asyncio.subprocess import Process
+from pathlib import Path
+from string import Template
+
+import aiofiles
+from pydantic import BaseModel, ConfigDict
+
+from .tools import get_mc_offline_uuid, run_cmd_realtime
+
+
+class LaunchGameInstanceReturn(BaseModel):
+    model_config = ConfigDict(arbitrary_types_allowed=True)
+
+    success: bool
+    proc: Process | None = None
+    error: Exception | None = None
+
+
+async def launch_game_instance(
+    game_name: str,
+    user_name: str,
+    game_path: str,
+    launcher_name: str,
+    launcher_ver: str,
+    core_path: str | None = None,
+    run_path: str | None = None,
+    java_path: str | None = None,
+    natives_path: str | None = None,
+    libraries_path: str | None = None,
+    game_json_path: str | None = None,
+    assets_path: str | None = None,
+    user_uuid: str | None = None,
+    max_memory: int = 6144,
+    min_memory: int = 2048,
+    window_width: int = 854,
+    window_height: int = 480,
+    user_access_token: str = "0",
+    user_type: str = "legacy",
+    xuid: str = "",
+    client_id: str = "",
+):
+    """启动Minecaft
+
+    Args:
+        game_name: 实例名称。
+        user_name: 用户名称。
+        game_path: 实例路径。
+        launcher_name: 启动器名称。
+        launcher_ver: 启动器版本。
+        core_path: 游戏jar路径，默认为f"{game_path}/{game_name}.jar"。
+        java_path: Java路径，默认为"java"。
+        run_path: 游戏运行目录，默认从Path.cwd()获取。
+        natives_path: 原生依赖目录，默认为f"{game_path}/natives-{system_name}-{system_machine}"。
+        libraries_path: 依赖库目录，默认为f"{game_path}/libraries"。
+        game_json_path: 实例JSON目录，默认为f"{game_path}/{game_name}.json"
+        assets_path: 资源目录，默认为f"{game_path}/assets"。
+        user_uuid: 用户UUID，默认从用户名生成。
+        max_memory: 最大可用内存(MB)，默认为6144。
+        min_memory: 最小可用内存(MB)，默认为2048。
+        window_width: 游戏窗口宽度，默认为854。
+        window_height: 游戏窗口高度，默认为480。
+        user_access_token: 微软账号登录令牌，默认为"0"。
+        user_type: 用户类型，离线模式为"legacy"，微软账号模式为"msa"，默认为"legacy"。
+        xuid: 微软账号登录XUID，默认为""。
+        client_id: 客户端ID，默认为""。
+    """
+    try:
+        # 获取系统基本信息
+        system_name = sys.platform
+        system_machine = platform.machine()
+        if system_name == "darwin":
+            system_name = "osx"
+        elif system_name == "win32":
+            system_name = "windows"
+
+        # 设置内存默认值
+        max_memory = max_memory or 6144
+        min_memory = min_memory or 2048
+
+        # 格式化路径
+        java_path = Path(java_path or "java").as_posix()
+        game_path = Path(game_path).as_posix()
+        core_path = Path(core_path or f"{game_path}/{game_name}.jar").as_posix()
+        run_path = Path(run_path or Path.cwd().as_posix()).as_posix()
+        natives_path = Path(
+            natives_path or f"{game_path}/natives-{system_name}-{system_machine}"
+        ).as_posix()
+        libraries_path = Path(libraries_path or f"{game_path}/libraries").as_posix()
+        game_json_path = Path(
+            game_json_path or f"{game_path}/{game_name}.json"
+        ).as_posix()
+        assets_path = Path(assets_path or f"{game_path}/assets").as_posix()
+        asset_index = "0"
+
+        # 构建UUID
+        user_uuid = user_uuid or str(get_mc_offline_uuid(user_name))
+
+        # 构建依赖库参数
+        start_libraries = []
+        libraries_split = ";" if system_name == "win32" else ":"
+        async with aiofiles.open(game_json_path, mode="r", encoding="utf-8") as f:
+            content = await f.read()
+            game_json_content = json.loads(content)
+
+        start_arguments = [
+            '"-Dfile.encoding=UTF-8"',
+            '"-Dstdout.encoding=UTF-8"',
+            '"-Dstderr.encoding=UTF-8"',
+            '"-Djava.rmi.server.useCodebaseOnly=true"',
+            '"-Dcom.sun.jndi.rmi.object.trustURLCodebase=false"',
+            '"-Dcom.sun.jndi.cosnaming.object.trustURLCodebase=false"',
+            f' "-Dminecraft.client.jar={core_path}" ',
+            f'"-Duser.home={run_path}"',
+            '"-Djava.net.useSystemProxies=true"',
+            "-XX:+UnlockExperimentalVMOptions",
+            "-XX:+UseG1GC",
+            "-XX:G1MixedGCCountTarget=5",
+            "-XX:G1NewSizePercent=20",
+            "-XX:G1ReservePercent=20",
+            "-XX:MaxGCPauseMillis=50",
+            "-XX:G1HeapRegionSize=32m",
+            "-XX:-OmitStackTraceInFastThrow",
+            "-XX:-DontCompileHugeMethods",
+            '"-XX:MaxNodeLimit=240000"',
+            '"-XX:NodeLimitFudgeFactor=8000"',
+            "-XX:TieredCompileTaskTimeout=10000",
+            '"-XX:ReservedCodeCacheSize=400M"',
+            '"-XX:NonNMethodCodeHeapSize=12M"',
+            '"-XX:ProfiledCodeHeapSize=194M"',
+            '"-XX:NmethodSweepActivity=1"',
+            "--sun-misc-unsafe-memory-access=allow",
+            '"-Dfml.ignoreInvalidMinecraftCertificates=true"',
+            '"-Dfml.ignorePatchDiscrepancies=true"',
+        ]
+        main_class = game_json_content.get("mainClass", "")
+        temp_game_arguments = game_json_content.get("arguments", {}).get("game", [])
+        temp_jvm_arguments = game_json_content.get("arguments", {}).get("jvm", [])
+        asset_index = game_json_content.get("assetIndex", {}).get("id", "0")
+        libraries_infos = game_json_content.get("libraries", [])
+        game_ver = game_json_content.get("id", "")
+        game_jar = game_json_content.get("jar", "")
+
+        def replace_arguments_placeholder(replace_str: str):
+            result = Template(replace_str).safe_substitute(
+                natives_directory=natives_path,
+                launcher_name=launcher_name,
+                launcher_version=launcher_ver,
+                classpath=libraries_split.join(unique_libraries),
+                resolution_width=window_width,
+                resolution_height=window_height,
+                auth_player_name=user_name,
+                version_name=game_ver,
+                game_directory=game_path,
+                assets_root=assets_path,
+                assets_index_name=asset_index,
+                auth_uuid=user_uuid,
+                auth_access_token=user_access_token,
+                clientid=client_id,
+                auth_xuid=xuid,
+                user_type=user_type,
+                version_type=f"{launcher_name} {launcher_ver}",
+                library_directory=libraries_path,
+                primary_jar_name=f"{game_jar}.jar",
+                classpath_separator=libraries_split,
+                fullscreen=False,
+            )
+            return result
+
+        # 解析依赖库
+        for librarie in libraries_infos:
+            for rule in librarie.get("rules", []):
+                os_name = rule.get("os", {}).get("name", "")
+                if (rule.get("action") == "allow") and (system_name != os_name):
+                    break
+            if librarie.get("downloads"):
+                librarie_path = f"{libraries_path}/{librarie.get('downloads', {}).get('artifact', {}).get('path', '')}"
+            else:
+                librarie_name: str = librarie.get("name", "")
+                librarie_name_list = librarie_name.split(":")
+                librarie_relative_path = f"{librarie_name_list[0].replace('.', '/')}/{librarie_name_list[1]}/{librarie_name_list[2]}/{librarie_name_list[1]}-{librarie_name_list[2]}.jar"
+                librarie_path = f"{libraries_path}/{librarie_relative_path}"
+            start_libraries.append(librarie_path)
+        start_libraries.append(core_path)
+        unique_libraries = list(dict.fromkeys(start_libraries))
+
+        # 添加从json内获取的参数
+        for arguments in (temp_jvm_arguments, temp_game_arguments):
+            for argument in arguments:
+                if isinstance(argument, str):
+                    start_arguments.append(replace_arguments_placeholder(argument))
+                else:
+                    rules = argument.get("rules", [])
+                    rules_allow = False
+                    for rule in rules:
+                        if (rule.get("action", "") == "allow") and (
+                            rule.get("features")
+                            or rule.get("os", {}).get("name", "") != system_name
+                        ):
+                            rules_allow = False
+                            break
+                        else:
+                            rules_allow = True
+                    if rules_allow:
+                        for value in argument.get("value", []):
+                            start_arguments.append(replace_arguments_placeholder(value))
+            if main_class not in start_arguments:
+                start_arguments.append(main_class)
+
+        # 构建完整命令
+        start_cmd = f"{java_path} -Xms{min_memory}m -Xmx{max_memory}m {' '.join(start_arguments)}"
+        print(start_cmd)
+        # 启动游戏
+        game_proc = await run_cmd_realtime(start_cmd)
+        return LaunchGameInstanceReturn(success=True, proc=game_proc)
+    except Exception as e:  # noqa: BLE001
+        # 错误处理
+        return LaunchGameInstanceReturn(success=False, error=e)

baka_mc_example-0.0.1/src/baka_mc_example/tools.py

@@ -0,0 +1,44 @@
+import asyncio
+import hashlib
+import uuid
+
+
+async def run_cmd_realtime(cmd: str):
+    # 创建异步子进程
+    proc = await asyncio.create_subprocess_shell(
+        cmd, stdout=asyncio.subprocess.PIPE, stderr=asyncio.subprocess.PIPE
+    )
+
+    return proc
+
+    """
+    # 实时读取标准输出
+    async def read_stream(stream, prefix="[stdout]"):
+        async for line in stream:
+            # line 是 bytes 类型，需要 decode
+            print(f"{prefix} {line.decode().rstrip()}")
+
+    # 同时实时读取 stdout 和 stderr
+    await asyncio.gather(
+        read_stream(proc.stdout, "[stdout]"), read_stream(proc.stderr, "[stderr]")
+    )
+    
+
+    # 等待子进程退出并获取返回码
+    await proc.wait()
+    print(f"[{cmd!r} exited with {proc.returncode}]")
+    """
+
+
+def get_mc_offline_uuid(username: str) -> uuid.UUID:
+    # 构造字符串前缀
+    target_str = f"OfflinePlayer:{username}"
+
+    # 计算MD5哈希的16字节原始数据
+    hash_bytes = bytearray(hashlib.md5(target_str.encode("utf-8")).digest())
+
+    # 设置UUID标志位
+    hash_bytes[6] = (hash_bytes[6] & 0x0F) | 0x30  # Version 3
+    hash_bytes[8] = (hash_bytes[8] & 0x3F) | 0x80  # Variant RFC 4122
+
+    return uuid.UUID(bytes=bytes(hash_bytes))