Grasscutter 私服搭建指南

Releases

注：打补丁方式为：将 ...\Grasscutter\launcher 文件夹下的 global-metadata.dat 文件复制至 ...\Genshin Impact\Genshin Impact Game\YuanShen_Data\Managed\Metadata 文件夹下，替换原文件，注意备份原文件。

1.3.1-dev-08fdcf6e 包已知 bug：仅旅行者能获得怪物掉落经验；

3.0.0 基于 1.3.1-dev-08f36195 的 Grasscutter （服务端加客户端，打补丁同上，解决了已知bug）

3.1.0 基于 1.3.4-dev-98ac42a6 的 Grasscutter （服务端加客户端，需要打补丁）

3.1.0 基于 1.4.2-dev-be8fbcbc 的 Grasscutter （服务端加客户端，需要打补丁）

注：自 3.1.0 版本后，打补丁方式变更为：首先下载补丁文件 UserAssembly.dll，然后将补丁文件 UserAssembly.dll 复制至 ...\Genshin Impact\Genshin Impact Game\YuanShen_Data\Native 文件夹下，替换原文件，注意备份原文件。

3.1.0 版本补丁文件 UserAssembly.dll

Grasscutter Tools v1.5.5 （适用于2.8.0）

Grasscutter Tools v1.6.6 （适用于3.0.0）

Grasscutter Tools v1.6.8 （适用于3.1.0）

仅客户端食用方法

WinRAR v6.11 x64 SC

GitHub项目地址

官网地址

Grasscutter 是某个动漫游戏的服务器在软件层面的重新实现，简单来说就是模拟该游戏原来的服务器，以本地服务器或云服务器作为替代，在本地或云端实现该游戏的部分功能。

A server software reimplementation for a certain anime game.

Github官方文档

当前功能

登录
战斗
好友
传送
祈愿
从控制台生成魔物
多人游戏部分可用
物品（获得物品/角色、升级角色/武器等）

快速设置指南

注意：如需帮助请加入 Discord

环境需求

Java SE - 17

注：如果仅运行服务端，只下载 jre 即可
MongoDB（推荐 4.0+）
代理程序：mitmproxy (仅需 mitmdump，推荐使用)，Fiddler Classic 等

服务端运行

注意：从旧版本升级到新版本，需要删除 config.json 使其重新生成

⒈获取 grasscutter.jar

从 Releases 下载

自行编译

⒉在 JAR 文件根目录中创建 resources 文件夹并复制 BinOutput 和 ExcelBinOutput（查看 Wiki 了解更多）

⒊确认 MongoDB 服务运行正常后，使用命令行 java -jar grasscutter.jar 运行 Grasscutter

客户端连接

⒈在服务器控制台创建账户

⒉重定向流量（选择其中一种方法）

mitmdump: mitmdump -s proxy.py -k 信任 CA 证书：

注意：mitmproxy 的 CA 证书通常存放在 %USERPROFILE%\ .mitmproxy，或者从 http://mitm.it 下载证书

双击安装根证书 或者 使用命令行：

certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer

Fiddler Classic 运行 Fiddler Classic，在设置中开启 解密 https 通信 并将端口设为除 8888 以外的任意端口 (工具 -> 选项 -> 连接) 并加载此脚本
Hosts 文件

⒊设置代理为 127.0.0.1:8080 或你设置的端口

也可直接运行 start.cmd 一键启动服务端并设置代理，但必须设置 JAVA_HOME 环境变量并配置 start_config.cmd

构建

具体参见构建 命令列表参见 Wiki

快速排查问题

如果编译失败，请检查 JDK 安装是否正确 (要求 JDK 17 并确认 JDK 处于环境变量 PATH 中)
客户端无法登录/连接，4206，其他问题… —— 大部分情况是因为代理设置本身就是问题。如果使用 Fiddler 请确认 Fiddler 监听端口不是 8888
启动顺序：MongoDB > Grasscutter > 代理程序 (mitmdump, fiddler 等) > 客户端