Template:DropTable: Difference between revisions

From bg3.wiki
Jump to navigation Jump to search
m (add alias doc)
(add droptablelevel)
Line 30: Line 30:
Empty ready-to-copy template.
Empty ready-to-copy template.
<pre>{{DropTableRow|icon=|item=|quantity=|rarity=}}</pre>
<pre>{{DropTableRow|icon=|item=|quantity=|rarity=}}</pre>
=== {{[[Template:DropTableLevel]]}} ===
Denote a leveled section of a drop table. Lower and upper are optional.
<pre>{{DropTableLevel|lower=|upper=}}</pre>


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


<pre>{{DropTableDivider|}}</pre>
<pre>{{DropTableDivider|}}</pre>
Line 63: Line 68:
====Levelled tables can use [[Template:DropTableDivider]].====
====Levelled tables can use [[Template:DropTableDivider]].====
{{DropTableStart}}
{{DropTableStart}}
{{DropTableDivider|Level 1 - 3}}
{{DropTableLevel|upper=3}}
{{DropTableGold|lower=5|upper=93}}
{{DropTableGold|lower=5|upper=93}}
{{DropTableDivider|Level 4 - 9}}
{{DropTableLevel|lower=4|upper=9}}
{{DropTableGold|lower=5|upper=93|rarity=1/2}}
{{DropTableGold|lower=5|upper=93|rarity=1/2}}
{{DropTableGold|lower=20|upper=159|rarity=1/2}}
{{DropTableGold|lower=20|upper=159|rarity=1/2}}
{{DropTableDivider|Level 10+}}
{{DropTableLevel|lower=10}}
{{DropTableGold|lower=5|upper=93|rarity=1/3}}
{{DropTableGold|lower=5|upper=93|rarity=1/3}}
{{DropTableGold|lower=20|upper=159|rarity=1/3}}
{{DropTableGold|lower=20|upper=159|rarity=1/3}}

Revision as of 09:39, 14 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.|skip_chance=If non-empty will hide the Chance column.}}

{{DropTableRow}}

The meat and potatoes of a drop table, each invocation of this template adds an item row to the drop table. If an icon or icon_override is specified, that icon is used. Otherwise, the icon is automatically fetched and included, if one exists.

{{DropTableRow
|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.
|icon=(optional) An image without the File: prefix. If provided, overrides the automatic Cargo icon.
|rarity_override=(optional) If icon is specified, will set the rarity.
|note=(optional) A note to add on the item link. It will be inserted as-is, so use the <ref> tag.
|skip_chance=If non-empty will hide the Chance column.
|alias=(optional) If specified, will rename the item link to this.
}}

<ref> documentation

Empty ready-to-copy template.

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

{{Template:DropTableLevel}}

Denote a leveled section of a drop table. Lower and upper are optional.

{{DropTableLevel|lower=|upper=}}

{{Template:DropTableDivider}}

Creates a whole-table row with text in it.

{{DropTableDivider|}}

{{Template:DropTableGold}}

Creates a row that displays an amount or range of gold. The icon is automatically set to the lower number provided.

{{DropTableGold|lower=|upper=}}

{{Template:TraderGoldRow}}

Creates a row that displays the amount of gold a trader of a given level and wealth would have.

{{TraderGoldRow|lower=|upper=|wealth=}}

{{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
Definitely Not a Healing Potion 2 1/25

Levelled tables can use Template:DropTableDivider.

Item Quantity Chance
Up to level 3
Gold 5 - 93 Always
Level 4 - 9
Gold 5 - 93 Always
Gold 20 - 159 Always
Level 10+
Gold 5 - 93 Always
Gold 20 - 159 Always
Gold 100 - 250 Always

Items you always get should have a Rarity of Always.

Item Quantity Chance
Padded Armour +1 1 Always
Titanstring Bow 1 Always

No Chance column

Item Quantity
Elixir of Necrotic Resistance 1
If you are a spooky scary skeleton, shivering in the night:
Elixir of Necrotic Resistance 2

(with only skip chance on table start)

Item Quantity
Elixir of Necrotic Resistance 1
If you are a spooky scary skeleton, shivering in the night:
Elixir of Necrotic Resistance 2