Template talk:DragonBox
From Dragon Mania Legends (DML) Wiki
The DragonBox is fairly complex and is made up of over 60 parameters which become more complex over time. This means that reading it thoroughly might become tedious. As such, provided you do not have the patience for it, we recommend picking an appropriate Dragon from this category's subcategories (near the bottom of the page) and then use it as the basis for creating a similar Dragon. Since some parameters are not used by all Dragons, the necessary parameters that you may need to use are already selected for the type of Dragon you have chosen, after which you can return to this article and read the documentation for said parameters. |
The DragonBox is a powerful template that can generate between 50% and 100% of the contents of Dragon articles. Aside from manually written information needed to generate content, the DragonBox uses other variables and templates to determine a Dragon's characteristics and the color of the box itself.
To get a general grasp of how templates work, visit MediaWiki Templates and the Manual of Style. The DragonBox will be fully explained in a way that anyone, regardless of their knowledge of wiki software, can use. If the explanation below is unclear or insufficient, or if you want to suggest modifications toward the betterment of this template, feel free to contact the maintainers of this template, namely Star Warden and Soukupmi.
Calling a template on any page is done by adding the name of the template between double braces: {{DragonBox}}. Note that, in this article, the term "base value" is used to represent those stats, characteristics and attributes a Dragon has at Level 1. These values are displayed on the Base Codex Entry of Dragons that are housed on the islands and not of those that have just hatched from an egg and are still in the Hatchery.
Parameters
Parameters are built-in segments that produce different content depending on their given value. When using any other word, which is not defined as a parameter in the template, on the position of a parameter, the template will simply ignore it.
To call any parameter, add it before the last double braces, making sure to add a | before each parameter. To assign a value to a parameter, add the equal sign after it and add the value after the sign. The beginning of the template and its end, as well as each parameter, will all be on a separate line. See the examples.
Note that some parameters only respond to certain values, while other parameters respond to any value. "Built-in Values" represent those values to which the parameter will respond and must be manually inserted, while "Default Values" represent the contents the parameter will generate if no value is attributed to it. The former will not be functional, unless it is given a value while the latter will be functional, regardless if a value is given or not, unless they are overridden by other parameters.
The position of the parameters inside the template, when creating articles, must be strictly respected as per below.
switch
{{DragonSwitch}} template. |
In the very beginning of each article, the DragonBox generates the contents of an incorporated template called the {{DragonSwitch}}
, which is built using DPL, a content-reporting tool. The function of this template is to retrieve the preceding and succeeding Dragons in alphabetical order, acting as a navigational bar between articles. This function is done automatically, without the need of user intervention. However, should the necessity to negate this template arises, simply attributing any value to the switch parameter will disable the display of DragonSwitch.
previous
|
As it was explained in the previous section, the DragonSwitch automatically retrieves the preceding and succeeding Dragons. However, in very rare cases, usually with Dragons that are at the end of the alphabetical order, the name of the preceding Dragon will have to be manually written. In this case, simply write the full name of the Dragon.
next
|
Uses the same mechanics as previous, but for the succeeding Dragon.
unknown
|
In those cases, in which no information about the Dragon is known, attributing any value to this template will override the color scheme, profile, and most parameters in the DragonBox. Used when the name of a Dragon is officially released to the public, but no other information about it is available.
special
|
Used when a Dragon has a wholly different cost and no other combination of parameters can generate said cost. This is an extremely rare occurrence, and more than probably it will need staff intervention to precisely determine whether it is truly needed or not. Normally, the icon of a currency is automatically generated next to the value of cost when certain conditions are met by a combination of the parameters cost, available, method, base, second, and third. Sometimes various notes can or must be added next to cost, and thus it must be overridden.
codex
|
The entry must be manually written, exactly as it is in the game, respecting the formatting and any additional symbol. This parameter cannot be used with Boss Dragons and Clan Dragons.
section
|
Simply write in the name of the section, as presented in the game.
collection
|
Simply write in the name of the collection, as presented in the game.
The method parameter must stay empty, as this is a Reward-Exclusive Dragon!
type
|
Simply pick the rarity of the Dragon from the possible values, or the ? value if the rarity is currently unknown. The parameter does not work for Boss Dragons. The rarity of a Dragon can be found on its Codex Entry or when inspecting the Dragon inside its Habitat.
powers
|
Manually write the description of the Dragon's power, exactly as it is written in the game. Before the description, the icon of the power, that is also present on the in-game description, must be added per the following format: [[File:CDP Icon - IconName.png|25px]]
.
powers2
|
A more complete description of the Dragon's power must be written here so that it is understandable to all users.
duration
|
Only add the digit representing the number of hours the power is active, without adding the unit of time, in this case Hours. If the power has an instant effect, do not use the parameter.
cooldown
|
So far, absolutely all Clan Dragons have the same cooldown, but should the need to use this parameter arise, simply add the cooldown, by writing the amount of time in digits and the unit of time with first letter capital.
unleash
|
Write the cost in digits, making sure to separate thousands through the use of commas, as stated in the Manual of Style.
base
|
The order of the Elements can be found either on the Dragon's Codex Entry, in order from top to bottom, or inside its Habitat, in order from left to right. Write the Element as it is, with first letter capital.
second
|
Same mechanics and instructions as for base.
third
|
Same mechanics and instructions as for base and second.
health
{{BaseHealth}}
|
Used as an override value in cases when the automatically generated Base Health does not match the real one the Dragon has. Simply add the amount in digits as it is on the Dragon's in-game Level 1 Codex Entry.
If this value is used, then health2 and health3 will most probably also have to be entered manually.
health2
{{BaseHealth}}
|
Uses the same mechanics as those of health, but adapted for Dragons that have unlockable Elements. In this case, it displays the Base Health of the Dragon when its second Element is awoken.
health3
{{BaseHealth}}
|
Uses the same mechanics as health2, but adapted for the amount of Base Health with all three Elements awoken.
attack
{{BaseAttack}}
|
Used as an override value in cases when the automatically generated Base Attack does not match the real one the Dragon has. Simply add the amount in digits as it is on the Dragon's in-game Level 1 Codex Entry.
If this value is used, then attack2 and attack3 will most probably also have to be entered manually.
attack2
{{BaseAttack}}
|
Uses the same mechanics as those of attack, but adapted for Dragons that have unlockable Elements. In this case, it displays the Base Attack of the Dragon when its second Element is awoken.
attack3
{{BaseAttack}}
|
Uses the same mechanics as attack2, but adapted for the amount of Base Attack power with all three Elements awoken.
gold
{{BaseGpH}}
|
Used when the automatically generated Base Gold per Hour does not match the real one the Dragon has. Simply add the amount in digits as it is on the Dragon's in-game Level 1 Codex Entry. For this parameter, the unformatted number must be added, and thus the thousands are not to be separated.
xp
{{HatchXP}}
|
Used when the automatically generated experience does not match the real one from the game. Simply add the amount in digits, making sure to separate thousands through the use of commas.
sell
{{SellGold}}
|
Used when the automatically generated selling cost of the Dragon does not match the real one from the game. Simply add the amount in digits, making sure to separate thousands through the use of commas. To find the real selling cost of a Dragon, simply navigate to that Dragon's Codex Entry and then click the "sell" button. A confirmation window will pop up, displaying the amount, and thus the Dragon needs not be actually sold.
dcp
{{ValType}}
|
Used when the automatically generated Dragon Collector Points base value of the Dragon does not match the real one from the game. Simply add the amount in digits as it is on the Dragon's in-game Level 1 Codex Entry.
limited
|
This parameter is used only when the DragonBox cannot correctly define the Dragon as time limited. In this case, add the parameter and attribute its value.
available
|
The general availability of a Dragon is displayed on the right of the Available section of the DragonBox. In numerous cases, the parameter available itself needs not be used, as the availability is given by other parameters. It is important to note that when this parameter is in use, either by attributing it one of the built-in values or any other value, it will override the function of the other parameters.
Parameter | Value | Display | Function |
---|---|---|---|
available | ? | Currently Unknown | Used when the availability of a Dragon is currently unknown. Not necessary if method also has the same value. |
{{csd}} | Card Segments | Used when the Dragon is a regular Card-Segment Dragon, as indicated here, or when it is obtained from Card Packs in the Dragon League, as indicated here. | |
Standard | Standard | Used when the Dragon is normally obtainable, as indicated here. | |
Guaranteed | Same function as for Standard, but it is used when the Dragon has a guaranteed combination, as indicated here. | ||
method | ? | Currently Unknown | Read this parameter's information section to learn more. |
{{eod}} | Occasional | ||
{{wdp}} | Card Segments | ||
Clan | |||
Task | |||
Top | Dragon League | ||
Elite | |||
Seasonal | Clockwork Dungeon | ||
den | Any Value | Enchantment | Used when the Dragon is obtained through Enchanted Breeding. |
league | Dragon League | If the trophies parameter is active, it indicates that the Dragon is obtained through promotions in the Dragon League}}. | |
Dragon League | If trophies is not active, then it indicates that the Dragon is obtained through promotions in the Dragon League. | ||
code | Reward Exclusive | Used when the Dragon is obtained through Recruitment Codes. | |
fp | Used when the Dragon is obtained through the Totem of Friendship. | ||
daily | Used when the Dragon is obtained through the Daily Rewards. | ||
q | Used when the Dragon is obtained through winning certain quests on the Campaign Map. | ||
dungeon | Bottomless Dungeon | Used when the Dragon is obtained through the Bottomless Dungeon. | |
vip | VIP Exclusive | Used if the Dragon is restricted to certain VIP Levels. | |
powers | Clan Action | Used if the Dragon is a Clan-Exclusive Dragon. | |
quest | Unlocking | Used for Boss Dragons. | |
token | Higher than 3000 | Breeding Token | Used when a permanent Breeding Token is given for the Dragon. |
method
|
The most common method of obtaining a Dragon is displayed in the right of the Method section of the DragonBox. In some cases, the parameter method itself needs not be used, as the method is given by other parameters. It is important to note that when this parameter is in use, either by attributing it one of the built-in values or any other value, it will override the function of the other parameters.
Parameter | Value | Display | Function |
---|---|---|---|
method | ? | Currently Unknown | Used when no method of obtaining the Dragon is currently known. |
{{eod}} | Events | This is, mostly, a fallback value as most Dragons are obtained through events. It is used when the Dragon does not have a more specific method. | |
{{wdp}} | Weekly Dragon Pieces | Used when a Dragon is usually obtained through Weekly Dragon Pieces. | |
Clan | Clan Events | Used when a regular Dragon can only be obtained from Milestone Card Packs in Clan Events. | |
Task | Daily Tasks | Used when a Dragon can only be obtained from the Daily Tasks. | |
Top | Top 5 or Milestone | Used when the Dragon can only be obtained from the Top 5 positions of Dragonscale League 1 and as Breeding Tokens from the Elite League milestones | |
Elite | 1st Place | Used when the Dragon can only be obtained from the first position of the Elite League | |
Seasonal | Seasonal Reward | Used when the Dragon is a limited reward in the Clockwork Dungeon, as indicated here. | |
Weekly | Dungeon Week Reward | Used when the Dragon can be found within one of the Chests in the Bottomless Dungeon. | |
den | Any Value | Enchanted Breeding | The explanation for each parameter is the same that applies for the parameter available. |
league | Dragon League | ||
code | Recruitment Code (CodeAmount ) | ||
fp | Friendship Points (PointAmount ) | ||
daily | Daily Rewards (Day NumberOfDay) | ||
q | NameOfMode Mode ( QuestNumber) | ||
vip | Breeding or Purchasing | ||
powers | Community Hatching | ||
quest | Purchasing | ||
token | Higher than 3000 | Breeding or Purchasing | If base has Legendary as value, then Unique Breeding is displayed instead of Breeding. |
available | {{csd}} | Card Packs | Same description applies here as for this parameter's own section. |
Standard | Breeding or Purchasing | If base has Legendary as value, then Unique Breeding is displayed instead of Breeding. | |
Guaranteed |
unlock
{{ValElem}}
|
A Dragon is not unlocked, per se, but rather its highest Element. A thorough explanation can be found here. The level is automatically generated, and thus this parameter is only used when said level must be overridden. Manually insert the level in digits.
token
|
If a permanent Breeding Token exists and Dragon Collector Points are needed to unlock it, then this amount must be written. Otherwise, if limited tokens are made available, then the amount of times the token was made available must be written.
The amount of DCP needed to unlock the Dragon can be found on the milestone for the Dragon Collector Leaderboard, while the number of times a Breeding Token was made available for the Dragon can be found on its page, under the Obtaining section. Add the unformatted number in digits.
mode
|
This parameter is applicable to those Reward-Exclusive Dragons that can be won from winning certain quests on the Campaign Map either in Normal Mode or in Heroic Mode. It is only used if the Dragon was made available in Normal Mode, as Heroic Mode is the default value. Simply add "Normal", if that is the case.
q
|
Add the quest number in digits, exactly as it appears in the game.
code
|
Add the amount in digits. The amount can be found when navigating to the Recruit a Friend section of the friend list.
fp
|
Add the amount in digits, making sure to separate thousands through the use of commas. The amount can be found by opening the Totem of Friendship screen.
league
|
Add only the name (Dragon League) of the league as specified in the values.
division
|
Add only one of 1, 2 or 3, depending on the division of said league. This parameter is not to be used if league has "Elite" as value or/and if available has "{{csd}} as value.
trophies
|
Add the amount in digits, making sure to separate thousands through the use of commas.
dungeon
|
daily
|
Simply choose the correct day and then write it in digits.
vip
|
Add the number of the VIP Level in digits which can be found in the information window of the VIP Status when navigating between the benefits of each level.
den
|
Add the number of the Breeding Den in digits, as it can be seen when clicking the "Upgrade" button after selecting the den.
parent1
|
For Enchantment Dragons, the first parent will be shown on the left-hand side of the screen, after opening the screen for breeding Enchantment Dragons. The method of finding the parents of the other types of Dragons is variable. Write the name of the Dragon while omitting the additional "Dragon" from its name.
parent2
|
Same mechanics as parent1, but for the second parent which, in the case of Enchanted Breeding, will be shown on the right-hand side of the screen.
s
|
This parameter is only used with Enchantment-Breedable Dragons and only if both parents require the same level of Enchantment. Simply add the digit of the level, as it can be seen when opening the Enchanted Breeding screen of the Breeding Den.
s1
|
This parameter is only used with Enchantment-Breedable Dragons and only if the parents each have a different Enchantment Level. Simply add the digit of the level, as it can be seen when opening the Enchanted Breeding screen of the Breeding Den.
s2
|
Same mechanics as for s1, but adapted for parent2.
cost
|
The cost of a Dragon represents the necessary amount of a specific currency needed to acquire that Dragon's egg and then subsequently incubate and hatch it. Adding the amount itself is done manually by writing it in digits with the thousands separated through commas. The icon of said currency is then automatically generated in accordance to the values of other parameters, unless overridden.
Parameter | Value | Function |
---|---|---|
special | Any | Overrides the currency icon. |
cost | ? | Returns Currently Unknown and overrides the currency icon. |
base | Any | If the parameter second is not present, returns the icon |
second | Returns the icon | |
den | Returns Unbuyable and overrides the currency icon. | |
type | Divine | |
dungeon | Any | Returns the icon |
available | {{csd}} | Returns the icon |
method | {{wdp}} | |
Clan | ||
Task | ||
powers | Any |
quest
|
Uses the same mechanics as q, but adapted for Boss Dragons.
regular
|
Write the name of the counterpart as it is while omitting the additional "Dragon".
cm
|
This amount can be found inside the Clan's collection of Clan Dragons on each of the Dragons' snapshot. Write the amount in digits, making sure to separate thousands through the use of commas, as stated in the Manual of Style.
breeding
{{template|BreedingTime}} (regular Dragons), Unbreedable (Boss Dragons & Clan Dragons)
|
Used when the automatically generated breeding time does not match the real one the Dragon has. Write it as x Days & x Hours, x Hours & x Minutes, or whichever unit of time it uses, where x stands for the number written in digits. If the Dragon has a time longer than two units of time, only add the two highest, consecutive units of time, then use the {{rt}}
template to indicate the full time, as in the following example: {{rt|1 Day & 4 Hours|The actual time is 1 Day, 4 Hours & 40 Minutes. The game displays only the two highest units of time.}}
hatching
{{template|HatchingTime}} (regular Dragons), Instant (Boss Dragons)
|
Same mechanics and explanation as for breeding, but adapted for the hatching time.
vipbreeding
{{template|BreedingTime}}
|
Same mechanics as breeding and hatching, but adapted for the 20% time reduction given by an active VIP Status of Level 2 or higher. To calculate the time, use the VIP Status#Time Conversion Table.
viphatching
{{template|HatchingTime}}
|
Same mechanics as vipbreeding, but adapted for hatching.
style
|
Simply follow the examples to see which body style is applicable to the Dragon, and then choose the correct one.
description
|
The description of the Dragon must be carefully and correctly written, following the writing standards of the Manual of Style. A small guide can be found here. Note that while all other parameters that are not in use must not be added inside the template, this parameter must be included when creating an article, even if it means leaving it empty.
obtaining
|
The information on obtaining a Dragon is, normally, generated by a combination of multiple parameters, usually available, method and the others that interact with these two. This parameter is used to override said information, in case it does not apply to the Dragon. Additionally, if no combination of parameters can generate the description, then "The Name Dragon is" will be shown as the first line under the "Obtaining" section of the article.
additional
|
The additional information that can be written includes additional methods of obtaining the Dragon, that are not automatically given by the DragonBox. The information must be objectively written and must follow the Manual of Style. This parameter is not to be used if the obtaining parameter is also in use.
lb
|
dotw
|
Simply add the amount in digits. There are two easy methods to finding out how many times a Dragon has been a Dragon of the Week:
1. Manually count all instances on the Dragon's own page.
2. Open the article in editing mode, hit the Ctrl + F keyboard shortcut, then type in {{dotw}}. The search results will indicate the number of times it appears on the page.
dotm
|
Same mechanics and instructions as those for the dotw parameter, but adapted for the Dragon of the Month.
update
|
Use for which update a dragon was introduced in, using the following format:
- ReleaseUpdae=Standard
|cost=1,000 |style=winged |description=
}}
Second
- Dragon characteristics: regular Card-Segment Dragon, Epic, Void as first Element, Energy as second Element, Metal as third Element, costs 50 Dragon Pieces, has a Collection section, Stout-Style.
{{DragonBox |codex=This Dragon is here to teach you how to train other Dragons! |collection=Highlanders |type=Epic |base=Void |second=Energy |third=Metal |available={{csd}} |cost=50 |style=stout |description= }}
Third
- Dragon characteristics: Enchantment-Breedable Dragon, Legendary, Legendary as first Element, Shadow as second Element, Earth as third Element, Saurian-Style, breedable in a Level 3 Den, Aurora Dragon as first parent; needs Enchantment Level 3, Heliotrope Dragon as second parent; needs Enchantment Level 5
{{DragonBox |codex=This Dragon likes to fight. |type=Legendary |base=Legendary |second=Shadow |third=Earth |den=4 |parent1=Aurora |parent2=Heliotrope |s1=3 |s2=5 |style=saurian |description= }}