Template:EventBox

When new event types are added, the following needs updates: Template:Event, Template:Calendar, EventInfos table (recreation, switch-in when populated). See Template:EventBox/Values which stores the Cargo table values passed to it by this template, and the Talk page for old documentation.

Template documentation
Note: portions of the template sample may not be visible without values provided.
View or edit this template's documentation. (About template documentation)

Notes:

• To convert scalable Food or Gold by Level Modifier use: {{modifier|5,000}}.

Example(s)

• {{EventBox|type=Gem Spending|prize=Earth|dragon=Plant}} gives:

OVERVIEW DESCRIPTION Spend as many Gems as you can to win awesome rewards! INFORMATION Limited Event Started 26 April 2024 Ended 30 April 2024 Duration 4 Days Type Gem Spending First Prize  Earth Dragon

The requirements stated in this article are that of the highest-level brackets while the milestone rewards belong to the highest level modifier.

Gem Spending Events are limited-time competitions in which Trainers compete against each other, reach individual milestones, and move up on the leaderboard by spending Gems on any game feature.

Mechanics

Each one Gem spent is equal to one point, regardless of what it is spent on.

Qualifiers

These events are always exclusive to Trainers with an active VIP Status. Trainers must select the   Participate!   button to begin, any Gems spent before this are not counted.

Progress Rewards

250	750	1,700
50	200	Plant

Leaderboard Prizes

The amount of Food or Gold awarded depends on Trainer Level, provided numbers are of the highest Level Modifier. See Level Modifier for more information.

1-5	Earth Dragon
6-10	150     750,000     2,250,000
11-20	75      375,000      1,125,000
21-100	20      150,000     525,500
101-250	10      37,500       300,000
251-500	3       15,000
501-2000	1

Test(s)

• {{EventBox|type=Hatching|prize=Fire|badge=Matchmaker|note=This is the default event.}}
• {{EventBox|ended=28 September 2018|duration=7 Days|type=Hatching|prize=Heavenly|exclusive={{wp|China}}|occasion={{wp|Mid-Autumn Festival}}}}
• {{EventBox|type=Feeding|prize=Wind}}
• {{EventBox|type=Gold Collecting|prize=Shadow}}
• {{EventBox|type=Food Gathering|prize=Light}}
• {{EventBox|type=Clan Siege}}
• {{EventBox|type=The Great Dragon Race|mult=2}}
• {{EventBox|type=Emerald Wars}}
• {{EventBox|type=Relay|specific=17|prize=Seahorse|ticket= (Fire)|ticketType=Ancient}}
• {{EventBox|type=Chain Breeding}}
• {{EventBox|type=Dragon Dice|reward=<center>{{di|Capricorn}}{{rt|Note|Double Dice Reward}}<br>{{di|Envoy}}</center>|duration=35 Days}}
• {{EventBox|type = Milestone Rewards| started = 3 August 2020| duration = 34 Days| prize = Fairy Dust}}
• {{EventBox|type=Chest Opening| started = 4 April 2022|duration = 14 Days|prize=River|text=This event took place during the [[Divine Fest - Springtime Passions]] Divine event series - Part I. |icons=Holy Talisman (Springtime Passions), Dragon Pieces, Divine (Element)|image=Divine Chest - Spring's Renewal (Divine Fest)}}
• {{EventBox|type=Cake Craze|prize=Cheesecake}}
• {{EventBox|type=Sigil Campaign|prize=Dreamcatcher|table=|duration=30 Days}}
• {{EventBox|type=Movie Marathon|table=|specific=}}
• {{EventBox|type=Dragon Grid|duration=7 Days}}
• {{EventBox|type=Bottomless Dungeon|prize=Fifth}}
• {{EventBox|type=Bottomless Dungeon|prize=Fifth|dungeonoffer=Quartern,Sixth|note=Catchup Dungeon}}
• {{EventBox|type=Bottomless Dungeon|prize=Fifth|dragon=Ladybug,Sixth|icons=Ancient Ticket (Fire), Ancient (Element)}}

This template is used for all Events taking place. It's quite extensive to satisfy every event type. More extensive documentation can be found on the Talk page.

Template parameters

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
(date) started	started	Start date. If omitted, date is generated from page title. Required when an event starts earlier than expected, particularly if hours ahead, in which case hours are added. Example 8 May 2023 OR 8 May 2023 00:00:00	Date	optional
(Override) ended	ended	Required for early endings, or lacks auto-calculated end date. Used by the Main Page events slider to correctly calculate when to drop events out of slider. Example 8 May 2023 OR 8 May 2023 00:00:00	String	optional
duration	duration	Number of days the event took place for. The "ended" date is calculated by either the type, or using duration. Example 2 Days	String	optional
(Event) type	type	Event type if not auto-generated from page title. Choose from an existing event category. Example Calendar	String	optional
(Dragon) prize	prize	Add the Dragon name, omitting the word "Dragon". Used only for the prize dragon awarded for completing the event. If no prize should be displayed, specify the {specific=Prize} parameter. Example Don	String	optional
(Event type) vip	vip	Enter "VIP" if this event was only available with active VIP status. Example VIP	String	optional
(Leaderboard) generic	generic	Compare the generated Leaderboard with actual event leaderboard. There are several generics for the majority of regular events (this param sets them). Some events have their own generic leaderboard (such as Hatching, Gem Spending Events and Clan Events). Other events typically use a particular generic leaderboard: VIP = 1. Gold Collecting/Spending = 2. VIP Food Gathering = 3. Hatching with Dragon as main prize = 4. Feeding/Food Gathering = 5. Example 1	Number	optional
(Name of) badge	badge	Displays the badge obtained within an event. Add the badge name omitting the word "Badge".	String	optional
(Additional) badge2	badge2	Enter the badge name omitting the word "Badge".	String	optional
(Required dragon) hero	hero	Indicates the Hero Dragon required to participate in Hero's Challenge. Add the name omitting the word "Dragon". Example Bludgeon	String	optional
(soon to be retired) dragon	dragon	Used ONLY for dragon given for final Gem Spending milestone, or the Dungeon Shop Dragon. As with prize, add the dragon name omitting "Dragon". Example Phoenix	String	optional
(Dragon) dungeonoffer	dungeonoffer	Used ONLY for Dungeon Shop dragons (can be a comma separated list, omitting "Dragon"). Example Phoenix	String	optional
section	section	Used to indicate the total days (Calendar), levels (Castle) or tiers (Solo) an event has. Example 8	Number	optional
(Non-dragon) reward	reward	Apart from Clan Events and the majority of Hatching Events, all other events almost always offer Dragons as their main prize. Since the prizes for Hatching Events are automatically generated, this parameter is only used when either a generic prize is not applicable or when a Dragon is not the main prize of the event (thus the prize parameter is not to be used). The parameter is also applicable to any other event that does not offer Dragons as a prize, such as the aforementioned Clan Events, to override the generic default. Example 525,000 {{i|Gold}}<br>45,000 {{i|Food}}<br>3 {{i|Scrolls}}	String	optional
(Skip) table	table	Use to supress table generation if the generic parameter cannot retrieve matching data. Negates the leaderboard or milestones and leaderboard. Depending on what is excluded, the prizes must be manually added through the use of {{Milestones}} or/and {{Leaderboard}}. Note milestone negation is not possible without the inclusion of the leaderboard because milestone is generated before the leaderboard. Even if a milestone is generic (but a leaderboard is not) both must be negated. Example 1 / 2	Number	optional
(Atypical rewards) specific	specific	Used when a Calendar Event does not double the prizes for Trainers with an active VIP Status (=novip) or the amount of (Divine) Tickets per round in a Relay Event is apart from the default of 15. If set to "Prize" then no reward (Dragon or other) is shown. Example 17	String	optional
(# req, calendar) pieces	pieces	no description	Number	optional
(top) text	text	Some observations that can be made include whether this type of event had double prizes, took place in the game for the very first or the very last time, or if the event was not available in a particular region because of a concurrent and exclusive event for that region, or any other factual and objective notes. Make sure to follow the writing style as specified in the Manual of Style. Example This event was not available in Australia because of the concurrent G'Day event.	String	optional
(Override) description	description	Displays the custom, in-game description. It is used only when an event does not have a generic, built-in description. When a unique description exists, write it exactly as it is written in the game. Example Some dragons feel at home on both land and sea; welcome them by completing goals to earn rewards.	String	optional
(Optional) ticket	ticket	Ticket name excluding "Icon" and extension. Default null Example Divine Ticket (Wind) Auto value	String	optional
(For BDGD page chest column) note	note	For plain-wikitext notes only ("|icons=" is for icons), when used with the"|badge=" parameter, becomes ref text which can only use text! For Catch-Up dungeon events, please don't also specify icons as DPL3 can only display one or the other, not both (keeping capabilities consistent between extensions, and so the results match with prior event entries).	String	optional
(Optional) icons	icons	Used to specify a comma-separated list of icons only. "|icons=" are for chest prize icons (except catch-up dungeons, that use only "note" text only), this is because DPL3 can display "|icons=" OR "|note=" not both, and to keep Cargo consistent with DPL3 capabilities.	String	optional
(Breeding) token	token	Used if the prize is only a breeding token, enter the Dragon Name (without "Dragon") Example Echo	String	optional
(Optional) exclusive	exclusive	Adds "Exclusivity: [content]" (to side infobox > information section)	String	optional
(Optional) occasion	occasion	Adds "Occasion: [content]" (to side infobox > information section)	String	optional
(Override, multiplier) mult	mult	Used if clan rewards were doubled Default 1 Example 2	Number	optional
(Override) element	element	Used if a specific element dragon must be fed, and not just any dragon Default null	String	optional
(Override) synopsis	synopsis	Used to override synopsis text	String	optional
(Override) mvp	mvp	Override clan coins/rewardsamount	String	optional
(Slider) image	image	If specified, overrides the Main Page event slider image, as that template looks at this one for data. The value is passed to that template. Example Solo Adventure (23.08.28) Icon	String	optional
(Override) page	page	Allows overriding page name for testing and debugging only.	Page name	optional

Parameters Passed

This template passes parameters to the {{EventBox/Profile}} template, meaning they are specified in the {{EventBox}} template.

Creates/populates the EventBox "Overview" section image and text header, either automatically or depending on the ad/banner/picture set. Used by EventBox to format event page infoboxes.

Template parameters

Parameter		Description	Type	Status
(Override automatic) ad	ad	If the ad MUST have a different name than the standard convention, specify a value to override automatic ad image grabbing.	String	optional
(EventBox) type	type	Passes EventBox type, to this template, to determine automatic banner type.	String	optional
(EventBox) vip	vip	Passes EventBox VIP value (if exists) to this template to set VIP banners.	String	optional
(Override, page) 1	1 page	To override page name, specify a value. Default {{PAGENAME}}	Page name	optional
(Optional) debug	debug	Specify any value to output in debug mode (plain text instead of an image).	String	optional