Template:Recipe/doc
This template is used to create a recipe table that is uniform across all items and easily searchable via DPL tables.
The resulting recipe table shows the result, ingredients required (for each quality/perk level of the item if applicable), the unlock options and the craft area needed.
Adding this recipe template to an item also adds the Craftable items category, unless the item has its Infobox item specifying a removed_version parameter.
If updating a recipe using this template please also check if the page has the {{Version|value}}
banner template and if necessary update it to the current version (or add it to the page to help everyone else see that it's current!)
If you need help editing or wish to contribute or have questions about this template join our 7 Days to Die Editors Discord and have access to the Admins and makers of this template!
How to use
The recipe template formats a crafting table with 3 main sections: the crafting table which is modelled like the in-game equivalent, an unlock options section & a craft area section which are only visible if associated parameters are defined. The crafting table row is then further divided into a few columns starting with the crafting result (i.e. the item which results from the recipe), amount produced and time required in the first column, after which the ingredients are shown in the order of image / name / count required to a maximum of 5 as well as the requirements per perk/quality level if it has that characteristic.
The recipe template should only be used on the page that it is tied to, i.e. the recipe for a Chemistry Station should only appear on the Chemistry Station page and should not appear on the pages of the components like the Beaker page. This is because the recipe is tied to the page it is on, so DPL searches would list the Beaker as having an ingredient of Chemistry Station and it will include the Beaker under Category:Craftable_items which it is not.
Template
You can copy and paste the following block wherever you need it to appear on the page (multiple recipes on a page are also possible if it has alternative recipes e.g. glue).
After pasting the template text you may fill in each parameter as needed (see Parameters below):
{{Recipe |nameresult= |imageresult= |yield= |time= |linkname1= |itemcount1= |linkname2= |itemcount2= |linkname3= |itemcount3= |linkname4= |itemcount4= |linkname5= |itemcount5= |craftskill= |craftskilllevel= |LeveledCraft= |craftmultiplier= |skill= |skillmod= |perkbook= |schematic= |workstation= |implement= |inventorycraft= }}
Notes
- All images are added automatically
- All links are created automatically
- For Crafting Skills, Perk Books, & Perks, please use the exact name as given on their respective page or see Parameters below.
- For missing critical information an error message will be displayed (see Examples: Error Messages below), however this does not check the correctness of the information for the recipe.
Parameters
Notes
- Parameter: the name of each definable parameter as they appear in the template
- Input Value: what kind of value is acceptable in the parameter field
- Default Value: what value is returned if the parameter field is left empty
- Description: what the purpose of the parameter is in the recipe/template
- Source: where you can find/check the information in the game files for each parameter field if not taken from in-game
Definable Parameters
Parameter | Input Value | Default Value (If left blank) |
Description (Use this parameter to...) |
Source in game files (...\7 Days to Die\Data\Config\...) |
---|---|---|---|---|
nameresult | <Text> | {{PAGENAME}} | change the name of the recipe | |
imageresult | <Imagename.png> | {{Infobox:Image}} | change the result image of the recipe | ...\7 Days to Die\Data\ItemIcons: Please check for the image on this page before uploading: Special:ListFiles |
yield | <Numeric> | 1x | change the amount of items produced | \recipes.xml: <recipe name="gunMGT1AK47" [count="1"] craft_area="workbench" |
time | <Numeric> | Auto-generated time from DPL table | change the crafting time manually | \recipes.xml: count="1" [craft_time="10"] craft_exp_gain="0" |
linkname1 linkname2 linkname3 linkname4 linkname5 |
<Text> | If itemcount#= TRUE: Shows 'Item # missing! (Parameter=linkname#)' FALSE: Removes item row |
add ingredient # image & name | \recipes.xml: <ingredient [name="resourceForgedIron"] count="10"/> |
itemcount1 itemcount2 itemcount3 itemcount4 itemcount5 |
<Numeric> | <Blank> | add ingredient # amount required | \recipes.xml: <ingredient name="resourceForgedIron" [count="10"/>] |
craftskill |
|
If craftskill= TRUE: Shows 'Crafting Skill missing!' FALSE: Removes table row |
add the Crafting Skill required for unlock | \progression.xml: [<crafting_skill name="craftingMachineGuns"] max_level="100" \items.xml: <property name="UnlockedBy" [value="craftingMachineGuns"/>] |
craftskilllevel | <Numeric> | <Blank> | add the Crafting Skill level(s) required for unlock further quality levels separated by commas (e.g. 1,2,4,5,8,10) |
\progression.xml: <display_entry item="gunMGT1AK47" unlock_level="11,13,16,19,22,25" /> |
LeveledCraft | <Boolean> | FALSE: Shows regular crafting table | display quality 1-6 item requirements | \recipes.xml: <passive_effect name="CraftingIngredientCount" [level="2,6"] operation="perc_add" |
craftmultiplier |
|
No multiplier applied to quality levels 2-5 | apply the +50%/+100% item requirement multiplier per quality above 1. SP allows each ingredient to have its own calculation per quality level | \recipes.xml: operation="perc_add" [value=".5,2.5"] tags="resourceDuctTape"/> |
skill |
|
Reverts to basic crafting recipe table | display item requirements per perk level | \recipes.xml: is_trackable="false" [tags="perkAdvancedEngineering">] |
skillmod |
|
Standard multiplier based on skill parameter above | change crafting multiplier when skill=Advanced Engineering | \recipes.xml: operation="perc_add" [value=".56,.56,.56,.34,.15"] tags="unit_clay,unit_iron"/> |
perkbook |
|
Removes table row | add the perk book required for unlock | \progression.xml: [<book name="perkSniperAPAmmo"] parent="skillSniper" \items.xml: <property name="UnlockedBy" [value="perkSniperAPAmmo"/>] |
schematic | <Text> | Removes table row | add the schematic required for unlock | \item_modifiers.xml <property name="UnlockedBy" [value="modGunLaserSightSchematic"/>] \items.xml [<item name="plantedGraceCorn1Schematic">...<property name="Unlocks" value="plantedGraceCorn1"/>] |
workstation | <Text> | If implement= TRUE: Shows 'Workstation missing!' FALSE: Removes table row (unless inventorycraft=TRUE) |
add the workstation required for crafting | \recipes.xml: count="1" [craft_area="workbench"] tags="workbenchCrafting"> |
implement | <Text> | <Blank> | add the implement required for crafting | \recipes.xml: is_trackable="false" [craft_tool="toolForgeCrucible"] tags="perkAdvancedEngineering"> |
inventorycraft | <Boolean> | Removes table row (Unless workstation=TRUE OR implement=TRUE) |
add the option for crafting in inventory | \recipes.xml: NO MENTION OF [craft_area="value"] |
Legacy
Deprecated parameters that still function for compatibility.
Parameter | Input Value | Default Value (If left blank) |
Description (Use this parameter to...) |
Source in game files (...\7 Days to Die\Data\Config\...) |
---|---|---|---|---|
magazinetype |
|
If magazinecount= TRUE: Shows 'Magazine type missing!' FALSE: Removes table row |
add the magazine type required for unlock | \progression.xml: [<crafting_skill name="craftingMachineGuns"] max_level="100" \items.xml: <property name="UnlockedBy" [value="craftingMachineGuns"/>] |
magazinecount | <Numeric> | <Blank> | add the magazine amount required for unlock | \progression.xml: <display_entry item="gunMGT1AK47" unlock_level="11,13,16,19,22,25" /> |
magazinequal2 magazinequal3 magazinequal4 magazinequal5 magazinequal6 |
<Numeric> | <Blank> | add the magazine amount required for unlock per quality above 1 | \progression.xml: <display_entry item="gunMGT1AK47" unlock_level="11,13,16,19,22,25" /> |
Examples
Normal Crafting Table
The normal crafting table shows the recipe for a given item as well as the yield, crafting time required, unlock options and the craft area.
- This is an example of the 'First Aid Kit' Recipe:
{{Recipe |nameresult= |imageresult= |yield= |time= |linkname1=Blood Bag |itemcount1=1 |linkname2=Beer |itemcount2=1 |linkname3=Bandage |itemcount3=5 |linkname4=Sewing Kit |itemcount4=1 |linkname5= |itemcount5= |craftskill=Medical |craftskilllevel=50 |LeveledCraft= |craftmultiplier= |skill= |skillmod= |perkbook= |schematic= |workstation=Chemistry Station |implement= |inventorycraft= }}
- Which produces the following table:
Item | Name | Count | |
---|---|---|---|
Blood Bag | 1 | ||
Beer | 1 | ||
Bandage | 5 | ||
Sewing Kit | 1 | ||
Unlock Options | |||
Medical 50/75 | |||
Crafted in | |||
Chemistry Station |
Skill Cost Reduction Table
The Skill Cost Reduction Table is a variant of the Normal Crafting Table that shows the reduced crafting cost of a recipe per associated perk level. There are currently only 4 perks in the game that reduce the cost of recipes as can be seen in the Parameters table above.
Currently only the Advanced Engineering perk uses the |skillmod=
parameter (due to separate reduction percentages), however all perks have exceptions which are hard coded and can be found here: Template:SkillCraft
An explanation about perk levels is provided automatically below the skillcraft recipe table in plain text with links to the resource and respective perk pages.
- This is an example of the '4x4 Truck Accessories' Recipe:
{{Recipe |nameresult= |imageresult= |yield= |time=210 |linkname1=Electrical Parts |itemcount1=33 |linkname2=Headlight |itemcount2=8 |linkname3=Short Iron Pipe |itemcount3=50 |linkname4=Spring |itemcount4=4 |linkname5=Mechanical Parts |itemcount5=16 |craftskill=Vehicles |craftskilllevel=70 |LeveledCraft= |craftmultiplier= |skill=Grease Monkey |skillmod= |perkbook= |schematic= |workstation=Workbench |implement= |inventorycraft= }}
- Which produces the following table:
Item | Name | Count | ||
---|---|---|---|---|
Grease Monkey Level | ||||
0-3 | 4-5 | |||
Electrical Parts | 49 | 33 | ||
Headlight | 8 | |||
Short Iron Pipe | 75 | 50 | ||
Spring | 6 | 4 | ||
Mechanical Parts | 24 | 16 | ||
Unlock Options | ||||
Vehicles 70/100 | ||||
Crafted in | ||||
Workbench |
A higher level in the associated perk will decrease the crafting cost, saving resources.
- This is an example of the 'Forged Steel' Recipe using
|skillmod=steel
:
{{Recipe |nameresult= |imageresult= |yield= |time=210 |linkname1=Iron |itemcount1=20 |linkname2=Clay Soil |itemcount2=10 |linkname3= |itemcount3= |linkname4= |itemcount4= |linkname5= |itemcount5= |craftskill= |craftskilllevel= |LeveledCraft= |craftmultiplier= |skill=Advanced Engineering |skillmod=steel |perkbook= |schematic= |workstation=Forge |implement=Crucible |inventorycraft= }}
- Which produces the following table:
Item | Name | Count | ||||
---|---|---|---|---|---|---|
Advanced Engineering Level | ||||||
0-2 | 3 | 4 | 5 | |||
Iron | 31 | 26 | 23 | 20 | ||
Clay Soil | 15 | 13 | 11 | 10 | ||
Crafted in | ||||||
Forge containing a Crucible |
A higher level in the associated perk will decrease the crafting cost, saving resources.
Levelcraft Table
The LevelCraft table shows all 6 crafting quality levels of an item after typing any value in the LeveledCraft parameter field, e.g. |LeveledCraft=1
.
A multiplier of +50%/+100% per quality level will be applied to the ingredients by setting the |craftmultiplier
parameter field to a value as described in the Parameters table above. Some items are unaffected which are hard coded and can be found here: Template:LeveledCraft
The required levels of the Crafting Skill to craft the appropriate quality level are specified with the |craftskilllevels
parameter, in order and separated by commas.
An explanation about quality levels is provided automatically below the levelcraft recipe table in plain text with links to the quality, resource and Crafting Skills pages.
- This is an example of the 'Auger' Recipe:
{{Recipe |nameresult= |imageresult= |yield= |time=153 |linkname1=Motor Tool Parts |itemcount1=1 |linkname2=Bicycle Handlebars |itemcount2=1 |linkname3=Engine |itemcount3=1 |linkname4=Forged Steel |itemcount4=10 |linkname5=Legendary Parts |itemcount5=0 |craftskill=Harvesting Tools |craftskilllevel=61,68,76,86,92,100 |LeveledCraft=1 |craftmultiplier=1 |skill= |skillmod= |perkbook= |schematic= |workstation=Workbench |implement= |inventorycraft= }}
- Which produces the following table:
Item | Name | Count | ||||||
---|---|---|---|---|---|---|---|---|
Quality 1 | Quality 2 | Quality 3 | Quality 4 | Quality 5 | Quality 6 | |||
Motor Tool Parts | 1 | 2 | 3 | 4 | 5 | 6 | ||
Bicycle Handlebars | 1 | |||||||
Engine | 1 | |||||||
Forged Steel | 10 | 20 | 30 | 40 | 50 | 60 | ||
Legendary Parts | Only applicable to Quality 6 >>> | 1 | ||||||
Unlock Options | ||||||||
Harvesting Tools */100 | 61 | 68 | 76 | 86 | 92 | 100 | ||
Crafted in | ||||||||
Workbench |
A higher Quality item may provide better stats at the cost of increased material and unlock requirements.
Error Messages
All variants of the recipe table have built-in error messages which will display if crucial information is missing and link to this page to help resolve it. Keep in mind that these only inform you of missing info, not whether the provided info is correct for the recipe in question.
The following error messages are provided:
- Image missing! (Parameter=imageresult): shows if the resulting item's image could not be retrieved AND the
|imageresult
parameter field has been left blank - Item # missing! (Parameter=linkname#): shows for any ingredient for which an item count has been provided but no name (i.e.
|linkname#
has been left blank with|itemcount#
filled) - Skill type invalid! (Parameter=skill): shows if the skill does not comply with the values set out in the Parameters table under
|skill
(applies to skill cost reduction crafting table only) - Crafting Skill invalid!: shows if the crafting skill does not comply with the values set out in the Parameters table under
|craftskill
- Magazine type invalid!: shows if the magazine type legacy parameter does not comply with the values set out in the Parameters table under
|magazinetype
- Crafting Skill missing!: shows if the
|craftskill
parameter field has been left blank with the|craftskilllevel
parameter field filled - ?/MAX: shows if the crafting skill is specified but
|craftskilllevel
has been left blank (applies to normal & skill cost reduction crafting table only) - Workstation missing!: shows if the
|workstation
parameter field has been left blank with the|implement
parameter field filled
Note: with the Crafting Skill invalid! or Crafting Skill missing! error message displayed the maximum skill level cannot be recalled and will default to /MAX
- This is an example of the fictional 'Artip' Recipe where some fields are missing or have a wrong value:
{{Recipe |nameresult=Artip |imageresult= |linkname1=Machine Gun Parts |itemcount1=100 |linkname2= |itemcount2=10 |linkname3=Duct Tape |itemcount3=50 |linkname4= |itemcount4=10 |linkname5=Legendary Parts |itemcount5=1 |yield=501 |time=148.5 |craftskill=Shooty Bang Bangs |magazinecount= |LeveledCraft= |craftmultiplier=501 |skill= |skillmod= |perkbook= |schematic= |workstation= |implement=Crucible |inventorycraft= }}
- Which produces the following table:
Item | Name | Count | |
---|---|---|---|
Image missing! |
Machine Gun Parts | 100 | |
Item 2 missing! (Parameter=linkname2) |
10 | ||
Duct Tape | 50 | ||
Item 4 missing! (Parameter=linkname4) |
10 | ||
Legendary Parts | 1 | ||
Unlock Options | |||
Crafting Skill invalid! ?/100 | |||
Crafted in | |||
Workstation missing! containing a Crucible |
- And the Skill Cost Reduction variant for the skill type error (with
|skill=Sexual Tyrannosaurus
):
Item | Name | Count | |
---|---|---|---|
Perk type invalid! Level | |||
(Parameter=skill) | |||
Image missing! |
Machine Gun Parts | 100 | |
Item 2 missing! (Parameter=linkname2) |
10 | ||
Duct Tape | 50 | ||
Item 4 missing! (Parameter=linkname4) |
10 | ||
Legendary Parts | 1 | ||
Unlock Options | |||
Crafting Skill missing! 11/MAX | |||
Crafted in | |||
Workstation missing! containing a Crucible |
A higher level in the associated perk will decrease the crafting cost, saving resources.
- And the LevelCraft variant with different errors for the magazine type (with
|magazinetype= |magazinecount=11
):
Item | Name | Count | ||||||
---|---|---|---|---|---|---|---|---|
Quality 1 | Quality 2 | Quality 3 | Quality 4 | Quality 5 | Quality 6 | |||
Image missing! |
Machine Gun Parts | 100 | 100 | 100 | 100 | 100 | 100 | |
Item 2 missing! (Parameter=linkname2) |
10 | 10 | 10 | 10 | 10 | 10 | ||
Duct Tape | 50 | 50 | 50 | 50 | 50 | 50 | ||
Item 4 missing! (Parameter=linkname4) |
10 | 10 | 10 | 10 | 10 | 10 | ||
Legendary Parts | Only applicable to Quality 6 >>> | 1 | ||||||
Unlock Options | ||||||||
Crafting Skill missing! */MAX | 11 | |||||||
Crafted in | ||||||||
Workstation missing! containing a Crucible |
A higher Quality item may provide better stats at the cost of increased material and unlock requirements.
All Parameter Options
The following tables are mere demonstrators to show off all possible parameter fields where each parameter has been filled with data for a fictional 'Artip' recipe:
{{Recipe |nameresult=Artip |imageresult=TacticalAssaultRifle.png |linkname1=Machine Gun Parts |itemcount1=100 |linkname2=Forged Iron |itemcount2=10 |linkname3=Duct Tape |itemcount3=50 |linkname4=Scrap Polymers |itemcount4=10 |linkname5=Legendary Parts |itemcount5=1 |yield=501 |time=148.5 |craftskill=Rifles |craftskilllevel=11 |LeveledCraft= |craftmultiplier=1 |skill= |skillmod=Steel |perkbook=The Automatic Weapon Handbook Vol. 10 |schematic=Artip |workstation=Cement Mixer |implement=Crucible |inventorycraft=1 }}
- Which produces the following table:
Item | Name | Count | |
---|---|---|---|
Machine Gun Parts | 100 | ||
Forged Iron | 10 | ||
Duct Tape | 50 | ||
Scrap Polymers | 10 | ||
Legendary Parts | 1 | ||
Unlock Options | |||
Rifles 11/100 | |||
The Automatic Weapon Handbook Vol. 10 | |||
Artip Schematic | |||
Crafted in | |||
Cement Mixer containing a Crucible Or Hand/Inventory |
- And the Skill Cost Reduction variant of the same recipe (with
|skill=Advanced Engineering
):
Item | Name | Count | ||||
---|---|---|---|---|---|---|
Advanced Engineering Level | ||||||
0-2 | 3 | 4 | 5 | |||
Machine Gun Parts | 156 | 134 | 114 | 100 | ||
Forged Iron | 15 | 13 | 11 | 10 | ||
Duct Tape | 78 | 67 | 57 | 50 | ||
Scrap Polymers | 15 | 13 | 11 | 10 | ||
Legendary Parts | 1 | |||||
Unlock Options | ||||||
Rifles 11/100 | ||||||
The Automatic Weapon Handbook Vol. 10 | ||||||
Artip Schematic | ||||||
Crafted in | ||||||
Cement Mixer containing a Crucible Or Hand/Inventory |
A higher level in the associated perk will decrease the crafting cost, saving resources.
- And the LevelCraft variant of the same recipe (with
|LeveledCraft=1
and|craftskilllevel=11,22,33,44,55,66
):
Item | Name | Count | ||||||
---|---|---|---|---|---|---|---|---|
Quality 1 | Quality 2 | Quality 3 | Quality 4 | Quality 5 | Quality 6 | |||
Machine Gun Parts | 100 | 200 | 300 | 400 | 500 | 600 | ||
Forged Iron | 10 | 20 | 30 | 40 | 50 | 60 | ||
Duct Tape | 50 | 100 | 150 | 200 | 250 | 300 | ||
Scrap Polymers | 10 | 20 | 30 | 40 | 50 | 60 | ||
Legendary Parts | Only applicable to Quality 6 >>> | 1 | ||||||
Unlock Options | ||||||||
Rifles */100 | 11 | 22 | 33 | 44 | 55 | 66 | ||
And having read The Automatic Weapon Handbook Vol. 10 | ||||||||
Crafted in | ||||||||
Cement Mixer containing a Crucible Or Hand/Inventory |
A higher Quality item may provide better stats at the cost of increased material and unlock requirements.
This is the documentation page, it should be transcluded into the main template page. See Template:Doc for more information.