|
|
| (51 intermediate revisions by 8 users not shown) |
| Line 1: |
Line 1: |
| == Basics == | | <div class="stub"><p>'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/prototypes/RecipePrototype.html https://lua-api.factorio.com/latest/prototypes/RecipePrototype.html] |
| A recipe. It can be a crafting recipe, a smelting recipe, or a custom type of recipe (see [[Prototype/RecipeCategory]]).
| |
|
| |
|
| == General properties ==
| | </p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div> |
| Inherits all properties from [[Prototype]].
| |
| | |
| === category ===
| |
| '''Type''': [[Types/string]]
| |
| | |
| '''Default''': "crafting"
| |
| | |
| Optional. The category of this recipe. The built-in categories can be found [[Data.raw#recipe-category|here]]. See also [[Prototype/RecipeCategory]].
| |
| | |
| === subgroup ===
| |
| '''Type''': [[Types/string]]
| |
| | |
| Optional. The subgroup of this recipe. If not specified, defaults to the subgroup of the product if there is only 1, or main_product if multiple products exist. If multiple products exit and no main_product is specified, the subgroup is required.
| |
| | |
| === icons, icon, icon_size (IconSpecification) ===
| |
| '''Type''': [[Types/IconSpecification]]
| |
| | |
| An icon is mandatory for recipe with more than 1 product and no main_product. Otherwise defaults to the icon of main_product/1 product.
| |
| | |
| If given, it overwrites the icon of the main_product/1 product.
| |
| | |
| === crafting_machine_tint ===
| |
| '''Type''': [[Types/table]] of [[Types/Color]]
| |
| | |
| '''Default''': nil
| |
| | |
| Format:
| |
| <syntaxhighlight lang="lua">crafting_machine_tint = { primary = {r=0,g=0,b=0,a=0}, secondary = {r=0,g=0,b=0,a=0}, tertiary = {r=0,g=0,b=0,a=0}}</syntaxhighlight>
| |
| | |
| Each key/value pair is optional and defaults to the above value.
| |
| | |
| == Recipe data ==
| |
| If the recipe does not have a difficulty, this is located directly in the prototype. Otherwise, if the "'''normal'''" or "'''expensive'''" property exists, the recipe has difficulty. Then, the recipe data has to be specified for each difficulty instead of directly in the prototype. If at least one difficulty has recipe data defined, the other difficulty can be set to <code>false</code> or it can be simply not defined/set to <code>nil</code>. This will give it the exact same properties as the difficulty that is defined. See below for examples.
| |
| | |
| === ingredients ===
| |
| '''Type''': [[Types/table]] of [[Types/IngredientPrototype]] | |
| | |
| A table containing ingredient names and counts. For example:
| |
| <pre>
| |
| ingredients = {{"iron-stick", 2}, {"iron-plate", 3}}
| |
| </pre>
| |
| or the same with full format: | |
| <pre>
| |
| ingredients = {{type = "item", name = "iron-stick", amount = 2}, {type = "item", name = "iron-plate", amount = 3}}
| |
| </pre>
| |
| Maximal ingredient amount is 65535.
| |
| | |
| === result ===
| |
| '''Type''': [[Types/string]]
| |
| | |
| Can be replaced with the results parameter. The item created by this recipe. Must be the name of an item, such as "iron-gear-wheel".
| |
| | |
| === result_count ===
| |
| '''Type''': [[Types/uint32]]
| |
| | |
| Optional. The number of items created by this recipe. The default is 1.
| |
| | |
| === results ===
| |
| '''Type''': [[Types/table]]
| |
| | |
| A table containing result names and counts. For example:
| |
| <pre>
| |
| results=
| |
| {
| |
| {type="fluid", name="heavy-oil", amount=3},
| |
| {type="fluid", name="light-oil", amount=3},
| |
| {type="fluid", name="petroleum-gas", amount=4}
| |
| },
| |
| </pre>
| |
| <pre>
| |
| results =
| |
| {
| |
| {type = "item", name = "iron-nuggets", amount = 9},
| |
| {type = "item", name = "gold-nuggets", amount = 1}
| |
| },
| |
| </pre>
| |
| | |
| === energy_required ===
| |
| '''Type''': [[Types/double]]
| |
| | |
| '''Default''': 0.5
| |
| | |
| Optional. The amount of time it takes to make this recipe.
| |
| | |
| This is the number of seconds it takes to craft at crafting speed 1.
| |
| | |
| === emissions_multiplier ===
| |
| '''Type''': [[Types/double]]
| |
| | |
| '''Default''': 1.0
| |
| | |
| === requester_paste_multiplier ===
| |
| '''Type''': [[Types/uint32]]
| |
| | |
| '''Default''': 30
| |
| | |
| === overload_multiplier ===
| |
| '''Type''': [[Types/uint32]]
| |
| | |
| '''Default''': 0
| |
| | |
| === enabled ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': true
| |
| | |
| Optional. This can be false to disable the recipe at the start of the game, or "true" to leave it enabled.
| |
| | |
| If your recipe is unlocked by a technology, you should set this to "false".
| |
| | |
| === hidden ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': false
| |
| | |
| Optional. Hides the recipe from crafting menus.
| |
| | |
| === hide_from_stats ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': false
| |
| | |
| Optional. Hides the recipe from flow stats (production statistics).
| |
| | |
| === allow_decomposition ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': true
| |
| | |
| Optional. Whether the recipe can be broken down for "total-raw" calculations.
| |
| | |
| === allow_as_intermediate ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': true
| |
| | |
| Optional. Whether the recipe can be used as an intermediate recipe in hand-crafting.
| |
| | |
| === allow_intermediates ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': true
| |
| | |
| Optional. Whether the recipe is allowed to use intermediate recipes when hand-crafting.
| |
| | |
| === always_show_made_in ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': false
| |
| | |
| Optional. Whether the "Made in: {Machine}" part of the tool-tip should always be present, not only when the recipe can not be hand-crafted.
| |
| | |
| === show_amount_in_title ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': true
| |
| | |
| Optional. Whether the recipe name should have the product amount in front of it, e.g. "2 [[transport belt]]"
| |
| | |
| === always_show_products ===
| |
| '''Type''': [[Types/bool]]
| |
| | |
| '''Default''': false
| |
| | |
| Optional. Whether the products are always shown in the recipe tool-tip.
| |
| | |
| === main_product ===
| |
| '''Type''': [[Types/string]]
| |
| | |
| Optional.
| |
| | |
| For recipes with more than one product: This defines of which result the icon, subgroup and name is used. If it is not set and the recipe has more than 1 result the recipe will use the recipe-name and recipe-description locale and its own subgroup and icon.
| |
| | |
| For recipes with 1 result: The recipe uses the icon, subgroup and name of the result by default. If set this property is set to an empty string, the recipe will use the properties of the recipe instead of the result.
| |
| | |
| == Examples ==
| |
| | |
| === "iron-plate" ===
| |
| <syntaxhighlight lang="lua">
| |
| {
| |
| type = "recipe",
| |
| name = "iron-plate",
| |
| category = "smelting",
| |
| energy_required = 3.5,
| |
| ingredients = {{"iron-ore", 1}},
| |
| result = "iron-plate"
| |
| }</syntaxhighlight>
| |
| | |
| === "coal-liquefaction" ===
| |
| | |
| <syntaxhighlight lang="lua">{
| |
| type = "recipe",
| |
| name = "coal-liquefaction",
| |
| category = "oil-processing",
| |
| subgroup = "fluid-recipes",
| |
| order = "a[oil-processing]-c[coal-liquefaction]",
| |
| enabled = false,
| |
| energy_required = 5,
| |
| icon = "__base__/graphics/icons/fluid/coal-liquefaction.png",
| |
| icon_size = 32,
| |
| ingredients =
| |
| {
| |
| {type="item", name="coal", amount=10},
| |
| {type="fluid", name="heavy-oil", amount=25},
| |
| {type="fluid", name="steam", amount=50}
| |
| },
| |
| results=
| |
| {
| |
| {type="fluid", name="heavy-oil", amount=35},
| |
| {type="fluid", name="light-oil", amount=15},
| |
| {type="fluid", name="petroleum-gas", amount=20}
| |
| },
| |
| allow_decomposition = false
| |
| }</syntaxhighlight>
| |
| | |
| === "iron-gear-wheel" — recipe with difficulty ===
| |
| <syntaxhighlight lang="lua"> {
| |
| type = "recipe",
| |
| name = "iron-gear-wheel",
| |
| normal =
| |
| {
| |
| ingredients = {{"iron-plate", 2}},
| |
| result = "iron-gear-wheel"
| |
| },
| |
| expensive =
| |
| {
| |
| ingredients = {{"iron-plate", 4}},
| |
| result = "iron-gear-wheel"
| |
| }
| |
| },</syntaxhighlight>
| |
| | |
| ==== Modified so that the expensive recipe is always used, even in normal mode ====
| |
| <syntaxhighlight lang="lua"> {
| |
| type = "recipe",
| |
| name = "iron-gear-wheel",
| |
| normal = false, --simply omitting this line gives the same result
| |
| expensive =
| |
| {
| |
| ingredients = {{"iron-plate", 4}},
| |
| result = "iron-gear-wheel"
| |
| }
| |
| },</syntaxhighlight>
| |