Template:DropTable: Difference between revisions

From bg3.wiki
Jump to navigation Jump to search
No edit summary
(→‎{{DropTableDivider}}: Fix template link)
Line 29: Line 29:
<pre>{{DropTableRow|icon=|item=|quantity=|rarity=}}</pre>
<pre>{{DropTableRow|icon=|item=|quantity=|rarity=}}</pre>


=== {{[[DropTableDivider]]}} ===
=== {{[[Template:DropTableDivider]]}} ===
Creates a whole-table row with text in it. This is useful for noting levelled sections of a drop table.
Creates a whole-table row with text in it. This is useful for noting levelled sections of a drop table.



Revision as of 10:16, 1 September 2023


The DropTable templates should be used to exhaustively describe drops. Drops is a loose term: they can include merchant stock, container contents, and, of course, the stuff you get from killing somebody. Drops are fixed but with some variance. They can depend on the player's level as well. The game files are the most thorough source of information, particularly `TreasureTable.txt`, though some drops are specified in level files and others in Character files. For example, Auntie Ethel can sell a Potion of Invisibility but this is not listed in the `DEN_Ethel` drop table.

Usage

{{DropTableStart}}

This template starts a table.

{{DropTableStart|caption=An optional caption to head the table.}}

{{DropTableRow}}

The meat and potatoes of a drop table, each invocation of this template adds an item row to the drop table.

{{DropTableRow
|icon=(optional) The item's icon. No File: prefix required. TODO: Take advantage of Cargo to automatically fetch icons from the item page.
|icon_override=(optional) The item's icon. This will be included directly into the template, so you will need to format it properly.
|item=The page name of the item. No square brackets required.
|quantity=How many of the item is dropped. It can be a range (e.g. 3 - 5) or a set of possibilities (1;3;5).
|rarity=The weight of the item in the drop table, specified as a fraction. Write "Always" for guaranteed drops.
|note=(optional) A note to add on the item link. It will be inserted as-is, so use the <ref> tag.
}}

<ref> documentation

Empty ready-to-copy template.

{{DropTableRow|icon=|item=|quantity=|rarity=}}

{{Template:DropTableDivider}}

Creates a whole-table row with text in it. This is useful for noting levelled sections of a drop table.

{{DropTableDivider|}}

{{DropTableEnd}}

No parameters. It ends the table.


A showcase of the DropTable templates

Miscellaneous Test Table

Describe how many times you roll on this table.

Item Quantity Chance
Potion of Healing 1;3;5 19/25
Potion of Superior Healing 1 1/5
Potion of Superior Healing 2 1/25

Levelled tables can use DropTableDivider.

Item Quantity Chance
Level 1 - 3
Gold 5 - 93 Always
Level 4 - 9
Gold 5 - 93 1/2
Gold 20 - 159 1/2
Level 10+
Gold 5 - 93 1/3
Gold 20 - 159 1/3
Gold 50 - 210 1/3

Items you always get should have a Rarity of Always.

Item Quantity Chance
Skull 1 Always
Skull 1 Always