The Pro Kit Box modular system is a system that
- enables users to easily insert a Pro Kit Box in an article and
- keeps Pro Kit Boxes up-to-date everywhere on Asphalt Wiki by storing their data in separate templates.
Pro Kit Boxes appear at many different places, mostly together with data like price, drop rates or statistical values:
- They are used on Championship, R&D, and other event pages.
- They are listed in overviews like the Pro Kit Box article or in tables like Pro Kit Box price comparison.
- They can also be mentioned in the flow of an article text or comment.
Unfortunately, one inherent property of Pro Kit Boxes is constant change. It would be extremely time-consuming and error-prone to replace outdated information on every single page where a box is mentioned. Therefore, each box has its own data container. Technically, these containers are templates.
Instead of manually writing down every property of a box, editors can simply insert the box name surrounded by curly brackets {{ }}. This tells the Asphalt Wiki parser to not treat this as simple text, but to display the content of the corresponding template instead. If the template is edited, all wiki pages containing it will display the changes without further maintenance.
Template types[]
There are three types of first-level Pro Kit Box templates editors can use in articles:
- predefined boxes (for example {{Champion Kit Box}}) that already contain all data such as description, drop rates, price and availability,
- half-custom boxes like {{R&D Basic Kit Box}} that are reused for events, but have different content that users can edit,
- a custom box ({{A8box}}) where all parameters can be fully customized.
For an explanation of parameters for half-custom and custom boxes, see {{A8box}}.
Display styles[]
Furthermore, boxes can be displayed in different styles by using the style
parameter: inline, as a compact block, a table row or an infobox—all appearances refer to the same template, only the outer appearance is different.
style = inline (default)[]
The easiest way to display a box is to type two opening curly brackets followed by the first letters of the box name. The autocomplete feature will usually show a preview of possible templates to choose from. For instance, typing {{opti
is sufficient to complete the text to {{Optimal Shuffle Box}}
which will display as Optimal Shuffle Box.
In this example, no style parameter has been specified. Omitting it defaults to style = inline
.
The inline style displays nothing but icon and box name. If the box has its own article, both icon and name will link to it.
{{Champion Kit Box}}
or{{Champion Kit Box|style=inline}}
gives:
The inline style has an additional suffix parameter. As boxes are sometimes mentioned in plural forms, editors can simply add a pipe (|) followed by the plural ending. In styles other than inline
, the suffix parameter is ignored.
{{Champion Kit Box|es}}
or{{Champion Kit Box|es|style=inline}}
gives:
However, if the suffix starts with a number sign (#
), it is not added to the box name, but interpreted as a single parameter call. This displays the value of the parameter instead of the box (see {{A8box-meta}} for further details and a parameter list). Example:
The {{Champion Kit Box}} currently contains {{Champion Kit Box|#items}} cards.
gives:
The Champion Kit Box currently contains 30 cards.
style = compact[]
The compact style is meant for in-depth overviews and displays all of the box's information except for statistical data.
{{Champion Kit Box|style=compact}}
gives:
Champion Kit Box – Last checked: Apr 28, 2020 "Grants 30 Cards, including one V8 Engine card guaranteed. At least 10 cards will be Rare or Legendary!" Common: 56.87 % | Rare: 38.53 % | Legendary: 4.6 % Mean value: 977 per card Availability: Mastery, VIP level reward |
style = list[]
The list style is used for (bulleted) lists. The box icon is smaller, and the information is displayed in a single line instead of a block. Availability is not shown.
* {{Champion Kit Box|style=list}}
gives:
- Champion Kit Box – "Grants 30 Cards, including one V8 Engine card guaranteed. At least 10 cards will be Rare or Legendary!" – Common: 56.87 % | Rare: 38.53 % | Legendary: 4.6 % – Last checked: Apr 28, 2020
style = icon[]
If only the icon is needed without further information, the icon style can be used.
{{Champion Kit Box|style=icon}}
gives:
If there is an article about the box, the image will link to it.
Editors can change the icon size by adding a size
parameter like in [[File:Example.png|60px]]
.
- In styles other than
icon
, the size parameter is ignored. size = 20px
scales the icon to a width of 20 pixels (px),size = x20px
scales it to a height of 20 px.size = 20x20px
scales the icon to fit both width and height of 20 px.
{{Champion Kit Box|style=icon|size=30px}}
gives:
style = template[]
The template style is used when an editor wants to link to the box template instead of the article.
{{Champion Kit Box|style=template}}
gives:
{{Champion Kit Box}}
style = infobox[]
Champion Kit Box | |||||||||
---|---|---|---|---|---|---|---|---|---|
"Grants 30 Cards, including one V8 Engine card guaranteed. At least 10 cards will be Rare or Legendary!" | |||||||||
Official info | |||||||||
| |||||||||
Price | - | ||||||||
Drop rates | Common: 56.87 % Rare: 38.53 % Legendary: 4.6 % | ||||||||
Availability | Mastery VIP level reward | ||||||||
Statistics | |||||||||
Period | Apr 16, 2019 – May 17, 2020 | ||||||||
Sample size | 2,160 trials (72 boxes) Excellent: Sample size >= 1,000 | ||||||||
Mean value | 977 per card | ||||||||
The infobox is the most comprehensive display style which also contains all statistical data of WikiProject Statistics (if available).
Infoboxes should only be inserted on a box's own article page as they automatically categorize the page depending on the availability of the box. For example, an article page with an infobox of the Champion Kit Box will be categorized under Category:Purchasable boxes (Asphalt 8) because it has a price.
This applies only to pages within the article (main) namespace. As this page is in the Help: namespace, it is not categorized.
{{Champion Kit Box|style=infobox}}
gives:
Standard tables[]
Pro Kit Box templates can be combined with table header templates to display various kinds of sortable tables. The header template for standard tables is {{A8box table header}}
style = table[]
The box info of most boxes is divided into common, rare and legendary. style = table
works for all boxes but Festival Bundles and World Tour Supplies which have different box infos.
- The table header template does not need additional parameters if used for
style = table
. - For all other table styles, the header template requires the same style parameter as the box template(s).
{{A8box table header|
{{Champion Kit Box|style=table}}
{{Prime Time Pro Supplies|style=table}}
}}
gives:
Name |
Trials |
C |
Price |
Price /trial |
Description |
Com- mon |
Rare |
Legen- dary | |
---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 30 | Grants 30 Cards, including one V8 Engine card guaranteed. At least 10 cards will be Rare or Legendary! | 56.87 | 38.53 | 4.6 | ||||
Pro Supplies | 4 | 2,000 | 500 | Grants 4 possible rewards: |
style = table festival[]
This is for Festival Bundles and World Tour Supplies. The rarity info is not shown, but the table displays the Blueprints - Pro Kits - Tokens - Credits info instead.
{{A8box table header|style=table festival|
{{Champion Kit Box|style=table festival}}
{{Prime Time Pro Supplies|style=table festival}}
}}
gives:
Name |
Trials |
C |
Price |
Price /trial |
Description |
BPs |
Pro Kits |
|||
---|---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 30 | Grants 30 Cards, including one V8 Engine card guaranteed. At least 10 cards will be Rare or Legendary! | ||||||||
Pro Supplies | 4 | 2,000 | 500 | Grants 4 possible rewards: | 21.25 | 41.25 | 12.5 | 25 |
style = table full[]
This view combines the default and the festival style.
{{A8box table header|style=table full|
{{Champion Kit Box|style=table full}}
{{Prime Time Pro Supplies|style=table full}}
}}
gives:
Name |
Trials |
C |
Price |
Price /trial |
Description |
Com- mon |
Rare |
Legen- dary |
BPs |
Pro Kits |
|||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 30 | Grants 30 Cards, including one V8 Engine card guaranteed. At least 10 cards will be Rare or Legendary! | 56.87 | 38.53 | 4.6 | ||||||||
Pro Supplies | 4 | 2,000 | 500 | Grants 4 possible rewards: | 21.25 | 41.25 | 12.5 | 25 |
Statistics tables[]
Statistics tables can help organize, compare and analyze the statistical data in Pro Kit Box templates.
- Articles containing statistics tables are automatically categorized under Category:Pages containing WikiProject Statistics data.
- Editors should add the {{Wikiproject statistics}} disclamer at the bottom of the page to warn users that the statistical data on the page contains original research which may be incomplete, incorrect or biased.
style = table mini[]
The mini table appears on many special event pages (Championship, R&D, EDD, ...). It is designed to give players a quick overview of selected cards and which boxes grant most of them. The indicator lights after the icons show the sample size for each box. See Sample size for details.
There is a ready-to-use template which already contains a customizable mini table for the most common boxes: {{Pro kit box statistics mini table}}. It is recommended to use this template on event pages instead of constructing the table manually. This ensures a consistent appearance on all event pages.
If it is required to build a different mini table:
- The header template for mini tables is {{A8box table header statistics mini}}. The displayed columns depend on the parameters, so it requires exactly the same parameters as the box template(s).
- See {{Pro kit box statistics mini table}} for parameter details.
{{A8box table header statistics mini|float=left|tech=eima|engine=v12|class=s|
{{Champion Kit Box|style=table mini|tech=eima|engine=v12|class=s}}
{{Daily Kit Box|style=table mini|tech=eima|engine=v12|class=s}}
}}
gives:
Name | S Parts |
|||||||
---|---|---|---|---|---|---|---|---|
Champion Kit Box | 0.97 | 8.06 | 8.43 | 3.98 | 0.37 | 15.60 | ||
Daily Kit Box † | 0.61 | 0.00 | 0.00 | 7.63 | 2.37 | 14.20 |
General statistics tables[]
General statistics tables are mainly used on Pro Kit Box statistics: average frequencies and Pro Kit Box statistics: minimum card requirements.
- The header template for general statistics tables is {{A8box table header statistics}}. It can display two variants of box tables: average relative frequencies and the minimum number of revealed cards required to get an item with a probability of 90 %. As the header stays the same for both variants, it requires the same style parameter as the box template(s), but without a possible
mincards
suffix. Themincards
variant is only shown in the first example, but works with all parameters accordingly. - The indicator lights after the icons show the sample size for each box. See Sample size for details.
style = table cards[]
{{A8box table header statistics|style=table cards|
{{Champion Kit Box|style=table cards}}
{{Daily Kit Box|style=table cards}}
}}
{{A8box table header statistics|style=table cards|
{{Champion Kit Box|style=table cards mincards}}
{{Daily Kit Box|style=table cards mincards}}
}}
gives:
Name |
Com- mon |
Rare |
Legen- dary |
Blue- prints |
En- gines |
Tech |
Parts |
Mean per card | ||
---|---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 55.05 | 40.05 | 4.91 | 0.00 | 12.22 | 20.83 | 66.94 | 977 | ||
Daily Kit Box † | 53.97 | 39.10 | 6.92 | 0.00 | 10.00 | 10.00 | 80.00 | 1,019 |
Name |
Com- mon |
Rare |
Legen- dary |
Blue- prints |
En- gines |
Tech |
Parts |
Mean per card | ||
---|---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 3 | 5 | 46 | 18 | 10 | 3 | 977 | |||
Daily Kit Box † | 3 | 5 | 33 | 22 | 22 | 2 | 1,019 |
style = table common engines[]
{{A8box table header statistics|style=table common engines|
{{Champion Kit Box|style=table common engines}}
{{Daily Kit Box|style=table common engines}}
}}
gives:
Name |
|||||||||
---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 0.00 | 0.00 | 0.65 | 0.05 | 0.74 | 3.89 | 0.00 | ||
Daily Kit Box † | 0.00 | 0.64 | 0.83 | 0.48 | 0.93 | 0.83 | 0.00 |
style = table rare engines[]
{{A8box table header statistics|style=table rare engines|
{{Champion Kit Box|style=table rare engines}}
{{Daily Kit Box|style=table rare engines}}
}}
gives:
Name |
||||||||
---|---|---|---|---|---|---|---|---|
Champion Kit Box | 1.11 | 0.00 | 0.09 | 0.00 | 0.93 | 0.23 | ||
Daily Kit Box † | 0.61 | 0.00 | 0.10 | 0.00 | 0.74 | 0.29 |
style = table legendary engines[]
{{A8box table header statistics|style=table legendary engines|
{{Champion Kit Box|style=table legendary engines}}
{{Daily Kit Box|style=table legendary engines}}
}}
gives:
Name |
|||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 0.09 | 0.19 | 0.37 | 0.56 | 0.69 | 0.46 | 0.19 | 0.05 | 0.60 | 0.97 | 0.00 | 0.19 | 0.19 | ||
Daily Kit Box † | 0.19 | 0.19 | 0.42 | 0.38 | 0.22 | 0.35 | 0.16 | 0.32 | 0.58 | 0.61 | 0.19 | 0.32 | 0.61 |
style = table tech[]
{{A8box table header statistics|style=table tech|
{{Champion Kit Box|style=table tech}}
{{Daily Kit Box|style=table tech}}
}}
gives:
Name |
|||||||||
---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 8.06 | 8.43 | 3.98 | 0.37 | 0.00 | 0.00 | 0.00 | ||
Daily Kit Box † | 0.00 | 0.00 | 7.63 | 2.37 | 0.00 | 0.00 | 0.00 |
style = table parts[]
{{A8box table header statistics|style=table parts|
{{Champion Kit Box|style=table parts}}
{{Daily Kit Box|style=table parts}}
}}
gives:
Name |
Tires |
Susp. |
Drvtr. |
Exhst |
Class D |
Class C |
Class B |
Class A |
Class S |
Car |
Bike | ||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Champion Kit Box | 21.94 | 22.31 | 10.83 | 11.85 | 11.85 | 13.33 | 8.06 | 18.10 | 15.60 | 66.94 | 0.00 | ||
Daily Kit Box † | 19.94 | 21.47 | 19.81 | 18.78 | 16.83 | 16.41 | 17.02 | 15.54 | 14.20 | 80.00 | 0.00 |
style = table maintenance[]
Maintenance tables are used on the maintenance page of WikiProject Statistics. They display links to both templates and articles as well as control dates and sample sizes. The E behind the box names leads directly to the respective edit page.
The header template for statistics maintenance tables is {{A8box table header statistics maintenance}}.
{{A8box table header statistics maintenance|
{{Champion Kit Box|style=table maintenance}}
{{Daily Kit Box|style=table maintenance}}
}}
gives:
Template |
Article |
Last info check |
Sample size |
End of sample period |
Show dev. |
||
---|---|---|---|---|---|---|---|
{{Champion Kit Box}} · E | Champion Kit Box · E | Apr 28, 2020 | 2,160 | May 17, 2020 | 1 | 1 | |
{{Daily Kit Box}} · E | Daily Kit Box · E | Apr 26, 2020 | 3,120 | May 4, 2020 | 1 | 1 |
Technical details[]
Technically, all box templates used in articles are first-level templates. They pass their parameters to {{A8box-meta}} which routes them to the correct third-level metatemplate depending on the style
parameter.
The following overview shows the structure of the system, together with all metatemplates acting "behind the scenes":
Color explanation: | First level | Templates used by editors in articles |
Second level | Metatemplate routing parameters to third-level template according to style parameter | |
Third level | Metatemplates defining the final display style |
Predefined boxes {{Daily Kit Box}} {{Finish Line Box}} {{Champion Kit Box}} {{...}} |
Half-custom boxes {{R&D Basic Kit Box}} {{Championship Rookie Box}} {{EDD Rookie Box}} {{...}} |
Custom box {{A8box}} |
Table headers | |||||
↓ calls | ↓ calls | ↓ calls | ||||||
{{A8box-meta}} | ||||||||
↓ calls with style = | ||||||||
inline · [omitted] → | {{A8box inline}} | |||||||
compact → | {{A8box compact}} | |||||||
list → | {{A8box list}} | |||||||
icon → | {{A8box icon}} | |||||||
template → | {{A8box template}} | |||||||
infobox → | {{A8box infobox}} | |||||||
table · table festival · table full → | {{A8box table}} | is used with → | {{A8box table header}} | |||||
table mini → | {{A8box table statistics mini}} | is used with → | {{A8box table header statistics mini}} | |||||
table cards · table common engines · table rare engines · table legendary engines · table tech · table parts → | {{A8box table statistics}} | is used with → | {{A8box table header statistics}} | |||||
table cards mincards · table common engines mincards · table rare engines mincards · table legendary engines mincards · table tech mincards · table parts mincards → |
{{A8box table statistics mincards}} | is used with → | ||||||
table maintenance→ | {{A8box table statistics maintenance}} | is used with → | {{A8box table header statistics maintenance}} |
See also[]
- Category:Pro kit box templates – first-level box templates
- Category:Pro kit box metatemplates – second- and third-level box templates
- Category:Pro kit box table header templates – table header templates for Pro Kit Boxes
- {{A8box}} for custom box parameters
- Asphalt Wiki:New A8box – how to create new box templates and articles