Difference between revisions of "Template:Item icon/doc"

Revision as of 16:21, 3 April 2021 (view source) Extractum11 (talk | contribs) m ← Older edit		Latest revision as of 13:34, 6 December 2023 (view source) BetaNotus (talk | contribs) m (Slightly improved documentation.)
(2 intermediate revisions by 2 users not shown)
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	==Description==		==Description==
−	This accepts an item name as input and returns the in-game icon. This is not specifically a function of this template, but you can then use CSS to resize the icon to 16x16, 32x32, or 64x64. Remember that you may lose image quality, see the 64x64 Ice Core in the Examples section below.	+	This template accepts an item name as input and returns the in-game icon. This template is used by both [[Template:Item]] and [[Template:Loot]]. See the Examples section below.
	==Syntax==		==Syntax==
	<pre>		<pre>
−	{{Item icon|<name>}}	+	{{Item icon|<name>|<size selection>}}
	</pre>		</pre>
	== Parameters ==		== Parameters ==
	; <name>		; <name>
−	: The name of the item. It must match exactly what is displayed in-game (e.g. "Red Apple", not "Apple" or "red apple")	+	: The name of the icon. It must match exactly what is displayed in-game (e.g. "Red Apple", not "Apple" or "red apple")
	: If omitted or empty, template returns a blank icon image.		: If omitted or empty, template returns a blank icon image.
	: If no match is found, template returns an error.		: If no match is found, template returns an error.
		+
		+	; <size selection>
		+	: 1 or 32 for 32x32.
		+	: 2 or 64 for 64x64.
		+	: If omitted, empty, or anything else, image isn't resized.
	== Examples ==		== Examples ==
	=== Standard Use ===		=== Standard Use ===
−	<pre>{{Item icon|Glowy Yellow Crystal}} {{Item icon|Ice Core}}	+	<pre>
		+	{{Item icon|Glowy Yellow Crystal}}
		+
		+	{{Item icon|Ice Core}}
		+
		+	{{Item icon}}
−	{{Item icon}} {{Item icon|FakeItemReturnsError}}</pre>	+	{{Item icon|FakeItemReturnsError}}
−	{{Item icon|Glowy Yellow Crystal}} {{Item icon|Ice Core}}	+	</pre>
		+	{{Item icon|Glowy Yellow Crystal}}
−	{{Item icon}} {{Item icon|FakeItemReturnsError}}	+	{{Item icon|Ice Core}}
		+	{{Item icon}}
−	=== Forcing 32x32 size ===	+	{{Item icon|FakeItemReturnsError}}
−	<pre><span class="extimage32px">{{Item icon|Glowy Yellow Crystal}}</span></pre>	+
−	<span class="extimage32px">{{Item icon|Glowy Yellow Crystal}}</span>	+
		+	=== Resizing ===
		+	<pre>
		+	{{Item icon|Glowy Yellow Crystal}} <!-- default size is 64x64 -->
		+
		+	{{Item icon|Ice Core}} <!-- default size is 32x32 -->
		+
		+	{{Item icon|Glowy Yellow Crystal|32}}
		+
		+	{{Item icon|Ice Core|64}}
		+	</pre>
		+	{{Item icon|Glowy Yellow Crystal}} <!-- default size is 64x64 -->
		+
		+	{{Item icon|Ice Core}} <!-- default size is 32x32 -->
		+
		+	{{Item icon|Glowy Yellow Crystal|32}}
		+
		+	{{Item icon|Ice Core|64}}
		+
		+
		+	=== Alternative Resizing (old method) ===
		+	You can also manually resize the images if you wish (using the template just wraps the image in this span automatically).
		+
		+	<pre>
		+	<span class="extimage32px">{{Item icon|Salt}}</span>
		+
		+	<span class="extimage64px">{{Item icon|Salt}}</span>
		+	</pre>
		+	<span class="extimage32px">{{Item icon|Salt}}</span>
		+	<span class="extimage64px">{{Item icon|Salt}}</span>
		+	=== Notes ===
		+	Sometimes items appear in-game that share the same displayed name but have different internal names. Often future patches rename one of them to prevent conflicts, but a few persist. This wiki resolves the issue by renaming the less-likely to be searched for item.
−	=== Forcing 64x64 size ===	+	One example is {{Item|Daisy}} and {{Item|Daisy (Lute)}}. Both are called just "Daisy" in-game, but the Lute has an InternalName (found in the items json) of "Daisy" and the flower has an InternalName of "Flower5".
−	<pre><span class="extimage64px">{{Item icon|Ice Core}}</span></pre>	+	==== Icon Codes for Items Sharing a Name ====
−	<span class="extimage64px">{{Item icon|Ice Core}}</span>	+	<pre> | Daisy = 5283
		+	| Daisy (Lute) = 5380</pre>
		+	[[Category:Template_documentation]]

---

Latest revision as of 13:34, 6 December 2023

Description

This template accepts an item name as input and returns the in-game icon. This template is used by both Template:Item and Template:Loot. See the Examples section below.

Syntax

{{Item icon|<name>|<size selection>}}

Parameters

<name>

The name of the icon. It must match exactly what is displayed in-game (e.g. "Red Apple", not "Apple" or "red apple")

If omitted or empty, template returns a blank icon image.

If no match is found, template returns an error.

<size selection>

1 or 32 for 32x32.

2 or 64 for 64x64.

If omitted, empty, or anything else, image isn't resized.

Examples

Standard Use

{{Item icon|Glowy Yellow Crystal}}

{{Item icon|Ice Core}}

{{Item icon}}

{{Item icon|FakeItemReturnsError}}

Error: Item not found

Resizing

{{Item icon|Glowy Yellow Crystal}} <!-- default size is 64x64 -->

{{Item icon|Ice Core}} <!-- default size is 32x32 -->

{{Item icon|Glowy Yellow Crystal|32}}

{{Item icon|Ice Core|64}}

Alternative Resizing (old method)

You can also manually resize the images if you wish (using the template just wraps the image in this span automatically).

<span class="extimage32px">{{Item icon|Salt}}</span>

<span class="extimage64px">{{Item icon|Salt}}</span>

Notes

Sometimes items appear in-game that share the same displayed name but have different internal names. Often future patches rename one of them to prevent conflicts, but a few persist. This wiki resolves the issue by renaming the less-likely to be searched for item.

One example is and . Both are called just "Daisy" in-game, but the Lute has an InternalName (found in the items json) of "Daisy" and the flower has an InternalName of "Flower5".

Icon Codes for Items Sharing a Name

		| Daisy = 5283
		| Daisy (Lute) = 5380