编译PlotSquared插件提示Unresolved reference: grgit错误如何解决

问题原因 #

报错是因为项目构建脚本需要用到grgit插件读取Git提交信息生成构建参数，但你的环境中没有正确加载该插件，或者本地项目不是完整Git克隆仓库导致grgit无法初始化。

解决方案 #

方案一：临时绕过（推荐新手、个人编译自用场景） #

直接修改报错的tasks.processResources配置块，去掉grgit依赖，手动补全参数即可，修改后代码如下：

tasks.processResources {
    filesMatching("plugin.properties") {
        expand(
            "version" to project.version.toString(),
            "commit" to "local-custom-build",
            "date" to java.time.LocalDate.now().format(DateTimeFormatter.ofPattern("yy.MM.dd"))
        )
    }
}

修改完成后重新执行构建命令即可正常编译。

方案二：完整配置grgit插件（需要正式构建参数的场景） #

1. 首先确认你是通过git clone命令拉取的项目源码，不是直接下载的Zip包，Zip包没有.git目录，grgit无法读取提交信息，必然报错。
2. 打开项目根目录的build.gradle.kts文件，在plugins配置块中添加grgit插件声明：

plugins {
    // 保留原有其他插件声明，新增下面这行
    id("org.ajoberstar.grgit") version "5.2.0" apply false
}

3. 确认根目录settings.gradle.kts中的pluginManagement块包含gradlePluginPortal()源，保证可以拉取到grgit插件：

pluginManagement {
    repositories {
        gradlePluginPortal()
        // 保留原有其他源配置
    }
}

4. 重新执行构建命令即可。

补充注意事项 #

• 编译PlotSquared需要JDK 17及以上版本，请提前配置好对应的Java环境
• 官方构建命令为./gradlew build（Linux/macOS）或gradlew.bat build（Windows），不要使用IDE的默认构建配置，避免依赖加载异常

内容的提问来源于stack exchange，提问作者KiHanLee