ItemPrototype - Prototype Docs

Home / Prototypes / ItemPrototype><

ItemPrototype 'item' changed

Possible configuration for all items.

Inherits from Prototype « PrototypeBase

Children

AmmoItemPrototype - 'ammo'
CapsulePrototype - 'capsule'
GunPrototype - 'gun'
ItemWithEntityDataPrototype - 'item-with-entity-data'
ItemWithLabelPrototype - 'item-with-label'
- ItemWithInventoryPrototype - 'item-with-inventory'
  - BlueprintBookPrototype - 'blueprint-book'
- ItemWithTagsPrototype - 'item-with-tags'
- SelectionToolPrototype - 'selection-tool'
  - BlueprintItemPrototype - 'blueprint'
  - CopyPasteToolPrototype - 'copy-paste-tool'
  - DeconstructionItemPrototype - 'deconstruction-item'
  - SpidertronRemotePrototype - 'spidertron-remote'
  - UpgradeItemPrototype - 'upgrade-item'
ModulePrototype - 'module'
RailPlannerPrototype - 'rail-planner'
SpacePlatformStarterPackPrototype - 'space-platform-starter-pack'
ToolPrototype - 'tool'
- ArmorPrototype - 'armor'
- RepairToolPrototype - 'repair-tool'

Properties

default

sorted

stack_size	:: ItemCountType	Count of items of the same name that can be stored in one inventory slot. [...]
Count of items of the same name that can be stored in one inventory slot. [...]
icons optional	:: array[IconData]	Can't be an empty array.
Can't be an empty array.
icon optional	:: FileName	Path to the icon file. [...]
Path to the icon file. [...]
icon_size optional	:: SpriteSizeType	The size of the square icon, in pixels. [...]
The size of the square icon, in pixels. [...]
dark_background_icons optional	:: array[IconData]	Can't be an empty array.
Can't be an empty array.
dark_background_icon optional	:: FileName	If this is set, it is used to show items in alt-mode instead of the normal item icon. [...]
If this is set, it is used to show items in alt-mode instead of the normal item icon. [...]
dark_background_icon_sizenew optional	:: SpriteSizeType	The size of the square icon, in pixels. [...]
The size of the square icon, in pixels. [...]
place_result optional	:: EntityID	Name of the EntityPrototype that can be built using this item. [...]
Name of the EntityPrototype that can be built using this item. [...]
place_as_equipment_resultnew optional	:: EquipmentID
fuel_category optional	:: FuelCategoryID	Must exist when a nonzero fuel_value is defined.
Must exist when a nonzero fuel_value is defined.
burnt_result optional	:: ItemID	The item that is the result when this item gets burned as fuel.
The item that is the result when this item gets burned as fuel.
spoil_resultnew optional	:: ItemID
plant_resultnew optional	:: EntityID
place_as_tile optional	:: PlaceAsTile
pictures optional	:: SpriteVariations	Used to give the item multiple different icons so that they look less uniform on belts. [...]
Used to give the item multiple different icons so that they look less uniform on belts. [...]
flags optional	:: ItemPrototypeFlags	Specifies some properties of the item.
Specifies some properties of the item.
spoil_ticksnew optional	:: uint32
fuel_value optional	:: Energy	Amount of energy the item gives when used as fuel. [...]
Amount of energy the item gives when used as fuel. [...]
fuel_acceleration_multiplier optional	:: double	Must be 0 or positive.
Must be 0 or positive.
fuel_top_speed_multiplier optional	:: double	Must be 0 or positive.
Must be 0 or positive.
fuel_emissions_multiplier optional	:: double
fuel_acceleration_multiplier_quality_bonusnew optional	:: double	Additional fuel acceleration multiplier per quality level. [...]
Additional fuel acceleration multiplier per quality level. [...]
fuel_top_speed_multiplier_quality_bonusnew optional	:: double	Additional fuel top speed multiplier per quality level. [...]
Additional fuel top speed multiplier per quality level. [...]
weightnew optional	:: Weight	The default weight is calculated automatically from recipes and falls back to UtilityConstants::default_item_weight.
The default weight is calculated automatically from recipes and falls back to UtilityConstants::default_item_weight.
ingredient_to_weight_coefficientnew optional	:: double
fuel_glow_color optional	:: Color	Colors the glow of the burner energy source when this fuel is burned. [...]
Colors the glow of the burner energy source when this fuel is burned. [...]
open_sound optional	:: Sound
close_sound optional	:: Sound
pick_soundnew optional	:: Sound
drop_soundnew optional	:: Sound
inventory_move_soundnew optional	:: Sound
default_import_locationnew optional	:: SpaceLocationID
color_hintnew optional	:: ColorHintSpecification	Only used by hidden setting, support may be limited.
Only used by hidden setting, support may be limited.
has_random_tintnew optional	:: bool
spoil_to_trigger_resultnew optional	:: SpoilToTriggerResult	Only loaded if `spoil_result` is not defined.
Only loaded if `spoil_result` is not defined.
destroyed_by_dropping_triggernew optional	:: Trigger	The effect/trigger that happens when an item is destroyed by being dropped on a TilePrototype marked as destroying dropped items. [...]
The effect/trigger that happens when an item is destroyed by being dropped on a TilePrototype marked as destroying dropped items. [...]
rocket_launch_products optional	:: array[ItemProductPrototype]
send_to_orbit_modenew optional	:: SendToOrbitMode	The way this item works when we try to send it to the orbit on its own. [...]
The way this item works when we try to send it to the orbit on its own. [...]
random_tint_colornew optional	:: Color	Randomly tints item instances on belts and in the world. [...]
Randomly tints item instances on belts and in the world. [...]
spoil_levelnew optional	:: uint8	Used by Inserters with spoil priority. [...]
Used by Inserters with spoil priority. [...]

Inherited from Prototype

factoriopedia_alternative optional	:: string	The ID type corresponding to the prototype that inherits from this. [...]
The ID type corresponding to the prototype that inherits from this. [...]

Inherited from PrototypeBase

type	:: string	Specifies the kind of prototype this is. [...]
Specifies the kind of prototype this is. [...]
name	:: string	Unique textual identification of the prototype. [...]
Unique textual identification of the prototype. [...]
order optional	:: Order	Used to order prototypes in inventory, recipes and GUIs. [...]
Used to order prototypes in inventory, recipes and GUIs. [...]
localised_name optional	:: LocalisedString	Overwrites the name set in the locale file. [...]
Overwrites the name set in the locale file. [...]
localised_description optional	:: LocalisedString	Overwrites the description set in the locale file. [...]
Overwrites the description set in the locale file. [...]
factoriopedia_descriptionnew optional	:: LocalisedString	Provides additional description used in factoriopedia.
Provides additional description used in factoriopedia.
subgroupnew optional	:: ItemSubGroupID	The name of an ItemSubGroup.
The name of an ItemSubGroup.
hiddennew optional	:: bool
hidden_in_factoriopedianew optional	:: bool
parameternew optional	:: bool	Whether the prototype is a special type which can be used to parametrize blueprints and doesn't have other function.
Whether the prototype is a special type which can be used to parametrize blueprints and doesn't have other function.
factoriopedia_simulationnew optional	:: SimulationDefinition	The simulation shown when looking at this prototype in the Factoriopedia GUI.
The simulation shown when looking at this prototype in the Factoriopedia GUI.

stack_size	:: ItemCountType	Count of items of the same name that can be stored in one inventory slot. [...]
Count of items of the same name that can be stored in one inventory slot. [...]
burnt_result optional	:: ItemID	The item that is the result when this item gets burned as fuel.
The item that is the result when this item gets burned as fuel.
close_sound optional	:: Sound
color_hintnew optional	:: ColorHintSpecification	Only used by hidden setting, support may be limited.
Only used by hidden setting, support may be limited.
dark_background_icon optional	:: FileName	If this is set, it is used to show items in alt-mode instead of the normal item icon. [...]
If this is set, it is used to show items in alt-mode instead of the normal item icon. [...]
dark_background_icon_sizenew optional	:: SpriteSizeType	The size of the square icon, in pixels. [...]
The size of the square icon, in pixels. [...]
dark_background_icons optional	:: array[IconData]	Can't be an empty array.
Can't be an empty array.
default_import_locationnew optional	:: SpaceLocationID
destroyed_by_dropping_triggernew optional	:: Trigger	The effect/trigger that happens when an item is destroyed by being dropped on a TilePrototype marked as destroying dropped items. [...]
The effect/trigger that happens when an item is destroyed by being dropped on a TilePrototype marked as destroying dropped items. [...]
drop_soundnew optional	:: Sound
flags optional	:: ItemPrototypeFlags	Specifies some properties of the item.
Specifies some properties of the item.
fuel_acceleration_multiplier optional	:: double	Must be 0 or positive.
Must be 0 or positive.
fuel_acceleration_multiplier_quality_bonusnew optional	:: double	Additional fuel acceleration multiplier per quality level. [...]
Additional fuel acceleration multiplier per quality level. [...]
fuel_category optional	:: FuelCategoryID	Must exist when a nonzero fuel_value is defined.
Must exist when a nonzero fuel_value is defined.
fuel_emissions_multiplier optional	:: double
fuel_glow_color optional	:: Color	Colors the glow of the burner energy source when this fuel is burned. [...]
Colors the glow of the burner energy source when this fuel is burned. [...]
fuel_top_speed_multiplier optional	:: double	Must be 0 or positive.
Must be 0 or positive.
fuel_top_speed_multiplier_quality_bonusnew optional	:: double	Additional fuel top speed multiplier per quality level. [...]
Additional fuel top speed multiplier per quality level. [...]
fuel_value optional	:: Energy	Amount of energy the item gives when used as fuel. [...]
Amount of energy the item gives when used as fuel. [...]
has_random_tintnew optional	:: bool
icon optional	:: FileName	Path to the icon file. [...]
Path to the icon file. [...]
icon_size optional	:: SpriteSizeType	The size of the square icon, in pixels. [...]
The size of the square icon, in pixels. [...]
icons optional	:: array[IconData]	Can't be an empty array.
Can't be an empty array.
ingredient_to_weight_coefficientnew optional	:: double
inventory_move_soundnew optional	:: Sound
open_sound optional	:: Sound
pick_soundnew optional	:: Sound
pictures optional	:: SpriteVariations	Used to give the item multiple different icons so that they look less uniform on belts. [...]
Used to give the item multiple different icons so that they look less uniform on belts. [...]
place_as_equipment_resultnew optional	:: EquipmentID
place_as_tile optional	:: PlaceAsTile
place_result optional	:: EntityID	Name of the EntityPrototype that can be built using this item. [...]
Name of the EntityPrototype that can be built using this item. [...]
plant_resultnew optional	:: EntityID
random_tint_colornew optional	:: Color	Randomly tints item instances on belts and in the world. [...]
Randomly tints item instances on belts and in the world. [...]
rocket_launch_products optional	:: array[ItemProductPrototype]
send_to_orbit_modenew optional	:: SendToOrbitMode	The way this item works when we try to send it to the orbit on its own. [...]
The way this item works when we try to send it to the orbit on its own. [...]
spoil_levelnew optional	:: uint8	Used by Inserters with spoil priority. [...]
Used by Inserters with spoil priority. [...]
spoil_resultnew optional	:: ItemID
spoil_ticksnew optional	:: uint32
spoil_to_trigger_resultnew optional	:: SpoilToTriggerResult	Only loaded if `spoil_result` is not defined.
Only loaded if `spoil_result` is not defined.
weightnew optional	:: Weight	The default weight is calculated automatically from recipes and falls back to UtilityConstants::default_item_weight.
The default weight is calculated automatically from recipes and falls back to UtilityConstants::default_item_weight.

Inherited from Prototype

factoriopedia_alternative optional	:: string	The ID type corresponding to the prototype that inherits from this. [...]
The ID type corresponding to the prototype that inherits from this. [...]

Inherited from PrototypeBase

name	:: string	Unique textual identification of the prototype. [...]
Unique textual identification of the prototype. [...]
type	:: string	Specifies the kind of prototype this is. [...]
Specifies the kind of prototype this is. [...]
factoriopedia_descriptionnew optional	:: LocalisedString	Provides additional description used in factoriopedia.
Provides additional description used in factoriopedia.
factoriopedia_simulationnew optional	:: SimulationDefinition	The simulation shown when looking at this prototype in the Factoriopedia GUI.
The simulation shown when looking at this prototype in the Factoriopedia GUI.
hiddennew optional	:: bool
hidden_in_factoriopedianew optional	:: bool
localised_description optional	:: LocalisedString	Overwrites the description set in the locale file. [...]
Overwrites the description set in the locale file. [...]
localised_name optional	:: LocalisedString	Overwrites the name set in the locale file. [...]
Overwrites the name set in the locale file. [...]
order optional	:: Order	Used to order prototypes in inventory, recipes and GUIs. [...]
Used to order prototypes in inventory, recipes and GUIs. [...]
parameternew optional	:: bool	Whether the prototype is a special type which can be used to parametrize blueprints and doesn't have other function.
Whether the prototype is a special type which can be used to parametrize blueprints and doesn't have other function.
subgroupnew optional	:: ItemSubGroupID	The name of an ItemSubGroup.
The name of an ItemSubGroup.

Properties

stack_size :: ItemCountType

Count of items of the same name that can be stored in one inventory slot. Must be 1 when the "not-stackable" flag is set.

Example

stack_size = 64

icons :: array[IconData] optional

Can't be an empty array.

icon :: FileName optional

Path to the icon file.

Mandatory if icons is not defined.

icon_size :: SpriteSizeType optional

Default: 64

The size of the square icon, in pixels. E.g. 32 for a 32px by 32px icon. Must be larger than 0.

Only loaded if icons is not defined.

dark_background_icons :: array[IconData] optional

Can't be an empty array.

dark_background_icon :: FileName optional

If this is set, it is used to show items in alt-mode instead of the normal item icon. This can be useful to increase the contrast of the icon with the dark alt-mode icon outline.

Path to the icon file.

Only loaded if dark_background_icons is not defined.

dark_background_icon_size :: SpriteSizeType optional new

Default: 64

The size of the square icon, in pixels. E.g. 32 for a 32px by 32px icon. Must be larger than 0.

Only loaded if dark_background_icons is not defined.

place_result :: EntityID optional

Default: ""

Name of the EntityPrototype that can be built using this item. If this item should be the one that construction bots use to build the specified place_result, set the "primary-place-result" item flag.

The localised name of the entity will be used as the in-game item name. This behavior can be overwritten by specifying localised_name on this item, it will be used instead.

Example

place_result = "wooden-chest"

place_as_equipment_result :: EquipmentID optional new

Default: ""

fuel_category :: FuelCategoryID optional

Default: ""

Must exist when a nonzero fuel_value is defined.

burnt_result :: ItemID optional

Default: ""

The item that is the result when this item gets burned as fuel.

spoil_result :: ItemID optional new

plant_result :: EntityID optional new

place_as_tile :: PlaceAsTile optional

PlaceAsTile :: struct

Properties

result :: TileID

condition :: CollisionMaskConnector

invert :: bool optional

Default: false

condition_size :: uint32

tile_condition :: array[TileID] optional

pictures :: SpriteVariations optional

Used to give the item multiple different icons so that they look less uniform on belts. For inventory icons and similar, icon/icons will be used. Maximum number of variations is 16.

When using sprites of size 64 (same as base game icons), the scale should be set to 0.5.

flags :: ItemPrototypeFlags optional

Specifies some properties of the item.

Example

flags = { "hide-from-bonus-gui" }

spoil_ticks :: uint32 optional new

Default: 0

fuel_value :: Energy optional

Default: "0J"

Amount of energy the item gives when used as fuel.

Mandatory if fuel_acceleration_multiplier, fuel_top_speed_multiplier or fuel_emissions_multiplier or fuel_glow_color are used.

Example

fuel_value = "12MJ"

fuel_acceleration_multiplier :: double optional

Default: 1.0

Must be 0 or positive.

fuel_top_speed_multiplier :: double optional

Default: 1.0

Must be 0 or positive.

fuel_emissions_multiplier :: double optional

Default: 1.0

fuel_acceleration_multiplier_quality_bonus :: double optional new

Additional fuel acceleration multiplier per quality level. Defaults to 30% of fuel_acceleration_multiplier - 1 if fuel_acceleration_multiplier is larger than 1. Otherwise defaults to 0.

Must be 0 or positive.

fuel_top_speed_multiplier_quality_bonus :: double optional new

Additional fuel top speed multiplier per quality level. Defaults to 30% of fuel_top_speed_multiplier - 1 if fuel_top_speed_multiplier is larger than 1. Otherwise defaults to 0.

Must be 0 or positive.

weight :: Weight optional new

The default weight is calculated automatically from recipes and falls back to UtilityConstants::default_item_weight.

ingredient_to_weight_coefficient :: double optional new

Default: 0.5

fuel_glow_color :: Color optional

Colors the glow of the burner energy source when this fuel is burned. Can also be used to color the glow of reactors burning the fuel, see ReactorPrototype::use_fuel_glow_color.

open_sound :: Sound optional

close_sound :: Sound optional

pick_sound :: Sound optional new

drop_sound :: Sound optional new

inventory_move_sound :: Sound optional new

default_import_location :: SpaceLocationID optional new

Default: "nauvis"

color_hint :: ColorHintSpecification optional new

Only used by hidden setting, support may be limited.

has_random_tint :: bool optional new

Default: true

spoil_to_trigger_result :: SpoilToTriggerResult optional new

Only loaded if spoil_result is not defined.

destroyed_by_dropping_trigger :: Trigger optional new

The effect/trigger that happens when an item is destroyed by being dropped on a TilePrototype marked as destroying dropped items.

This overrides the TilePrototype::default_destroyed_dropped_item_trigger from the tile.

rocket_launch_products :: array[ItemProductPrototype] optional

send_to_orbit_mode :: SendToOrbitMode optional new

Default: "not-sendable"

The way this item works when we try to send it to the orbit on its own.

When "manual" is set, it can only be launched by pressing the launch button in the rocket silo.

When "automated" is set, it will force the existence of "launch to orbit automatically" checkBox in the rocket silo which will then force the silo to automatically send the item to orbit when present.

random_tint_color :: Color optional new

Default: Value of UtilityConstants::item_default_random_tint_strength

Randomly tints item instances on belts and in the world. 0 no tinting. 1 full tint.

spoil_level :: uint8 optional new

Default: 0

Used by Inserters with spoil priority. Item with higher spoil level is considered more spoiled than item with lower spoil level regardless of progress of spoiling

Factorio Prototype DocsVersion 2.0.26

ItemPrototype 'item' changed

Properties

Properties

stack_size :: ItemCountType

Example

icons :: array[IconData] optional

icon :: FileName optional

icon_size :: SpriteSizeType optional

dark_background_icons :: array[IconData] optional

dark_background_icon :: FileName optional

dark_background_icon_size :: SpriteSizeType optional new

place_result :: EntityID optional

Example

place_as_equipment_result :: EquipmentID optional new

fuel_category :: FuelCategoryID optional

burnt_result :: ItemID optional

spoil_result :: ItemID optional new

plant_result :: EntityID optional new

place_as_tile :: PlaceAsTile optional

PlaceAsTile :: struct

Properties

result :: TileID

condition :: CollisionMaskConnector

invert :: bool optional

condition_size :: uint32

tile_condition :: array[TileID] optional

pictures :: SpriteVariations optional

flags :: ItemPrototypeFlags optional

Example

spoil_ticks :: uint32 optional new

fuel_value :: Energy optional

Example

fuel_acceleration_multiplier :: double optional

fuel_top_speed_multiplier :: double optional

fuel_emissions_multiplier :: double optional

fuel_acceleration_multiplier_quality_bonus :: double optional new

fuel_top_speed_multiplier_quality_bonus :: double optional new

weight :: Weight optional new

ingredient_to_weight_coefficient :: double optional new

fuel_glow_color :: Color optional

open_sound :: Sound optional

close_sound :: Sound optional

pick_sound :: Sound optional new

drop_sound :: Sound optional new

inventory_move_sound :: Sound optional new

default_import_location :: SpaceLocationID optional new

color_hint :: ColorHintSpecification optional new

has_random_tint :: bool optional new

spoil_to_trigger_result :: SpoilToTriggerResult optional new

destroyed_by_dropping_trigger :: Trigger optional new

rocket_launch_products :: array[ItemProductPrototype] optional

send_to_orbit_mode :: SendToOrbitMode optional new

random_tint_color :: Color optional new

spoil_level :: uint8 optional new

Prototypes

Types

Defines

Factorio Prototype Docs Version 2.0.26