Module:Item/doc

From Space Station 14 Wiki
Revision as of 12:31, 17 August 2024 by Aliser (talk | contribs) (→‎Adding items: added example)

This is the documentation page for Module:Item

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}}.