Preserved terrain across updates

- Saved chunks retain their natural geometry and generation ownership - Future chunks blend against frozen terrain boundaries - Build revisions capture generation source and dependencies automatically - Native terrain queries use contained transition geometry and final height caches - Historical searches retain recorded pack identities and placement facts - World creation and Studio updates preserve native lifecycle ordering - Hydrology containment and scoped content workers retain generation context - Pregeneration validates saved completion before trusting cached progress
2026-10-11 19:14:11 +00:00 · 2026-09-05 11:57:01 -04:00
parent 20ad49b9d2
commit b1e1fbc15e
214 changed files with 11985 additions and 4082 deletions
@@ -0,0 +1,91 @@
+import art.arcane.iris.buildtools.GenerationBuildRevision
+import art.arcane.iris.buildtools.GenerationRevisionScope
+import org.gradle.api.artifacts.Configuration
+import org.gradle.api.artifacts.ResolvedArtifact
+import org.gradle.api.tasks.TaskProvider
+import org.gradle.jvm.tasks.Jar
+
+import java.nio.file.Path
+
+Configuration kernelDependencies = configurations.create('generationKernelDependencies') {
+    canBeConsumed = false
+    canBeResolved = true
+    extendsFrom(configurations.implementation, configurations.slim, configurations.annotationProcessor)
+}
+dependencies.add(kernelDependencies.name, libs.guava)
+
+GenerationBuildRevision.CaptureOptions revisionScope = GenerationRevisionScope.current(rootProject.projectDir.toPath())
+File catalogFile = file('generation-kernels/catalog.tsv')
+TaskProvider<Jar> kernelAgentJar = project(':core:agent').tasks.named('jar', Jar)
+File generatedResources = layout.buildDirectory.dir('generated/generation-revision').get().asFile
+File generatedCatalog = new File(generatedResources, 'META-INF/iris/generation-kernels/catalog.tsv')
+File generatedRevision = new File(generatedResources, 'META-INF/iris/generation-kernels/abi-1.revision')
+
+Closure<Map<String, Path>> resolvedKernelDependencies = {
+    Map<String, Path> artifacts = new TreeMap<>()
+    for (ResolvedArtifact artifact : kernelDependencies.resolvedConfiguration.resolvedArtifacts) {
+        String group = artifact.moduleVersion.id.group
+        String name = artifact.moduleVersion.id.name
+        if (group == 'art.arcane' && name == 'spi') {
+            continue
+        }
+        boolean volmLib = (group == 'com.github.VolmitSoftware' && name == 'VolmLib')
+            || group == 'com.github.VolmitSoftware.VolmLib'
+            || (group == 'art.arcane' && name == 'shared')
+        String key = volmLib ? 'volmlib' : "${group}:${name}".toString()
+        if (artifact.classifier != null) {
+            key += ':' + artifact.classifier
+        }
+        if (artifacts.putIfAbsent(key, artifact.file.toPath()) != null) {
+            throw new GradleException("Duplicate generation dependency identity: ${key}")
+        }
+    }
+    if (!artifacts.containsKey('volmlib')) {
+        throw new GradleException('The generation revision must include the resolved VolmLib artifact.')
+    }
+    artifacts.put('iris-agent', kernelAgentJar.get().archiveFile.get().asFile.toPath())
+    return artifacts
+}
+
+TaskProvider<Task> revisionResources = tasks.register('generateGenerationBuildRevision') {
+    group = 'build'
+    description = 'Captures generation sources and resolved dependencies as build revision provenance.'
+    dependsOn(kernelDependencies, kernelAgentJar, ":adapters:bukkit:nms:v26_2_R1:convert")
+    inputs.files(revisionScope.roots().collect { String source -> rootProject.file(source) })
+    inputs.property('revisionScope', revisionScope.toString())
+    inputs.files(catalogFile, kernelDependencies, kernelAgentJar.flatMap { Jar jar -> jar.archiveFile })
+    outputs.files(generatedRevision, generatedCatalog)
+    doLast {
+        GenerationBuildRevision.SourceManifest captured = GenerationBuildRevision.capture(revisionScope, resolvedKernelDependencies())
+        GenerationBuildRevision.verifyCatalog(catalogFile.toPath(), [(revisionScope.abi()): captured])
+        GenerationBuildRevision.write(generatedRevision.toPath(), captured)
+        generatedCatalog.text = catalogFile.getText('UTF-8')
+    }
+}
+
+TaskProvider<Task> verifyRevision = tasks.register('verifyGenerationBuildRevision') {
+    group = 'verification'
+    description = 'Verifies that the packaged revision describes the inputs of this build.'
+    dependsOn(revisionResources)
+    doLast {
+        GenerationBuildRevision.verifySnapshot(rootProject.projectDir.toPath(), generatedRevision.toPath(), resolvedKernelDependencies())
+        GenerationBuildRevision.verifyCatalog(generatedCatalog.toPath(), [(revisionScope.abi()): GenerationBuildRevision.read(generatedRevision.toPath())])
+    }
+}
+
+tasks.named('processResources').configure {
+    dependsOn(revisionResources)
+    from(generatedResources)
+}
+tasks.named('test', Test).configure {
+    dependsOn(revisionResources)
+    classpath = files(generatedResources) + classpath
+}
+tasks.named('check').configure { dependsOn(verifyRevision) }
+tasks.withType(Jar).configureEach { dependsOn(verifyRevision) }
+rootProject.tasks.named('check').configure { dependsOn(verifyRevision) }
+rootProject.tasks.withType(Jar).configureEach { dependsOn(verifyRevision) }
+rootProject.tasks.matching { Task task -> task.name in ['fabricJar', 'forgeJar', 'neoforgeJar'] }
+    .configureEach { dependsOn(verifyRevision) }
+rootProject.subprojects.findAll { Project candidate -> candidate.path.startsWith(':adapters:bukkit:') }
+    .each { Project adapter -> adapter.tasks.withType(Jar).configureEach { dependsOn(verifyRevision) } }