• Welcome to the Kancolle Wiki!
  • If you have any questions regarding site content, account registration, etc., please visit the KanColle Wiki Discord

Difference between revisions of "Template:MapBranchingTable/doc"

From Kancolle Wiki
Jump to navigation Jump to search
m
(Added missing premade colours/mixes)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Parameter Naming==
+
==Usage==
* <"From" Node> -> <"To" Node> = <argument value>  
+
Below is a list of all parameters available for this template.
 +
Keep in mind that invalid parameters and/or arguments will be ignored.
 +
 
 +
To invoke this template, simply start with:
 +
<pre>
 +
{{MapBranchingTable
 +
|<parameters>
 +
|<parameters>
 +
|<parameters>
 +
}}
 +
</pre>
 +
 
 +
===Title===
 +
* Allows you to set the title of the table
 +
* '''OPTIONAL'''
 +
* Default value is "Branching Rules" if not specified
 +
<pre>
 +
{{MapBranchingTable
 +
|title = <value>
 +
}}
 +
</pre>
 +
 
 +
===Id===
 +
* Allows you to manually set the id of the table. Rarely useful, unless you want multiple tables to be affected by the same button.
 +
* '''OPTIONAL'''
 +
* Default value is a RNG generated through the [[Module:RemiLib|RemiLib]] if not specified.
 +
<pre>
 +
{{MapBranchingTable
 +
|id = <value>
 +
}}
 +
</pre>
 +
 
 +
===Width===
 +
* Allows you to set the width of the table. Value has to be a valid css width property.
 +
* Check the following [http://www.w3schools.com/cssref/pr_dim_width.asp link] if you're unfamiliar with css width properties.
 +
* '''OPTIONAL'''
 +
* Default is "auto" if not specified or if the value given is invalid.
 +
<pre>
 +
{{MapBranchingTable
 +
|width = <value>
 +
}}
 +
</pre>
 +
 
 +
===Order===
 +
* Allows you to manually set the order of the starting nodes listed from top to bottom.
 +
* '''Note''': Make sure you list all the relevant nodes!
 +
* '''OPTIONAL'''
 +
* Default is alphabetical ordering. This is not desirable if the first node happens to be G, while the second node is C for example.
 +
<pre>
 +
{{MapBranchingTable
 +
|order = G, D, C, Z
 +
|G -> A = *Text...
 +
|D -> A = *Text...
 +
|C -> A = *Text...
 +
|Z -> A = *Text...
 +
}}
 +
</pre>
 +
 
 +
===Branching Rules===
 +
* Creates nodes for your branching table.
 +
* '''REQUIRED'''
 +
 
 +
<"From" Node/[color]> -> <"To" Node/[color]> = <argument value> for single rows for each node <br />
 +
'''OR''' <br />
 +
<"From" Node/[color]> -> <"To" Node/[color]>,<"To" Node/[color]> = <argument value> for joint rows.
 +
*Valid node values are:
 
** 0 = Start
 
** 0 = Start
** 1, 2, 3, etc = Starting points, when a map has multiple starting points, depending on the branching rules.
+
** 1, 2, 3, etc = Starting points, when a map has multiple starting points.
** <Node>/battle = Red node, which is also the default if nothing is assigned
+
** A single alphabetical letter from A to Z
** <Node>/empty = Blue node
+
 
** <Node>/storm = Purple node
+
*To add a color to a node ('''OPTIONAL'''), add the following value behind the node:
** <Node>/resource = Green node
+
** <span style="color:#FF1744">/battle</span>, default if not specified
 +
** <span style="color:#64DD17">/resource</span>
 +
** <span style="color:#EA80FC">/storm</span>
 +
** <span style="color:#40C4FF">/empty</span>
 +
** <span style="color:#7E57C2">/night</span>
 +
** <span style="color:#7E57C2">/night</span><span style="color:#FF1744">day</span><span style="color:#7E57C2">_night</span><!--/nightday_night -->
 +
** <span style="color:#7E57C2">/night</span><span style="color:#FF1744">battle</span><span style="color:#40C4FF">_empty</span><!--/night_battle_empty-->
 +
** <span style="color:#FF1744">/am</span><span style="color:orange">bush</span><!--/ambush-->
 +
** Any other valid color value.
  
To assign a manual id for the tables, you can use "id = <value>". This is generally not necessary, unless you want some buttons to show/hide multiple branches for whatever reason you have. Either way, the option is there.
+
<pre>
 +
{{MapBranchingTable
 +
|title = Example
 +
|width = 30%
 +
|0 -> 1 =
 +
* Fleet contains a CL
 +
* Fleet does not meet the requirements to start at 2
 +
|0 -> 2 =  
 +
* Fleet contains no CL
 +
* Fleet contains CV(L)
 +
* Fleet contains CLT
 +
|0 -> 3 =
 +
* Fleet contains AP
  
To change the width of the table, you can use "width = auto" for a more compact table. If "width" is not stated, it will create a wide table that fits the screen on default. Table is always collapsed by default.
+
|1 -> A/storm, B/resource = * Random
 +
|2 -> C = * Fleet contains a CL
 +
|2 -> D/empty = * Does not meet the requirements to go to C
 +
|3 -> E/night = * Random
 +
|3 -> F/nightday_night = * Random
 +
|3 -> G/night_battle_empty = * Random
 +
|3 -> H/ambush = * Random
 +
}}
 +
</pre>
 +
{{MapBranchingTable
 +
|title = Example
 +
|width = 30%
 +
|0 -> 1 =
 +
* Fleet contains a CL
 +
* Fleet does not meet the requirements to start at 2
 +
|0 -> 2 =
 +
* Fleet contains no CL
 +
* Fleet contains CV(L)
 +
* Fleet contains CLT
 +
|0 -> 3 =
 +
* Fleet contains AP
  
With the use of a template, invoking the module through #invoke is no longer required and you can treat this module as a template.
+
|1 -> A/storm, B/resource = * Random
Each parameter line still requires a pipe character "|".
+
|2 -> C = * Fleet contains a CL
 +
|2 -> D/empty = * Does not meet the requirements to go to C
 +
|3 -> E/night = * Random
 +
|3 -> F/nightday_night = * Random
 +
|3 -> G/night_battle_empty = * Random
 +
|3 -> H/ambush = * Random
 +
}}
  
 
==Examples==
 
==Examples==
Line 19: Line 130:
 
<pre>
 
<pre>
 
{{MapBranchingTable
 
{{MapBranchingTable
|0 -> 1 = Some text...
+
|title = Example 1
|0 -> 2 = Some text...
+
|0 -> 1, 2 = Some text...
 
|1 -> A = Some text...
 
|1 -> A = Some text...
 
|1 -> B/resource = [[DD]], [[CL]]
 
|1 -> B/resource = [[DD]], [[CL]]
Line 30: Line 141:
 
</pre>
 
</pre>
 
{{MapBranchingTable
 
{{MapBranchingTable
|0 -> 1 = Some text...
+
|title = Example 1
|0 -> 2 = Some text...
+
|0 -> 1, 2 = Some text...
 
|1 -> A = Some text...
 
|1 -> A = Some text...
 
|1 -> B/resource = [[DD]], [[CL]]
 
|1 -> B/resource = [[DD]], [[CL]]
Line 71: Line 182:
 
|id = E-1
 
|id = E-1
 
|width = auto
 
|width = auto
|0 -> 1 = Some text...
+
|0 -> 1, 2, 3 = * Random
|0 -> 2 = Some text...
+
|Q -> = Invalid because there is no destination node
|1 -> A = Some text...
+
|QW -> SD = Invalid because there are more than 1 letters assigned per node
|1 -> B/resource = [[DD]], [[CL]]
+
}}
|1 -> C/storm =
+
 
* A
 
* list
 
|C/storm -> D/empty = ...
 
 
}}
 
}}
 
</pre>
 
</pre>
Line 84: Line 192:
 
|id = E-1
 
|id = E-1
 
|width = auto
 
|width = auto
|0 -> 1 = Some text...
+
|0 -> 1, 2, 3 = * Random
|0 -> 2 = Some text...
+
|Q -> = Invalid because there is no destination node. Ignored.
|1 -> A = Some text...
+
|QW -> SD = Invalid because there are more than 1 letters assigned per node. Ignored
|1 -> B/resource = [[DD]], [[CL]]
+
}}
|1 -> C/storm =
+
 
* A
+
===Example 4===
* list
+
<pre>
|C/storm -> D/empty = ...
+
{{MapBranchingTable
 +
|order = D, Z, C, G
 +
|G -> A = *Text...
 +
|D -> A = *Text...
 +
|C -> A = *Text...
 +
|Z -> A = *Text...
 +
}}
 +
</pre>
 +
{{MapBranchingTable
 +
|order = D, Z, C, G
 +
|G -> A = *Text...
 +
|D -> A = *Text...
 +
|C -> A = *Text...
 +
|Z -> A = *Text...
 
}}
 
}}
 +
 
==Credits==
 
==Credits==
 
Special thanks to がか(gaka) for writing this module.
 
Special thanks to がか(gaka) for writing this module.

Latest revision as of 15:01, 1 March 2023

Usage

Below is a list of all parameters available for this template. Keep in mind that invalid parameters and/or arguments will be ignored.

To invoke this template, simply start with:

{{MapBranchingTable
|<parameters>
|<parameters>
|<parameters>
}}

Title

  • Allows you to set the title of the table
  • OPTIONAL
  • Default value is "Branching Rules" if not specified
{{MapBranchingTable
|title = <value>
}}

Id

  • Allows you to manually set the id of the table. Rarely useful, unless you want multiple tables to be affected by the same button.
  • OPTIONAL
  • Default value is a RNG generated through the RemiLib if not specified.
{{MapBranchingTable
|id = <value>
}}

Width

  • Allows you to set the width of the table. Value has to be a valid css width property.
  • Check the following link if you're unfamiliar with css width properties.
  • OPTIONAL
  • Default is "auto" if not specified or if the value given is invalid.
{{MapBranchingTable
|width = <value>
}}

Order

  • Allows you to manually set the order of the starting nodes listed from top to bottom.
  • Note: Make sure you list all the relevant nodes!
  • OPTIONAL
  • Default is alphabetical ordering. This is not desirable if the first node happens to be G, while the second node is C for example.
{{MapBranchingTable
|order = G, D, C, Z
|G -> A = *Text...
|D -> A = *Text...
|C -> A = *Text...
|Z -> A = *Text...
}}

Branching Rules

  • Creates nodes for your branching table.
  • REQUIRED

<"From" Node/[color]> -> <"To" Node/[color]> = <argument value> for single rows for each node
OR
<"From" Node/[color]> -> <"To" Node/[color]>,<"To" Node/[color]> = <argument value> for joint rows.

  • Valid node values are:
    • 0 = Start
    • 1, 2, 3, etc = Starting points, when a map has multiple starting points.
    • A single alphabetical letter from A to Z
  • To add a color to a node (OPTIONAL), add the following value behind the node:
    • /battle, default if not specified
    • /resource
    • /storm
    • /empty
    • /night
    • /nightday_night
    • /nightbattle_empty
    • /ambush
    • Any other valid color value.
{{MapBranchingTable
|title = Example
|width = 30%
|0 -> 1 =
* Fleet contains a CL
* Fleet does not meet the requirements to start at 2
|0 -> 2 = 
* Fleet contains no CL
* Fleet contains CV(L)
* Fleet contains CLT
|0 -> 3 = 
* Fleet contains AP

|1 -> A/storm, B/resource = * Random
|2 -> C = * Fleet contains a CL
|2 -> D/empty = * Does not meet the requirements to go to C
|3 -> E/night = * Random
|3 -> F/nightday_night = * Random
|3 -> G/night_battle_empty = * Random
|3 -> H/ambush = * Random
}}
Example
Nodes Rules
Start
1
  • Fleet contains a CL
  • Fleet does not meet the requirements to start at 2
2
  • Fleet contains no CL
  • Fleet contains CV(L)
  • Fleet contains CLT
3
  • Fleet contains AP
1
A
  • Random
B
2
C
  • Fleet contains a CL
D
  • Does not meet the requirements to go to C
3
E
  • Random
F
  • Random
G
  • Random
H
  • Random


Examples

Example 1

{{MapBranchingTable
|title = Example 1
|0 -> 1, 2 = Some text...
|1 -> A = Some text...
|1 -> B/resource = [[DD]], [[CL]]
|1 -> C/storm =
* A
* list
|C/storm -> D/empty = ...
}}
Example 1
Nodes Rules
Start
1

Some text...

2
1
A

Some text...

B

DD, CL

C
  • A
  • list
C
D

...


Example 2

{{MapBranchingTable
|width = auto
|0 -> 1 = Some text...
|0 -> 2 = Some text...
|1 -> A = Some text...
|1 -> B/resource = [[DD]], [[CL]]
|1 -> C/storm =
* A
* list
|C/storm -> D/empty = ...
}}
Branching Rules
Nodes Rules
Start
1

Some text...

2

Some text...

1
A

Some text...

B

DD, CL

C
  • A
  • list
C
D

...


Example 3

{{MapBranchingTable
|id = E-1
|width = auto
|0 -> 1, 2, 3 = * Random
|Q -> = Invalid because there is no destination node
|QW -> SD = Invalid because there are more than 1 letters assigned per node
}}

}}
Branching Rules
Nodes Rules
Start
1
  • Random
2
3
QW
SD

Invalid because there are more than 1 letters assigned per node. Ignored


Example 4

{{MapBranchingTable
|order = D, Z, C, G
|G -> A = *Text...
|D -> A = *Text...
|C -> A = *Text...
|Z -> A = *Text...
}}
Branching Rules
Nodes Rules
D
A
  • Text...
Z
A
  • Text...
C
A
  • Text...
G
A
  • Text...


Credits

Special thanks to がか(gaka) for writing this module.