Go to file
2022-12-18 02:44:45 +08:00
.idea init 2022-12-18 02:44:45 +08:00
build/extracted-include-protos/main/google/protobuf init 2022-12-18 02:44:45 +08:00
gradle/wrapper ver3.3 2022-12-13 14:01:27 +08:00
lib ver3.3 2022-12-13 14:01:27 +08:00
src init 2022-12-18 02:44:45 +08:00
.gitignore init 2022-12-18 02:44:45 +08:00
build.gradle ver3.3 2022-12-13 14:01:27 +08:00
gradle.properties init 2022-12-18 02:44:45 +08:00
gradlew ver3.3 2022-12-13 14:01:27 +08:00
gradlew-jar.bat ver3.3 2022-12-13 14:01:27 +08:00
gradlew.bat ver3.3 2022-12-13 14:01:27 +08:00
java_pid22002.hprof init 2022-12-18 02:44:45 +08:00
keystore.p12 ver3.3 2022-12-13 14:01:27 +08:00
LICENSE ver3.3 2022-12-13 14:01:27 +08:00
proxy_config.py ver3.3 2022-12-13 14:01:27 +08:00
proxy.py ver3.3 2022-12-13 14:01:27 +08:00
README.md init 2022-12-18 02:44:45 +08:00
settings.gradle ver3.3 2022-12-13 14:01:27 +08:00

Grasscutter

Documention GitHub release (latest by date) GitHub GitHub last commit GitHub Workflow Status
Discord - Grasscutter

EN | 简中 | 繁中 | FR | ES | HE | RU | PL | ID | KR | FIL/PH | NL | JP | IT

请注意: 欢迎成为本项目的贡献者。但在提交 PR 之前, 请仔细阅读 代码规范

当前功能

  • 登录
  • 战斗
  • 好友
  • 传送
  • 祈愿
  • 多人游戏 部分 可用
  • 从控制台生成魔物
  • 物品 (接收或升级角色、武器等)

快速设置指南

注意: 如需帮助请加入 Discord

环境需求

运行服务端

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

  1. 获取 grasscutter.jar
  2. 在 JAR 文件根目录中创建 resources 文件夹并复制 BinOutputExcelBinOutput (查看 Wiki 了解更多)
  3. 确认 MongoDB 服务运行正常后,使用命令行 java -jar grasscutter.jar 运行 Grasscutter。

客户端连接

½. 在服务器控制台 创建账户

  1. 重定向流量: (选择其中一个)

    • 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 文件

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

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

构建

Grasscutter 使用 Gradle 来处理依赖及编译。

前置依赖:

Windows
git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # 建立开发环境
.\gradlew jar # 编译
Linux
git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # 编译
  • 编译后的 JAR 文件会在源码根目录生成

命令列表请到 wiki 查看

快速问题排除

  • 如果编译失败, 请检查 JDK 安装是否正确 (需要 JDK 17 并确认 JDK 的 bin 文件夹处于环境变量 PATH 中)
  • 客户端无法登录、连接、错误 4206 等其他问题... - 大部分情况是因为代理设置出现了问题。 如果使用 Fiddler请确认 Fiddler 监听端口不是 8888
  • 启动顺序: MongoDB > Grasscutter > 代理程序 (mitmdump, Fiddler 等) > 客户端