Prototype/SelectionTool: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(Set prototype parent)
(Converted to SMW format)
Line 1: Line 1:
{{Prototype parent|Prototype/ItemWithLabel}}
{{Prototype parent|Prototype/ItemWithLabel}}
Used in the base game as a base for the blueprint item and the deconstruction item.


== Basics ==
{{Prototype TOC|selection-tool}}
Prototype type: '''selection-tool'''
 
Used in the base game as a base for the blueprint item and the deconstruction item. Extends [[Prototype/ItemWithLabel]].


== Extensions ==
== Extensions ==
Line 15: Line 13:
This prototype inherits all the properties from [[Prototype/ItemWithLabel]].
This prototype inherits all the properties from [[Prototype/ItemWithLabel]].


=== selection_color ===
{{Prototype property|selection_color|[[Types/Color|Color]]}}
'''Type''': [[Types/Color]]
 
The color of the rectangle used when standard selection is done in-game.
The color of the rectangle used when standard selection is done in-game.


=== alt_selection_color ===
{{Prototype property|alt_selection_color|[[Types/Color|Color]]}}
'''Type''': [[Types/Color]]
 
The color of the rectangle used when alt-selection is done in-game.
The color of the rectangle used when alt-selection is done in-game.


=== selection_mode ===
{{Prototype property|selection_mode|[[Types/table|table]] of [[Types/string|string]]}}
'''Type''': [[Types/table]] of [[Types/string]]
 
A list of selection mode flags that define how the selection tool selects things in-game.
A list of selection mode flags that define how the selection tool selects things in-game.


Line 74: Line 66:
|}
|}


=== alt_selection_mode ===
{{Prototype property|alt_selection_mode|[[Types/table|table]] of [[Types/string|string]]}}
'''Type''': [[Types/table]] of [[Types/string]]
 
A list of selection mode flags that define how the selection tool alt-selects things in-game. Possible values are identical to normal selection_mode.
A list of selection mode flags that define how the selection tool alt-selects things in-game. Possible values are identical to normal selection_mode.


=== selection_cursor_box_type ===
{{Prototype property|selection_cursor_box_type|[[Types/string|string]]}}
'''Type''': [[Types/string]]
 
The type of cursor box used to render selection of entities/tiles when standard selecting.
The type of cursor box used to render selection of entities/tiles when standard selecting.


Line 104: Line 92:
|}
|}


=== alt_selection_cursor_box_type ===
{{Prototype property|alt_selection_cursor_box_type|[[Types/string|string]]}}
'''Type''': [[Types/string]]
 
The type of cursor box used to render selection of entities/tiles when alt selecting.  Possible values are identical to normal selection_cursor_box_type.
The type of cursor box used to render selection of entities/tiles when alt selecting.  Possible values are identical to normal selection_cursor_box_type.


== Optional properties ==
== Optional properties ==


=== always_include_tiles ===
{{Prototype property|always_include_tiles|[[Types/bool|bool]]|false|optional=true}}
'''Type''': [[Types/bool]]
 
'''Default''': false
 
If tiles should be included in the selection regardless of entities also being in the selection. This is a visual only setting.
If tiles should be included in the selection regardless of entities also being in the selection. This is a visual only setting.


=== show_in_library ===
{{Prototype property|show_in_library|[[Types/bool|bool]]|false|optional=true}}
'''Type''': [[Types/bool]]
 
'''Default''': false
 
Whether this is shown in the blueprint library.
Whether this is shown in the blueprint library.


=== mouse_cursor ===
{{Prototype property|mouse_cursor|[[Types/string|string]]|"selection-tool-cursor"|optional=true}}
'''Type''': [[Types/string]]
 
'''Default''': "selection-tool-cursor"
 
Name of a [[Prototype/MouseCursor]].
Name of a [[Prototype/MouseCursor]].


=== entity_filters ===
{{Prototype property|entity_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
'''Type''': [[Types/table]] of [[Types/string]]
 
Array of [[Prototype/Entity]] names.
Array of [[Prototype/Entity]] names.


=== alt_entity_filters ===
{{Prototype property|alt_entity_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
'''Type''': [[Types/table]] of [[Types/string]]
 
Array of [[Prototype/Entity]] names.
Array of [[Prototype/Entity]] names.


=== entity_type_filters ===
{{Prototype property|entity_type_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
'''Type''': [[Types/table]] of [[Types/string]]
 
=== alt_entity_type_filters ===
'''Type''': [[Types/table]] of [[Types/string]]


=== tile_filters ===
{{Prototype property|alt_entity_type_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
'''Type''': [[Types/table]] of [[Types/string]]


{{Prototype property|tile_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
Array of [[Prototype/Tile]] names.
Array of [[Prototype/Tile]] names.


=== alt_tile_filters ===
{{Prototype property|alt_tile_filters|[[Types/table|table]] of [[Types/string|string]]|optional=true}}
'''Type''': [[Types/table]] of [[Types/string]]
 
Array of [[Prototype/Tile]] names.
Array of [[Prototype/Tile]] names.


=== entity_filter_mode ===
{{Prototype property|entity_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
'''Type''': [[Types/string]]
 
'''Default''': "whitelist"
 
One of "whitelist" and "blacklist".
One of "whitelist" and "blacklist".


=== alt_entity_filter_mode ===
{{Prototype property|alt_entity_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
'''Type''': [[Types/string]]
 
'''Default''': "whitelist"
 
One of "whitelist" and "blacklist".
One of "whitelist" and "blacklist".


=== tile_filter_mode ===
{{Prototype property|tile_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
'''Type''': [[Types/string]]
 
'''Default''': "whitelist"
 
One of "whitelist" and "blacklist".
One of "whitelist" and "blacklist".


=== alt_tile_filter_mode ===
{{Prototype property|alt_tile_filter_mode|[[Types/string|string]]|"whitelist"|optional=true}}
'''Type''': [[Types/string]]
 
'''Default''': "whitelist"
 
One of "whitelist" and "blacklist".
One of "whitelist" and "blacklist".

Revision as of 15:52, 26 July 2019

Template:Prototype parent Used in the base game as a base for the blueprint item and the deconstruction item.

Template:Prototype TOC

Extensions

Mandatory properties

This prototype inherits all the properties from Prototype/ItemWithLabel.

Template:Prototype property The color of the rectangle used when standard selection is done in-game.

Template:Prototype property The color of the rectangle used when alt-selection is done in-game.

Template:Prototype property A list of selection mode flags that define how the selection tool selects things in-game.

Possible values are:

Flag meaning
blueprint The normal rules for acceptable entities in blueprints
deconstruct The normal rules for acceptable entities for deconstruction
cancel-deconstruct The normal rules for acceptable entities for cancel deconstruction
items Item entities
trees Trees
buildable-type Buildable entities as defined by the game
nothing Nothing
items-to-place The entity has an item that builds the entity
any-entity Any entity
any-tile Any tile
same-force The entity force matches that of the player doing the selection
not-same-force The entity force does not match that of the player doing the selection
friend The entity force is friend to that of the player doing the selection
enemy The entity force is enemy to that of the player doing the selection
upgrade The normal rules for acceptable entities in upgrade planners
cancel-upgrade The normal rules for acceptable entities for cancel upgrade
entity-with-health
entity-with-force
entity-with-owner

Template:Prototype property A list of selection mode flags that define how the selection tool alt-selects things in-game. Possible values are identical to normal selection_mode.

Template:Prototype property The type of cursor box used to render selection of entities/tiles when standard selecting.

Possible values are:

Flag meaning
entity The normal entity selection box. Yellow by default.
electricity The selection box used to specify electric poles an entity is connected to. Light blue by default.
copy The selection box used when doing entity copy-paste. Green by default.
not-allowed The selection box used when specifying colliding entities. Red by default.
pair
logistics
train-visualization

Template:Prototype property The type of cursor box used to render selection of entities/tiles when alt selecting. Possible values are identical to normal selection_cursor_box_type.

Optional properties

Template:Prototype property If tiles should be included in the selection regardless of entities also being in the selection. This is a visual only setting.

Template:Prototype property Whether this is shown in the blueprint library.

Template:Prototype property Name of a Prototype/MouseCursor.

Template:Prototype property Array of Prototype/Entity names.

Template:Prototype property Array of Prototype/Entity names.

Template:Prototype property

Template:Prototype property

Template:Prototype property Array of Prototype/Tile names.

Template:Prototype property Array of Prototype/Tile names.

Template:Prototype property One of "whitelist" and "blacklist".

Template:Prototype property One of "whitelist" and "blacklist".

Template:Prototype property One of "whitelist" and "blacklist".

Template:Prototype property One of "whitelist" and "blacklist".