在 Windows 部署 ToolDelta

本文整理了在 Windows 上部署 ToolDelta 的完整流程, 包括 Python 3.12.9 的安装、pip 清华源配置、源码安装、pip 安装和 venv 安装 3 种方案, 以及首次启动、后续运行与更新方法. 文中还补充了 GitHub 测速卡住、FateArk 下载失败等常见问题的处理思路, 适合按图操作完成从零部署到正常启动的全过程.(AI摘要总结)

项目介绍#

重要提示

禁止在我的世界官方群聊发布任何有关 ToolDelta 内容.

ToolDelta 是一个为网易《我的世界：中国版》特制的基岩版租赁服组件加载器

安装 Python#

教程演示使用 Windows 10 64 位以 Python 3.12.9 为例.

浏览器访问 https://www.python.org/downloads/release/python-3129/ , 滑到最下方下载 Windows installer(64-bit).

或者使用阿里云镜像站对应 3.12.9 版本下载链接: https://mirrors.aliyun.com/python-release/windows/python-3.12.9-amd64.exe

下载完成后双击 exe 文件运行会看到如下页面.

勾选左下角的两个选项随后点击 Install Now 开始安装.

看到如下页面 Python 就安装完成了

推荐顺手点击 Disable path Length Limit 解除 Windows 对文件路径长度的限制

最后点击Close关闭 Python 安装程序

安装 ToolDelta#

源码安装#

安装教程#

找一个喜欢的目录用来存放 ToolDelta 数据文件教程以C:\Users\Administrator\Downloads为例.
先使用文件管理器打开对应目录

浏览器访问https://github.com/ToolDelta-Basic/ToolDelta/archive/refs/heads/main.zip下载 ToolDelta 仓库的 main 分支完整源代码.

下载完成后解压压缩包

进入解压后的 ToolDelta-main 文件夹然后在路径栏输入 cmd

在弹出的 cmd 窗口中输入

python -V

验证 Python 是否安装成功

更改 pip 源为清华源

python -m pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple --upgrade pip
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

安装 pip 包过程可能很慢耐心等待

pip install .

注意 install 后面还有一个. 不要漏掉

安装完成后启动 ToolDelta

python main.py

运行教程#

进入部署 ToolDelta 的文件夹内在空白处右键选择在终端中打开

运行main.py 启动ToolDelta

python main.py

更新教程#

(还真没考虑这个问题备份数据后直接替换源码吧应该可行)

如果会使用Git 建议使用Git拉取代码教程就不写了建议用下面两种方法

从pip源安装#

安装教程#

找一个喜欢的目录用来存放 ToolDelta 数据文件教程以C:\Users\yeqin\Downloads\ToolDelta为例.
先使用文件管理器打开对应目录

在空白处右键选择在终端中打开

在弹出的 cmd 窗口中输入

python -V

验证 Python 是否安装成功

更改 pip 源为清华源

python -m pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple --upgrade pip
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

安装 ToolDelta

pip install tooldelta

安装完成后创建main.py文件.(你也可以手动创建)

"import tooldelta; tooldelta.client_title()" | Out-File -FilePath main.py -Encoding utf8

运行main.py 启动ToolDelta

python main.py

ToolDelta 数据文件位于main.py同级目录下(main.py文件在最开始你选择的文件夹里)

运行教程#

进入部署 ToolDelta 的文件夹内在空白处右键选择在终端中打开

运行main.py 启动ToolDelta

python main.py

更新教程#

进入部署 ToolDelta 的文件夹内在空白处右键选择在终端中打开

更新pip包

pip install --upgrade tooldelta

从pip源安装(venv)#

安装教程#

找一个喜欢的目录用来存放 ToolDelta 数据文件教程以C:\Users\yeqin\Downloads\ToolDelta为例.
先使用文件管理器打开对应目录

在空白处右键选择在终端中打开

在弹出的 cmd 窗口中输入

python -V

验证 Python 是否安装成功

更改 pip 源为清华源

python -m pip install -i https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple --upgrade pip
pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

创建 venv 虚拟环境

python -m venv venv

激活虚拟环境

venv\Scripts\activate

重要提示

下方命令都需要在虚拟环境内指定. (最前面显示绿色的venv 就是在虚拟环境中了)

安装 ToolDelta

pip install tooldelta

安装完成后创建main.py文件.(你也可以手动创建)

"import tooldelta; tooldelta.client_title()" | Out-File -FilePath main.py -Encoding utf8

运行main.py 启动ToolDelta

python main.py

ToolDelta 数据文件位于venv同级目录下(venv文件夹在最开始你选择的文件夹里)

运行教程#

进入部署 ToolDelta 的文件夹内在空白处右键选择在终端中打开

激活虚拟环境

venv\Scripts\activate

运行main.py 启动ToolDelta

python main.py

更新教程#

进入部署 ToolDelta 的文件夹内在空白处右键选择在终端中打开

激活虚拟环境

venv\Scripts\activate

更新pip包

pip install --upgrade tooldelta

后续#

如果你卡在 Github 测速请见教程

小提示

首次启动成功后后续可以双击点我启动.bat 直接启动ToolDelta

本地部署 ToolDelta 对于普通用户只能使用 FateArk 框架也就是选项 5

输入 5 后正常情况下会自动下载 FateArk 框架如果下载失败请见教程

ToolDelta 需要借助验证服务完成进服您无法在无验证服务的情况下在租赁服内使用 ToolDelta

常见问题#

卡在 GitHub 测速#

如图所示一直卡在 GitHub 测速

关闭 cmd 窗口使用任意文本编辑器修改 ToolDelta基本配置.json 文件(记事本也行)

修改 全局GitHub镜像 和 插件市场源

Github镜像见 /blog/free-mirror/#Github%E9%95%9C%E5%83%8F

# 插件市场源
https://pm.tooldelta.top
https://pm.2a.hk

例如

随后保存并退出(记事本没有自动保存需要手动保存) 双击点我启动.bat 启动 ToolDelta

FateArk 下载失败#

请从 DependencyLibrary 仓库手动下载 FateArk 文件并移动到tooldelta/bin文件夹内