割草机编译教程

重点：各位低调使用，不要点赞不要Star！！！

1. 安装Git

1. 在Git官网下载安装文件并安装https://git-scm.com/
2. 在TortoiseGit官网下载安装文件https://tortoisegit.org/download/

2. 安装java环境

割草机所需环境为java17，这里给一个OpenJDK的发行版LibericaJDK的下载地址https://bell-sw.com/pages/downloads/

1. 选择JDK 17 LTS --> Standrad JDK --> Download ZIP
2. 将下载的ZIP文件解压至任意地方（路径不要有中文）
3. 设置Java环境变量
   • 打开系统属性，点击高级系统设置，会打开如下页面，点击环境变量
   • 在"系统变量"中设置3项属性，JAVA_HOME、CLASSPATH、PATH
     • 变量名：JAVA_HOME
     • 变量值：D:\Dev\Java\liberica-jdk-17-full // 要根据自己的实际路径配置
     • 变量名：CLASSPATH
     • 变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar; // 记得前面有个"."
     • 第3个Path变量，直接选中"系统变量"中已经存在的Path，点击编辑，在空白处添加一行%JAVA_HOME%\bin即可
     • 设置完成后点击确定保存
4. 设置Java环境变量完成后，在cmd中输入java -version，能够显示出java版本信息即为成功

3. 安装MongoDB

MongoDB的安装教程网上有很多，这里不再赘述。

• https://blog.csdn.net/qq_44732146/article/details/119760448
• https://blog.csdn.net/crsitin_spade/article/details/121383699

4. 拉取代码

• Grasscutter后端源码https://github.com/Grasscutters/Grasscutter
• Grasscutter_Resourceshttps://github.com/Koko-boya/Grasscutter_Resources

1. 在你想要存放代码的地方，点击右键 --> TortoiseGit --> Clone
2. 在打开的窗口中，在URL处粘贴复制的git地址（不是网址）
3. 等待拉取完成（一共两个项目，需要拉取两次）
4. 后续更新代码，在代码文件夹中，点击右键 --> TortoiseGit --> Pull

5. 编译代码

• 该项目有3个分支，stable，dev，2.7。建议切换为dev分支，这样可以享受到最新的更新
• 打开Grasscutter文件夹，点击右键 --> TortoiseGit --> Switch/Checkout，选择development

1. 打开Grasscutter文件夹，在文件夹中打开终端（Shift+右键）
2. 执行.\gradlew.bat，等待其完成

3. 同样在此处执行.\gradlew jar，等待其完成（第一次编译时间会有些长，需要下载依赖，速度取决于网速）
4. 编译完成后，会在该文件夹内看见编译后的jar包（文件名为grasscutter.jar或grasscutter-dev-1.3.0.jar）

5. 后续拉取更新代码再次编译，只需执行.\gradlew jar即可

6. 运行代码

做一键端，运行代码，就可以不需要JDK环境了，直接使用JRE即可，这里同样使用OpenJDK的发行版LibericaJDK。在运行之前，请确保MongoDB已经开启

• 下载地址https://bell-sw.com/pages/downloads/
• 选择JDK 17 LTS --> Standrad JRE --> Download ZIP

1. 创建一个文件夹，用于存放相关文件
2. 将JRE和编译后的jar放入该文件夹，编译后的jar记得改名为grasscutter.jar。可以像我这样给文件夹命名，创个文件夹将jar放进去，方便后续文件整理

3. 在项目Grasscutter文件夹中，复制data、keys、proto文件夹以及keystore.p12文件过来

4. 创建一个resources文件夹，在项目Grasscutter_Resources文件夹中，将里面的内容复制到resources文件夹里

5. 编写启动脚本，start.bat可以在此文档里面直接下载

6. 运行启动脚本，第一次运行会生成config.json，可以修改里面的内容，重新运行
   • 若为服务端部署，设置GameServer节点下的PublicIp为服务器的公网IP，设置DispatchServer节点下的PublicIp为服务器的公网IP，Port为你需要部署的端口
   • 若不需要https部署，将DispatchServer节点下的UseSSL与FrontHTTPS改为false