原神私服4.0搭建,附带服务端客户端开服、支持多人联机保姆级开服教程

发布于 2025-09-06  23 次阅读


目前 Grasscutter 项目仓库最大支持到 4.0 版本

文章中用的系统是windows10,

兼容系统windows2016以上或windows11,win7以下未做测试

原神本体游戏客户端+语音包

点我下载原神v4.0.0客户端压缩包 约56.2GB

点我下载原神v4.0.0中文语音包 约10.5GB(不下载全部角色技能无音效,剧情任务皆为哑剧

搭建环境(必要环境需全部安装,安装路径最好全部默认

Java17(来源: 编程宝库

MongoDB(来源:官网

Python3.8+(来源:官网

Mitmproxy(来源:官网

配置服务端资源

需要把上述环境安装好才能开始这一步操作,否则报错

下载 Grasscutter 项目,解压到任意位置,解压后会得到的文件夹名为 Grasscutter-development

不想下载也没问题,我已经集成好了懒人一键开服包

会放在文章末尾

自定义配置

config.json 文件

# 监听的本地地址,建议保持 0.0.0.0
server.http.bindAddress
server.game.bindAddress

# 服务器的 公网/内网IP,默认为 127.0.0.1 即只允许本机连接
server.http.accessAddress
server.game.accessAddress

# 服务器名称
server.dispatch.defaultName 

# 进入游戏的欢迎表情 id(int 数组)
server.game.joinOptions.welcomeEmotes 

# 进入游戏的欢迎语
server.game.joinOptions.welcomeMotd

# 进入游戏的欢迎邮件,成员有 title content sender items ,items 成员有物品 id itemId 数量 itemCount 等级 itemLevel
server.game.joinOptions.welcomeMail

# 游戏控制台的资料,成员有 avatarId 头像 (长的角色 id),nameCardId 名片 id,adventureRank 冒险等级, worldLevel 世界等级, nickName 昵称, signature 签名
server.game.joinOptions.serverAccount 

# 是否自动创建账号,默认为 false ,如修改为 true ,则允许登陆不存在的账号时自动创建 (不建议)
account.autoCreate

# 自动创建的帐号默认拥有的权限 (文本型数组)
account.defaultPermissions

# 库存上限
server.game.gameOptions.inventoryLimits

# 单人 / 联机的队伍角色数量上限
server.game.gameOptions.avatarLimits

# 是否启用体力系统
server.game.gameOptions.staminaUsage

修改卡池

配置文件为 .\data\Banners.json

# 常驻池
gachaType=200,scheduleId=893

# 角色 UP 池
gachaType=301,scheduleId=903

# 武器 UP 池
gachaType=302,scheduleId=903

# 角色 UP 池 2
gachaType=400,scheduleId=913

多卡池
增加 gachaType 为非以上四个值且 scheduleId 不重复的成员即可,注意客户端只识别以上四个 gachaType 值,添加的其他卡池不会显示类型。

注意 2.7 版本的新卡池是按照实际 up 五星角色显示名称而不是和老版本一样根据卡池 id 显示 (旧卡池不受影响)。


# UP 五星,对应 id 在 Handbook 中可以找到,需修改 prefabPath previewPrefabPath titlePath 中的 A0** 为对应的卡池 id
rateUpItems5

# UP 四星,对应 id 在 Handbook 中可以找到,需修改 prefabPath previewPrefabPath titlePath 中的 A0** 为对应的卡池 id
rateUpItems4

# 抽卡耗费的货币名称,223 为纠缠之缘,224 为相遇之缘(修改可能会引发 bug)
costItem

# 卡池排序,越大越靠前
sortId

# 卡池开始的 10 位时间戳
beginTime

# 卡池结束的 10 位时间戳
endTime

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

# 为四星的权重数组,每个成员由两个数字构成,后一个数字代表前一个数字抽数下出四星的权重
weights4

# 为五星的权重数组,每个成员由两个数字构成,后一个数字代表前一个数字抽数下出五星的权重
weights5

# 为 STANDARD 表示常驻池,EVENT 表示角色 UP 池,WEAPON 表示武器 UP 池 (这个参数貌似只是看的)
bannerType

常见问题

控制台命令

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

查询指令可以,打开服务端的 GM Handbook\GM Handbook - CHS.txt 文件,查询指令及资源id,或者使用 GrasscutterCommandGenerator 和 GrasscutterTools 生成指令

错误问题

4206错误
检查代理端 / 服务端所有配置,重启代理端 / 重启服务器。
若无法解决则,关闭代理正常启动游戏,检查更新完后,再次开代理进入游戏。
修改 config.json 中 server.http.accessAddress 为 dispatchcnglobal.yuanshen.com 。

登陆账号提示网络错误 / 网络超时
修改 config.json 中 server.http.accessAddress 为 dispatchcnglobal.yuanshen.com 然后进一遍游戏,如果能进去,就可以将其还原。

点击登录转圈然后没反应
如果点击后服务端日志有成功登录的提示,关掉登录窗口即可进入游戏。如无,重启服务端代理。

502/4301/ 无法连接服务器
没配置正确,请自行检查

登陆后检查更新失败
代理日志中有 mihoyo.com / hoyoverse.com 子域的请求,但显示拒绝连接等错误,可能是服务端网络问题导致无法连接米哈游服务器

开启代理后还是登录了官服
有其他代理冲突,服务端没有正确运行。

4214错误
密钥错误,原因 没有 patch 客户端 / 客户端 patch 错误 / 客户端与服务端不兼容。

-9203错误
一般为代理问题

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

进门后连接超时
放通 UDP 22102

进门白屏
乱改数据库改出问题了,或者服务端系统不兼容 Java

不错
最后更新于 2025-09-06