Jump to content
Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Template:Icon: Difference between revisions

Template page
m Docs: describe current pill/link behaviour only, drop the 'old default look' historical reference
m Trim documentation prose for concision, keep all supported-icon tables intact
Line 149: Line 149:
<pre>{{icon|name}}</pre>
<pre>{{icon|name}}</pre>


renders a small icon, sized and aligned to sit inline like an emoji wherever it's typed -- in running prose, a heading, a table cell, anywhere -- e.g. <code><nowiki>{{icon|zyre}}</nowiki></code>:
renders a small icon that scales with its surrounding text, e.g. <code><nowiki>{{icon|zyre}}</nowiki></code>:


: Zyre has the most PvP activity of the isolated worlds, alongside {{icon|zyre}} the End.
: Zyre has the most PvP activity of the isolated worlds, alongside {{icon|zyre}} the End.


'''Name matching is case- and space-insensitive''' -- <code>zyre</code>, <code>Zyre</code> and <code>ZYRE</code> all match the same icon, and a name normally written with a space (e.g. "Shard Pouch") can be typed either way: <code><nowiki>{{icon|shard pouch}}</nowiki></code> and <code><nowiki>{{icon|shardpouch}}</nowiki></code> render identically. Every name below also has its own shorter aliases (see the Aliases column) -- an unrecognised name renders a visible error (the {{icon|unknown}} question-mark icon, followed by the error text) instead of silently showing nothing, so a typo is easy to spot rather than quietly vanishing. This is the wiki's general convention for a failed template inclusion or a failed icon/image lookup anywhere, not just here.
Name matching is case- and space-insensitive (<code>zyre</code>/<code>Zyre</code>/<code>ZYRE</code>, <code>shard pouch</code>/<code>shardpouch</code> all work). Every name also has shorter aliases (Aliases column below). An unrecognised name renders a visible error instead of nothing.


'''Scales with its surrounding text''' -- sized in proportion to whatever font-size it's typed in, so the same call reads at normal size in running prose and larger inside a heading, rather than staying a fixed pixel size regardless of context.
Some icons have their own article and name (e.g. Zyre links to [[Zyre]]); others are bare only, meant to sit before a word you type yourself. The tables below mark which. '''Icons render bare by default''' either way -- see [[#Pill and link|Pill and link]] to show a name's bundled text.
 
Some icons also come with their own article and a bundled name (e.g. Zyre links to [[Zyre]]); others are bare only -- just the icon, meant to sit before a word you type yourself, the same way <code><nowiki>{{icon|zyre}}</nowiki></code> sits before "the End" in the example above. The tables below mark which is which. Either way, '''the icon renders bare by default''' -- see [[#Pill and link|Pill and link]] below for the ones that can optionally show their own name too.


=== Variants ===
=== Variants ===


A name with more than one icon (e.g. two senses of the same abbreviation, or a set of rarity tiers) takes an optional second parameter to pick which one:
A name with more than one icon takes an optional second parameter:


<pre>{{icon|name|variant}}</pre>
<pre>{{icon|name|variant}}</pre>


e.g. <code><nowiki>{{icon|lcr|ballot}}</nowiki></code>. Where a default variant is defined, leaving the second parameter out falls back to it, so the bare <code><nowiki>{{icon|lcr}}</nowiki></code> still renders something rather than erroring. Some names (e.g. Rank, Capital) have no sensible default and require an explicit variant, or render an error. Each variant can have its own alias too, shown in the same Variant column as the variant name itself where it's a parallel short form (e.g. Lock's rarities double as <code>1</code>-<code>6</code>), or in Aliases where it's an abbreviation of one specific variant (e.g. Rank's <code>dia2</code> for <code>diamond2</code>).
e.g. <code><nowiki>{{icon|lcr|ballot}}</nowiki></code>. Where a default variant exists, leaving it out falls back to that (<code><nowiki>{{icon|lcr}}</nowiki></code> still works); others (Rank, Capital) require an explicit variant. A variant's own alias appears in the Variant column when it's a parallel short form (e.g. Lock's <code>1</code>-<code>6</code>), or in Aliases when it's an abbreviation (e.g. Rank's <code>dia2</code>).


=== Pill and link ===
=== Pill and link ===


For an icon that has its own name and article (see the tables below), two independent optional parameters bring back its bundled name text:
For icons with their own name, two independent parameters bring it back:


<pre>{{icon|name|pill=yes}}</pre>
<pre>{{icon|name|pill=yes}}</pre>


shows the icon and its name together inside a rounded pill background, but not as a link:
icon + name in a pill, not a link: {{icon|donatorstar|1|pill=yes}}
 
: {{icon|donatorstar|1|pill=yes}}


<pre>{{icon|name|link=yes}}</pre>
<pre>{{icon|name|link=yes}}</pre>


shows the icon and its name as a plain clickable link to the subject's own article, with no pill background:
icon + name as a plain link, no pill: {{icon|donatorstar|1|link=yes}}
 
: {{icon|donatorstar|1|link=yes}}
 
Setting both together shows the icon and name bundled inside a pill, the whole thing clickable:


<pre>{{icon|name|pill=yes|link=yes}}</pre>
<pre>{{icon|name|pill=yes|link=yes}}</pre>


: {{icon|donatorstar|1|pill=yes|link=yes}}
both together: {{icon|donatorstar|1|pill=yes|link=yes}}


Leaving both out (the default) drops straight to the bare icon, same as <code><nowiki>{{icon|donatorstar|1}}</nowiki></code>: {{icon|donatorstar|1}}. Neither parameter has any effect on a name with no article/label of its own (e.g. Rank, Lock) -- there's no name to bundle or link, so it always renders bare.
Leaving both out (the default) renders bare: {{icon|donatorstar|1}}. Neither has any effect on names with no article of their own (Rank, Lock, etc.) -- always bare.


== Supported icons ==
== Supported icons ==

Revision as of 12:20, 23 August 2026

Usage

{{icon|name}}

renders a small icon that scales with its surrounding text, e.g. {{icon|zyre}}:

Zyre has the most PvP activity of the isolated worlds, alongside Zyre the End.

Name matching is case- and space-insensitive (zyre/Zyre/ZYRE, shard pouch/shardpouch all work). Every name also has shorter aliases (Aliases column below). An unrecognised name renders a visible error instead of nothing.

Some icons have their own article and name (e.g. Zyre links to Zyre); others are bare only, meant to sit before a word you type yourself. The tables below mark which. Icons render bare by default either way -- see Pill and link to show a name's bundled text.

Variants

A name with more than one icon takes an optional second parameter:

{{icon|name|variant}}

e.g. {{icon|lcr|ballot}}. Where a default variant exists, leaving it out falls back to that ({{icon|lcr}} still works); others (Rank, Capital) require an explicit variant. A variant's own alias appears in the Variant column when it's a parallel short form (e.g. Lock's 1-6), or in Aliases when it's an abbreviation (e.g. Rank's dia2).

For icons with their own name, two independent parameters bring it back:

{{icon|name|pill=yes}}

icon + name in a pill, not a link: Donator Star 1$50 Donator

{{icon|name|link=yes}}

icon + name as a plain link, no pill: Donator Star 1$50 Donator

{{icon|name|pill=yes|link=yes}}

both together: Donator Star 1$50 Donator

Leaving both out (the default) renders bare: Donator Star 1. Neither has any effect on names with no article of their own (Rank, Lock, etc.) -- always bare.

Supported icons

Example Variant Aliases File Renders as
{{icon|orbs|<variant>}} emoji orb File:Orbs icon.png Orbs
web File:Orbs icon (web).png Orbs
{{icon|ascalon}} asc, west File:Shield ascalon.png Ascalon
{{icon|kalros}} north File:Shield kalros.png Kalros
{{icon|garama}} south File:Shield garama.png Garama
{{icon|aladra}} spawn File:Shield aladra.png Aladra
{{icon|balak}} bigboi File:Shield balak.png Balak
{{icon|rivina}} rivi, lilboi File:Shield rivina.png Rivina
{{icon|zyre}} isles File:Shield pvp.png Zyre
{{icon|theend}} end File:Shield end.png The End
{{icon|nether}} thenether File:Shield nether.png Nether
{{icon|loka|<variant>}} crest logo File:Loka icon.png Loka
pixel File:Loka icon (pixel).png Loka
{{icon|capital|<variant>}} world world cap File:World Capital icon.png World Capital
continent cont cap File:Continent Capital icon.png Continent Capital
{{icon|dev}} developer, lokadev File:Dev icon.png Dev
{{icon|shardpouch}} sp File:Shard Pouch icon.png Shard Pouch
{{icon|soulboundbag}} sb bag, sb File:Soulbound Bag icon.png Soulbound Bag
{{icon|waterstone}} File:Waterstone icon.png Waterstone
{{icon|twitch}} ttv File:Twitch icon.png Twitch
{{icon|youtube}} yt File:YouTube icon.png YouTube
{{icon|guide|<variant>}} gold File:Guide icon (gold).png Guide
purple File:Guide icon (purple).png Guide
{{icon|lcr|<variant>}} megaphone mega File:LCR icon (megaphone).png LCR
ballot File:LCR icon (ballot).png LCR
{{icon|powershard|<variant>}} single shard Power Shard icon (single).... Power Shard
core Power Shard icon (core).pn... Power Shard
cluster Power Shard icon (cluster)... Power Shard
{{icon|basiccrystal}} File:Basic Crystal icon.png Basic Crystal
{{icon|basicshard}} File:Basic Shard icon.png Basic Shard
{{icon|blood|<variant>}} normal File:Blood icon (normal).png Normal blood
stained File:Blood icon (stained).png Stained blood
coagulated Blood icon (coagulated).pn... Coagulated blood
{{icon|leafcutter}} File:Leaf Cutter icon.png Leaf Cutter
{{icon|opyc}} File:Opyc icon.png Opyc
{{icon|unknown}} ? File:Unknown icon.png Unknown
{{icon|recallstone}} File:Recall Stone icon.png Recall Stone
{{icon|voidstorage|<variant>}} input vs Void Storage icon (input).... Void Storage input
output Void Storage icon (output)... Void Storage output
{{icon|webbedbola}} antipearl, bola File:Webbed Bola icon.png Webbed Bola
{{icon|xpbottle|<variant>}} small xp File:XP Bottle icon (small).png Small XP Bottle
medium XP Bottle icon (medium).pn... Medium XP Bottle
large File:XP Bottle icon (large).png Large XP Bottle

Collectibles

Example Variant Aliases File Renders as
{{icon|lock|<variant>}} common, 1 File:Lock icon (common).png Common lock
uncommon, 2 File:Lock icon (uncommon).png Uncommon lock
rare, 3 File:Lock icon (rare).png Rare lock
epic, 4 File:Lock icon (epic).png Epic lock
legendary, 5 File:Lock icon (legendary).png Legendary lock
mythic, 6 File:Lock icon (mythic).png Mythic lock
{{icon|title|<variant>}} common, 1 File:Title icon (common).png Common title
uncommon, 2 File:Title icon (uncommon).png Uncommon title
rare, 3 File:Title icon (rare).png Rare title
epic, 4 File:Title icon (epic).png Epic title
legendary, 5 File:Title icon (legendary).png Legendary title
mythic, 6 File:Title icon (mythic).png Mythic title
{{icon|kmdeath|<variant>}} common, 1 deathmessage, deathmsg Kill Message Death icon (c... Common kill message (death)
uncommon, 2 Kill Message Death icon (u... Uncommon kill message (death)
rare, 3 Kill Message Death icon (r... Rare kill message (death)
epic, 4 Kill Message Death icon (e... Epic kill message (death)
legendary, 5 Kill Message Death icon (l... Legendary kill message (death)
mythic, 6 Kill Message Death icon (m... Mythic kill message (death)
{{icon|kmkill|<variant>}} common, 1 killmessage, killmsg Kill Message Kill icon (co... Common kill message (kill)
uncommon, 2 Kill Message Kill icon (un... Uncommon kill message (kill)
rare, 3 Kill Message Kill icon (ra... Rare kill message (kill)
epic, 4 Kill Message Kill icon (ep... Epic kill message (kill)
legendary, 5 Kill Message Kill icon (le... Legendary kill message (kill)
mythic, 6 Kill Message Kill icon (my... Mythic kill message (kill)

Donator Stars

Example Variant Aliases File Renders as
{{icon|donatorstar|<variant>}} 1 donor File:Donator Star icon (1).png Donator Star 1
2 File:Donator Star icon (2).png Donator Star 2
3 File:Donator Star icon (3).png Donator Star 3
4 File:Donator Star icon (4).png Donator Star 4
5 File:Donator Star icon (5).png Donator Star 5
6 File:Donator Star icon (6).png Donator Star 6
7 File:Donator Star icon (7).png Donator Star 7
8 File:Donator Star icon (8).png Donator Star 8

Ranked Icons

Example Variant Aliases File Renders as
{{icon|rank|<variant>}} wood File:Rank icon (wood).png Wood rank
stone1 File:Rank icon (stone1).png Stone 1 rank
stone2 File:Rank icon (stone2).png Stone 2 rank
stone3 File:Rank icon (stone3).png Stone 3 rank
iron1 File:Rank icon (iron1).png Iron 1 rank
iron2 File:Rank icon (iron2).png Iron 2 rank
iron3 File:Rank icon (iron3).png Iron 3 rank
copper1 File:Rank icon (copper1).png Copper 1 rank
copper2 File:Rank icon (copper2).png Copper 2 rank
copper3 File:Rank icon (copper3).png Copper 3 rank
gold1 File:Rank icon (gold1).png Gold 1 rank
gold2 File:Rank icon (gold2).png Gold 2 rank
gold3 File:Rank icon (gold3).png Gold 3 rank
emerald1 em1 File:Rank icon (emerald1).png Emerald 1 rank
emerald2 em2 File:Rank icon (emerald2).png Emerald 2 rank
emerald3 em3 File:Rank icon (emerald3).png Emerald 3 rank
diamond1 dia1 File:Rank icon (diamond1).png Diamond 1 rank
diamond2 dia2 File:Rank icon (diamond2).png Diamond 2 rank
diamond3 dia3 File:Rank icon (diamond3).png Diamond 3 rank
netherite1 neth1 File:Rank icon (netherite1).png Netherite 1 rank
netherite2 neth2 File:Rank icon (netherite2).png Netherite 2 rank
netherite3 neth3 File:Rank icon (netherite3).png Netherite 3 rank
bedrock File:Rank icon (bedrock).png Bedrock rank