Admin: 1 revision imported

2023-12-22T16:45:54Z

1 revision imported

← Older revision

Revision as of 12:45, 22 December 2023

minecraft>Mykytius at 20:16, 9 April 2023

2023-04-09T20:16:28Z

New page

{{documentation header}}

{{lua}}
This template automatically populates the "Crafting ingredient" section of pages by retrieving recipes from other pages which use it as an ingredient.

Only pages which are in <code>Category:Recipe using <ingredient></code> ([[:Category:Recipes|category list]]) are searched for recipes. Only recipes using {{tl|crafting}} are used.

If no relevant recipes are found, the page will be added to [[:Category:Empty crafting usage]].

== Usage ==

* <code>{{{1}}}</code>: is used to control which category to look through and which ingredient it is looking for, this defaults to the page name. Multiple ingredients can be specified here, separated by commas.
* <code>{{{match}}}</code>: how exact the ingredient match should be, the default being an exact match. Multiple match types can be specified here, separated by commas. If multiple ingredients are specified, but only one match type, then that will be used for all ingredients.
** <code>start</code> means the start of the ingredient has to exactly match. E.g: "Redstone" will match "Redstone Torch", "Redstone Block", "Redstone Dust", etc.; but not "Block of Redstone", "Some Redstone thing", etc.
** <code>end</code> means the end of the ingredient has to exactly match. E.g: "Redstone" will match "Block of Redstone", "Redstone Dust", etc.; but not "Redstone Block", "Some Redstone thing", etc.
** <code>any</code> means the ingredient can be found anywhere within the name. E.g: "Redstone" will match "Block of Redstone, "Redstone Dust", "Redstone Block", "Some Redstone thing", etc.; but not "Red stone", "Block of Reddishstone", etc.
** '''Note:''' The code for <code>{{{match}}}</code> is run only after the category-based search is done. As a result, if the first argument is simply "Redstone", no results will be returned ''at all'' because no pages are found in {{fake redlink|Category:Recipe using Redstone}} (which doesn't exist at all).
* <code>{{{category}}}</code>: look through a different category from the ingredient name, defaults to <code>Recipe using {{{1}}}</code>. Multiple categories can be separated using a pipe character <code>|</code>.
* <code>{{{ignore}}}</code>: a regex string of pages to ignore, without namespace and with spaces replaced with underscores. Pipe characters have to be replaced with <code>¦</code> (broken bar). See [https://followthescore.org/dpldemo/index.php?title=DPL:Manual_-_General_Usage_and_Invocation_Syntax#Characters_with_special_meaning DPL manual] for the full list.
* <code>{{{description}}}</code>: By default, the description is shown automatically if any of the recipes has one, but if this is set to 0, the description column will be forced to not show and if set to 1, it will be forced to show.
* <code>{{{continue}}}</code>: if set, the table will not be ended, allowing additional recipes to be manually added to it. As with normal {{tl|crafting}} usage, the last recipe must have <code>{{{foot}}}</code> set. This is really just a stopgap for if the template somehow misses some recipes, or if coupled with {{{ignore}}} used to manually write a recipe, for greater customisability.

== {{t|Crafting}} usage ==

These args are used on the {{t|crafting}} templates themselves, but are read by this template.
* <code>{{{ignoreusage}}}</code>: This can be added to crafting recipes which should be ignored by this template. Best for recipes which need to be ignored by multiple {{t|crafting usage}} templates.
* <code>{{{arggroups}}}</code>: Used to manually specify which arguments are grouped (see below). Use the arg names (A1, A2, etc.) if the recipe is shaped, or numbers if the recipe is shapeless. Grouped args are separated by commas, and groups are separated by semi-colons. For example: <code>A1,B1,A2;C1,Output</code> would make A1, B1 and A2 a group and C1 and Output a group.

If not all frames of an animation is used, any value set in the <code>name</code> or <code>ingredients</code> arguments will be removed.

== Arg groups ==

In order to correctly understand how the animations in a recipe should be displayed, the template needs to know which arguments are related. For example: in the [[bed]] recipe, any wood plank and any wool color can be mixed, and they will all produce the same color bed, thus none of them are related. However in the [[firework star]] recipe, the dye and the resulting firework star ''are'' related, but the extra ingredient isn't (any extra ingredient can be used with any color of firework star, but the correct dye has to be used to get the correct firework star).

For animations with different amount of frames, the template knows that they are not grouped, because the animation would get out of sync. However, if they have the same amount of frames (excluding randomised frames from "Any *" aliases), the module assumes they are a group. In cases where this isn't true, {{{arggroups}}} should be used.

{{LoadPage|Template:Crafting usage/doc/example|transcluded=1|Example}}

<includeonly>

[[Category:Inventory templates]]
[[Category:Table templates]]

[[ko:틀:Crafting usage]]
[[nl:Sjabloon:Verwerkingsgebruik]]
[[ru:Шаблон:Использование для крафта]]
[[uk:Шаблон:Використання для майстрування]]
</includeonly>
<noinclude>

[[ko:틀:Crafting usage/doc]]
[[nl:Sjabloon:Verwerkingsgebruik/doc]]
[[uk:Шаблон:Використання для майстрування/док]]
</noinclude>

Template:Crafting usage/doc - Revision history

Admin: 1 revision imported

minecraft>Mykytius at 20:16, 9 April 2023