Products API

The Products API provides functionality for working with product items in the game, including specialized products like drugs.

Namespace

using S1API.Products;
using S1API.Items;
using S1API.Properties;

Key Classes

ProductDefinition

Represents a product definition in the game. Inherits from ItemDefinition.

public class ProductDefinition : ItemDefinition
{
    // INTERNAL properties and methods omitted
    
    public float Price { get; }
    public float BasePrice { get; }
    public float MarketValue { get; }
    public Sprite Icon { get; }
    public System.Collections.Generic.IReadOnlyList<PropertyBase> Properties { get; }
    
    public override ItemInstance CreateInstance(int quantity = 1);
}

Note: This class also exposes base-game drug typing information.

• DrugTypes: runtime-specific list of ScheduleOne.Product.DrugTypeContainer
• DrugType: ScheduleOne.Product.EDrugType

ProductInstance

Represents an instance of a product in the game. Inherits from ItemInstance.

public class ProductInstance : ItemInstance
{
    // INTERNAL properties and methods omitted
    
    public bool IsPackaged { get; }
    public PackagingDefinition AppliedPackaging { get; }
    public Quality Quality { get; }
    public ProductDefinition Definition { get; }
    public System.Collections.Generic.IReadOnlyList<PropertyBase> Properties { get; }
}

ProductManager

Static class for accessing products in the game.

public static class ProductManager
{
    public static ProductDefinition[] DiscoveredProducts { get; }
}

Product Type Definitions

The API provides specialized product definition classes for different drug types:

WeedDefinition

public class WeedDefinition : ProductDefinition
{
    // INTERNAL properties and methods omitted
    
    public override ItemInstance CreateInstance(int quantity = 1);
}

MethDefinition

public class MethDefinition : ProductDefinition
{
    // INTERNAL properties and methods omitted
    
    public override ItemInstance CreateInstance(int quantity = 1);
}

CocaineDefinition

public class CocaineDefinition : ProductDefinition
{
    // INTERNAL properties and methods omitted
    
    public override ItemInstance CreateInstance(int quantity = 1);
}

PackagingDefinition

Represents a type of packaging in-game. Inherits from ItemDefinition.

public class PackagingDefinition : ItemDefinition
{
    // INTERNAL properties and methods omitted
    
    public int Quantity { get; }
}

ProductDefinitionWrapper

INTERNAL: A wrapper class for converting a product definition to its proper dedicated class.

public static class ProductDefinitionWrapper
{
    public static ProductDefinition Wrap(ProductDefinition def);
}

Quality

Represents quality tiers for product instances.

public enum Quality
{
    Trash = 0,
    Poor = 1,
    Standard = 2,
    Premium = 3,
    Heavenly = 4
}

Related Base Classes

These classes are from the S1API.Items namespace and serve as base classes for the Products API.

ItemDefinition

public class ItemDefinition
{
    public string GUID { get; }
    public string ID { get; }
    public string Name { get; }
    public string Description { get; }
    public ItemCategory Category { get; }
    public int StackLimit { get; }
    
    public virtual ItemInstance CreateInstance(int quantity = 1);
}

ItemInstance

public class ItemInstance
{
    public ItemDefinition Definition { get; }
}

ItemCategory

public enum ItemCategory
{
    Product,
    Packaging,
    Growing,
    Tools,
    Furniture,
    Lighting,
    Cash,
    Consumable,
    Equipment,
    Ingredient,
    Decoration,
    Clothing
}

Usage Examples

Getting Products

// Access all discovered products
ProductDefinition[] products = ProductManager.DiscoveredProducts;

// Loop through products
foreach (var product in products)
{
    Console.WriteLine($"Product: {product.Name}, Price: ${product.Price}, MV: ${product.MarketValue}");
    
    // Check for specific product types
    if (product is WeedDefinition weedProduct)
    {
        // Handle weed-specific functionality
    }
    else if (product is MethDefinition methProduct)
    {
        // Handle meth-specific functionality
    }
    else if (product is CocaineDefinition cocaineProduct)
    {
        // Handle cocaine-specific functionality
    }
}

Creating Product Instances

// Get a product definition
ProductDefinition productDef = ProductManager.DiscoveredProducts.FirstOrDefault(p => p.Name == "Product Name");

if (productDef != null)
{
    // Create an instance (e.g., to add to inventory)
    ProductInstance productInstance = (ProductInstance)productDef.CreateInstance(5); // Quantity of 5
    
    // Access the icon for a product
    Sprite productIcon = productDef.Icon;

    // Inspect instance-specific data
    var quality = productInstance.Quality; // Quality enum
    var isPackaged = productInstance.IsPackaged;
    var packaging = productInstance.AppliedPackaging;
    var props = productInstance.Properties; // IReadOnlyList<PropertyBase>
}