CC-Tweaked/projects/common-api/build.gradle.kts

plugins {
    id("cc-tweaked.java-convention")
    id("cc-tweaked.publishing")
    id("cc-tweaked.vanilla")
}

java {
    withJavadocJar()
}

dependencies {
    api(project(":core-api"))
    compileOnly(project(":forge-stubs"))
}

tasks.javadoc {
    include("dan200/computercraft/api/**/*.java")
}
Move our public API into separate modules This adds two new modules: common-api and forge-api, which contain the common and Forge-specific interfaces for CC's Minecraft-specific API. We add a new PlatformHelper interface, which abstracts over some of the loader-specific functionality, such as reading registries[^1] or calling Forge-specific methods. This interface is then implemented in the main mod, and loaded via ServiceLoaders. Some other notes on this: - We now split shared and client-specific source code into separate modules. This is to make it harder to reference client code on the server, thus crashing the game. Eventually we'll split the main mod up too into separate source sets - this is, of course, a much bigger problem! - There's currently some nastiness here due to wanting to preserve binary compatibility of the API. We'll hopefully be able to remove this when 1.19.3 releases. - In order to build a separate Forge-specific API jar, we compile the common sources twice: once for the common jar and once for the Forge jar. Getting this to play nicely with IDEs is a little tricky and so we provide a cct.inlineProject(...) helper to handle everything. [^1]: We /can/ do this with vanilla's APIs, but it gives a lot of deprecation warnings. It just ends up being nicer to abstract over it. 2022-11-06 15:07:13 +00:00			`plugins {`
			`id("cc-tweaked.java-convention")`
			`id("cc-tweaked.publishing")`
			`id("cc-tweaked.vanilla")`
			`}`

			`java {`
			`withJavadocJar()`
			`}`

			`dependencies {`
			`api(project(":core-api"))`
			`compileOnly(project(":forge-stubs"))`
			`}`

			`tasks.javadoc {`
			`include("dan200/computercraft/api/*/.java")`
			`}`