单文件 · 零外部依赖 · 约 1900 行

把「下载游戏」
这一步,补回来

PCL 暂时不再提供游戏下载。这个单文件脚本接过这一步: 选版本、装加载器、配好 Java,再把版本安静地放进你的启动器目录。 它不替代启动器,只负责在启动之前,把事情准备好。

  • Windows 10 1803+
  • PowerShell 5.1+
  • Forge / Fabric / NeoForge

一段想法

为什么会有这个脚本

对大多数国内玩家来说,PCL、HMCL 等启动器曾经是最短的那条路:打开、选版本、点下载。 装 Forge 这种以前要折腾半天的活,也被压成了几次点击。很多人第一次进游戏, 走的都是这条路径。

但因为一些原因,PCL、HMCL 暂时不再提供游戏下载功能。对老玩家影响有限——版本早就躺在硬盘里; 对刚入坑的人,这一步却突然变成了门槛:官方启动器慢,手动装加载器要面对一堆 JSON、 Maven 坐标和 Java 版本。

我们不想让「玩到游戏」之前,先学一遍启动器原理。于是把这条链路拆开重写: 直接读 Mojang 的版本元数据,按官方规则下载、校验、合并,最后写进你已经熟悉的启动器目录。 PCL 仍然是 PCL,只是它的版本列表里,多了一个刚装好的版本。

合规声明

本工具仅读取 Mojang 官方公开的版本元数据与下载地址,在用户本机安装游戏文件;不提供游戏本体、账号、联机服务或任何破解内容。

使用本工具即表示你同意遵守中华人民共和国法律法规及主管部门的相关要求,不将其用于任何违法或侵权用途。

我们尊重知识产权。如权利人认为本工具或其提供的内容侵犯其合法权益,请通过页面底部的邮箱与我们联系;核实后我们将立即停止提供或下架相关功能。

联系邮箱见页面最底部。

它做了什么

安装之前的所有事

从版本清单到最终 JSON,每一步都按启动器认的格式来。

01

原版与三大加载器

Forge、Fabric、NeoForge。加载器列表来自镜像站与官方元数据,兼容版本优先,稳定版排在最前。

02

镜像优先,官方兜底

每个文件独立回退:BMCLAPI、清华 TUNA 不可用时自动换官方源,不会因为一个文件卡住整次安装。

03

逐文件校验

游戏资源按 SHA-1 校验,Java 安装包按 SHA-256 校验。大小或哈希不符就重下,不把坏文件留在目录里。

04

断点复用

已经下载并通过校验的文件会直接跳过。中断之后重新运行,不会从零开始。

05

Java 自动处理

检测版本要求,缺少时询问是否安装 Temurin JDK,装完写好 JAVA_HOME 与 PATH,再继续安装。

06

认识你的启动器

递归扫描磁盘,读取 PCL 的 Setup.ini 与 HMCL 的配置,直接列出真实游戏目录,不用自己找路径。

安装流程

六个步骤,一个窗口

全部用方向键和回车完成,没有弹窗、没有网页跳转。

  1. 1

    选择游戏版本

    预置 1.7.10、1.12.2、1.16.5、1.20.1、1.21.4,也可以直接输入任意版本号,例如 1.20.4。

  2. 2

    选择加载器与版本

    列出与所选游戏兼容的前 10 个版本,第一个标为推荐,其余按版本号排列。

  3. 3

    选择安装位置

    自动检测 PCL、HMCL 和官方启动器目录,也可以手填游戏根目录。检测结果直接是真实的 .minecraft 路径。

  4. 4

    选择下载源

    国内镜像优先,或只用官方源。单个文件失败时会自动回退,不会中断整个队列。

  5. 5

    预览并确认

    所有设置列在一屏里。方向键选中任意一项,回车就能回去修改,确认无误再开始。

  6. 6

    安装

    下载本体与资源、合并加载器配置、执行 Forge 安装处理器,最后写入版本 JSON。完成后在启动器里刷新即可。

开始使用

两种运行方式

都需要管理员权限。脚本不会修改系统执行策略。

双击运行

把 mc.ps1 和 MCDownload.cmd 放在同一目录,双击后者,UAC 点「是」。

  1. 启动器会自动申请管理员权限
  2. 只在当前进程内放开执行策略
  3. 关闭窗口后一切恢复原样

一行命令

把脚本托管在服务器上,在管理员 PowerShell 里执行:

powershell -ep Bypass -c "irm mc.ps1 | iex"

托管地址需要返回 text/plain; charset=utf-8,否则中文会乱码。

下载脚本

单文件,约 1900 行,可以直接打开读。

下载 mc.ps1

常见问题

可能会遇到的几件事

提示「未对文件进行数字签名」怎么办?

这是 Windows 执行策略在拦截未签名的 .ps1,不是脚本损坏。用 MCDownload.cmd 启动,或者在管理员窗口里先执行 Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force,再运行脚本。不需要改系统级策略,也不需要买签名证书。

为什么一定要管理员权限?

三个原因:写入 Program Files 下的 Java、修改系统环境变量、以及某些启动器装在受保护目录。脚本本身不会提权做别的事。

它会改我的系统吗?

只写你选择的游戏目录。如果选择自动安装 Java,会写入 C:\Program Files\Eclipse Adoptium\jdk-<主版本>、系统 JAVA_HOME 和 PATH。不会动注册表里的启动器配置,也不会改执行策略。

为什么加载器版本只有 10 个?

终端菜单能舒服显示的数量有限,这里只列最新的 10 个稳定版本。第一个就是当前推荐版本,绝大多数情况够用。

NeoForge 安装到一半报下载失败?

个别 fancymodloader 依赖在 BMCLAPI 上没有收录,而官方 Maven 在部分网络下不可达。脚本会列出失败文件并保留已下载内容,换时间或切换下载源后重跑即可。

它和 PCL、HMCL 是什么关系?

没有隶属关系,也不修改它们本体。脚本只是把版本文件写进它们读取的目录,之后照常在启动器里刷新版本列表即可。

版本装好,剩下的交给启动器

在 PCL 或 HMCL 里刷新一下列表,就能看到它。