mmccli 0.1.0__py3-none-any.whl

mmccli/__init__.py

@@ -0,0 +1 @@
+from .app import app

mmccli/add.py

@@ -0,0 +1,327 @@
+# mmccli.minecraft.add
+import json
+import os
+import ssl
+import time
+from pathlib import Path
+from typing import Literal
+
+import certifi
+import requests
+from pypdl import Pypdl
+from pypdl.utils import EFuture, FileValidator
+from rich.progress import Progress
+
+from mmccli.cache import (
+    get_assets_cache_file_path,
+    get_forge_installer_cache_file_path,
+    get_library_cache_file_path,
+    get_version_jar_cache_file_path,
+    link_or_move,
+)
+from mmccli.forge import ForgeInstallerVersionInfo
+from mmccli.forge.model import ForgeInstallerInstallProfileJson, ForgeInstallerVersionJson
+from mmccli.log import RequestStatusError, console, out, warn
+from mmccli.minecraft import (
+    McGameAssetIndexJson,
+    McGameVersionJson,
+    McGameVersionJson_FileModel,
+    McGameVersionJson_LibrariesItem,
+    McLauncherLaunchProfilesJson,
+    McLauncherLaunchProfilesJson_ProfilesItem,
+    validate_assets,
+    validate_libraries,
+)
+
+ssl_context = ssl.create_default_context(cafile=certifi.where())
+
+COPY_DICT = dict[str | Path, str | Path]
+
+
+def load_mc_version_json(version_json_url: str) -> McGameVersionJson:
+    response = requests.get(version_json_url)
+    out(version_json_url)
+    data = response.json()
+    if not response.ok:
+        raise RequestStatusError(f"获取游戏版本 version.json 时请求失败 | {version_json_url=}")
+    return McGameVersionJson.model_validate(data)
+
+
+def load_assetsIndex_json(assetIndex_json_url: str) -> McGameAssetIndexJson:
+    response = requests.get(assetIndex_json_url)
+    out(assetIndex_json_url)
+    data = response.json()
+    if not response.ok:
+        raise RequestStatusError(f"获取游戏资源索引 assetIndex.json 时请求失败 | {assetIndex_json_url=}")
+    return McGameAssetIndexJson.model_validate(data)
+
+
+def download_libraries(
+    libraries: list[McGameVersionJson_LibrariesItem],
+    dl: Pypdl,
+    libraries_from: Literal["minecraft", "forge", "fabric"],
+):
+    if libraries_from == "minecraft":
+        base_url = os.environ.get("MCLI_MC_GAME_DOWNLOAD_LIBRARIES_URL", None)
+        template_url_prefix = "https://libraries.minecraft.net/"
+    elif libraries_from == "forge":
+        base_url = os.environ.get("MCLI_FORGE_DOWNLOAD_LIBRARIES_URL", None)
+        template_url_prefix = "https://maven.minecraftforge.net/"
+    elif libraries_from == "fabric":
+        base_url = os.environ.get("MCLI_FABRIC_DOWNLOAD_LIBRARIES_URL", None)
+        template_url_prefix = "https://maven.fabricmc.net/"
+    else:
+        raise RuntimeError(f"Unexpected value {libraries_from=}")
+
+    # 并非所有库文件都要下载，此处存放需要下载的库文件
+    download_list: list[McGameVersionJson_LibrariesItem] = []
+
+    for item in libraries:
+        if item.rules is None:  # 没有 rules 的 library
+            download_list.append(item)
+            continue
+
+        for rule in item.rules:
+            if rule.action == "allow" and rule.os and rule.os.name == "windows":
+                download_list.append(item)
+
+    # 拼装任务列表，批量下载
+    tasks = []
+    copy_dict: COPY_DICT = {}
+    total_size = 0
+    for item in download_list:
+        item: McGameVersionJson_LibrariesItem  # type: ignore[no-redef]
+        if item.downloads.artifact.url == "":  # 为什么会存在 library 的 url 为空呢？
+            continue  # 原来这个玩意是不需要手动下载的呀！
+        file_path = Path.cwd() / ".minecraft" / "libraries" / item.downloads.artifact.path  # 游戏目录中的库文件路径
+        file_path.parent.mkdir(exist_ok=True, parents=True)
+        cache_file_path = get_library_cache_file_path(item.downloads.artifact.path)  # 缓存中的库文件路径
+        cache_file_path.parent.mkdir(exist_ok=True, parents=True)
+        copy_dict[file_path] = cache_file_path  # 建立关联
+        if cache_file_path.exists():
+            continue  # 信任缓存，跳过缓存命中
+        if item.downloads.artifact.size:
+            total_size += item.downloads.artifact.size
+        url = (
+            item.downloads.artifact.url.replace(template_url_prefix, base_url)
+            if base_url
+            else item.downloads.artifact.url
+        )
+        out(url)
+        tasks.append(
+            {
+                "url": url,
+                "file_path": str(cache_file_path),
+                "retries": 2,
+                "segments": 8 if item.downloads.artifact.size and item.downloads.artifact.size >= 2_000_000 else 2,
+                "mirrors": item.downloads.artifact.url if base_url else None,
+            }
+        )
+    out(f"待下载库文件数量 | {len(tasks)=}")
+
+    if len(tasks) > 0:
+        results = _multi_download_with_progress(tasks, total_size, dl)
+        validate_libraries(download_list, results)
+    out("链接或复制文件……")
+
+    for file_path, cache_file_path in copy_dict.items():  # type: ignore[assignment]
+        link_or_move(cache_file_path, file_path)
+    out("库文件已下载完成。")
+
+
+def download_assets(assetIndex_data: McGameAssetIndexJson, dl: Pypdl):
+    # 拼装任务列表，批量下载
+    tasks = []
+    copy_dict: COPY_DICT = {}
+    total_size = 0
+    base_url = os.environ.get("MCLI_MC_GAME_DOWNLOAD_ASSETS_URL", None)
+    for item in assetIndex_data.objects.values():
+        file_path = Path.cwd() / ".minecraft" / "assets" / "objects" / item.hash[:2] / item.hash
+        file_path.parent.mkdir(exist_ok=True, parents=True)
+        cache_file_path = get_assets_cache_file_path(f"objects/{item.hash[:2]}/{item.hash}")
+        cache_file_path.parent.mkdir(exist_ok=True, parents=True)
+        copy_dict[file_path] = cache_file_path
+        if cache_file_path.exists():
+            continue  # 信任缓存，跳过缓存命中
+        total_size += item.size
+        path = item.hash[:2] + "/" + item.hash
+        url = (base_url if base_url else "https://resources.download.minecraft.net/") + path
+        out(url)
+        tasks.append(
+            {
+                "url": url,
+                "file_path": str(cache_file_path),
+                "retries": 2,
+                "segments": 4 if item.size >= 1_000_000 else 1,
+                "mirrors": ("https://resources.download.minecraft.net/" + path) if base_url else None,
+            }
+        )
+    out(f"待下载资源文件数量 | {len(tasks)=}")
+
+    if len(tasks) > 0:
+        results = _multi_download_with_progress(tasks, total_size, dl)
+        validate_assets(list(assetIndex_data.objects.values()), results)
+    out("链接或复制文件……")
+
+    for file_path, cache_file_path in copy_dict.items():  # type: ignore[assignment]
+        link_or_move(cache_file_path, file_path)
+    out("资源文件已下载完成。")
+
+
+def download_mc_version_jar(version_id: str, clientItem: McGameVersionJson_FileModel, dl: Pypdl, name: str):
+    file_path = Path.cwd() / ".minecraft" / "versions" / name / (name + ".jar")
+    file_path.parent.mkdir(exist_ok=True, parents=True)
+    cache_file_path = get_version_jar_cache_file_path("client/" + version_id + ".jar")
+    cache_file_path.parent.mkdir(exist_ok=True, parents=True)
+    base_url = os.environ.get("MCLI_MC_GAME_DOWNLOAD_VERSIONS_URL", None)
+    if not cache_file_path.exists():  # 信任缓存
+        result = _single_download_with_progress(
+            url=clientItem.url.replace("https://piston-data.mojang.com/", base_url) if base_url else clientItem.url,
+            mirrors=clientItem.url if base_url else None,
+            file_path=str(cache_file_path),
+            size=clientItem.size,
+            dl=dl,
+        )
+        if result[0][1].get_hash("sha1") != clientItem.sha1:
+            warn("下载的版本游戏主文件 version.jar 存在损坏。")
+    out("链接或复制文件……")
+
+    link_or_move(cache_file_path, file_path)
+    out("版本 jar 游戏主文件下载完成。")
+
+
+def download_forge_installer_jar(info: ForgeInstallerVersionInfo, dl: Pypdl):
+    cache_file_path = get_forge_installer_cache_file_path(info.name)
+    cache_file_path.parent.mkdir(exist_ok=True, parents=True)
+    if not cache_file_path.exists():  # 信任缓存
+        result = _single_download_with_progress(
+            url=f"https://bmclapi2.bangbang93.com/forge/download/{info.build}",
+            file_path=str(cache_file_path),
+            dl=dl,
+        )
+        if result[0][1].get_hash("sha1") != info.hash:
+            warn("下载的 Forge 安装器文件存在损坏。")
+
+    return cache_file_path
+
+
+def analysis_forge_installer_version_json(file_path: str):
+    from tempfile import TemporaryDirectory
+    from zipfile import ZipFile
+
+    with TemporaryDirectory() as tmp_dir:
+        tmp_path = Path(tmp_dir)
+        with ZipFile(file=file_path, mode="r") as z:
+            z.extractall(tmp_path / "forge-installer-extractall")
+
+        with open(file=tmp_path / "forge-installer-extractall" / "version.json") as f:
+            version_json = ForgeInstallerVersionJson.model_validate_json(f.read())
+
+        with open(file=tmp_path / "forge-installer-extractall" / "install_profile.json") as f:
+            install_profile_json = ForgeInstallerInstallProfileJson.model_validate_json(f.read())
+
+    out("已在临时目录解压并解析 Forge 安装器内的 version.json 和 install_profile.json")
+    return version_json, install_profile_json
+
+
+def save_mc_version_json(version_json: McGameVersionJson, name: str):
+    file_path = Path.cwd() / ".minecraft" / "versions" / name / (name + ".json")
+    file_path.parent.mkdir(exist_ok=True, parents=True)
+    with open(file=file_path, mode="w", encoding="UTF-8") as f:
+        f.write(version_json.model_dump_json(exclude_unset=True, indent=4))
+    out("已保存版本 json 文件。")
+
+
+def save_assetIndex_json(assetIndex_id: str, assetIndex_json: McGameAssetIndexJson):
+    file_path = Path.cwd() / ".minecraft" / "assets" / "indexes" / (assetIndex_id + ".json")
+    file_path.parent.mkdir(exist_ok=True, parents=True)
+    with open(file=file_path, mode="w", encoding="UTF-8") as f:
+        f.write(assetIndex_json.model_dump_json(exclude_unset=True, indent=4))
+    out("已保存资源文件索引 json 文件。")
+
+
+def save_launcher_profiles_json(mc_version_json: McGameVersionJson):
+    from datetime import datetime
+    from uuid import uuid4
+
+    key = uuid4().hex
+    now = datetime.now()
+
+    # 已有启动器配置文件就写入，否则新建
+    file_path = Path.cwd() / ".minecraft" / "launcher_profiles.json"
+    file_path.parent.mkdir(exist_ok=True, parents=True)
+    profile = McLauncherLaunchProfilesJson_ProfilesItem(
+        created=now.isoformat(),
+        icon="Grass",
+        javaArgs="-Xms2G -Xmx4G -XX:+UseCompactObjectHeaders -XX:+AlwaysPreTouch -XX:+UseStringDeduplication -XX:+UseZGC",
+        lastUsed="1970-01-01T00:00:00.000Z",
+        lastVersionId=mc_version_json.id,
+        name=mc_version_json.id,
+        type="custom",
+    )
+    if file_path.exists():
+        with open(file=file_path, mode="r") as f:
+            launcher_profiles = McLauncherLaunchProfilesJson.model_validate_json(f.read())
+            launcher_profiles.profiles["key"] = profile
+    else:
+        launcher_profiles = McLauncherLaunchProfilesJson(
+            profiles={key: profile},
+            settings={},
+            version=6,
+        )
+    with open(file=file_path, mode="w", encoding="UTF-8") as f:
+        f.write(launcher_profiles.model_dump_json(indent=4))
+    out("已更新或新建启动器配置 json 文件。")
+
+
+def _multi_download_with_progress(tasks: list[dict], total_size: int, dl: Pypdl) -> list[tuple[str, FileValidator]]:
+    future: EFuture = dl.start(
+        tasks=tasks,
+        block=False,
+        hash_algorithms="sha1",
+        display=False,
+        proxy=os.environ.get("HTTP_PROXY", None),
+        overwrite=False,
+        ssl=ssl_context,
+    )
+
+    if len(tasks) > 0:
+        with Progress(console=console, transient=True) as progress:
+            task_files = progress.add_task("[cyan]下载总文件", total=dl.total_task)
+            task_size = progress.add_task("[green]下载总空间", total=total_size)
+            while not dl.completed:
+                progress.update(task_files, completed=dl.completed_task)
+                progress.update(task_size, completed=dl.current_size)
+                time.sleep(0.5)
+
+    return future.result()  # type: ignore[no-any-return]
+
+
+def _single_download_with_progress(
+    url: str,
+    file_path: str,
+    dl: Pypdl,
+    mirrors: str | list[str] | None = None,
+    size: int | None = None,
+) -> list[tuple[str, FileValidator]]:
+    future: EFuture = dl.start(
+        url=url,
+        file_path=file_path,
+        mirrors=mirrors,
+        segments=8,
+        retries=2,
+        block=False,
+        overwrite=False,
+        hash_algorithms="sha1",
+        display=False,
+        proxy=os.environ.get("HTTP_PROXY", None),
+        ssl=ssl_context,
+    )
+
+    with Progress(console=console, transient=True) as progress:
+        task_size = progress.add_task("[green]下载空间", total=size)
+        while not dl.completed:
+            progress.update(task_size, completed=dl.current_size)
+            time.sleep(0.5)
+
+    return future.result()  # type: ignore[no-any-return]

mmccli/app.py

@@ -0,0 +1,227 @@
+# mmccli.app
+from dotenv import load_dotenv
+
+from mmccli.forge import rename_forge_version
+from mmccli.path_dector import detect_minecraft_install_folder
+
+load_dotenv()
+
+import re
+from typing import Annotated
+
+import typer
+
+from mmccli.log import err, info, out, useGlobalState, warn
+from mmccli.minecraft import app_minecraft, load_mc_version_from_cache
+
+app = typer.Typer(help="Minecraft Java Cli", name="MCLI")
+app.add_typer(app_minecraft)
+
+pattern = re.compile(r"To sign in, use a web browser to open the page (\S*) and enter the code (\S*) to authenticate.")
+
+
+@app.command()
+def login():
+    """
+    登录微软账号，验证您的 Minecraft Java 版游戏所有权。
+
+    由于未获得 Mojang 批准所以 TvT
+    """
+    err("正版登录尚不可用，因为 Mojang 没有批准 MCLI 访问其游戏服务 API。")
+    raise typer.Exit(code=100)
+
+    from mmccli.ms_oauth import (
+        login_for_minecraft_with_xsts,
+        login_for_xbox_live,
+        login_for_xsts,
+        login_with_microsoft_oauth,
+        wait_for_access_token,
+    )
+
+    out("正在创建 Device Code 以登录微软账号……")
+
+    flow = login_with_microsoft_oauth()
+    validateInfo: tuple[str, str] = pattern.findall(flow["message"])[0]
+    info(f"请在浏览器中打开页面 {validateInfo[0]}，并输入代码 {validateInfo[1]} 完成登录。")
+
+    ms_data = wait_for_access_token(flow)  # 阻塞直到用户授权
+    out("已完成微软账号登录，开始 Xbox Live 验证……")
+
+    xbl_data = login_for_xbox_live(ms_data.access_token)
+    out("已完成 Xbox Live 验证，开始获取 XSTS 令牌。")
+
+    xsts_data = login_for_xsts(xbl_data.Token)
+    out("已获取 XSTS 令牌，开始获取 Minecraft 令牌。")
+
+    mc_data = login_for_minecraft_with_xsts(xsts_data.DisplayClaims.xui[0].uhs, xsts_data.Token)
+    out("已获取 Minecraft 令牌，开始获取玩家信息。")
+
+
+@app.command()
+def add(
+    mc_version_id: Annotated[
+        str, typer.Option("--minecraft", "-mc", help="Minecraft 本体版本，或用 latest-release 和 latest-snapshot")
+    ],
+    forge_version_promo_or_id: Annotated[
+        str | None,
+        typer.Option("--forge", "-fo", help="Forge 加载器版本，或用 latest 和 recommended，不安装 forge 请省略"),
+    ] = None,
+    fabric_version_promo_or_id: Annotated[
+        str | None,
+        typer.Option("--fabric", "-fa", help="Fabric 加载器版本，或用 latest，不安装 fabric 请省略"),
+    ] = None,
+    name: Annotated[str | None, typer.Option("--name", "-n", help="版本的自定义名称")] = None,
+):
+    """
+    添加一个游戏版本并立刻开始构建。
+    """
+    if detect_minecraft_install_folder():
+        out(f"{useGlobalState.MINECRAFT=}")
+    else:
+        raise typer.Exit(code=418)
+
+    forge_version_info = None
+    fabric_version_info = None
+    if forge_version_promo_or_id and fabric_version_promo_or_id:
+        err("无法同时安装 Forge 和 Fabric 加载器。")
+        raise typer.Exit(code=500)
+
+    info("正在查找 Minecraft 版本信息……")
+    mc_version = load_mc_version_from_cache(mc_version_id, True)  # latest-release 和 latest-snapshot 在此方法内处理
+    if not mc_version:
+        err(f"未找到游戏版本 {mc_version_id}，请检查。")
+        raise typer.Exit(code=404)
+
+    if forge_version_promo_or_id:
+        from mmccli.forge import load_forge_version_from_cache
+
+        info("正在查找 Forge 版本信息……")
+        forge_version_info = load_forge_version_from_cache(mc_version.id, forge_version_promo_or_id, True)
+        if not forge_version_info:
+            err(f"未找到支持 {mc_version.id} 的 Forge 版本 {forge_version_promo_or_id}，请检查。")
+            raise typer.Exit(code=404)
+        info(f"已确认 Forge 版本 {forge_version_info.name}")
+
+    if fabric_version_promo_or_id:
+        from mmccli.fabric import load_fabric_versions
+
+        info("正在查找 Fabric 版本信息……")
+        fabric_version_info = load_fabric_versions(mc_version.id, fabric_version_promo_or_id)
+        if not fabric_version_info:
+            err(f"未找到 Fabric 版本 {fabric_version_promo_or_id}，请检查。")
+            raise typer.Exit(code=404)
+        info(f"已确认 Fabric 版本 {fabric_version_info.loader.version}")
+
+    if not name:
+        name = mc_version.id
+        if fabric_version_info:
+            name += "-fabric-" + fabric_version_info.loader.version
+
+    from mmccli.add import (
+        analysis_forge_installer_version_json,
+        download_assets,
+        download_forge_installer_jar,
+        download_libraries,
+        download_mc_version_jar,
+        load_assetsIndex_json,
+        load_mc_version_json,
+        save_assetIndex_json,
+        save_launcher_profiles_json,
+        save_mc_version_json,
+    )
+
+    version_json = load_mc_version_json(mc_version.url)
+    vanilla_mc_version_id = version_json.id
+    version_json.id = name  # 将自定义版本名称覆盖到 version.json
+    info("已解析版本索引文件，开始下载库文件……")
+
+    from pypdl import Pypdl
+
+    dl = Pypdl(max_concurrent=48, allow_reuse=True)
+    download_libraries(version_json.libraries, dl, "minecraft")
+    info("库文件下载完成，开始解析资源索引文件……")
+
+    assetIndex_json = load_assetsIndex_json(version_json.assetIndex.url)
+    info("已解析资源索引文件，开始下载资源文件……")
+
+    download_assets(assetIndex_json, dl)
+    info("资源文件下载完成，开始下载游戏主文件……")
+
+    download_mc_version_jar(
+        vanilla_mc_version_id,
+        version_json.downloads["client"],
+        dl,
+        vanilla_mc_version_id if forge_version_info else name,
+    )  # 由于 Forge 安装器需要基于合法的原版游戏进行安装，所以要保留合法的原版游戏。
+    info("游戏主文件下载完成，保存资源索引……")
+
+    save_assetIndex_json(version_json.assets, assetIndex_json)
+    save_mc_version_json(version_json, name)
+    save_launcher_profiles_json(version_json)
+    info(f"已添加 Minecraft Java {version_json.id}")
+
+    if forge_version_info:
+        forge_installer_path = download_forge_installer_jar(forge_version_info, dl)
+        info(f"已下载 Forge 安装器 {forge_version_info.name}，开始解析 Forge 版本信息……")
+
+        forge_version_json, forge_install_profile_json = analysis_forge_installer_version_json(forge_installer_path)
+        info("已解析 Forge 版本信息，开始下载 Forge 库文件……")
+
+        download_libraries(forge_version_json.libraries + forge_install_profile_json.libraries, dl, "forge")
+        info("Forge 库文件下载完成，开始安装 Forge……")
+
+        from mmccli.forge import install_forge_silently
+
+        if install_forge_silently(str(forge_installer_path), str(useGlobalState.MINECRAFT)):
+            rename_forge_version(vanilla_mc_version_id, forge_version_info.id, name)
+            info(f"{forge_version_info.name} 已为 Minecraft {version_json.id} 安装成功。（共安装两个实例）")
+        else:
+            warn(f"{forge_version_info.name} 安装失败，但游戏本体应当安装成功。")
+
+    if fabric_version_info:
+        from mmccli.fabric import build_version_json_libraries_item, update_mc_version_json_with_fabric
+
+        fabric_libraries = [
+            build_version_json_libraries_item(
+                name=library.name,
+                base_url=library.url if library.url else "https://libraries.mojang.com/",
+                size=library.size,
+                sha1=library.sha1,
+            )
+            for library in fabric_version_info.launcherMeta.libraries.common
+            + fabric_version_info.launcherMeta.libraries.client
+        ]
+        fabric_libraries.append(
+            build_version_json_libraries_item(
+                name=fabric_version_info.loader.maven,
+                base_url="https://maven.fabricmc.net/",
+            )
+        )
+        fabric_libraries.append(
+            build_version_json_libraries_item(
+                name=fabric_version_info.intermediary.maven,
+                base_url="https://maven.fabricmc.net/",
+            )
+        )
+        info("已解析 Fabric 版本信息，开始下载 Fabric 库文件……")
+
+        download_libraries(fabric_libraries, dl, "fabric")
+        info("Fabric 库文件下载完成，更新版本 json 文件中……")
+
+        save_mc_version_json(
+            update_mc_version_json_with_fabric(
+                version_json, fabric_libraries, fabric_version_info.launcherMeta.mainClass
+            ),
+            name,
+        )
+        info(f"Fabric loader {fabric_version_info.loader.version} 已为 Minecraft {version_json.id} 安装成功。")
+
+    dl.stop()
+    dl.shutdown()
+
+    if useGlobalState.HARDLINK_DOWNGRADE_TO_FULL_COPY:
+        warn("硬链接失败，已退化为全量复制文件。")
+
+
+if __name__ == "__main__":
+    app()

mmccli/bin/whats this.txt

@@ -0,0 +1,6 @@
+https://github.com/bangbang93/forge-install-bootstrapper
+
+计划用于 Forge 的静默安装。
+
+作者：bangbang93
+版本：v0.3.0

mmccli/cache/__init__.py

@@ -0,0 +1,19 @@
+# mmccli.cache
+
+from ._lib import (
+    CACHE_ROOT_DIR,
+    get_assets_cache_file_path,
+    get_forge_installer_cache_file_path,
+    get_library_cache_file_path,
+    get_version_jar_cache_file_path,
+    link_or_move,
+)
+
+__all__ = [
+    "CACHE_ROOT_DIR",
+    "get_assets_cache_file_path",
+    "get_forge_installer_cache_file_path",
+    "get_library_cache_file_path",
+    "get_version_jar_cache_file_path",
+    "link_or_move",
+]

mmccli/cache/_lib.py

@@ -0,0 +1,47 @@
+# mmccli.cache._lib
+
+import os
+import platform
+import shutil
+from pathlib import Path
+
+from mmccli.log import useGlobalState
+
+match platform.system():
+    case "Windows":
+        ENV_HOME_NAME = "USERPROFILE"
+    case _:
+        ENV_HOME_NAME = "HOME"
+CACHE_ROOT_DIR = Path(os.environ.get(ENV_HOME_NAME, "")) / ".mmccli" / "cache"
+CACHE_ROOT_DIR.mkdir(parents=True, exist_ok=True)
+
+
+def get_library_cache_file_path(file_path: str | Path):
+    return CACHE_ROOT_DIR / "libraries" / file_path
+
+
+def get_assets_cache_file_path(file_path: str | Path):
+    return CACHE_ROOT_DIR / "assets" / file_path
+
+
+def get_version_jar_cache_file_path(file_path: str | Path):
+    return CACHE_ROOT_DIR / "versions" / file_path
+
+
+def get_forge_installer_cache_file_path(file_path: str | Path):
+    return CACHE_ROOT_DIR / "forge-installer" / file_path
+
+
+def link_or_move(cache_file_path: str | Path, file_path: str | Path):
+    if useGlobalState.HARDLINK_DOWNGRADE_TO_FULL_COPY:
+        shutil.copy(cache_file_path, file_path)
+        return
+
+    try:
+        if Path(file_path).exists():
+            os.remove(file_path)
+        os.link(cache_file_path, file_path)
+    except Exception:
+        if not useGlobalState.HARDLINK_DOWNGRADE_TO_FULL_COPY:
+            useGlobalState.HARDLINK_DOWNGRADE_TO_FULL_COPY = True
+        shutil.copy(cache_file_path, file_path)

mmccli/fabric/__init__.py

@@ -0,0 +1,6 @@
+# mmccli.fabric
+
+from .install import build_version_json_libraries_item, update_mc_version_json_with_fabric
+from .versions import load_fabric_versions
+
+__all__ = ["build_version_json_libraries_item", "load_fabric_versions", "update_mc_version_json_with_fabric"]

mmccli/fabric/install.py

@@ -0,0 +1,43 @@
+# mmccli.fabric.install
+import os
+
+from mmccli.fabric.model import FabricMetaVersions_LoaderItem_LauncherMeta_MainClass
+from mmccli.minecraft import (
+    McGameVersionJson,
+    McGameVersionJson_LibrariesItem,
+    McGameVersionJson_LibrariesItemDownloads,
+    McGameVersionJson_LibrariesItemDownloadsArtifact,
+)
+
+
+def build_version_json_libraries_item(name: str, base_url: str, size: int | None = None, sha1: str | None = None):
+    """
+    产出依赖库结构中，path 是根据 name 拼接得到的，url 是根据 path 拼接完整的，sha1 是可能没有的。
+    :return:
+    """
+
+    parts: list[str] = name.split(":")  # 长度为 3，形如 ["net.fabricmc", "fabric-loader", "0.16.14"]
+
+    path = "/".join(parts[0].split(".")) + "/" + parts[1] + "/" + parts[2] + "/" + parts[1] + "-" + parts[2] + ".jar"
+
+    return McGameVersionJson_LibrariesItem(
+        name=name,
+        downloads=McGameVersionJson_LibrariesItemDownloads(
+            artifact=McGameVersionJson_LibrariesItemDownloadsArtifact(
+                path=path,
+                url=os.environ.get("MCLI_FABRIC_DOWNLOAD_LIBRARIES_URL", base_url) + path,
+                size=size,
+                sha1=sha1,
+            )
+        ),
+    )
+
+
+def update_mc_version_json_with_fabric(
+    version_json: McGameVersionJson,
+    fabric_libraries: list[McGameVersionJson_LibrariesItem],
+    mainClass: FabricMetaVersions_LoaderItem_LauncherMeta_MainClass | str,
+):
+    version_json.libraries += fabric_libraries
+    version_json.mainClass = mainClass if isinstance(mainClass, str) else mainClass.client
+    return version_json