Module:Item/doc: Difference between revisions

From Space Station 14 Wiki
(Adding images for items)
(→‎Adding items: added example)
Line 13: Line 13:
An item can have as many names as you wish, but it must have at least one.
An item can have as many names as you wish, but it must have at least one.
The first name listed will be used as a «main» name in various lookups, so it's generally should be the name used by the game.
The first name listed will be used as a «main» name in various lookups, so it's generally should be the name used by the game.
{{Callout|Example
|For coils, the game has 3 item IDs: {{c|CableHVStack}} (hv), {{c|CableMVStack}} (mv), {{c|CableApcStack}} (lv).
These three allow to configure a single icon for each coil variation, but the game has more variations per type of coil depending on how many coils are left in stack. For instance, for 20 HV coils the icon will change to {{item|hv20|l=}}, and when there are 10 or less - to {{item|hv10|l=}}.
To support more icons per item, we can just add more "fake" item IDs, give them any name we want and then define icons for them.
}}


== Adding images for items ==
== Adding images for items ==

Revision as of 12:31, 17 August 2024

Module documentation
View or edit this documentation (about module documentation)

Contains utilities for working with in-game items.

Adding items

To add more items, go to Module:Item/item names by item id.json.

It is a JSON file containing an object with keys being the item in-game IDs, but also allows custom IDs for displaying items such as coil variations.

Each item has a list of names. These are used for various lookups. An item can have as many names as you wish, but it must have at least one. The first name listed will be used as a «main» name in various lookups, so it's generally should be the name used by the game.

Example
For coils, the game has 3 item IDs: CableHVStack (hv), CableMVStack (mv), CableApcStack (lv).

These three allow to configure a single icon for each coil variation, but the game has more variations per type of coil depending on how many coils are left in stack. For instance, for 20 HV coils the icon will change to Lua error in Module:Item at line 83: item generation failed: no item was found by ID/name 'hv20'., and when there are 10 or less - to .

To support more icons per item, we can just add more "fake" item IDs, give them any name we want and then define icons for them.

Adding images for items

To add images for items, go to Module:Item/item image files by item id.json.

It is a JSON file containing an object with keys being the item in-game IDs, but also allows custom IDs for displaying items such as coil variations.

Warning
For items to show up, they must also be added as items.

The value of an item is its icon filename.

To see if icons do work, look at newly-added items in the list of items in {{item}}.