User:KnightMiner/Tag Standards
This page details standardized tag names for compatibility among modders. The following subsections give specific information on where the tags are used.
General
In general, tag names should follow a couple of conventions for consistency:
- Tag names should be plural.
- Tag names should be in US English, rather than English variants such as British English. This is for consistency with the default language.
- Tags should be stored under
forgeif they are used commonly between mods. Tags specific to a single mod should be stored under the mod ID.
Output Consistency
This section describes how to set up recipes for tagged output to allow to choose their preferred output for tagged outputs.
- If recipe involves crafting a tagged input into a tagged output, do not use tags on the input. This means that the recipe result is consistent for a given input.
- If a recipe involves crafting multiple tagged inputs into a tagged output, all inputs expect 1 should be tagged. This allows the user to select the preferred output by varying non-tagged input.
- For linear recipes, the first slot should contain the untagged input.
- For two-dimensional recipes (such as crafting tables), the centermost slot should contain the untagged input. If there is an even number of inputs, prefer the the upper-left slot of the center.
Examples:
- A recipe crafting 9 Tinkers' Construct copper nuggets should use a single Tinkers' Construct copper ingot as the input. If all mods their recipe for copper nuggets like this, the mod will be consistent between the recipe input an output.
- A recipe crafting a Tinkers' Construct copper ingot from 9 copper nuggets should use a Tinkers' Construct copper nugget in the center of the 3x3. If all mods their recipe for copper ingots like this, the mod will be consistent between the center item and the output, while nuggets on the outside can be from any mod.
Materials
Material tags all follow the general format of forge:<prefix>/<material>.
Common metals
This section contains names for many common metals that show up in multiple mods and names for materials named after real world materials.
| ID | Name(s) | Obtaining |
|---|---|---|
| Gold | gold
|
Ore (vanilla) |
| Iron | iron
|
Ore (vanilla) |
| Netherite Scrap Ancient Debris |
netherite_scrap
|
Ore (vanilla) |
| Netherite | netherite
|
Alloying 1 from 4 gold and 4 netherite scrap (vanilla) |
| Copper | copper
|
Ore Vanilla ore in 1.17 |
| Aluminum | aluminum
|
Ore |
| Lead | lead
|
Ore |
| Nickel | nickel
|
Ore |
| Osmium | osmium
|
Ore |
| Platinum | platinum
|
Ore |
| Silver | silver
|
Ore |
| Tin | tin
|
Ore |
| Tungsten | tungsten
|
Ore |
| Uranium | uranium
|
Ore |
| Zinc | zinc
|
Ore |
| Steel | steel
|
Purifying iron, exact process varies |
| Brass | brass
|
Alloying 4 from 3 copper and 1 zinc |
| Bronze | brass
|
Alloying 4 from 3 copper and 1 tin |
| Constantan | constantan
|
Alloying 2 from 1 copper and 1 nickel |
| Electrum | electrum
|
Alloying 2 from 1 gold and 1 silver |
| Hepatizon | hepatizon
|
Alloying 2 from 2 copper, 1 cobalt, and 1 obsidian |
| Invar | invar
|
Alloying 3 from 2 iron and 1 nickel |
| Rose Gold | rose_gold
|
Alloying 4 from 3 copper and 1 gold |
| Silicon Bronze Tinker's Bronze |
silicon_bronze
|
Alloying 4 from 3 copper and 1 silicon (sand) |
Common non-metals
This section contains names for many common materials that are not metals. This means they will contain
| Name(s) | ID | Type | Obtaining | Notes |
|---|---|---|---|---|
| Coal | coal
|
None | Ore (vanilla) | |
| Redstone | redstone
|
Dust | Ore (vanilla) | |
| Lapis Lazuli | lapis
|
Gem | Ore (vanilla) | Logically more similar to a dust, but classification used in Forge. |
| Diamond | diamond
|
Gem | Ore (vanilla) | |
| Emerald | emerald
|
Gem | Ore (vanilla) | |
| Quartz | quartz
|
Gem | Ore (vanilla) | Storage block is only 4 to 1 instead of 9 to 1. There are discussions to use a different storage block prefix. |
| Wood Wooden |
wooden
|
Log Planks |
Ore (vanilla) | Does not use most standard prefixes |
Prefixes
This section describes common tag prefixes and their values relative to an ingot. Columns marked as ore means mod mechanics such as ore doubling can safely be used on the tag without the risk of crafting duplication.
| Name | Prefix | Ratio | Is Ore | Notes | |
|---|---|---|---|---|---|
| Value | Ingots | ||||
| Ingot | ingots
|
1 | 1 | No | |
| Nugget | nuggets
|
9 | 1 | No | |
| Block | storage_blocks
|
1 | 9 | No | |
| Ore | ores
|
1 | 1 | Yes | |
| Gems | gems
|
1 | 1 | No | Unlike ingots, multiple may drop from mining ores using fortune. Non-standard, diamond and lapis lazuli respond from ores differently. Most ores either have gems or ingots/nuggets. |
| Nugget Ore | nugget_ores
|
9 | 1 | Yes | Uncommon, most mods use poor ores instead |
| Poor Ore | poor_ores
|
3 | 1 | Yes | Note that a 3 to 1 ratio means each ore is 3 nuggets |
| Dense Ore | dense_ores
|
1 | 3 | Yes | |
| Dust | dusts
|
1 | 1 | No | Output from crushing ores typically, commonly used as part of an ore multiplying method. For some ores, the ore dropped dust directly. Multiple typically drop. |
| Tiny Pile of Dust | tiny_dusts
|
9 | 1 | No | Output from crushing nuggets or nugget ores, uncommon |
| Plate | plates
|
1 | 1 | No | |
| Dense Plate | dense_plates
|
1 | 3 | No | |
| Rod | rods
|
2 | 1 | No | |
| Gear | gears
|
1 | 4 | No | |
| Wire | wires
|
2 | 1 | No | Uncommon, used in mods such as Immersive Engineering |
| Fence | fences
|
3 | 5 | No | Uncommon |
Common Tags
The table below contains a list of common tags used in multiple mods that are not included in Forge or vanilla. Some of these tags have subtags, all items in the subtags are added to the base tag.
| ID | Vanilla items | Notes |
|---|---|---|
forge:workbenches
|
Crafting Table | Currently includes both wooden and non-wooden crafting tables. If needed additional subtags could be proposed. |