• 不做任何收费
• 基于3.4客户端 拥有完善的剧情体验
• 至于 Gm工具我还需待研究 后续会开放

一，电脑端

• 客户端：链接：跳转 提取码：d7j8
• 客户端补丁文件：链接：跳转 提取码：BSxE
• Grasscutter●服务器●PC端教程
• 1.下载原神客户端和补丁文件并解压
• 2.补丁文件替换至原神客户端目录文件夹下
• 3.双击客户端文件-原神启动-即可享受不一样的体验
• 4.未注册用户-登入框填写随意账号（账号即为密钥，注意保存！）
• 5.密码随意填写 点击登入 如有报错 白屏 问题反馈 原神—萌新交流群 等待修复！

二，安卓端

• 客户端： 链接：跳转 提取码：R2Qw
• Grasscutter●服务器●安卓端教程
• 1.下载原神自定义服务器客户端
• 2.按客户端要求填写 地址下载资源文件
• 3.下载完成后 重启 填写 服务器地址https://grasscutter.muyu.love/
• 4.未注册用户-登入框填写随意账号（账号即为密钥，注意保存！）
• 5.密码随意填写 点击登入 如有报错 白屏 问题反馈 原神—萌新交流群 等待修复！

三，苹果端

• 苹果端：因为代码加密限制，目前操作过于麻烦，所以暂时不对外开放使用！
• 1.下载原神客户端
• 2.下载完成后使用IOS签名工具安装客户端文件
• 4.未注册用户-登入框填写随意账号（账号即为密钥，注意保存！）
• 5.密码随意填写 点击登入 如有报错 白屏 问题反馈 原神—萌新交流群 等待修复！

  四，故障问题

• 如有其他疑问，欢迎在此评论或 加群： 原神—萌新交流群 探讨，提问前请确保您的问题恰当

本教程基于服务端2.8版本一键端
部署教程 目前已失效 仅供参考！

环境要求

• Windows x64 (建议 Windows Server 2016 + 最低 Windows Server 2012R2，过老版本不保证兼容性；
• Linux 自行解决：如果你真的有自信用 Linux 搭建我相信你用不着看这篇文档)
• Java17 (其他版本)](http://www.codebaoku.com/jdk/jdk-index.html)
• MongoDB(建议安装时注意左下角，取消勾选 Compass，网络不好可能会卡进度，取消后可使用 Robo 3T 等工具来管理数据库；Win10 以下的系统只兼容 4.2 - 版本)
• Python3.8+
• Mitmproxy (本教程使用此工具演示，也可使用 Fiddler 等流量代理工具)
• 私服服务端（本文下方回复获取下载）
• 7-zip 用于解压极限压缩的服务端（压缩后约 102MB，压缩前约 947MB）
• 如服务端与客户端分开在两台机子，则还需确保服务端端口 UDP22102 TCP443 TCP54321 均开启且未被其他程序占用！

1，启动服务端

解压服务端，并进入 grasscutter 文件夹

如果您按照我的教程部署，直接双击 run.bat 即可运行服务端；如果安装了其他版本的 java 或者修改了安装位置，请自行修改此文件后再启动，启动前请确保 MongoDB 在运行中
启动后控制台无任何报错，且最后输出 Game Server started on port 22102 字样即为启动成功，有报错请参照本文档最后一章处理

服务端不可直接关闭，需输入指令 stop 后再退出；若不小心关闭，在 任务管理器 中找到 Java 相关进程杀掉即可

2，启动代理

双击运行 proxy.bat ，如果您不希望其他主机连接到服务端，删除此脚本中的 --set block_global=false<span> </span>即可；如果希望在其他端口运行代理，右键编辑此文件修改 54321 为你期望的端口即可，如果删除此参数则默认监听 8080 端口，不要使用常见端口避免被攻击，此端口即为=客户端系统代理所用端口=
代理可直接关闭窗口以停止运行

出现 Proxy server listening at http://*:54321 即为启动成功

注意，如果您的服务器性能过低，此代理程序可能会假死，手动重启即可

3，获取证书

前往服务端的 设置-网络-代理-手动设置代理 ，设置为 127.0.0.1:54321 后，使用浏览器访问 http://mitm.it 并选择相应证书下载，此证书需要下发给客户端所在机器安装，注意服务器 IP 更换后需要重新下载安装证书

如果服务端和游戏都跑在本机，不用手动安装证书，代理会自动安装

注意：这一步服务端开启代理只是为了便于下载证书 (当然你也可以直接去这里复制 %USERPROFILE%.mitmproxy\mitmproxy-ca-cert.cer )，下载完后请关闭服务端的系统代理，否则无法正常连接服务端

前往服务端的 设置-网络-代理-手动设置代理 ，设置为 127.0.0.1:54321 后，使用浏览器访问 http://mitm.it 并选择相应证书下载，此证书需要下发给客户端所在机器安装，注意服务器 IP 更换后需要重新下载安装证书

如果服务端和游戏都跑在本机，不用手动安装证书，代理会自动安装

注意：这一步服务端开启代理只是为了便于下载证书 (当然你也可以直接去这里复制 %USERPROFILE%.mitmproxy\mitmproxy-ca-cert.cer )，下载完后请关闭服务端的系统代理，否则无法正常连接服务端

4，创建账号

需要使用文末的 account 指令在控制台创建账号才可以登录，当然你也可以根据下节更改配置从而允许不存在的账号自动注册

config.json

• GameServer.Ip DispatchServer.Ip 为准入 IP，建议保持 0.0.0.0
• GameServer.PublicIp DispatchServer.PublicIp 为 公网/内网IP (取决于你在公网 / 内网联机)，改为 127.0.0.1 即只允许本机连接
  GameServer.Name 为你的服务器名称
• GameServer.WelcomeEmotes 为进入游戏的欢迎表情 id
• GameServer.WelcomeMotd 为进入游戏的欢迎语
• DispatchServer.defaultPermissions 为用户默认拥有的权限 (注意是数组)，目前版本主要有 server player 两个权限组，建议只给后者
• DispatchServer.AutomaticallyCreateAccounts 默认为 false ，如修改为 true ，则允许登陆不存在的账号时自动创建 (不建议)

其他不在此赘述

修改卡池

卡池配置文件为 .\data\Banners.json ，其中

• gachaType=200,scheduleId=893 的为常驻池
• gachaType=301,scheduleId=903 的为角色 UP 池 (多 UP: 增加 gachaType 为 302,303,304… 的成员即可)
• gachaType=400,scheduleId=913 的为武器 UP 池

本站整合包默认为万达双 UP 及其专武 (专武封面为前者，是客户端内置资源，无法修改)

rateUpItems1 为 UP 五星，rateUpItems2 为 UP 四星，对应 id 在 Handbook_CHS.txt 中可以找到

需修改 prefabPath previewPrefabPath titlePath 中的 A0** 为对应的卡池 id（在 卡池顺序.xlsx<span> </span>中）

costItem 为抽卡耗费的货币名称，223 为纠缠之缘，224 为相遇之缘（修改可能会引发 bug）

beginTime endTime 为卡池开始 / 结束的 10 位时间戳

softPity 最少几次出 hardPity 最多几次出 eventChance 歪的概率 % ，如果没有这三个成员自己加上即可

bannerType 为 STANDARD 表示常驻池，EVENT 表示角色 UP 池，WEAPON 表示武器 UP 池

sortId 可能与卡池展示顺序有关？

注意开启太多卡池会容易报错，修改完建议使用工具检查语法是否正确

只需 stop 服务端，替换 grasscutter.jar 后启动服务端即可，整合包中的服务端核心为 1.0.0 版本，以后的 release 版本都将在网盘同步上传 jar 包

注意有的版本可能需要同步更新相关资源文件，会打包上传，全部覆盖即可

首次连接需要安装证书

Windows 下载 并双击打开相应服务器的证书 -> 安装证书 -> 本地计算机 -> 放入下列…-> 浏览 -> 受信任的根证书颁发机构 -> 完成
Android 下载 pem 格式证书，root 并解锁 system 分区后手动复制到 /system/etc/security/cacerts 并重命名为 c8750f0d.0 即可 (如果安装多个私服的证书，依次把文件命名为 c8750f0d.1 c8750f0d.2 … 即可)；如果不能解锁系统分区可参照网盘中我的私服专用的模块制作自己私服的 CA 证书模块，或者安装信任用户证书的模块后直接在 Android 系统设置中安装为用户证书即可
（待测试）无 root 的安卓可尝试直接下载安装用户证书 (分别安装 CA 和 WLAN 证书) 后使用网盘版本游戏客户端
iOS 下载证书后复制到手机并打开点击安装即可，安装完打开系统设置信任刚才安装的证书

其他操作系统不提供安装证书教程

之后直接如此操作即可进入

1. 修改前先打开游戏客户端检查并完成更新
2. Windows：前往 设置-网络-代理-手动设置代理 设置代理，服务器 / 端口 按照自己所要连接私服的服务端配置填写，关闭 请勿将代理服务器用于本地地址 ，清空 请勿对以下条目... 编辑框的内容，填写完确定并开启代理，完成后暂时不要关闭页面
   Android：前往 系统设置-WLAN 设置当前连接 WiFi 的代理，或前往 移动网络-APN 修改 APN 设置，修改前请自行备份避免出错，完成后暂时不要清后台
   iOS：WiFi 类似于 Android，移动网络无法修改 APN
3. 修改完成后启动 国服官服 / 国际服客户端 ，用户名 + 密码 (密码随便填) 即可登录，登录后进入最后白屏加载界面即可关掉代理，=务必尽快关闭代理= ：长时间代理，你流量全走服务器，你电脑和服务器都累，而且还可能会被服务商 ban 机！

每次登录都需要如此操作！=开启代理再运行游戏便进入私服，不开启代理运行游戏就是官服=

Tip：

• 如果使用的是 国服客户端，启动后有弹窗 (仅 Win) 且登录页面标题为 HOYOVERSE 而不是 miHoYo 即代表成功连接私服；国际服客户端服务器选择界面如只有一个服务器 (默认为 GenshinTJ )(或者没出现服务器选择页面) 而不是 Asia 等四个则成功连接到私服
• Windows 如果无法使用系统代理，请尝试使用云盘中的 米哈游代理转向 软件 (易语言开发，报毒属正常现象)

传送？

任意标点并点击确认即可传送至目标上空；传送后不会自动关闭地图，手动关闭地图即可看到

如何去金苹果？

眼睛稍微往上挪那么一内内看，金苹果地图没亮不用管，传就是了

尘歌壶

目前看起来去不了

角色 id

每个角色都有两个 id，长 id 100000xx 只用在 givec 命令中，短 id 10xx 用在其他各处；另外大部分角色各种 id 都是对应的，比如命星 id 为 11xx ，卡池标题和封面为 A0xx

游戏登陆后默认有一个名为 Server 的好友，此为游戏控制台，可向其发送指令；当然，你也可以在服务端控制台窗口中输入指令；注意部分指令仅可在其中一种途径使用

注意：

• 游戏内发送指令均需加上前缀 ! 或 /
• 请注意， 使用 | 隔开的指令 / 变量代表两者皆可，使用 <> 括起来的变量必需，使用 [] 括起来的变量可省略 (省略后如 UID 则为你自己，数量 / 等级等则为 1)
• 指令只有使用下方 permission 指令授权后，相应用户才可使用

示例：如要给用户 UID 114514 原石 x1919810，查阅得知用法 give|g [player] <itemId|itemName> [amount] ，原石 id 201 ，则可直接控制台输入 g 114514 201 1919810 / give 114514 201 1919810 ；或者游戏内聊天发送 /g 114514 201 1919810 / !g 114514 201 1919810 ，直接给当前用户的话也可省略 uid

指令同步最新版，网盘提供的端不一定可用

关于各种 id 都在 Handbook_CHS.txt ， 文本编辑器 (推荐 VS Code 等，Win 自带记事本无法完全搜索内容) 打开后 Ctrl+F 即可搜索

(在我的私服中) 以下指令仅管理员可用，请勿尝试使用

1. 服务端启动报错

如下图报错表示 443 端口被占用，请检查 (很多情况是 VMWare 占用)；如确实无法接触占用请尝试修改 config.json 中的端口，同时修改 proxy_config.py 中的端口

类似于下图报错说明你的 Java 版本与核心需求不一致 (或核心本身有问题)，请自行更换适配 Java 版本或换核心

2. 服务端下不了证书

没有正确配置代理；存在其他代理软件；打开的是 https 而不是 http

3. 命令行窗口闪退

在 Grasscutter 文件夹 shift + 右键，打开控制台窗口，在控制台窗口中手动运行出错的 bat ，根据输出判断错误

4. 端口被占用

cmd 运行以下指令查看占用端口的进程

netstat -aon|findstr "端口号"

输出行末的数字为进程 pid，使用以下指令杀掉进程

taskkill /t /f /pid 进程pid

如果杀不掉并且显示是 xx 的子进程的话，杀掉 xx 这个 pid 即可

1. 4206 错误

此类错误大多数情况为代理未正确配置，可尝试

重启代理端 / 重启服务器

开启代理后运行游戏，检查服务端和代理的日志，如果代理中

• 没有 mihoyo.com / hoyoverse.com 子域的请求或者没刷新任何日志，则为客户端代理配置错误
• 有 mihoyo.com / hoyoverse.com 子域的请求，但报 TLS handshake failed，则为客户端未安装对应服务端的证书
• 有 mihoyo.com / hoyoverse.com 子域的请求，但报拒绝连接等错误，可能是服务端网络问题导致无法连接米哈游服务器

如果代理没有报错，则应为服务端问题，检查服务端配置或者更新服务端

如仍无法解决，可尝试以下操作：

• 关闭代理正常启动游戏检查更新完后再次开代理进入游戏
• (搬运，待验证) 修改 config.json 中 DispatchServer.PublicIp 为 dispatchcnglobal.yuanshen.com

另外，据经验此问题可能是 凉心云 的锅，建议跑路去 良心云 吧

如仍无法解决请去烧一炷香把，虔诚点儿

2. 点击登录转圈然后没反应

如果点击后服务端日志有成功登录的提示，关掉登录窗口即可进入游戏 (手机版特供 bug)
如无，请检查服务端代理是否正确运行，是否假死 (尝试重启)

3. 502 / 4301 / 无法连接服务器

绝对是你没正确配置，自行检查

4. 登陆后检查更新失败

如果代理日志中有 mihoyo.com / hoyoverse.com 子域的请求，但报拒绝连接等错误，可能是服务端网络问题导致无法连接米哈游服务器

5. 开启代理后还是登录了官服

有其他代理冲突；服务端没有正确运行

6. 4201

检查是否正确安装并信任证书

7. -9203

一般为代理问题，已知 iOS 使用小火箭会存在此问题

88. 卡检查更新

尝试正常进游戏一次后再连代理进；检查服务端网络问题，如确实没问题请尝试重启代理端 / 更换代理端口 / 重启服务器

9.b 进门后连接超时

UDP22102！！！