feat: add Forge 1.20.1 platform module

.github/workflows/gradle.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches: [ "**" ]
   pull_request:
+  workflow_dispatch:
 
 permissions:
   contents: read
@@ -27,7 +28,7 @@ jobs:
         uses: actions/setup-java@v4
         with:
           distribution: temurin
-          java-version: "21"
+          java-version: "17"
           cache: gradle
 
       # 可选：更安全，防止 wrapper 被篡改（不想要可删）

build.gradle

@@ -59,11 +59,13 @@ subprojects {
             inputs.file "../gradle.properties"
     }
     afterEvaluate {
-        tasks.named("sourcesJar") {
-            duplicatesStrategy = DuplicatesStrategy.INCLUDE
+        def sourcesJar = tasks.findByName("sourcesJar")
+        if (sourcesJar != null) {
+            sourcesJar.duplicatesStrategy = DuplicatesStrategy.INCLUDE
         }
-        tasks.named("jar") {
-            duplicatesStrategy = DuplicatesStrategy.INCLUDE
+        def jarTask = tasks.findByName("jar")
+        if (jarTask != null) {
+            jarTask.duplicatesStrategy = DuplicatesStrategy.INCLUDE
         }
     }
 }

common/src/main/java/cn/coostack/cooparticlesapi/mixin/compat/iris/FinalPassRendererAccessor.java

@@ -0,0 +1,12 @@
+package cn.coostack.cooparticlesapi.mixin.compat.iris;
+
+import net.irisshaders.iris.gl.framebuffer.GlFramebuffer;
+import net.irisshaders.iris.pipeline.FinalPassRenderer;
+import org.spongepowered.asm.mixin.Mixin;
+import org.spongepowered.asm.mixin.gen.Accessor;
+
+@Mixin(FinalPassRenderer.class)
+public interface FinalPassRendererAccessor {
+    @Accessor
+    GlFramebuffer getColorHolder();
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/annotations/codec/CommonStreamCodec.kt

@@ -0,0 +1,13 @@
+package cn.coostack.cooparticlesapi.annotations.codec
+
+interface CommonStreamCodec<T> {
+    fun decode(buf: Any): T
+    fun encode(buf: Any, value: T)
+    companion object {
+        fun <T> of(dec: (Any) -> T, enc: (Any, T) -> Unit): CommonStreamCodec<T> =
+            object : CommonStreamCodec<T> {
+                override fun decode(buf: Any): T = dec(buf)
+                override fun encode(buf: Any, value: T) = enc(buf, value)
+            }
+    }
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/compat/iris/CooIrisRenderState.kt

@@ -0,0 +1,64 @@
+package cn.coostack.cooparticlesapi.compat.iris
+
+import kotlin.jvm.JvmStatic
+import net.irisshaders.iris.gl.framebuffer.GlFramebuffer
+import net.irisshaders.iris.targets.DepthTexture
+import net.irisshaders.iris.targets.RenderTargets
+
+object CooIrisRenderState {
+    @JvmStatic
+    fun beginFrame() {}
+
+    @JvmStatic
+    fun captureSceneDepth(depthTextureId: Int, width: Int, height: Int) {}
+
+    @JvmStatic
+    fun captureTerrainDepth(textureId: Int, width: Int, height: Int) {}
+
+    @JvmStatic
+    fun captureNoHandDepth(textureId: Int, width: Int, height: Int) {}
+
+    @JvmStatic
+    fun captureFinalColor(colorAttachment0: Any?, framebufferId: Int, width: Int, height: Int) {}
+
+    @JvmStatic
+    fun clear() {}
+
+    @JvmStatic
+    fun clearFinalColor() {}
+
+    @JvmStatic
+    fun snapshot(): IrisSnapshot = EmptySnapshot
+
+    object EmptySnapshot : IrisSnapshot {
+        override fun terrainDepthTextureId(): Int = 0
+        override fun terrainDepthWidth(): Int = 0
+        override fun terrainDepthHeight(): Int = 0
+        override fun sceneDepthTextureId(): Int = 0
+        override fun sceneDepthWidth(): Int = 0
+        override fun sceneDepthHeight(): Int = 0
+        override fun noHandDepthTextureId(): Int = 0
+        override fun noHandDepthWidth(): Int = 0
+        override fun noHandDepthHeight(): Int = 0
+        override fun finalColorTextureId(): Int = 0
+        override fun finalColorWidth(): Int = 0
+        override fun finalColorHeight(): Int = 0
+        override fun finalColorFramebufferId(): Int = 0
+    }
+}
+
+interface IrisSnapshot {
+    fun terrainDepthTextureId(): Int
+    fun terrainDepthWidth(): Int
+    fun terrainDepthHeight(): Int
+    fun sceneDepthTextureId(): Int
+    fun sceneDepthWidth(): Int
+    fun sceneDepthHeight(): Int
+    fun noHandDepthTextureId(): Int
+    fun noHandDepthWidth(): Int
+    fun noHandDepthHeight(): Int
+    fun finalColorTextureId(): Int
+    fun finalColorWidth(): Int
+    fun finalColorHeight(): Int
+    fun finalColorFramebufferId(): Int
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/compat/CParticleEmitterBridge.kt

@@ -417,16 +417,18 @@ object CParticleEmitterBridge {
             val base = index * ForceCommand.STRIDE
             when (val force = command.force) {
                 is CParticleForce.Texture -> {
-                    val slot = textureSlots.getOrPut(force.resource) {
-                        resources.add(force.resource)
+                    val resource = force.resource
+                    val slot = textureSlots.getOrPut(resource) {
+                        resources.add(resource)
                         textureSlots.size
                     }
                     command.pack(packed, base, origin, slot)
                 }
 
                 is CParticleForce.FluidFlow -> {
-                    val slot = fluidSlots.getOrPut(force.resource) {
-                        resources.add(force.resource)
+                    val resource = force.resource
+                    val slot = fluidSlots.getOrPut(resource) {
+                        resources.add(resource)
                         fluidSlots.size
                     }
                     command.pack(packed, base, origin, slot)

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/force/CParticleFluidResource.kt

@@ -0,0 +1,7 @@
+package cn.coostack.cooparticlesapi.cparticle.force
+
+class CParticleFluidResource(id: String) : CParticleForceResource(id), CParticleFluidBinding {
+    override fun sampleFluid(x: Double, y: Double, z: Double, out: FloatArray) {}
+    fun bindCompute(index: Int) {}
+    fun resetCompute() {}
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/force/CParticleForceResource.kt

@@ -0,0 +1,6 @@
+package cn.coostack.cooparticlesapi.cparticle.force
+
+open class CParticleForceResource(val id: String) {
+    override fun equals(other: Any?): Boolean = other is CParticleForceResource && other.id == id
+    override fun hashCode(): Int = id.hashCode()
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/force/CParticleForceResourceRegistry.kt

@@ -0,0 +1,11 @@
+package cn.coostack.cooparticlesapi.cparticle.force
+
+object CParticleForceResourceRegistry {
+    private val bindings = mutableMapOf<CParticleForceResource, Any>()
+    fun bind(resource: CParticleForceResource, binding: Any) {
+        bindings[resource] = binding
+    }
+    fun clearResolvedBindings() {
+        bindings.clear()
+    }
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/force/CParticleForceResourceTable.kt

@@ -0,0 +1,31 @@
+package cn.coostack.cooparticlesapi.cparticle.force
+
+interface CParticleTextureBinding {
+    fun sampleTexture(x: Double, y: Double, z: Double, out: FloatArray)
+}
+
+interface CParticleFluidBinding {
+    fun sampleFluid(x: Double, y: Double, z: Double, out: FloatArray)
+}
+
+class CParticleForceResourceTable {
+    companion object {
+        const val MAX_TEXTURE_RESOURCES: Int = 16
+    }
+    fun resolve(resource: CParticleForceResource): Any? = null
+    fun slotFor(resource: CParticleTextureResource): Int = -1
+    fun slotFor(resource: CParticleFluidResource): Int = -1
+    fun textureBinding(slot: Int): CParticleTextureBinding = NullTextureBinding
+    fun fluidBinding(slot: Int): CParticleFluidBinding = NullFluidBinding
+    fun textureBindings(): List<CParticleTextureResource> = emptyList()
+    fun fluidBindings(): List<CParticleFluidResource> = emptyList()
+    fun clear() {}
+}
+
+private object NullTextureBinding : CParticleTextureBinding {
+    override fun sampleTexture(x: Double, y: Double, z: Double, out: FloatArray) {}
+}
+
+private object NullFluidBinding : CParticleFluidBinding {
+    override fun sampleFluid(x: Double, y: Double, z: Double, out: FloatArray) {}
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/force/CParticleTextureResource.kt

@@ -0,0 +1,7 @@
+package cn.coostack.cooparticlesapi.cparticle.force
+
+class CParticleTextureResource(id: String) : CParticleForceResource(id), CParticleTextureBinding {
+    override fun sampleTexture(x: Double, y: Double, z: Double, out: FloatArray) {}
+    fun bindCompute(index: Int) {}
+    fun resetCompute() {}
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/simulate/CParticleGpuSimulator.kt

@@ -5,6 +5,8 @@ import cn.coostack.cooparticlesapi.cparticle.CParticleCapabilities
 import cn.coostack.cooparticlesapi.cparticle.collision.CParticleBlockCollisionGrid
 import cn.coostack.cooparticlesapi.cparticle.force.CParticleForceResourceTable
 import cn.coostack.cooparticlesapi.cparticle.force.CParticleForce
+import cn.coostack.cooparticlesapi.cparticle.force.CParticleTextureResource
+import cn.coostack.cooparticlesapi.cparticle.force.CParticleFluidResource
 import cn.coostack.cooparticlesapi.cparticle.force.ForceCommand
 import cn.coostack.cooparticlesapi.renderer.shader.AdvancedShaderProgramBuilder
 import cn.coostack.cooparticlesapi.renderer.shader.ShaderProgramRegistry
@@ -180,8 +182,8 @@ object CParticleGpuSimulator {
             "[cparticle] ${if (useLegacy) "legacy Force" else "Force Command"} GPU compute program 无效，拒绝回退 CPU"
         }
 
-        val textureBindings = if (useLegacy) emptyList() else system.forceResourceTable.textureBindings()
-        val fluidBindings = if (useLegacy) emptyList() else system.forceResourceTable.fluidBindings()
+        val textureBindings = if (useLegacy) emptyList<CParticleTextureResource>() else system.forceResourceTable.textureBindings()
+        val fluidBindings = if (useLegacy) emptyList<CParticleFluidResource>() else system.forceResourceTable.fluidBindings()
         var dispatched = false
         try {
             compute.useOnContext {

common/src/main/kotlin/cn/coostack/cooparticlesapi/cparticle/storage/CParticleCommandGlBuffer.kt

@@ -0,0 +1,10 @@
+package cn.coostack.cooparticlesapi.cparticle.storage
+
+class CParticleCommandGlBuffer {
+    val initialized: Boolean get() = false
+    fun init() {}
+    fun upload(data: FloatArray, count: Int) {}
+    fun release() {}
+    fun dispose() {}
+    fun bindShaderStorage(binding: Int) {}
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/data/holder/DataHolderManager.kt

@@ -3,16 +3,16 @@ package cn.coostack.cooparticlesapi.data.holder
 import cn.coostack.cooparticlesapi.CooParticlesConstants
 import cn.coostack.cooparticlesapi.annotations.CooAutoRegister
 import cn.coostack.cooparticlesapi.annotations.codec.CodecHelper
+import cn.coostack.cooparticlesapi.annotations.codec.CommonStreamCodec
 import cn.coostack.cooparticlesapi.network.packet.server.PacketDataHolderS2C
 import cn.coostack.cooparticlesapi.reflect.CooAPIScanner
 import cn.coostack.cooparticlesapi.reflect.SimpleClassInfo
-import net.minecraft.network.codec.StreamCodec
 import net.minecraft.world.entity.Entity
 import java.util.concurrent.ConcurrentHashMap
 
 object DataHolderManager {
     val entities = ConcurrentHashMap<Entity, DataHolder>()
-    private val registeredTypes = ConcurrentHashMap<String, StreamCodec<*, *>>()
+    private val registeredTypes = ConcurrentHashMap<String, CommonStreamCodec<*>>()
 
     fun getOrCreate(entity: Entity): DataHolder {
         return entities.getOrPut(entity) { DataHolder(entity) }
@@ -33,11 +33,11 @@ object DataHolderManager {
         registeredTypes[randomInstance::class.java.name] = codec
     }
 
-    fun register(type: Class<*>, codec: StreamCodec<*, *>) {
+    fun register(type: Class<*>, codec: CommonStreamCodec<*>) {
         registeredTypes[type.name] = codec
     }
 
-    fun getCodecFromID(id: String): StreamCodec<*, *>? {
+    fun getCodecFromID(id: String): CommonStreamCodec<*>? {
         return registeredTypes[id] ?: CodecHelper.supposedTypes[id]
     }
 
@@ -63,7 +63,7 @@ object DataHolderManager {
         register(instance)
     }
 
-    private fun findCodec(instance: Any): StreamCodec<*, *> {
+    private fun findCodec(instance: Any): CommonStreamCodec<*> {
         val codec = CodecHelper.supposedTypes[instance::class.java.name]
         return codec
             ?: throw IllegalStateException("DataHolder codec not registered for type: ${instance::class.java.name}")

common/src/main/kotlin/cn/coostack/cooparticlesapi/network/packet/api/CommonCodec.kt

@@ -0,0 +1,13 @@
+package cn.coostack.cooparticlesapi.network.packet.api
+
+interface CommonCodec<T> {
+    fun encode(buf: PacketByteBuf, value: T)
+    fun decode(buf: PacketByteBuf): T
+    companion object {
+        fun <T> of(enc: (PacketByteBuf, T) -> Unit, dec: (PacketByteBuf) -> T): CommonCodec<T> =
+            object : CommonCodec<T> {
+                override fun encode(buf: PacketByteBuf, value: T) = enc(buf, value)
+                override fun decode(buf: PacketByteBuf): T = dec(buf)
+            }
+    }
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/network/packet/api/CooServerPacketManager.kt

@@ -12,7 +12,6 @@ import cn.coostack.cooparticlesapi.network.packet.api.envelope.CooPacketEnvelope
 import cn.coostack.cooparticlesapi.performance.PerformanceStatusNetworkEndpoint
 import cn.coostack.cooparticlesapi.performance.PerformanceStatusNetworkMetrics
 import cn.coostack.cooparticlesapi.platform.CooParticlesServices
-import net.minecraft.network.protocol.common.custom.CustomPacketPayload
 import net.minecraft.server.level.ServerLevel
 import net.minecraft.server.level.ServerPlayer
 import java.util.UUID
@@ -332,7 +331,7 @@ object CooServerPacketManager {
             CooParticlesConstants.logger.error("CooPacket 编码失败: ${packet::class.java.name}", e)
             return false
         }
-        val envelope: CustomPacketPayload = CooPacketEnvelopeS2C(
+        val envelope = CooPacketEnvelopeS2C(
             kindId = kind.id,
             packetId = packet.id(),
             correlationId = correlationId,

common/src/main/kotlin/cn/coostack/cooparticlesapi/network/packet/api/PacketByteBuf.kt

@@ -0,0 +1,18 @@
+package cn.coostack.cooparticlesapi.network.packet.api
+
+interface PacketByteBuf {
+    fun writeUtf(value: String)
+    fun writeResourceLocation(value: Any?)
+    fun writeInt(value: Int)
+    fun writeFloat(value: Float)
+    fun writeDouble(value: Double)
+    fun writeLong(value: Long)
+    fun writeBoolean(value: Boolean)
+    fun readUtf(): String
+    fun readResourceLocation(): Any?
+    fun readInt(): Int
+    fun readFloat(): Float
+    fun readDouble(): Double
+    fun readLong(): Long
+    fun readBoolean(): Boolean
+}

common/src/main/kotlin/cn/coostack/cooparticlesapi/platform/ClientNetworking.kt

@@ -1,13 +1,5 @@
 package cn.coostack.cooparticlesapi.platform
 
-import net.minecraft.network.protocol.common.custom.CustomPacketPayload
-import net.minecraft.server.level.ServerLevel
-import net.minecraft.server.level.ServerPlayer
-import net.minecraft.world.level.ChunkPos
-
 interface ClientNetworking {
-
-    fun send(packet: CustomPacketPayload)
-
-
+    fun send(packet: cn.coostack.cooparticlesapi.network.packet.api.CooPacket)
 }

common/src/main/kotlin/cn/coostack/cooparticlesapi/platform/ServerNetworking.kt

@@ -1,19 +1,15 @@
 package cn.coostack.cooparticlesapi.platform
 
-import net.minecraft.network.protocol.common.custom.CustomPacketPayload
 import net.minecraft.server.level.ServerLevel
 import net.minecraft.server.level.ServerPlayer
 import net.minecraft.world.level.ChunkPos
 
 interface ServerNetworking {
-    fun send(packet: CustomPacketPayload, to: ServerPlayer)
-    fun sendAllPlayers(packet: CustomPacketPayload)
-    fun sendToPlayersTrackingChunk(world: ServerLevel, chunk: ChunkPos, packet: CustomPacketPayload)
+    fun send(packet: cn.coostack.cooparticlesapi.network.packet.api.CooPacket, to: ServerPlayer)
+    fun sendAllPlayers(packet: cn.coostack.cooparticlesapi.network.packet.api.CooPacket)
+    fun sendToPlayersTrackingChunk(world: ServerLevel, chunk: ChunkPos, packet: cn.coostack.cooparticlesapi.network.packet.api.CooPacket)
 
-    /**
-     * 把数据包发送给指定世界 (维度) 内的所有玩家
-     */
-    fun sendToWorld(world: ServerLevel, packet: CustomPacketPayload) {
+    fun sendToWorld(world: ServerLevel, packet: cn.coostack.cooparticlesapi.network.packet.api.CooPacket) {
         world.players().forEach { send(packet, it) }
     }
 }

common/src/main/kotlin/cn/coostack/cooparticlesapi/platform/network/ServerContext.kt

@@ -1,11 +1,10 @@
 package cn.coostack.cooparticlesapi.platform.network
 
-import net.minecraft.network.protocol.common.custom.CustomPacketPayload
 import net.minecraft.server.MinecraftServer
 import net.minecraft.world.entity.player.Player
 
 interface ServerContext {
     fun player(): Player
     fun server(): MinecraftServer
-    fun reply(packet: CustomPacketPayload)
+    fun reply(packet: cn.coostack.cooparticlesapi.network.packet.api.CooPacket)
 }