Usage and constraints

Describe ordered alternatives for native consumables, such as furnace fuel. The list is bounded to 32 choices. Supply comes from free network stock; it is not a reserved recipe input and must not be refunded when a job is cancelled.

Public addon API

NebulaPhysicalSupplyOptions

NebulaPhysicalSupplyOptions
package dev.nebulastorage.api.platform

import dev.nebulastorage.api.production.ProductionRecipeId
import dev.nebulastorage.api.resource.ResourceKey
import dev.nebulastorage.api.resource.ResourceStack

/** Ordered alternatives for one local consumable; at most one option is delivered per advance. */
interface NebulaPhysicalSupplyOptions : NebulaPhysicalSupplies {
    /** At most 32 finite requests, bounded by native capacity; no resource is reserved by discovery. */
    fun requestedSupplies(id: ProductionRecipeId, inputs: Map<ResourceKey, Long>): List<ResourceStack>

    override fun requestedSupply(id: ProductionRecipeId, inputs: Map<ResourceKey, Long>): ResourceStack? =
        requestedSupplies(id, inputs).firstOrNull()
}
Source

src/main/kotlin/dev/nebulastorage/api/platform/NebulaPhysicalSupplyOptions.kt; editorial/en.json

43b4d12d69e6033c24fa8c39dac383ef2429b446