cubemain

cubemain.txt defines every Horadric Cube recipe in the game: rune upgrades, gem combines, socket-creation recipes, crafted items, unique/rare item upgrades (Normal → Exceptional → Elite), the act-quest combines (Horadric Staff, Khalim's Will), the secret-portal recipes (Cow Level, Pandemonium, Uber Tristram), and the Token of Absolution. Each row is one recipe — a set of input items that, when transmuted in the Cube, yields one or more output items (or special effects like a portal).

227 rows, 106 columns. The schema is wide because each row supports up to 7 inputs, 3 outputs (each with a level-control block plus 5 property mods), and a conditional-gate function. Most live recipes use only the first output and one or two mod slots; the schema's full capacity is never reached in shipped data.

What's in a row

The 106 columns split into six functional groups.

Identity and gating

Conditional gate (op / param / value)

A recipe can require an arbitrary check beyond having the right items in the cube — for example, "this recipe only works if the player has reached this difficulty on this quest." That check is encoded by op (which function), param (the function's input, usually a stat ID from ItemStatCost.txt), and value (the comparison threshold).

The engine supports 28 op codes (1–28). They cover: real-world calendar checks (op 1, 2), player-stat comparisons (3–14, base/non-base/current variants of ≥ ≤ ≠ =), input-item-stat comparisons (15–26, same comparison family), an item Mod Class check (27), and the quest-item / quest-difficulty check (28).

Of the 227 rows, only 6 set an op — and all 6 use op = 28. Those six are the act-quest item combines (Horadric Staff, Khalim's Will, Mephisto/Diablo/Baal organ portal, etc.) — recipes that require the quest to be at the right stage. Op codes 1–27 are documented in the engine but unused in shipped data; modders can rely on them.

Inputs

Output (the primary output block)

Output B and Output C (multi-output capacity)

The schema mirrors the entire Output block twice more — a full set of output b / b lvl / b plvl / b ilvl / b mod 1–b mod 5 columns, and again as output c / c lvl / etc. — supporting recipes that yield two or three distinct items in one transmute.

0 of the 227 shipped rows currently populate output b or output c. The capacity is in the engine but no live recipe uses it.

Row terminator

Input/output code reference

Every input and output slot accepts either a base-item code (the 3- or 4-character code from armor.txt / weapons.txt / misc.txt) or one of these predefined codes. Codes can be combined with commas: fhl,mag,upg = a magic, upgradable Full Helm.

Quality and version codes (input or output)

Sockets and ethereal (input or output)

Quantity (input or output)

Output-only codes

Conditional ops at a glance

The first column is the op value the recipe sets; the second describes what the engine checks. Player and input-item stat ops come in three flavors: base (hard points only), non-base (from states/skills/gear), and current (base + non-base combined).

Worked example: Token of Absolution

The Token of Absolution is a one-respec consumable, crafted from the four difficulty-keyed essences dropped by the act bosses on Hell:

The engine validates: enabled=1 (live), version matches (Expansion game), numinputs=4 matches what's in the cube, the four input codes match, no op condition to check — recipe succeeds, the four essences are consumed, one Token of Absolution is created.

For comparison, the Hit Power crafting recipe (1 Magic Full Helm + 1 Jewel + 1 Ith Rune + 1 Perfect Sapphire → Crafted Hit Power Helm) demonstrates the mod block in action: output = usetype,crf (output is a Crafted-quality version of input 1's helm type), mod 1 = gethit-skill with param=44 / min=5 / max=4 (a chance-on-being-struck skill cast — param/min/max meanings come from Properties.txt's function for gethit-skill), mod 2 = thorns with min=3 / max=7 (3–7 Thorns damage rolled at craft time).

Cross-references

• armor.txt, weapons.txt, misc.txt — base-item codes used in the input N and output columns (fhl, r07, gpr, tes, toa, etc.).
• MagicPrefix.txt — pre=# in an output forces a specific prefix; # is the row index.
• MagicSuffix.txt — suf=# in an output forces a specific suffix; # is the row index.
• Properties.txt — mod 1–mod 5 reference property codes here; mod N param, mod N min, and mod N max are interpreted per the property's function.
• ItemStatCost.txt — op codes 3–26 reference stat IDs from this table via the param column.
• PlayerClass.txt — the class column references player-class codes here (currently unused).
• levels.txt — Red Portal outputs reference area IDs from this table for the portal destination.