Skip to main content

Trade Recipes

Based on game build 714014 | Last updated: 2026-03-10

Overview

trade_recipes.lua defines a static table TRADE_RECIPES that enumerates named trade recipe definitions. Each entry specifies the name, required number of items, and rarity tier for a trade transaction. This file is a configuration data source, not a component, and is intended to be consumed by systems that manage player–merchant or player–event trades (e.g., Wickerbottom’s book trades or Quagmire currency conversions). It does not contain logic, components, or event handlers on its own.

Usage example

-- Example of referencing a defined recipe in mod code
local recipe = TRADE_RECIPES.common_upgrade
print(recipe.name) --> "9_COMMON_UPGRADE"
print(recipe.inputs.number) --> 9
print(recipe.inputs.rarity) --> "Common"

Dependencies & tags

Components used: None identified
Tags: None identified

Properties

PropertyTypeDefault ValueDescription
TRADE_RECIPES.classy_upgrade.namestring"9_CLASSY_UPGRADE"Unique identifier for the Classy rarity upgrade recipe.
TRADE_RECIPES.classy_upgrade.inputs.numbernumber9Number of items required.
TRADE_RECIPES.classy_upgrade.inputs.raritystring"Classy"Rarity tier required (used for filtering eligible items).
TRADE_RECIPES.common_upgrade.namestring"9_COMMON_UPGRADE"Unique identifier for the Common rarity upgrade recipe.
TRADE_RECIPES.common_upgrade.inputs.numbernumber9Number of items required.
TRADE_RECIPES.common_upgrade.inputs.raritystring"Common"Rarity tier required.
TRADE_RECIPES.spiffy_upgrade.namestring"9_SPIFFY_UPGRADE"Unique identifier for the Spiffy rarity upgrade recipe.
TRADE_RECIPES.spiffy_upgrade.inputs.numbernumber9Number of items required.
TRADE_RECIPES.spiffy_upgrade.inputs.raritystring"Spiffy"Rarity tier required.

Main functions

Not applicable.

Events & listeners

None identified.