This wiki has a lot of different tournament bracket templates to create all kind of brackets.
This page explains which templates exist, how they work, and how they can be used.
General infos
There are two types of tournament brackets in use on the Puroresu System Wiki:
- Templates using the Lua module TeamBracket.
This module allows for the creation of many different templates and offers various options.
Bracket templates using this module are collected in the category Team bracket templates using the Lua module.
- Templates using static html tables.
Some specific brackets that cannot be created by the module use a static html table design imitating the look of the module-produced brackets. They are less flexible and have fewer options.
These type of bracket templates are collected in the category Team bracket templates using static html tables.
Both types use the same general syntax for the possible parameters. However, the static table templates are limited to the options implemented into the given template, while the module-created templates can use all additional module parameters if needed.
Which bracket should I use?
- For regular team numbers (i.e. 2 / 4 / 8 / 16 / 32 / 64 teams) use the corresponding bracket template.
- For irregular brackets (anything outside the above), there is either a specific template (3-team & 6-team-bracket), or else one of the n-round brackets can be used. The latter exist for 3, 4, and 5 rounds. These can be used for 5+7, 9-15, and 17-31 teams, respectively.
For tournaments above 32 teams (which at the time of writing this help page do not exist on this wiki), the 64-team-bracket can be used, using additional module parameters to allow byes.
- For even more specific cases, like tournaments including games with 3 or 4 teams, there are a few special templates. These are all static table templates and can therefore be found in that category.
How to find a bracket?
All available team brackets are collected in the category Tournament bracket templates.
There are further subcategories for number of teams, number of rounds, or template type.
- → Show/hide the list of bracket categories.
By number of teams By number of rounds By other criteria
Bracket types
Module brackets
Most brackets on this wiki use the module mentioned above. It is very flexible and allows for many options, including:
- Number of rounds
- Number of teams
- Custom round titles
- Byes
- Display of a 3rd place game
- Set the alignment of the bracket
- Set the width of the seed, team, and score fields
- Line break handling
- → Show/hide the list of all currenty available templates using the module.
Regular brackets Irregular brackets {{2TeamBracket}} [usage] {{3TeamBracket}} [usage] {{4TeamBracket}} [usage] {{6TeamBracket}} [usage] {{8TeamBracket}} [usage] {{3RoundBracket-Byes}} [usage] {{16TeamBracket}} [usage] {{4RoundBracket-Byes}} [usage] {{32TeamBracket}} [usage] {{5RoundBracket-Byes}} [usage] {{64TeamBracket}} [usage]
Static brackets
Very specific templates which the module cannot create use a static html table design. They look the same and use the same syntax, but have fewer options than the module-created brackets. However, all static brackets allow for:
- Custom round titles
- Alignment of the bracket
- Width of the seed, team, and score fields (if applicable)
- Line break handling
- → Show/hide the list of all currenty available templates using the static tables.
Static table brackets {{3TeamBracket1Round}} [usage] {{3TeamBracket2Rounds}} [usage] {{6TeamBracket2Rounds}} [usage] {{6TeamBracket-3WayFinal}} [usage] {{8TeamBracket-4WayFinal}} [usage]
Usage & parameters
- Note
- For detailed infos about a template's parameters and its predefined settings, always look at that template's documentation.
- This section only describes some general pattern in the parameters in use.
Bracket field parameters
Team field parameters
- Brackets have generally 3 available fields per team: Seed, team name, and score.
- The seed field is usually only drawn if its parameter is defined, while the other two are always shown.
- General pattern for all fields is
RDn-xxxxm
RD
stands for "round".n
stands for the number of the round.xxxx
stands for "seed", "team", or "score", representing the 3 available fields mentioned above.m
stands for the position of the field in the round, always counted from top.
- 3rd place games:
- 3rd place game parameters use the designator of the last round, with a "b" attached, e.g.
RD3b
for a 3-round bracket.
- Examples:
RD1-seed1
Seed field of the first team in round 1 (usually only drawn if defined) RD1-team1
Team name of the first team in round 1 RD1-score1
Score of the first team in round 1 RD3-team8
Team name of the eighth team in round 3, counted from the top of that round RD2b-team2
Team name of the second team in the 3rd place game in a 2 round bracket
Round titles
- Round titles use
RDn
- Examples:
RD1
RD2
...Custom title for the corresponding round RD3b
Custom title for the 3rd place game in a 3-round bracket Note that all brackets have default titles that make most sense for the specific type of bracket.
See each template's documentation for details.
Groups
- Group names use
RDn-groupm
- The number of available groups depends on the bracket and the number of rounds.
- → See the example on the 64-team bracket template for all possible groups on the largest bracket available.
Layout parameters
- Layout parameters include the alignment of the bracket, line break behavior inside the fields, and width of the fields.
- Some more parameters may be available for the brackets using the Lua module, see its full list of parameters below.
Alignment
- Brackets are aligned left by default and act as a block element, meaning text outside the bracked does not wrap around it.
- Available options are:
- center - Centers the bracket on the page.
- left/right - Turns the bracket into a floating object where text outside the bracket wraps around it.
- The parameters to use these options are
align
orfloat
. (either of them can be used for all options)
- → See the examples on the 2-team bracket template for a demonstration of the behavior of left / right / center.
Field widths
- The 3 available team fields (seed, team name, score) have default widths defined.
- These defaults are 25px, 160px and 40px, respectively.
- Some larger brackets (4 rounds and up) have a smaller default for the team name field, see the individual template's documentation.
- These widths can be changed with parameters if needed. (→ see also the "nowrap" option below, which most of the time makes more sense)
- Parameters to use for this are:
seed-width
team-width
score-width
- Values can be any valid css unit for module-generated templates.
- For the static table template, pixel (px) is the only allowed value and must be entered without the unit (number only).
Line breaks (nowrap)
- The parameter
nowrap
can be used to avoid text inside any field breaking into multiple lines. - This results in the fields taking the width they need for its content.
- This makes often sense, especially for smaller brackets (3 rounds or less), however it can also be undesired for some very long team names like groups with many names.
- By default, this option is activated on all bracket templates with 3 rounds or less, and not activated for brackets with more than 3 rounds.
- The option can be activated by defining the
nowrap
parameter withy
oryes
, or deactivated withn
orno
.
Copy/paste lists
- All bracket templates documentations include copy/paste-ready lists with all available field parameters for that template. See the tab "Parameter lists (copy/paste)" in the "Syntax & parameters" section of each template's doc. Most documentations provide more than one of such lists, like with or without seeds or a compact format.
- Most commonly used additional parameters are listed in the first tab of that section.
- Alternatively, the template {{TeamBracketParamCreate}} can be used to create any kind of parameter lists up to 64 team fields.
All module parameters
- Brackets using the Lua module can use additional parameters to the ones documented if needed.
- → Click here to show/hide the full list of module parameters.
- The full module documentation can be found here.
Parameter | Description |
---|---|
rounds |
Number of rounds. Use 1 for a 2 team bracket, 2 for a 4 team bracket, 3 for an 8 team bracket, etc.
|
maxround |
Maximum round to display. This parameter should be omitted unless it is less than the default value set by rounds .
|
seed-width |
The width of the cells for seeds. Plain numbers are assumed to be in px units (e.g., 25 or 25px 2em for 2em or auto for automatic width sizing)Default: 25px |
team-width |
The width of the cells for team names. Plain numbers are assumed to be in px units (e.g., 200 for 200px or 15em for 15em or auto for automatic width sizing)Default: 160px |
score-width |
The width of the cells for scores. Plain numbers are assumed to be in px units (e.g., 25 or 25px 2em for 2em or auto for automatic width sizing)Default: 40px |
compact |
Set to yes for compact bracket and to disable groups.
|
seeds |
Set to no to omit seed cells, and yes to always show seed cells
|
sets or legs |
The number of sets/legs in each round of matches (delimit with / for different numbers of sets or legs per round) |
nowrap |
Set to yes to prevent lines from wrapping
|
byes |
Set to 1 , 2 , ... to specify the maximum round number with byes
|
boldwinner |
Set to high to automatically bold the seed/team/scores for the team with the highest score, and low for the lowest score
|
hideomittedscores |
Set to 1 to hide all omitted score cells. To only omit score cells from the second set or leg onwards, use 2
|
sepwidth |
Set to 1 or 2 to override the default separator width
|
headings |
Set to no to omit the column headings
|
RDn |
The name of round n. Defaults are "Round of m", ..., "Quarterfinals", "Semifinals", and "Finals", where m is the number of teams in the round. |
RDn-groupm |
The name of group m in round n. For each round, every set of four teams is classified as a group. |
RDn-seedm |
The seed of team m in round n. For round 1, this value defaults to the conventional seed allocation for tournaments. If omitted, the cell is hidden. To hide seeds for round 1, the value must be explicitly set to be empty. m is the zero-padded position. |
RDn-teamm |
The name of team m in round n. |
RDn-scorem |
The score of team m in round n. |
RDn-scorem-s |
The score of team m in round n and set s (or leg for multileg matches). Alternatively, the last score in the round can be specified using the -agg suffix.
|
RD1-omit |
Selectively omit teams from the first round. For example, use 1 / 2 / 5 / 6 to omit team1, team2, team5, and team6 from the first round.
|
RD-shade |
Background color for the RDn headings
|
RDn-shadem-s |
Background coloring for team m in round n and set s (or leg for multileg matches). |
RDn-RDn+1-path |
Set to 0 to omit the path between round n and round n+1.
|
float or align |
Float the bracket to the left or right or center or centre of the page.
|
clear |
Set to no to prevent "clearing" the left/right side of the page before floating to the left/right. This parameter is only valid with |float|left or |float|right .
|
aggregate |
Set to sets or legs to sum the sets/legs won and append to the end of the scores. Set to score to sum the scores from each set/leg and append to the end of the scores. Set to y or yes to enable the -agg suffix, but without any auto computation. Only works when there are two or more legs/sets in the round. Any automatically computed value can be overridden by setting the value manually with the -agg suffix for the score.
|
| |
path-width |
This parameter can be used to define the width of the lines connecting the rounds. There are two of these lines, so the width between rounds is twice that value. Default is set to 8px (was 5px in the original module). Experimental. Be careful. |
class |
This parameter can be used to add one or several css classes to the table produced by the module. Note that all tables already have the class tbr added by default.
|
style |
This parameter can be used to add custom inline styles to the table. |
nocat |
This parameter can be used to suppress the categorization of pages the module is used on. By default, pages using this module are categorized into Pages using module TeamBracket. Define with any value to activate. |
Special cases not covered by any bracket
- There are specific brackets for many cases, but not for all.
- Sometimes, combining more than one bracket may be a solution.
- Some examples for this are shown below.
Display 3rd and 5th place game
- Module-generated brackets can display the 3rd place game with parameters, but not the 5th.
- There are several solutions for this, depending on the size of the main bracket.
Version 1
- If the main bracket is not too wide (3 rounds or less and with short team names), an additional 2-team (1-round) bracket could be placed beside it.
- This can be done by using
align = left
on both bracket templates. Then, in the second bracket, the option for the 3rd game can be used for the 5th game. - This displays nicely and even works on smaller screens, where the 2nd bracket is just moved below the first one if there is not enough space (change your browser's window size to see this happen).
- → Don't forget to use {{Clear left}} or {{-}} after the 2nd template!
Quarterfinals | Semifinals | Final | ||||||||||||
Third place | ||||
Fifth place | ||||
- Code:
{{8TeamBracket |align = left }} {{2TeamBracket | align = left | RD1 = Third place | RD1b = Fifth place }} {{Clear left}}
Version 2
- If the main bracket is too wide to place another one beside, other templates could also be placed below.
- To make it fit perfectly with the bracket above, some extra css has to be applied to the first lower bracket.
- This will of course only align that perfect if the field widths are default and
nowrap
is not set to "yes".
Quarterfinals | Semifinals | Final | ||||||||||||
Third place | ||||
Fifth place | ||||
- Code:
{{8TeamBracket | nowrap = no }} {{2TeamBracket | align = left | style = margin-left: 1em; margin-right: 8px; | RD1 = Third place }} {{2TeamBracket | align = left | RD1 = Fifth place }} {{Clear left}}
Version 3
- A third option is wrapping everything into a div with a defined max-width of the first bracket.
- Then use the 3rd place option in the first template, and add a 2-team bracket below.
- The second bracket needs to float right and have its margin corrected to align with the one above.
Quarterfinals | Semifinals | Final | ||||||||||||
Third place | ||||||||||||||
Fifth place | ||||
- Code:
<div style="max-width: fit-content;"> {{8TeamBracket | RD3b = Third place }} {{2TeamBracket | align = right | style = margin-right:2em; | RD1 = Fifth place }} </div>{{-}}