如何使用OpenDoctoratePy-EX-Public

前言

这份使用指南并非我主动要写,而是身边朋友需要,我才决定编写这份使用指南。

什么是ODPYEX?它是一个明日方舟服务端模拟器,全称 OpenDoctoratePy-EX-Public ,主要对国服版本明日方舟的服务器进行模拟。

本文章不包含任何对明日方舟客户端有侵入的解决方案,只提供零侵入的解决方案。如果解决方案失效,请自行寻找其它办法解决。

不要发送任何邮件询问如何使用这种问题,我不会回复任何此类邮件

使用指南

推荐使用 Git 进行版本更新,这能节省部分精力,后续更新也非常方便。亦可使用 Download ZIP 进行部署

准备阶段

Git方案:
安装git后,在你计划用于存放 ODPYEX 的文件夹中输入

git clone https://github.com/jiellll1219/OpenDoctoratePy-EX-Public.git

克隆 OpenDoctoratePy-EX-Public 存储库,如果你有我的gitea地址,请优先使用gitea仓库的版本,它比github版本更完善

Download ZIP方案:
在仓库页面点击 “<> Code” 按钮,再点击 “Download ZIP” 按钮下载当前 OpenDoctoratePy-EX-Public 仓库,然后解压ZIP到你计划用于存放 ODPYEX 的文件夹内。解压后,OpenDoctoratePy-EX-Public.zip 可以删除

安装运行环境

Windows的安装步骤:
https://www.python.org/downloads/ 下载不低于 3.11 版本的Python并安装它,在安装阶段需要勾选 Add python.exe to PATH 使其配置环境变量。

安装完毕后,在ODPYEX文件夹内空白处按住 Shift+右键 ,点击“在此处打开 PowerShell 窗口”或“在终端打开”打开命令行,输入下面这串命令安装运行库

pip install -r ./requirements.txt

最后准备

https://github.com/Kengxxiao/ArknightsGameData 点击Download ZIP ,接着解压ZIP到任意一个文件夹中把 zh_CN/gamedata/ 下的 excel 文件夹移动到ODPYEX文件夹中 data/ 目录下即可。此时解压后的 ArknightsGameData-main 文件夹和ZIP文件可以删除

在ODPYEX文件夹内空白处按住 Shift+右键 ,点击“在此处打开 PowerShell 窗口”或“在终端打开”打开命令行,输入下面这串命令启动服务端

py ./server/app.py

补充:如果你有计算机基础知识,可以使用 mklink /J 命令链接 zh_CN/gamedata/excel 文件夹到 ODPYEX 的 data/excel 文件夹中,后续只需要在 ArknightsGameData 文件夹中使用 git pull 命令同步云端更新到本地。这不是唯一获取 excel 文件夹的渠道,你可以自行从游戏中 dump 获得这份文件夹的内容,在此不提供任何方法

客户端准备

注意,这部分比较有难度,请各位新手使用 Deepseek、Gemini、ChatGPT 等AI大模型进行辅助。

下载任意MITM(中间人攻击)软件,这是部分软件的例子,新手推荐使用Reqable。
Reqable 基础功能免费
Fiddler 收费软件
MitmProxy 完全免费

以Reqable和PC客户端为例,在安装证书到设备后,打开重写功能,新建一个规则,名称随意,URL填写https://*.hypergryph.com/*,重定向到填写http://127.0.0.1:8443接着启用重写和这条规则,打开游戏即可。

使用 Fiddler 和 MitmProxy 软件和上述行为类似,使用AI模型辅助你编写一个重写脚本,把全部以 hypergryph.com 结尾的域名重写为http并重定向到http://127.0.0.1:8443,接着打开游戏即可。

如果遇到登录在乱写无法通过时(在BiliBili客户端尤为显著),请使用真实账号登录,这不需要你真的有游戏账号,只是使用这个账号通过登录检查,这没有风险。
在进入游戏主界面后,可以关闭代理,只有在返回到登录页面时需要再次打开代理软件。

手机端亦可使用上述操作重定向游戏到客户端,但是需要游戏信任系统证书,在Android 7.0及以上,安卓系统不再信任用户级的证书,只信任系统级的证书,需要将证书安装到Android系统证书目录中,而不是直接将证书文件导入Android设备进行安装,这需要magisk模块才能实现。但是在有ROOT的情况下,有更好的选择,而不是使用这个繁琐的无侵入方案。

Termux使用补充

推荐使用 Git 进行部署,如果你使用的是深度测试仓库,执行仓库内的 update_excel.py 脚本即可快速创建和更新excel文件夹。

需要在部署前执行这串命令更新,防止在安装过程中报错

pkg upgrade

执行下面这串命令安装所需的软件包,防止pycryptodome模块安装错误

pkg install python-cryptography