# 割草机编译教程

**Repository Path**: liangfm/Grasscutter_Compilation

## Basic Information

- **Project Name**: 割草机编译教程
- **Description**: 割草机编译教程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 10
- **Created**: 2022-07-18
- **Last Updated**: 2023-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 割草机编译教程

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

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

### 2. 安装java环境
割草机所需环境为java17，这里给一个OpenJDK的发行版LibericaJDK的下载地址[https://bell-sw.com/pages/downloads/](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版本信息即为成功

![输入图片说明](image/1.png)
![输入图片说明](image/2.png)
![输入图片说明](image/3.png)
![输入图片说明](image/4.png)

### 3. 安装MongoDB
MongoDB的安装教程网上有很多，这里不再赘述。
-  [https://blog.csdn.net/qq_44732146/article/details/119760448](https://blog.csdn.net/qq_44732146/article/details/119760448)
-  [https://blog.csdn.net/crsitin_spade/article/details/121383699](https://blog.csdn.net/crsitin_spade/article/details/121383699)

### 4. 拉取代码
-  Grasscutter后端源码[https://github.com/Grasscutters/Grasscutter](https://github.com/Grasscutters/Grasscutter)
-  Grasscutter_Resources[https://github.com/Koko-boya/Grasscutter_Resources](https://github.com/Koko-boya/Grasscutter_Resources)

![输入图片说明](image/5.png)

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

![输入图片说明](image/6.png)
![输入图片说明](image/7.png)
![输入图片说明](image/8.png)
![输入图片说明](image/9.png)

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

![输入图片说明](image/14.png)
![输入图片说明](image/15.png)

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

![输入图片说明](image/10.png)
![输入图片说明](image/11.png)

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

![输入图片说明](image/12.png)
![输入图片说明](image/13.png)

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

### 6. 运行代码
做一键端，运行代码，就可以不需要JDK环境了，直接使用JRE即可，这里同样使用OpenJDK的发行版LibericaJDK。在运行之前，请确保MongoDB已经开启
-  下载地址[https://bell-sw.com/pages/downloads/](https://bell-sw.com/pages/downloads/)
-  选择JDK 17 LTS --> Standrad JRE --> Download ZIP
1.  创建一个文件夹，用于存放相关文件
2.  将JRE和编译后的jar放入该文件夹，编译后的jar记得改名为grasscutter.jar。可以像我这样给文件夹命名，创个文件夹将jar放进去，方便后续文件整理

![输入图片说明](image/16.png)
![输入图片说明](image/20.png)

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

![输入图片说明](image/17.png)

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

![输入图片说明](image/18.png)

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

![输入图片说明](image/19.png)

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

![输入图片说明](image/21.png)
![输入图片说明](image/22.png)