factorio-types 1.2.58 → 1.2.60

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  // Factorio API reference https://lua-api.factorio.com/latest/index.html
3
3
  // Generated from JSON source https://lua-api.factorio.com/latest/prototype-api.json
4
4
  // Definition source https://github.com/sguest/factorio-types
5
- // Factorio version 2.0.77
5
+ // Factorio version 2.1.8
6
6
  // API version 6
7
7
 
8
8
  declare namespace prototype {
@@ -149,6 +149,14 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
149
149
  * When missing, all items with {@link plant result | prototype:ItemPrototype::plant_result} will be accepted. When provided, only items on this list that have plant result will be accepted.
150
150
  */
151
151
  accepted_seeds?: ItemID[];
152
+ /**
153
+ * Sets the {@link modules | prototype:ModulePrototype} and {@link beacon | prototype:BeaconPrototype} effects that are allowed to be used on this machine.
154
+ */
155
+ allowed_effects?: EffectTypeLimitation;
156
+ /**
157
+ * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
158
+ */
159
+ allowed_module_categories?: ModuleCategoryID[];
152
160
  arm_extending_sound?: InterruptibleSound;
153
161
  arm_extending_sound_source?: string;
154
162
  central_orienting_sound?: InterruptibleSound;
@@ -165,6 +173,7 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
165
173
  crane_energy_usage: Energy;
166
174
  draw_circuit_wires?: boolean;
167
175
  draw_copper_wires?: boolean;
176
+ effect_receiver?: EffectReceiver;
168
177
  energy_source: EnergySource;
169
178
  /**
170
179
  * The amount of energy this agricultural tower uses for each planted or harvested {@link plant | prototype:PlantPrototype}.
@@ -178,7 +187,7 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
178
187
  /**
179
188
  * The minimum radius of empty space a {@link plant | prototype:PlantPrototype} requires around it to be planted.
180
189
  *
181
- * Must be >= 0 and <= growth_grid_tile_size / 2
190
+ * Must be greater than or equal to 0 and less than or equal to `growth_grid_tile_size / 2`.
182
191
  */
183
192
  growth_area_radius?: double;
184
193
  /**
@@ -190,9 +199,17 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
190
199
  harvesting_procedure_points?: Vector3D[];
191
200
  harvesting_sound?: Sound;
192
201
  input_inventory_size: ItemStackIndex;
202
+ /**
203
+ * The number of module slots in this machine.
204
+ */
205
+ module_slots?: ItemStackIndex;
193
206
  output_inventory_size?: ItemStackIndex;
194
207
  planting_procedure_points?: Vector3D[];
195
208
  planting_sound?: Sound;
209
+ /**
210
+ * If set, {@link QualityPrototype::mining_drill_module_slots_bonus | prototype:QualityPrototype::mining_drill_module_slots_bonus} will be added to module slots count.
211
+ */
212
+ quality_affects_module_slots?: boolean;
196
213
  /**
197
214
  * The radius represents {@link grid tiles | prototype:AgriculturalTowerPrototype::growth_grid_tile_size} which are created around the agricultural tower from its {@link collision box | prototype:EntityPrototype::collision_box}.
198
215
  *
@@ -203,7 +220,7 @@ interface AgriculturalTowerPrototype extends EntityWithOwnerPrototype {
203
220
  /**
204
221
  * The maximum offset from the grid tile center which will be applied to the planting spot selected by this agricultural tower.
205
222
  *
206
- * Must be >= 0 and < 1.
223
+ * Must be greater than or equal to 0 and less than 1.
207
224
  */
208
225
  random_growth_offset?: double;
209
226
  /**
@@ -232,7 +249,7 @@ interface AirbornePollutantPrototype extends Prototype {
232
249
  localised_name_with_amount?: string;
233
250
  }
234
251
  /**
235
- * This prototype is used to make sound while playing the game. This includes the game's {@link music | https://store.steampowered.com/app/436090/Factorio__Soundtrack/}, composed by Daniel James Taylor.
252
+ * This prototype is used to make sound while playing the game. This includes the {@link base game's music | https://store.steampowered.com/app/436090/Factorio__Soundtrack/}, composed by Daniel James Taylor and the {@link Space Age's music | https://store.steampowered.com/app/3311770/Factorio_Space_Age__Soundtrack/}, composed by Petr Wajsar.
236
253
  * @example ```
237
254
  {
238
255
  type = "ambient-sound",
@@ -247,20 +264,64 @@ interface AirbornePollutantPrototype extends Prototype {
247
264
  ```
248
265
  */
249
266
  interface AmbientSound {
267
+ /**
268
+ * The track cannot play on specified planets.
269
+ *
270
+ * Can be used only if `play_on_all_surfaces` is true or `surface_names` are defined.
271
+ *
272
+ * Cannot be used when `planets` are defined.
273
+ */
274
+ exclude_planets?: SpaceLocationID[];
275
+ /**
276
+ * The track cannot play on surfaces with specified name. It's enough if the specified name is a sub-string of the surface name.
277
+ *
278
+ * Can be used only if `play_on_all_surfaces` is true or `surface_names` are defined.
279
+ *
280
+ * Cannot exclude a name given in `surface_names`.
281
+ */
282
+ exclude_surface_names?: string[];
250
283
  /**
251
284
  * Unique textual identification of the prototype.
252
285
  */
253
286
  name: string;
254
287
  /**
255
- * Track without a planet is bound to space platforms.
288
+ * The track can play only on specified planets.
289
+ *
290
+ * If neither `planets` nor `surface_names` is given, the track plays on space platforms and in the space map.
291
+ *
292
+ * Cannot be defined if `track_type` is `"script-track"`.
293
+ *
294
+ * Cannot be defined when `play_on_all_surfaces` is true.
295
+ */
296
+ planets?: SpaceLocationID[];
297
+ /**
298
+ * The track can play everywhere.
299
+ *
300
+ * Cannot be defined if `track_type` is `"hero-track"` or `"script-track"`.
301
+ *
302
+ * Cannot be true if `planets` or `surface_names` are defined.
256
303
  */
257
- planet?: SpaceLocationID;
304
+ play_on_all_surfaces?: boolean;
258
305
  /**
259
306
  * Static music track.
260
307
  *
261
308
  * One of `sound` or `variable_sound` must be defined. Both cannot be defined together.
262
309
  */
263
310
  sound?: Sound;
311
+ /**
312
+ * The track can play only on surfaces with specified names. It's enough if the specified name is a sub-string of the surface name.
313
+ *
314
+ * If neither `planets` nor `surface_names` is given, the track plays on space platforms and in the space map.
315
+ *
316
+ * Cannot be defined if `track_type` is `"hero-track"` or `"script-track"`.
317
+ *
318
+ * Cannot be defined when `play_on_all_surfaces` is true.
319
+ */
320
+ surface_names?: string[];
321
+ /**
322
+ * Alternative name of the track. It doesn't need to be unique.
323
+ */
324
+ title?: string;
264
325
  track_type: AmbientSoundType;
265
326
  /**
266
327
  * Specification of the type of the prototype.
@@ -275,7 +336,7 @@ interface AmbientSound {
275
336
  /**
276
337
  * Cannot be less than zero.
277
338
  *
278
- * Cannot be defined if `track_type` is `"hero-track"`.
339
+ * Cannot be defined if `track_type` is `"hero-track"` or `"script-track"`.
279
340
  */
280
341
  weight?: double;
281
342
  }
@@ -884,9 +945,8 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
884
945
  disabled_when_recipe_not_researched?: boolean;
885
946
  draw_circuit_wires?: boolean;
886
947
  draw_copper_wires?: boolean;
887
- enable_logistic_control_behavior?: boolean;
888
948
  /**
889
- * Only loaded when fixed_recipe is provided.
949
+ * Only loaded if `fixed_recipe` is defined.
890
950
  */
891
951
  fixed_quality?: QualityID;
892
952
  /**
@@ -981,12 +1041,15 @@ interface AsteroidCollectorPrototype extends EntityWithOwnerPrototype {
981
1041
  unpowered_arm_speed_scale?: float;
982
1042
  }
983
1043
  interface AsteroidPrototype extends EntityWithOwnerPrototype {
1044
+ /**
1045
+ * How much damage should entities and tiles get for each asteroid health point lost due to collision with these objects.
1046
+ */
1047
+ damage_per_hp?: float;
984
1048
  /**
985
1049
  * Emissions cannot be larger than zero, asteroids cannot produce pollution.
986
1050
  */
987
1051
  emissions_per_second?: Record<AirbornePollutantID, double>;
988
1052
  graphics_set?: AsteroidGraphicsSet;
989
- mass?: double;
990
1053
  }
991
1054
  /**
992
1055
  * A setting in the map creation GUI. Used by the {@link autoplace system | prototype:AutoplaceSpecification::control}.
@@ -1196,6 +1259,18 @@ interface BoilerPrototype extends EntityWithOwnerPrototype {
1196
1259
  * Note that `fire` and `fire_glow` alpha is set to the light intensity of the energy source, so 0 light intensity means the fire is invisible. For burner energy sources, the light intensity will reach zero rather quickly after the boiler runs out of fuel, effectively capping the time that `fire` and `fire_glow` will be shown after the boiler runs out of fuel.
1197
1260
  */
1198
1261
  burning_cooldown: uint16;
1262
+ circuit_connector?: [
1263
+ CircuitConnectorDefinition,
1264
+ CircuitConnectorDefinition,
1265
+ CircuitConnectorDefinition,
1266
+ CircuitConnectorDefinition
1267
+ ];
1268
+ /**
1269
+ * The maximum circuit wire distance for this entity.
1270
+ */
1271
+ circuit_wire_max_distance?: double;
1272
+ draw_circuit_wires?: boolean;
1273
+ draw_copper_wires?: boolean;
1199
1274
  energy_consumption: Energy;
1200
1275
  energy_source: EnergySource;
1201
1276
  /**
@@ -1340,6 +1415,10 @@ interface CarPrototype extends VehiclePrototype {
1340
1415
  auto_sort_inventory?: boolean;
1341
1416
  consumption: Energy;
1342
1417
  darkness_to_render_light_animation?: float;
1418
+ /**
1419
+ * Cannot be negative.
1420
+ */
1421
+ driving_sound_volume_modifier?: float;
1343
1422
  /**
1344
1423
  * Modifies the efficiency of energy transfer from burner output to wheels.
1345
1424
  */
@@ -1353,6 +1432,10 @@ interface CarPrototype extends VehiclePrototype {
1353
1432
  * If this car is immune to movement by belts.
1354
1433
  */
1355
1434
  has_belt_immunity?: boolean;
1435
+ /**
1436
+ * If this car gets damaged by driving into anything.
1437
+ */
1438
+ immune_to_all_impacts?: boolean;
1356
1439
  /**
1357
1440
  * If this car gets damaged by driving against {@link cliffs | prototype:CliffPrototype}.
1358
1441
  */
@@ -1401,11 +1484,16 @@ interface CarPrototype extends VehiclePrototype {
1401
1484
  turret_rotation_speed?: float;
1402
1485
  }
1403
1486
  interface CargoBayPrototype extends EntityWithOwnerPrototype {
1487
+ /**
1488
+ * When set to `true`, inserters will be able to take items out of this cargo bay when it is connected to a cargo landing pad.
1489
+ */
1490
+ allow_unloading?: boolean;
1404
1491
  /**
1405
1492
  * Has to be 2 for 2x2 grid.
1406
1493
  */
1407
1494
  build_grid_size?: 2;
1408
1495
  graphics_set?: CargoBayConnectableGraphicsSet;
1496
+ has_direction?: boolean;
1409
1497
  hatch_definitions?: CargoHatchDefinition[];
1410
1498
  /**
1411
1499
  * Cannot be 0.
@@ -1415,6 +1503,14 @@ interface CargoBayPrototype extends EntityWithOwnerPrototype {
1415
1503
  * A special variant which renders on space platforms. If not specified, the game will fall back to the regular graphics set.
1416
1504
  */
1417
1505
  platform_graphics_set?: CargoBayConnectableGraphicsSet;
1506
+ /**
1507
+ * Only relevant for cargo bays that have {@link allow_unloading | prototype:CargoBayPrototype::allow_unloading} set.
1508
+ *
1509
+ * When `false` this cargo bay will allow item unloading regardless of distance as long as it is connected to a cargo landing pad.
1510
+ *
1511
+ * When `true` this cargo bay will allow item unloading only when connected to a cargo landing pad and cargo bay is within distance limit set by {@link MaxCargoBayUnloadingDistanceModifier | prototype:MaxCargoBayUnloadingDistanceModifier} from that cargo landing pad.
1512
+ */
1513
+ use_unloading_distance_limit?: boolean;
1418
1514
  }
1419
1515
  interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
1420
1516
  cargo_station_parameters: CargoStationParameters;
@@ -1431,20 +1527,12 @@ interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
1431
1527
  * In chunks. The radius of how many chunks this cargo landing pad charts around itself.
1432
1528
  */
1433
1529
  radar_range?: uint32;
1434
- radar_visualisation_color?: Color;
1435
- /**
1436
- * Drawn when a robot brings/takes items from this landing pad.
1437
- */
1438
- robot_animation?: Animation;
1439
- /**
1440
- * Played when a robot brings/takes items from this landing pad. Only loaded if `robot_animation` is defined.
1441
- */
1442
- robot_animation_sound?: Sound;
1443
1530
  /**
1444
- * The offset from the center of this landing pad where a robot visually brings/takes items.
1531
+ * The visualisation used when showing cargo bay unloading distance limits.
1445
1532
  */
1446
- robot_landing_location_offset?: Vector;
1447
- robot_opened_duration?: uint8;
1533
+ radar_visualisation_color?: Color;
1534
+ radius_visualisation_picture?: Sprite;
1535
+ robot_door?: RobotDoorSpecification;
1448
1536
  trash_inventory_size?: ItemStackIndex;
1449
1537
  }
1450
1538
  interface CargoPodPrototype extends EntityWithOwnerPrototype {
@@ -1728,7 +1816,21 @@ interface CombatRobotPrototype extends FlyingRobotPrototype {
1728
1816
  idle?: RotatedAnimation;
1729
1817
  in_motion?: RotatedAnimation;
1730
1818
  light?: LightDefinition;
1819
+ /**
1820
+ * The maximum force that can be applied to separate from other friendly combat robots.
1821
+ */
1822
+ max_separation_force?: double;
1731
1823
  range_from_player?: double;
1824
+ /**
1825
+ * A factor determining how strongly the robot will try to separate from other friendly combat robots.
1826
+ *
1827
+ * Higher values result in stronger separation forces.
1828
+ */
1829
+ separation_force_factor?: double;
1830
+ /**
1831
+ * The range within which the robot will try to separate itself from other friendly combat robots.
1832
+ */
1833
+ separation_range?: double;
1732
1834
  shadow_idle?: RotatedAnimation;
1733
1835
  shadow_in_motion?: RotatedAnimation;
1734
1836
  time_to_live: uint32;
@@ -1867,15 +1969,22 @@ interface ConstructionRobotPrototype extends RobotWithLogisticInterfacePrototype
1867
1969
  working_light?: LightDefinition;
1868
1970
  }
1869
1971
  /**
1870
- * A generic container, such as a chest. Cannot be rotated.
1972
+ * A generic container, such as a chest.
1871
1973
  */
1872
1974
  interface ContainerPrototype extends EntityWithOwnerPrototype {
1873
- circuit_connector?: CircuitConnectorDefinition;
1975
+ /**
1976
+ * If given, there must be exactly `direction_count` elements in the table.
1977
+ */
1978
+ circuit_connector?: CircuitConnectorDefinition[];
1874
1979
  /**
1875
1980
  * The maximum circuit wire distance for this container.
1876
1981
  */
1877
1982
  circuit_wire_max_distance?: double;
1878
1983
  default_status?: EntityStatus;
1984
+ /**
1985
+ * Amount of directions this container should have. Allowed values are 1, 2 and 4.
1986
+ */
1987
+ direction_count?: uint8;
1879
1988
  draw_circuit_wires?: boolean;
1880
1989
  draw_copper_wires?: boolean;
1881
1990
  /**
@@ -1897,7 +2006,7 @@ interface ContainerPrototype extends EntityWithOwnerPrototype {
1897
2006
  /**
1898
2007
  * The picture displayed for this entity.
1899
2008
  */
1900
- picture?: Sprite;
2009
+ picture?: Sprite4Way;
1901
2010
  quality_affects_inventory_size?: boolean;
1902
2011
  }
1903
2012
  /**
@@ -2089,7 +2198,6 @@ interface CraftingMachinePrototype extends EntityWithOwnerPrototype {
2089
2198
  ```
2090
2199
  */
2091
2200
  fluid_boxes?: FluidBox[];
2092
- forced_symmetry?: Mirroring;
2093
2201
  graphics_set?: CraftingMachineGraphicsSet;
2094
2202
  graphics_set_flipped?: CraftingMachineGraphicsSet;
2095
2203
  ignore_output_full?: boolean;
@@ -2133,6 +2241,10 @@ interface CraftingMachinePrototype extends EntityWithOwnerPrototype {
2133
2241
  */
2134
2242
  show_recipe_icon_on_map?: boolean;
2135
2243
  trash_inventory_size?: ItemStackIndex;
2244
+ /**
2245
+ * Defaults to true if `vector_to_place_result` is given.
2246
+ */
2247
+ use_mirroring?: boolean;
2136
2248
  vector_to_place_result?: Vector;
2137
2249
  }
2138
2250
  /**
@@ -2482,16 +2594,13 @@ interface CustomInputPrototype extends Prototype {
2482
2594
  * - RALT
2483
2595
  * - RGUI
2484
2596
  * - MODE
2485
- * - AUDIONEXT
2486
- * - AUDIOPREV
2487
- * - AUDIOSTOP
2488
- * - AUDIOPLAY
2489
- * - AUDIOMUTE
2490
- * - MEDIASELECT
2491
- * - WWW
2492
- * - MAIL
2493
- * - CALCULATOR
2494
- * - COMPUTER
2597
+ * - MEDIA_NEXT_TRACK
2598
+ * - MEDIA_PREVIOUS_TRACK
2599
+ * - MEDIA_STOP
2600
+ * - MEDIA_PLAY
2601
+ * - MEDIA_PLAY_PAUSE
2602
+ * - MUTE
2603
+ * - MEDIA_SELECT
2495
2604
  * - AC_SEARCH
2496
2605
  * - AC_HOME
2497
2606
  * - AC_BACK
@@ -2499,18 +2608,10 @@ interface CustomInputPrototype extends Prototype {
2499
2608
  * - AC_STOP
2500
2609
  * - AC_REFRESH
2501
2610
  * - AC_BOOKMARKS
2502
- * - BRIGHTNESSDOWN
2503
- * - BRIGHTNESSUP
2504
- * - DISPLAYSWITCH
2505
- * - KBDILLUMTOGGLE
2506
- * - KBDILLUMDOWN
2507
- * - KBDILLUMUP
2508
- * - EJECT
2611
+ * - MEDIA_EJECT
2509
2612
  * - SLEEP
2510
- * - APP1
2511
- * - APP2
2512
- * - AUDIOREWIND
2513
- * - AUDIOFASTFORWARD
2613
+ * - MEDIA_REWIND
2614
+ * - MEDIA_FAST_FORWARD
2514
2615
  */
2515
2616
  key_sequence: string;
2516
2617
  /**
@@ -2577,10 +2678,6 @@ interface DeconstructionItemPrototype extends SelectionToolPrototype {
2577
2678
  * This property is hardcoded to `false`.
2578
2679
  */
2579
2680
  always_include_tiles?: boolean;
2580
- /**
2581
- * Can't be > 255.
2582
- */
2583
- entity_filter_count?: ItemStackIndex;
2584
2681
  /**
2585
2682
  * The {@link SelectionModeData::mode | prototype:SelectionModeData::mode} is hardcoded to `"deconstruct"`.
2586
2683
  *
@@ -2594,10 +2691,6 @@ interface DeconstructionItemPrototype extends SelectionToolPrototype {
2594
2691
  ```
2595
2692
  */
2596
2693
  stack_size: 1;
2597
- /**
2598
- * Can't be > 255.
2599
- */
2600
- tile_filter_count?: ItemStackIndex;
2601
2694
  }
2602
2695
  /**
2603
2696
  * Simple decorative purpose objects on the map, they have no health and some of them are removed when the player builds over. Usually used for grass patches, roots, small plants etc.
@@ -2772,6 +2865,14 @@ interface DisplayPanelPrototype extends EntityWithOwnerPrototype {
2772
2865
  circuit_wire_max_distance?: double;
2773
2866
  draw_circuit_wires?: boolean;
2774
2867
  draw_copper_wires?: boolean;
2868
+ /**
2869
+ * Maximum amount of message records that can be configured in this display panel when it is connected to circuit network. Must be >= 1.
2870
+ */
2871
+ max_records_count?: uint32;
2872
+ /**
2873
+ * Maximum length of the text. If the text exceeds this length all characters beyond the limit will be discarded.
2874
+ */
2875
+ max_text_length?: uint32;
2775
2876
  /**
2776
2877
  * The maximum display width of the text on the display panel. If the text exceeds this width it will be wrapped so that it continues on the next line.
2777
2878
  */
@@ -2917,6 +3018,27 @@ interface EditorControllerPrototype {
2917
3018
  show_status_icons: boolean;
2918
3019
  type: 'editor-controller';
2919
3020
  }
3021
+ /**
3022
+ * Provides or consumes power in equipment grids.
3023
+ */
3024
+ interface ElectricEnergyInterfaceEquipmentPrototype extends EquipmentPrototype {
3025
+ /**
3026
+ * @example ```
3027
+ energy_production = "500GW"
3028
+ ```
3029
+ */
3030
+ energy_production?: Energy;
3031
+ /**
3032
+ * @example ```
3033
+ energy_usage = "10kW"
3034
+ ```
3035
+ */
3036
+ energy_usage?: Energy;
3037
+ gui_mode?: 'all' | 'none' | 'admins';
3038
+ show_power_production_in_tooltip?: boolean;
3039
+ show_power_usage_in_tooltip?: boolean;
3040
+ show_stored_energy_in_tooltip?: boolean;
3041
+ }
2920
3042
  /**
2921
3043
  * Entity with electric energy source with that can have some of its values changed runtime. Useful for modding in energy consumers/producers.
2922
3044
  */
@@ -3017,6 +3139,10 @@ interface ElevatedCurvedRailAPrototype extends CurvedRailAPrototype {
3017
3139
  * The value `0` will be treated the same as `nil`.
3018
3140
  */
3019
3141
  selection_priority?: uint8;
3142
+ /**
3143
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3144
+ */
3145
+ tall?: boolean;
3020
3146
  }
3021
3147
  /**
3022
3148
  * An elevated curved-B rail.
@@ -3034,6 +3160,10 @@ interface ElevatedCurvedRailBPrototype extends CurvedRailBPrototype {
3034
3160
  * The value `0` will be treated the same as `nil`.
3035
3161
  */
3036
3162
  selection_priority?: uint8;
3163
+ /**
3164
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3165
+ */
3166
+ tall?: boolean;
3037
3167
  }
3038
3168
  /**
3039
3169
  * An elevated half diagonal rail.
@@ -3051,6 +3181,10 @@ interface ElevatedHalfDiagonalRailPrototype extends HalfDiagonalRailPrototype {
3051
3181
  * The value `0` will be treated the same as `nil`.
3052
3182
  */
3053
3183
  selection_priority?: uint8;
3184
+ /**
3185
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3186
+ */
3187
+ tall?: boolean;
3054
3188
  }
3055
3189
  /**
3056
3190
  * An elevated straight rail.
@@ -3068,6 +3202,10 @@ interface ElevatedStraightRailPrototype extends StraightRailPrototype {
3068
3202
  * The value `0` will be treated the same as `nil`.
3069
3203
  */
3070
3204
  selection_priority?: uint8;
3205
+ /**
3206
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3207
+ */
3208
+ tall?: boolean;
3071
3209
  }
3072
3210
  /**
3073
3211
  * Can spawn entities. Used for biter/spitter nests.
@@ -3116,6 +3254,10 @@ interface EnemySpawnerPrototype extends EntityWithOwnerPrototype {
3116
3254
  * Array of the {@link entities | prototype:EntityPrototype} that this spawner can spawn and their spawn probabilities. The sum of probabilities is expected to be 1.0. The array must not be empty.
3117
3255
  */
3118
3256
  result_units: UnitSpawnDefinition[];
3257
+ /**
3258
+ * Trigger that is activated when the spawner cannot find a valid spawn location.
3259
+ */
3260
+ spawn_blocked_trigger?: Trigger;
3119
3261
  /**
3120
3262
  * Decoratives to be created when the spawner is created by the {@link map generator | https://wiki.factorio.com/Map_generator}. Placed when enemies expand if `spawn_decorations_on_expansion` is set to true.
3121
3263
  */
@@ -3224,7 +3366,6 @@ interface EntityPrototype extends Prototype {
3224
3366
  * Used to specify the rules for placing this entity during map generation.
3225
3367
  */
3226
3368
  autoplace?: AutoplaceSpecification;
3227
- build_base_evolution_requirement?: double;
3228
3369
  /**
3229
3370
  * Supported values are 1 (for 1x1 grid) and 2 (for 2x2 grid, like rails).
3230
3371
  *
@@ -3427,6 +3568,10 @@ interface EntityPrototype extends Prototype {
3427
3568
  * The cursor size used when shooting at this entity.
3428
3569
  */
3429
3570
  shooting_cursor_size?: double;
3571
+ /**
3572
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
3573
+ */
3574
+ show_fluid_visualization_when_in_cursor?: boolean;
3430
3575
  stateless_visualisation?: StatelessVisualisation | StatelessVisualisation[];
3431
3576
  /**
3432
3577
  * Used to specify the area where the {@link sticker | prototype:StickerPrototype} animation can appear for entities that can have stickers on them.
@@ -3436,6 +3581,12 @@ interface EntityPrototype extends Prototype {
3436
3581
  */
3437
3582
  sticker_box?: BoundingBox;
3438
3583
  surface_conditions?: SurfaceCondition[];
3584
+ /**
3585
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
3586
+ *
3587
+ * Rail signals are always treated as 'tall' when built attached to elevated rails.
3588
+ */
3589
+ tall?: boolean;
3439
3590
  tile_buildability_rules?: TileBuildabilityRule[];
3440
3591
  tile_height?: int32;
3441
3592
  /**
@@ -3502,7 +3653,7 @@ interface EntityWithHealthPrototype extends EntityPrototype {
3502
3653
  dying_explosion?: ExplosionDefinition | ExplosionDefinition[];
3503
3654
  dying_trigger_effect?: TriggerEffect;
3504
3655
  /**
3505
- * The amount of health automatically regenerated per tick. The entity must be active for this to work.
3656
+ * The amount of health automatically regenerated per tick. If the value is in range [-0.0166, 0.0166], then healing is considered slow and will apply 60 * healing_per_tick once every second.
3506
3657
  * @example ```
3507
3658
  healing_per_tick = 0.01
3508
3659
  ```
@@ -3528,15 +3679,16 @@ interface EntityWithHealthPrototype extends EntityPrototype {
3528
3679
  loot =
3529
3680
  {
3530
3681
  {
3531
- count_max = 10,
3532
- count_min = 2,
3533
- item = "stone",
3534
- probability = 1
3682
+ type = "item",
3683
+ name = "stone",
3684
+ amount_min = 2,
3685
+ amount_max = 10,
3686
+ independent_probability = 1
3535
3687
  }
3536
3688
  }
3537
3689
  ```
3538
3690
  */
3539
- loot?: LootItem[];
3691
+ loot?: ItemProductPrototype[];
3540
3692
  /**
3541
3693
  * The unit health can never go over the maximum. Default health of units on creation is set to max. Must be greater than 0.
3542
3694
  * @example ```
@@ -3922,6 +4074,10 @@ interface FluidPrototype extends Prototype {
3922
4074
  * Also the minimum temperature of the fluid. Has to be lower than `max_temperature`.
3923
4075
  */
3924
4076
  default_temperature: float;
4077
+ /**
4078
+ * Whether the fluid should glow in pipe and storage tank windows.
4079
+ */
4080
+ draw_as_glow?: boolean;
3925
4081
  /**
3926
4082
  * Scales pollution generated when the fluid is consumed.
3927
4083
  */
@@ -3968,6 +4124,10 @@ interface FluidPrototype extends Prototype {
3968
4124
  */
3969
4125
  icons?: IconData[];
3970
4126
  max_temperature?: float;
4127
+ /**
4128
+ * Fluid and amount produced per 1 unit of fluid consumed. Used by Generator only if {@link GeneratorPrototype::spent_fluid | prototype:GeneratorPrototype::spent_fluid} is not set and it has {@link GeneratorPrototype::output_fluid_box | prototype:GeneratorPrototype::output_fluid_box}. Used by FluidEnergySource only if {@link FluidEnergySource::spent_fluid | prototype:FluidEnergySource::spent_fluid} is not set and it has {@link FluidEnergySource::output_fluid_box | prototype:FluidEnergySource::output_fluid_box}.
4129
+ */
4130
+ spent_fluid?: SpentFluidSpecification;
3971
4131
  /**
3972
4132
  * Color to use for visualization. This color should be vibrant and easily distinguished.
3973
4133
  *
@@ -4064,7 +4224,7 @@ interface FluidTurretPrototype extends TurretPrototype {
4064
4224
  attacking_muzzle_animation_shift?: AnimatedVector;
4065
4225
  ending_attack_muzzle_animation_shift?: AnimatedVector;
4066
4226
  enough_fuel_indicator_light?: LightDefinition;
4067
- enough_fuel_indicator_picture?: Sprite4Way;
4227
+ enough_fuel_indicator_picture?: Sprite8Way;
4068
4228
  fluid_box: FluidBox;
4069
4229
  fluid_buffer_input_flow: FluidAmount;
4070
4230
  fluid_buffer_size: FluidAmount;
@@ -4073,7 +4233,7 @@ interface FluidTurretPrototype extends TurretPrototype {
4073
4233
  muzzle_animation?: Animation;
4074
4234
  muzzle_light?: LightDefinition;
4075
4235
  not_enough_fuel_indicator_light?: LightDefinition;
4076
- not_enough_fuel_indicator_picture?: Sprite4Way;
4236
+ not_enough_fuel_indicator_picture?: Sprite8Way;
4077
4237
  /**
4078
4238
  * The sprite will be drawn on top of fluid turrets that are out of fluid ammunition. If the `out_of_ammo_alert_icon` is not set, {@link UtilitySprites::fluid_icon | prototype:UtilitySprites::fluid_icon} will be used instead.
4079
4239
  */
@@ -4090,6 +4250,22 @@ interface FluidTurretPrototype extends TurretPrototype {
4090
4250
  * A {@link fluid wagon | https://wiki.factorio.com/Fluid_wagon}.
4091
4251
  */
4092
4252
  interface FluidWagonPrototype extends RollingStockPrototype {
4253
+ /**
4254
+ * Horizontal (xy) offset of the central valve from the wagon position when it is oriented east/west.
4255
+ */
4256
+ base_valve_xy_offset_when_horizontal?: Vector;
4257
+ /**
4258
+ * Horizontal (xy) offset of the central valve from the wagon position when it is oriented north/south.
4259
+ */
4260
+ base_valve_xy_offset_when_vertical?: Vector;
4261
+ /**
4262
+ * Projected height of valves when the wagon is oriented east/west.
4263
+ */
4264
+ base_valve_z_offset_projected_when_horizontal?: float;
4265
+ /**
4266
+ * Projected height of valves when the wagon is oriented north/south.
4267
+ */
4268
+ base_valve_z_offset_projected_when_vertical?: float;
4093
4269
  capacity: FluidAmount;
4094
4270
  /**
4095
4271
  * Pumps are only allowed to connect to this fluid wagon if the pump's {@link fluid box connection | prototype:PipeConnectionDefinition} and this fluid wagon share a connection category. Pump may have different connection categories on the input and output side, connection categories will be taken from the connection that is facing towards fluid wagon.
@@ -4097,9 +4273,21 @@ interface FluidWagonPrototype extends RollingStockPrototype {
4097
4273
  connection_category?: string | string[];
4098
4274
  quality_affects_capacity?: boolean;
4099
4275
  /**
4100
- * Must be 1, 2 or 3.
4276
+ * Must be positive.
4101
4277
  */
4102
4278
  tank_count?: uint8;
4279
+ /**
4280
+ * Must be > 0.1.
4281
+ */
4282
+ tank_spacing?: float;
4283
+ /**
4284
+ * Projected offset between valves when the wagon is oriented east/west.
4285
+ */
4286
+ valve_to_valve_offset_when_horizontal?: Vector;
4287
+ /**
4288
+ * Projected offset between valves when the wagon is oriented north/south.
4289
+ */
4290
+ valve_to_valve_offset_when_vertical?: Vector;
4103
4291
  }
4104
4292
  /**
4105
4293
  * Abstract base for construction/logistics and combat robots.
@@ -4223,7 +4411,9 @@ interface FuelCategory extends Prototype {
4223
4411
  fuel_value_type?: LocalisedString;
4224
4412
  }
4225
4413
  /**
4226
- * A furnace. Normal furnaces only process "smelting" category recipes, but you can make furnaces that process other {@link recipe categories | prototype:RecipeCategory}. The difference to assembling machines is that furnaces automatically choose their recipe based on input.
4414
+ * A furnace. Normal furnaces only process "smelting" category recipes, but you can make furnaces that process other {@link recipe categories | prototype:RecipeCategory}.
4415
+ *
4416
+ * The difference to assembling machines is that furnaces automatically choose their recipe based on input. See {@link Furnace Recipe Selection | auxiliary:furnace-recipe-selection} for how the recipe is chosen.
4227
4417
  */
4228
4418
  interface FurnacePrototype extends CraftingMachinePrototype {
4229
4419
  /**
@@ -4431,8 +4621,6 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4431
4621
  * The number of fluid units the generator uses per tick.
4432
4622
  */
4433
4623
  fluid_usage_per_tick: FluidAmount;
4434
- horizontal_animation?: Animation;
4435
- horizontal_frozen_patch?: Sprite;
4436
4624
  /**
4437
4625
  * The power production of the generator is capped to this value. This is also the value that is shown as the maximum power output in the tooltip of the generator.
4438
4626
  *
@@ -4445,10 +4633,12 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4445
4633
  * Used to calculate the `max_power_output` if it is not defined and `burns_fluid` is false. Then, the max power output is `(min(fluid_max_temp, maximum_temperature) - fluid_default_temp) × fluid_usage_per_tick × fluid_heat_capacity × effectivity`, the fluid is the filter specified on the `fluid_box`.
4446
4634
  */
4447
4635
  maximum_temperature: float;
4636
+ output_fluid_box?: FluidBox;
4448
4637
  /**
4449
4638
  * Affects animation speed and working sound.
4450
4639
  */
4451
4640
  perceived_performance?: PerceivedPerformance;
4641
+ pictures?: GeneratorPictureSet;
4452
4642
  /**
4453
4643
  * Scales the generator's fluid usage to its maximum power output.
4454
4644
  *
@@ -4458,8 +4648,11 @@ interface GeneratorPrototype extends EntityWithOwnerPrototype {
4458
4648
  */
4459
4649
  scale_fluid_usage?: boolean;
4460
4650
  smoke?: SmokeSource[];
4461
- vertical_animation?: Animation;
4462
- vertical_frozen_patch?: Sprite;
4651
+ /**
4652
+ * Fluid and amount produced per 1 unit of fluid consumed. Only used when `output_fluid_box` is defined. If this value is not provided, {@link FluidPrototype::spent_fluid | prototype:FluidPrototype::spent_fluid} will be used based on the input fluid being consumed.
4653
+ */
4654
+ spent_fluid?: SpentFluidSpecification;
4655
+ two_direction_only?: boolean;
4463
4656
  }
4464
4657
  /**
4465
4658
  * Properties of the god controller.
@@ -4546,7 +4739,18 @@ interface HeatInterfacePrototype extends EntityWithOwnerPrototype {
4546
4739
  * A {@link heat pipe | https://wiki.factorio.com/Heat_pipe}.
4547
4740
  */
4548
4741
  interface HeatPipePrototype extends EntityWithOwnerPrototype {
4742
+ /**
4743
+ * Set of 16 circuit connector definitions. They correspond to the following sprites in this exact order: {@link single | prototype:ConnectableEntityGraphics::single}, {@link ending_up | prototype:ConnectableEntityGraphics::ending_up}, {@link ending_right | prototype:ConnectableEntityGraphics::ending_right}, {@link corner_right_up | prototype:ConnectableEntityGraphics::corner_right_up}, {@link ending_down | prototype:ConnectableEntityGraphics::ending_down}, {@link straight_vertical | prototype:ConnectableEntityGraphics::straight_vertical}, {@link corner_right_down | prototype:ConnectableEntityGraphics::corner_right_down}, {@link t_right | prototype:ConnectableEntityGraphics::t_right}, {@link ending_left | prototype:ConnectableEntityGraphics::ending_left}, {@link corner_left_up | prototype:ConnectableEntityGraphics::corner_left_up}, {@link straight_horizontal | prototype:ConnectableEntityGraphics::straight_horizontal}, {@link t_up | prototype:ConnectableEntityGraphics::t_up}, {@link corner_left_down | prototype:ConnectableEntityGraphics::corner_left_down}, {@link t_left | prototype:ConnectableEntityGraphics::t_left}, {@link t_down | prototype:ConnectableEntityGraphics::t_down}, {@link cross | prototype:ConnectableEntityGraphics::cross}.
4744
+ */
4745
+ circuit_connector?: CircuitConnectorDefinition[];
4746
+ /**
4747
+ * The maximum circuit wire distance for this entity.
4748
+ */
4749
+ circuit_wire_max_distance?: double;
4549
4750
  connection_sprites?: ConnectableEntityGraphics;
4751
+ default_temperature_signal?: SignalIDConnector;
4752
+ draw_circuit_wires?: boolean;
4753
+ draw_copper_wires?: boolean;
4550
4754
  heat_buffer: HeatBuffer;
4551
4755
  heat_glow_sprites?: ConnectableEntityGraphics;
4552
4756
  /**
@@ -4618,7 +4822,7 @@ interface InfinityContainerPrototype extends LogisticContainerPrototype {
4618
4822
  /**
4619
4823
  * The way this chest interacts with the logistic network.
4620
4824
  */
4621
- logistic_mode?: 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
4825
+ logistic_mode?: LogisticMode;
4622
4826
  /**
4623
4827
  * When true, items created inside the infinity chest will not start to spoil until they have been removed from the chest.
4624
4828
  */
@@ -4660,6 +4864,12 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4660
4864
  CircuitConnectorDefinition,
4661
4865
  CircuitConnectorDefinition
4662
4866
  ];
4867
+ circuit_connector_flipped?: [
4868
+ CircuitConnectorDefinition,
4869
+ CircuitConnectorDefinition,
4870
+ CircuitConnectorDefinition,
4871
+ CircuitConnectorDefinition
4872
+ ];
4663
4873
  /**
4664
4874
  * The maximum circuit wire distance for this entity.
4665
4875
  */
@@ -4714,7 +4924,9 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4714
4924
  max_belt_stack_size?: uint8;
4715
4925
  pickup_position: Vector;
4716
4926
  platform_frozen?: Sprite4Way;
4927
+ platform_frozen_flipped?: Sprite4Way;
4717
4928
  platform_picture?: Sprite4Way;
4929
+ platform_picture_flipped?: Sprite4Way;
4718
4930
  rotation_speed: double;
4719
4931
  /**
4720
4932
  * Stack size bonus that is inherent to the prototype without having to be researched.
@@ -4725,6 +4937,7 @@ interface InserterPrototype extends EntityWithOwnerPrototype {
4725
4937
  * Whether the inserter should be able to fish {@link fish | https://wiki.factorio.com/Raw_fish}.
4726
4938
  */
4727
4939
  use_easter_egg?: boolean;
4940
+ use_mirroring?: boolean;
4728
4941
  /**
4729
4942
  * When set to false, then relevant value of inserter stack size bonus ({@link LuaForce::inserter_stack_size_bonus | runtime:LuaForce::inserter_stack_size_bonus} or {@link LuaForce::bulk_inserter_capacity_bonus | runtime:LuaForce::bulk_inserter_capacity_bonus}) will not affect inserter stack size.
4730
4943
  */
@@ -4800,7 +5013,7 @@ interface ItemGroup extends Prototype {
4800
5013
  */
4801
5014
  icons?: IconData[];
4802
5015
  /**
4803
- * Item ingredients in recipes are ordered by item group. The `order_in_recipe` property can be used to specify the ordering in recipes without affecting the inventory order.
5016
+ * Item ingredients in recipes are ordered by item group if {@link RecipePrototype::sort_item_ingredients | prototype:RecipePrototype::sort_item_ingredients} is set to `true`. The `order_in_recipe` property can be used to specify the ordering in recipes with sorted ingredients without affecting the item group's inventory order.
4804
5017
  */
4805
5018
  order_in_recipe?: Order;
4806
5019
  }
@@ -4917,6 +5130,7 @@ interface ItemPrototype extends Prototype {
4917
5130
  icons?: IconData[];
4918
5131
  ingredient_to_weight_coefficient?: double;
4919
5132
  inventory_move_sound?: Sound;
5133
+ lab_ignores_spoil_percent?: boolean;
4920
5134
  /**
4921
5135
  * Whether this item should be moved to the hub when space platform performs building, upgrade or deconstruction and is left with this item. The following items are considered valuable and moved to hub by default: {@link Modules | prototype:ModulePrototype}, {@link items that build entities | prototype:ItemPrototype::place_result}, {@link items that build tiles | prototype:ItemPrototype::place_as_tile} and items {@link not obtainable from asteroid chunks | prototype:AsteroidChunkPrototype::minable} that have {@link subgroup | prototype:PrototypeBase::subgroup} from a {@link group | prototype:ItemSubGroup::group} other than `"intermediate-products"`.
4922
5136
  */
@@ -4954,10 +5168,17 @@ interface ItemPrototype extends Prototype {
4954
5168
  * 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.
4955
5169
  */
4956
5170
  send_to_orbit_mode?: SendToOrbitMode;
5171
+ /**
5172
+ * Used by space platforms to prioritize item requests and make sure there is enough space for priority items before requesting the rest.
5173
+ */
5174
+ space_platform_request_priority?: boolean;
4957
5175
  /**
4958
5176
  * 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.
4959
5177
  */
4960
5178
  spoil_level?: uint8;
5179
+ spoil_quality_change?: int8;
5180
+ spoil_quality_max?: QualityID;
5181
+ spoil_quality_min?: QualityID;
4961
5182
  spoil_result?: ItemID;
4962
5183
  spoil_ticks?: uint32;
4963
5184
  spoil_to_trigger_result?: SpoilToTriggerResult;
@@ -4971,7 +5192,7 @@ interface ItemPrototype extends Prototype {
4971
5192
  /**
4972
5193
  * The default weight is calculated automatically from recipes and falls back to {@link UtilityConstants::default_item_weight | prototype:UtilityConstants::default_item_weight}.
4973
5194
  *
4974
- * More information on how item weight is determined can be found on its {@link auxiliary page | runtime:item-weight}.
5195
+ * More information on how item weight is determined can be found on its {@link auxiliary page | auxiliary:item-weight}.
4975
5196
  */
4976
5197
  weight?: Weight;
4977
5198
  }
@@ -5081,6 +5302,7 @@ interface ItemWithInventoryPrototype extends ItemWithLabelPrototype {
5081
5302
  ```
5082
5303
  */
5083
5304
  item_subgroup_filters?: ItemSubGroupID[];
5305
+ quality_affects_inventory_size?: boolean;
5084
5306
  /**
5085
5307
  * 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.
5086
5308
  * @example ```
@@ -5162,7 +5384,7 @@ interface KillAchievementPrototype extends AchievementPrototype {
5162
5384
  type_to_kill?: string;
5163
5385
  }
5164
5386
  /**
5165
- * A {@link lab | https://wiki.factorio.com/Lab}. It consumes {@link science packs | prototype:ToolPrototype} to research {@link technologies | prototype:TechnologyPrototype}.
5387
+ * A {@link lab | https://wiki.factorio.com/Lab}. It consumes science packs (items) to research {@link technologies | prototype:TechnologyPrototype}.
5166
5388
  */
5167
5389
  interface LabPrototype extends EntityWithOwnerPrototype {
5168
5390
  /**
@@ -5173,6 +5395,14 @@ interface LabPrototype extends EntityWithOwnerPrototype {
5173
5395
  * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
5174
5396
  */
5175
5397
  allowed_module_categories?: ModuleCategoryID[];
5398
+ circuit_connector?: CircuitConnectorDefinition;
5399
+ /**
5400
+ * The maximum circuit wire distance for this entity.
5401
+ */
5402
+ circuit_wire_max_distance?: double;
5403
+ default_technology_level_signal?: SignalIDConnector;
5404
+ draw_circuit_wires?: boolean;
5405
+ draw_copper_wires?: boolean;
5176
5406
  effect_receiver?: EffectReceiver;
5177
5407
  /**
5178
5408
  * Defines how this lab gets energy.
@@ -5365,6 +5595,13 @@ interface LampPrototype extends EntityWithOwnerPrototype {
5365
5595
  interface LandMinePrototype extends EntityWithOwnerPrototype {
5366
5596
  action?: Trigger;
5367
5597
  ammo_category?: AmmoCategoryID;
5598
+ circuit_connector?: CircuitConnectorDefinition;
5599
+ /**
5600
+ * The maximum circuit wire distance for this entity.
5601
+ */
5602
+ circuit_wire_max_distance?: double;
5603
+ draw_circuit_wires?: boolean;
5604
+ draw_copper_wires?: boolean;
5368
5605
  /**
5369
5606
  * Force the landmine to kill itself when exploding.
5370
5607
  */
@@ -5464,7 +5701,7 @@ interface LightningPrototype extends EntityPrototype {
5464
5701
  /**
5465
5702
  * When lightning strikes something that is not a lightning attractor, this damage is applied to the target.
5466
5703
  */
5467
- damage?: double;
5704
+ damage?: DamageParameters;
5468
5705
  effect_duration: uint16;
5469
5706
  /**
5470
5707
  * When lightning hits a {@link lightning attractor | prototype:LightningAttractorPrototype}, this amount of energy is transferred to the lightning attractor.
@@ -5629,32 +5866,20 @@ interface LocomotivePrototype extends RollingStockPrototype {
5629
5866
  * A generic container, such as a chest, that interacts with the logistics network.
5630
5867
  */
5631
5868
  interface LogisticContainerPrototype extends ContainerPrototype {
5632
- /**
5633
- * Drawn when a robot brings/takes items from this container.
5634
- */
5635
- animation?: Animation;
5636
- /**
5637
- * Played when a robot brings/takes items from this container. Only loaded if `animation` is defined.
5638
- */
5639
- animation_sound?: Sound;
5640
- /**
5641
- * The offset from the center of this container where a robot visually brings/takes items.
5642
- */
5643
- landing_location_offset?: Vector;
5644
5869
  /**
5645
5870
  * The way this chest interacts with the logistic network.
5646
5871
  * This property is required, but marked as optional due to typescript inheritance limitations
5647
5872
  */
5648
- logistic_mode?: 'active-provider' | 'passive-provider' | 'requester' | 'storage' | 'buffer';
5873
+ logistic_mode?: LogisticMode;
5649
5874
  /**
5650
5875
  * The number of request slots this logistics container has. Requester-type containers must have > 0 slots and can have a maximum of {@link UtilityConstants::max_logistic_filter_count | prototype:UtilityConstants::max_logistic_filter_count} slots. Storage-type containers must have <= 1 slot.
5651
5876
  */
5652
5877
  max_logistic_slots?: uint16;
5653
- opened_duration?: uint8;
5654
5878
  /**
5655
5879
  * Whether the "no network" icon should be rendered on this entity if the entity is not within a logistics network.
5656
5880
  */
5657
5881
  render_not_in_network_icon?: boolean;
5882
+ robot_door?: RobotDoorSpecification;
5658
5883
  trash_inventory_size?: ItemStackIndex;
5659
5884
  /**
5660
5885
  * Whether logistic robots have to deliver the exact amount of items requested to this logistic container instead of over-delivering (within their cargo size).
@@ -5766,7 +5991,6 @@ interface MapSettings {
5766
5991
  name: string;
5767
5992
  path_finder: PathFinderSettings;
5768
5993
  pollution: PollutionSettings;
5769
- steering: SteeringSettings;
5770
5994
  type: 'map-settings';
5771
5995
  unit_group: UnitGroupSettings;
5772
5996
  }
@@ -5792,17 +6016,18 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5792
6016
  * Sets the {@link module categories | prototype:ModuleCategory} that are allowed to be inserted into this machine.
5793
6017
  */
5794
6018
  allowed_module_categories?: ModuleCategoryID[];
5795
- /**
5796
- * Used by the {@link pumpjack | https://wiki.factorio.com/Pumpjack} to have a static 4 way sprite.
5797
- */
5798
- base_picture?: Sprite4Way;
5799
- base_render_layer?: RenderLayer;
5800
6019
  circuit_connector?: [
5801
6020
  CircuitConnectorDefinition,
5802
6021
  CircuitConnectorDefinition,
5803
6022
  CircuitConnectorDefinition,
5804
6023
  CircuitConnectorDefinition
5805
6024
  ];
6025
+ circuit_connector_flipped?: [
6026
+ CircuitConnectorDefinition,
6027
+ CircuitConnectorDefinition,
6028
+ CircuitConnectorDefinition,
6029
+ CircuitConnectorDefinition
6030
+ ];
5806
6031
  /**
5807
6032
  * The maximum circuit wire distance for this entity.
5808
6033
  */
@@ -5830,7 +6055,12 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5830
6055
  */
5831
6056
  filter_count?: uint8;
5832
6057
  graphics_set?: MiningDrillGraphicsSet;
6058
+ graphics_set_flipped?: MiningDrillGraphicsSet;
5833
6059
  input_fluid_box?: FluidBox;
6060
+ /**
6061
+ * When a save file from version 2.0.x or older is loaded and this property is `true`, entities facing east or west direction are migrated to flipped state.
6062
+ */
6063
+ migrate_horizontal_mirroring?: boolean;
5834
6064
  /**
5835
6065
  * The speed of this drill.
5836
6066
  */
@@ -5861,6 +6091,7 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5861
6091
  * The sprite used to show the range of the mining drill.
5862
6092
  */
5863
6093
  radius_visualisation_picture?: Sprite;
6094
+ require_resources_to_place?: boolean;
5864
6095
  /**
5865
6096
  * The names of the {@link ResourceCategory | prototype:ResourceCategory} that can be mined by this drill. For a list of built-in categories, see {@link here | https://wiki.factorio.com/Data.raw#resource-category}.
5866
6097
  *
@@ -5882,12 +6113,14 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
5882
6113
  */
5883
6114
  resource_searching_radius: double;
5884
6115
  shuffle_resources_to_mine?: boolean;
6116
+ use_mirroring?: boolean;
5885
6117
  uses_force_mining_productivity_bonus?: boolean;
5886
6118
  /**
5887
6119
  * The position where any item results are placed, when the mining drill is facing north (default direction). If the drill does not produce any solid items but uses a fluidbox output instead (e.g. pumpjacks), a vector of `{0,0}` disables the yellow arrow alt-mode indicator for the placed item location.
5888
6120
  */
5889
6121
  vector_to_place_result: Vector;
5890
6122
  wet_mining_graphics_set?: MiningDrillGraphicsSet;
6123
+ wet_mining_graphics_set_flipped?: MiningDrillGraphicsSet;
5891
6124
  }
5892
6125
  /**
5893
6126
  * Block of arbitrary data set by mods in prototype stage.
@@ -5936,11 +6169,41 @@ interface ModulePrototype extends ItemPrototype {
5936
6169
  * Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules of the same category with higher tier modules.
5937
6170
  */
5938
6171
  category: ModuleCategoryID;
6172
+ /**
6173
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6174
+ *
6175
+ * Defaults to 1.0 if the module consumption effect is < 0, otherwise 0.0.
6176
+ */
6177
+ consumption_quality_multiplier?: float;
5939
6178
  /**
5940
6179
  * The effect of the module on the machine it's inserted in, such as increased pollution.
5941
6180
  */
5942
6181
  effect: Effect;
6182
+ /**
6183
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6184
+ *
6185
+ * Defaults to 1.0 if the module pollution effect is < 0, otherwise 0.0.
6186
+ */
6187
+ pollution_quality_multiplier?: float;
6188
+ /**
6189
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6190
+ *
6191
+ * Defaults to 1.0 if the module productivity effect is > 0, otherwise 0.0.
6192
+ */
6193
+ productivity_quality_multiplier?: float;
6194
+ /**
6195
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6196
+ *
6197
+ * Defaults to 1.0 if the module quality effect is > 0, otherwise 0.0.
6198
+ */
6199
+ quality_quality_multiplier?: float;
5943
6200
  requires_beacon_alt_mode?: boolean;
6201
+ /**
6202
+ * 0.0 means that no quality scaling is applied (common for penalties). 1.0 means that the full scaling of the quality prototype applies.
6203
+ *
6204
+ * Defaults to 1.0 if the module speed effect is > 0, otherwise 0.0.
6205
+ */
6206
+ speed_quality_multiplier?: float;
5944
6207
  /**
5945
6208
  * Tier of the module inside its category. Used when upgrading modules: Ctrl + click modules into an entity and it will replace lower tier modules with higher tier modules if they have the same category.
5946
6209
  */
@@ -6025,7 +6288,7 @@ interface MovementBonusEquipmentPrototype extends EquipmentPrototype {
6025
6288
  *
6026
6289
  * Alternate expressions can be made available in the map generator GUI by setting their `intended_property` to the name of the property they should override.
6027
6290
  *
6028
- * Named noise expressions can also be used as {@link noise variables | runtime:noise-expressions} e.g. `var("my-noise-expression")`.
6291
+ * Named noise expressions can also be used as {@link noise variables | auxiliary:noise-expressions} e.g. `var("my-noise-expression")`.
6029
6292
  * @example ```
6030
6293
  {
6031
6294
  type = "noise-expression",
@@ -6169,6 +6432,10 @@ interface OffshorePumpPrototype extends EntityWithOwnerPrototype {
6169
6432
  */
6170
6433
  pumping_speed: FluidAmount;
6171
6434
  remove_on_tile_collision?: boolean;
6435
+ /**
6436
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6437
+ */
6438
+ show_fluid_visualization_when_in_cursor?: boolean;
6172
6439
  }
6173
6440
  /**
6174
6441
  * An entity with a limited lifetime that can use trigger effects.
@@ -6241,6 +6508,16 @@ interface ParticleSourcePrototype extends EntityPrototype {
6241
6508
  * An entity to transport fluids over a distance and between machines.
6242
6509
  */
6243
6510
  interface PipePrototype extends EntityWithOwnerPrototype {
6511
+ circuit_connector?: [
6512
+ CircuitConnectorDefinition,
6513
+ CircuitConnectorDefinition,
6514
+ CircuitConnectorDefinition,
6515
+ CircuitConnectorDefinition
6516
+ ];
6517
+ circuit_wire_max_distance?: double;
6518
+ default_fluid_temperature_signal?: SignalIDConnector;
6519
+ draw_circuit_wires?: boolean;
6520
+ draw_copper_wires?: boolean;
6244
6521
  /**
6245
6522
  * The area of the entity where fluid/gas inputs, and outputs.
6246
6523
  */
@@ -6250,13 +6527,27 @@ interface PipePrototype extends EntityWithOwnerPrototype {
6250
6527
  * All graphics for this pipe.
6251
6528
  */
6252
6529
  pictures?: PipePictures;
6530
+ /**
6531
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6532
+ */
6533
+ show_fluid_visualization_when_in_cursor?: boolean;
6253
6534
  vertical_window_bounding_box: BoundingBox;
6254
6535
  }
6255
6536
  /**
6256
6537
  * A {@link pipe to ground | https://wiki.factorio.com/Pipe_to_ground}.
6257
6538
  */
6258
6539
  interface PipeToGroundPrototype extends EntityWithOwnerPrototype {
6540
+ circuit_connector?: [
6541
+ CircuitConnectorDefinition,
6542
+ CircuitConnectorDefinition,
6543
+ CircuitConnectorDefinition,
6544
+ CircuitConnectorDefinition
6545
+ ];
6546
+ circuit_wire_max_distance?: double;
6547
+ default_fluid_temperature_signal?: SignalIDConnector;
6259
6548
  disabled_visualization?: Sprite4Way;
6549
+ draw_circuit_wires?: boolean;
6550
+ draw_copper_wires?: boolean;
6260
6551
  /**
6261
6552
  * Causes fluid icon to always be drawn, ignoring the usual pair requirement.
6262
6553
  */
@@ -6264,6 +6555,10 @@ interface PipeToGroundPrototype extends EntityWithOwnerPrototype {
6264
6555
  fluid_box: FluidBox;
6265
6556
  frozen_patch?: Sprite4Way;
6266
6557
  pictures?: Sprite4Way;
6558
+ /**
6559
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6560
+ */
6561
+ show_fluid_visualization_when_in_cursor?: boolean;
6267
6562
  visualization?: Sprite4Way;
6268
6563
  }
6269
6564
  interface PlaceEquipmentAchievementPrototype extends AchievementPrototype {
@@ -6290,10 +6585,18 @@ interface PlanetPrototype extends SpaceLocationPrototype {
6290
6585
  }
6291
6586
  interface PlantPrototype extends TreePrototype {
6292
6587
  agricultural_tower_tint?: RecipeTints;
6588
+ /**
6589
+ * Mound sprite drawn under growing trees which fades close to full growth. If defined, it can't be empty.
6590
+ */
6591
+ growth_mounds?: Sprite[];
6293
6592
  /**
6294
6593
  * Must be positive.
6295
6594
  */
6296
6595
  growth_ticks: MapTick;
6596
+ /**
6597
+ * If defined, it can't be empty.
6598
+ */
6599
+ growth_variations?: TreeGrowth[];
6297
6600
  /**
6298
6601
  * The burst of pollution to emit when the plant is harvested.
6299
6602
  */
@@ -6612,6 +6915,8 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6612
6915
  * The animation for the pump.
6613
6916
  */
6614
6917
  animations?: Animation4Way;
6918
+ arm_orienting_sound?: InterruptibleSound;
6919
+ base_lifting_sound?: InterruptibleSound;
6615
6920
  circuit_connector?: [
6616
6921
  CircuitConnectorDefinition,
6617
6922
  CircuitConnectorDefinition,
@@ -6619,6 +6924,7 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6619
6924
  CircuitConnectorDefinition
6620
6925
  ];
6621
6926
  circuit_wire_max_distance?: double;
6927
+ clamp_sound?: Sound;
6622
6928
  draw_circuit_wires?: boolean;
6623
6929
  draw_copper_wires?: boolean;
6624
6930
  /**
@@ -6638,16 +6944,23 @@ interface PumpPrototype extends EntityWithOwnerPrototype {
6638
6944
  * The area of the entity where fluid travels.
6639
6945
  */
6640
6946
  fluid_box: FluidBox;
6641
- fluid_wagon_connector_alignment_tolerance?: double;
6642
6947
  fluid_wagon_connector_frame_count?: uint8;
6643
- fluid_wagon_connector_graphics?: FluidWagonConnectorGraphics;
6644
6948
  fluid_wagon_connector_speed?: double;
6949
+ /**
6950
+ * counts from the "start of the arm", which is `pump's position + wagon_connection_graphics.part1_to_2_shift + wagon_connection_graphics.top_pivot_shift (depending on direction)`
6951
+ */
6952
+ fluid_wagon_tank_valve_max_distance?: double;
6645
6953
  frozen_patch?: Sprite4Way;
6646
6954
  glass_pictures?: Sprite4Way;
6647
6955
  /**
6648
6956
  * The amount of fluid this pump transfers per tick.
6649
6957
  */
6650
6958
  pumping_speed: FluidAmount;
6959
+ /**
6960
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
6961
+ */
6962
+ show_fluid_visualization_when_in_cursor?: boolean;
6963
+ wagon_connection_graphics?: PumpWagonConnectionGraphics;
6651
6964
  }
6652
6965
  /**
6653
6966
  * One quality step. Its effects are specified by the level and the various multiplier and bonus properties. Properties ending in `_multiplier` are applied multiplicatively to their base property, properties ending in `_bonus` are applied additively.
@@ -6668,7 +6981,7 @@ interface QualityPrototype extends Prototype {
6668
6981
  */
6669
6982
  beacon_module_slots_bonus?: ItemStackIndex;
6670
6983
  /**
6671
- * Must be >= 0.
6984
+ * Must be >= 0.01.
6672
6985
  */
6673
6986
  beacon_power_usage_multiplier?: float;
6674
6987
  /**
@@ -6677,6 +6990,16 @@ interface QualityPrototype extends Prototype {
6677
6990
  * Must be >= 0 and <= 64.
6678
6991
  */
6679
6992
  beacon_supply_area_distance_bonus?: float;
6993
+ /**
6994
+ * Must be >= 0.01.
6995
+ */
6996
+ cargo_wagon_inventory_size_multiplier?: double;
6997
+ /**
6998
+ * Probability of additional quality increase happening after quality was increased to reach this quality in the same crafting/mining operation.
6999
+ *
7000
+ * Must be in range `[0, 1]`.
7001
+ */
7002
+ chain_probability?: double;
6680
7003
  color: Color;
6681
7004
  /**
6682
7005
  * Must be >= 0.01.
@@ -6759,6 +7082,10 @@ interface QualityPrototype extends Prototype {
6759
7082
  * Requires Space Age to use level greater than `0`.
6760
7083
  */
6761
7084
  level: uint32;
7085
+ /**
7086
+ * Must be >= 0.01.
7087
+ */
7088
+ locomotive_power_multiplier?: double;
6762
7089
  /**
6763
7090
  * Must be >= 0.01.
6764
7091
  */
@@ -6783,6 +7110,26 @@ interface QualityPrototype extends Prototype {
6783
7110
  * Must be in range `[0, 1]`.
6784
7111
  */
6785
7112
  mining_drill_resource_drain_multiplier?: float;
7113
+ /**
7114
+ * Must be >= 0.01.
7115
+ */
7116
+ module_consumption_multiplier?: float;
7117
+ /**
7118
+ * Must be >= 0.01.
7119
+ */
7120
+ module_pollution_multiplier?: float;
7121
+ /**
7122
+ * Must be >= 0.01.
7123
+ */
7124
+ module_productivity_multiplier?: float;
7125
+ /**
7126
+ * Must be >= 0.01.
7127
+ */
7128
+ module_quality_multiplier?: float;
7129
+ /**
7130
+ * Must be >= 0.01.
7131
+ */
7132
+ module_speed_multiplier?: float;
6786
7133
  /**
6787
7134
  * Unique textual identification of the prototype. May only contain alphanumeric characters, dashes and underscores. May not exceed a length of 200 characters.
6788
7135
  *
@@ -6791,23 +7138,49 @@ interface QualityPrototype extends Prototype {
6791
7138
  name: string;
6792
7139
  next?: QualityID;
6793
7140
  /**
6794
- * The quality {@link effect of the module | prototype:ModulePrototype::effect} is multiplied by this. For example, if a module's quality effect is 0.2 and the current quality's next_probability is 0.1, then the chance to get the next quality item is 2%.
7141
+ * Probability that a crafting machine affected by a 100% quality {@link effect from modules | prototype:ModulePrototype::effect} will cause quality to be increased.
6795
7142
  *
6796
- * Must be in range [0, 1.0].
7143
+ * Probability is scaled linearly with quality effect. E.g. for `next_probability = 1`, 100% quality effect means quality is always increased, at 50% quality effect the quality is increased 50% of the time and so on.
7144
+ *
7145
+ * Must be >= 0.
6797
7146
  */
6798
7147
  next_probability?: double;
7148
+ /**
7149
+ * Probability of additional quality decrease happening after quality was decreased to reach this quality in the same crafting/mining operation.
7150
+ *
7151
+ * Must be in range `[0, 1]`.
7152
+ */
7153
+ previous_chain_probability?: double;
7154
+ /**
7155
+ * Probability that a crafting machine affected by a -100% quality {@link effect from modules | prototype:ModulePrototype::effect} will cause quality to be decreased.
7156
+ *
7157
+ * Probability is scaled linearly with quality effect. E.g. for `previous_probability = 1`, -100% quality effect means quality is always decreased, at -50% quality effect the quality is decreased 50% of the time and so on.
7158
+ *
7159
+ * Must be >= 0.
7160
+ *
7161
+ * Note: for a machine to have a negative quality effect, {@link EffectReceiver::quality_limits | prototype:EffectReceiver::quality_limits} needs to be set.
7162
+ */
7163
+ previous_probability?: double;
6799
7164
  /**
6800
7165
  * Must be within `[1, 3]`.
6801
7166
  *
6802
7167
  * Affects the range of {@link attack parameters | prototype:AttackParameters}, e.g. those used by combat robots, units, guns and turrets.
6803
7168
  */
6804
7169
  range_multiplier?: double;
7170
+ /**
7171
+ * Must be >= 0.01.
7172
+ */
7173
+ rolling_stock_max_speed_multiplier?: double;
6805
7174
  /**
6806
7175
  * Must be in range `[0, 1]`.
6807
7176
  *
6808
7177
  * Only affects labs with {@link LabPrototype::uses_quality_drain_modifier | prototype:LabPrototype::uses_quality_drain_modifier} set.
6809
7178
  */
6810
7179
  science_pack_drain_multiplier?: float;
7180
+ /**
7181
+ * Must be >= 0.01.
7182
+ */
7183
+ spoil_ticks_multiplier?: float;
6811
7184
  /**
6812
7185
  * Must be >= 0.01.
6813
7186
  *
@@ -6828,6 +7201,10 @@ interface RadarPrototype extends EntityWithOwnerPrototype {
6828
7201
  * If set to true, radars on the same surface will connect to other radars on the same surface using hidden wires with {@link radar | runtime:defines.wire_origin.radars} origin.
6829
7202
  */
6830
7203
  connects_to_other_radars?: boolean;
7204
+ /**
7205
+ * The default channel for the circuit network connection in universe mode.
7206
+ */
7207
+ default_universe_channel?: SignalIDConnector;
6831
7208
  draw_circuit_wires?: boolean;
6832
7209
  draw_copper_wires?: boolean;
6833
7210
  /**
@@ -6919,7 +7296,7 @@ interface RailPrototype extends EntityWithOwnerPrototype {
6919
7296
  * Must be 0, 2 or 4. Can't be non-zero if `fence_pictures` is defined.
6920
7297
  */
6921
7298
  forced_fence_segment_count?: uint8;
6922
- pictures: RailPictureSet;
7299
+ pictures?: RailPictureSet;
6923
7300
  removes_soft_decoratives?: boolean;
6924
7301
  /**
6925
7302
  * The rail {@link selection_boxes | prototype:EntityPrototype::selection_box} are automatically calculated from the collision boxes, which are hardcoded. So effectively the selection boxes also hardcoded.
@@ -6958,6 +7335,10 @@ interface RailRampPrototype extends RailPrototype {
6958
7335
  * Must be lower than 500 and at least 1.
6959
7336
  */
6960
7337
  support_range?: float;
7338
+ /**
7339
+ * When this is true, this entity prototype will be translucent and unselectable when "Hide tall entities" mode is active.
7340
+ */
7341
+ tall?: boolean;
6961
7342
  }
6962
7343
  /**
6963
7344
  * Used for rail corpses.
@@ -6971,7 +7352,7 @@ interface RailRemnantsPrototype extends CorpsePrototype {
6971
7352
  * "Rail remnant entities must have a non-zero {@link collision_box | prototype:EntityPrototype::collision_box} defined.
6972
7353
  */
6973
7354
  collision_box?: BoundingBox;
6974
- pictures: RailPictureSet;
7355
+ pictures?: RailPictureSet;
6975
7356
  related_rail: EntityID;
6976
7357
  secondary_collision_box?: BoundingBox;
6977
7358
  }
@@ -7101,11 +7482,19 @@ interface ReactorPrototype extends EntityWithOwnerPrototype {
7101
7482
  */
7102
7483
  meltdown_action?: Trigger;
7103
7484
  neighbour_bonus?: double;
7485
+ /**
7486
+ * Defines connection points to neighbours used to compute neighbour bonus.
7487
+ */
7488
+ neighbour_connectable?: NeighbourConnectable;
7104
7489
  picture?: Sprite;
7105
7490
  /**
7106
7491
  * When this is true, the reactor will stop consuming fuel/energy when the temperature has reached the maximum.
7107
7492
  */
7108
7493
  scale_energy_usage?: boolean;
7494
+ /**
7495
+ * The temperature above which energy icons are suppressed. Defaults to maximum double value.
7496
+ */
7497
+ temperature_to_suppress_energy_icons?: double;
7109
7498
  /**
7110
7499
  * Whether the reactor should use {@link fuel_glow_color | prototype:ItemPrototype::fuel_glow_color} from the fuel item prototype as light color and tint for `working_light_picture`. {@link Forum post. | https://forums.factorio.com/71121}
7111
7500
  */
@@ -7131,7 +7520,7 @@ interface RecipeCategory extends Prototype {
7131
7520
  {
7132
7521
  type = "recipe",
7133
7522
  name = "iron-plate",
7134
- category = "smelting",
7523
+ categories = {"smelting"},
7135
7524
  energy_required = 3.5,
7136
7525
  ingredients = {{type = "item", name = "iron-ore", amount = 1}},
7137
7526
  results = {{type = "item", name = "iron-plate", amount = 1}}
@@ -7141,7 +7530,7 @@ interface RecipeCategory extends Prototype {
7141
7530
  {
7142
7531
  type = "recipe",
7143
7532
  name = "coal-liquefaction",
7144
- category = "oil-processing",
7533
+ categories = {"oil-processing"},
7145
7534
  subgroup = "fluid-recipes",
7146
7535
  order = "a[oil-processing]-c[coal-liquefaction]",
7147
7536
  enabled = false,
@@ -7165,7 +7554,6 @@ interface RecipeCategory extends Prototype {
7165
7554
  ```
7166
7555
  */
7167
7556
  interface RecipePrototype extends Prototype {
7168
- additional_categories?: RecipeCategoryID[];
7169
7557
  /**
7170
7558
  * Whether the recipe can be used as an intermediate recipe in hand-crafting.
7171
7559
  */
@@ -7204,10 +7592,6 @@ interface RecipePrototype extends Prototype {
7204
7592
  * Whether the "Made in: <Machine>" part of the tool-tip should always be present, and not only when the recipe can't be hand-crafted.
7205
7593
  */
7206
7594
  always_show_made_in?: boolean;
7207
- /**
7208
- * Whether the products are always shown in the recipe tooltip.
7209
- */
7210
- always_show_products?: boolean;
7211
7595
  /**
7212
7596
  * Whether the recipe should be included in the recycling recipes automatically generated by the quality mod.
7213
7597
  *
@@ -7215,14 +7599,24 @@ interface RecipePrototype extends Prototype {
7215
7599
  */
7216
7600
  auto_recycle?: boolean;
7217
7601
  /**
7218
- * The {@link category | prototype:RecipeCategory} of this recipe. Controls which machines can craft this recipe.
7602
+ * When set to `true`, player can set quality of this recipe to craft. If set to `false` then this recipe can only be crafted at normal quality.
7603
+ *
7604
+ * Defaults to `true` if recipe is a parameter, or has at least one item ingredient that does not have any of {@link quality_min | prototype:ItemIngredientPrototype::quality_min}, {@link quality_max | prototype:ItemIngredientPrototype::quality_max}, or {@link quality_change | prototype:ItemIngredientPrototype::quality_change} set.
7605
+ *
7606
+ * This property also influences the automatic {@link Furnace Recipe Selection | auxiliary:furnace-recipe-selection}.
7607
+ */
7608
+ can_set_quality?: boolean;
7609
+ /**
7610
+ * The {@link categories | prototype:RecipeCategory} of this recipe. Controls which machines can craft this recipe.
7219
7611
  *
7220
7612
  * The built-in categories can be found {@link here | https://wiki.factorio.com/Data.raw#recipe-category}. The base `"crafting"` category can not contain recipes with fluid ingredients or products.
7613
+ *
7614
+ * The array must contain at least one category, it cannot be empty.
7221
7615
  * @example ```
7222
- category = "smelting"
7616
+ categories = {"smelting"}
7223
7617
  ```
7224
7618
  */
7225
- category?: RecipeCategoryID;
7619
+ categories?: RecipeCategoryID[];
7226
7620
  /**
7227
7621
  * Used by {@link WorkingVisualisations::working_visualisations | prototype:WorkingVisualisations::working_visualisations} to tint certain layers with the recipe color. {@link WorkingVisualisation::apply_recipe_tint | prototype:WorkingVisualisation::apply_recipe_tint} determines which of the four colors is used for that layer, if any.
7228
7622
  */
@@ -7281,7 +7675,7 @@ interface RecipePrototype extends Prototype {
7281
7675
  *
7282
7676
  * Can be set to an empty table to create a recipe that needs no ingredients. {@link Assembling machines | prototype:AssemblingMachinePrototype::ingredient_count} do not support recipes with more than 65 535 different item ingredients.
7283
7677
  *
7284
- * Duplicate ingredients, e.g. two entries with the same name, are *not* allowed. In-game, the item ingredients are ordered by {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe}.
7678
+ * Duplicate ingredients, e.g. two entries with the same name, are *not* allowed. In-game, the item ingredients are ordered by {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe} if {@link RecipePrototype::sort_item_ingredients | prototype:RecipePrototype::sort_item_ingredients} is set to `true`.
7285
7679
  * @example ```
7286
7680
  -- Recipe with items
7287
7681
  ingredients =
@@ -7319,13 +7713,9 @@ interface RecipePrototype extends Prototype {
7319
7713
  preserve_products_in_machine_output?: boolean;
7320
7714
  requester_paste_multiplier?: uint32;
7321
7715
  /**
7322
- * When set to true, if the recipe successfully finishes crafting without spoiling, the result is produced fresh (non-spoiled).
7323
- */
7324
- reset_freshness_on_craft?: boolean;
7325
- /**
7326
- * When set to true, the recipe will always produce fresh (non-spoiled) item even when the ingredients are spoiled.
7716
+ * Whether enabling this recipe requires the ingredients be unlocked before the products are marked as unlocked.
7327
7717
  */
7328
- result_is_always_fresh?: boolean;
7718
+ requires_ingredients_to_unlock_results?: boolean;
7329
7719
  /**
7330
7720
  * A table containing result names and amounts. Products also contain information such as fluid temperature, probability of results and whether some of the amount is ignored by productivity.
7331
7721
  *
@@ -7353,9 +7743,9 @@ interface RecipePrototype extends Prototype {
7353
7743
  */
7354
7744
  results?: ProductPrototype[];
7355
7745
  /**
7356
- * Whether the recipe name should have the product amount in front of it. E.g. "2x Transport belt".
7746
+ * When set to `true`, item ingredients will be sorted based on {@link ItemGroup::order_in_recipe | prototype:ItemGroup::order_in_recipe}.
7357
7747
  */
7358
- show_amount_in_title?: boolean;
7748
+ sort_item_ingredients?: boolean;
7359
7749
  surface_conditions?: SurfaceCondition[];
7360
7750
  /**
7361
7751
  * Whether enabling this recipe unlocks its item products to show in selection lists (item filters, logistic requests, etc.).
@@ -7448,7 +7838,7 @@ interface ResourceCategory extends Prototype {
7448
7838
  name = "crude-oil",
7449
7839
  amount_min = 10,
7450
7840
  amount_max = 10,
7451
- probability = 1
7841
+ independent_probability = 1
7452
7842
  }
7453
7843
  }
7454
7844
  },
@@ -7830,6 +8220,10 @@ interface RobotWithLogisticInterfacePrototype extends FlyingRobotPrototype {
7830
8220
  * Must be >= max_payload_size.
7831
8221
  */
7832
8222
  max_payload_size_after_bonus?: ItemCountType;
8223
+ /**
8224
+ * If true, this can't be mined unless it has more than {@link FlyingRobotPrototype::max_to_charge | prototype:FlyingRobotPrototype::max_to_charge} energy, or the players personal roboports have enough energy to charge it.
8225
+ */
8226
+ require_charge_to_mine?: boolean;
7833
8227
  /**
7834
8228
  * Only the first frame of the animation is drawn. This means that the graphics for the idle state cannot be animated.
7835
8229
  */
@@ -7858,6 +8252,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7858
8252
  arm_01_back_animation?: Animation;
7859
8253
  arm_02_right_animation?: Animation;
7860
8254
  arm_03_front_animation?: Animation;
8255
+ /**
8256
+ * Must be >= 0.
8257
+ */
8258
+ arms_speed_modifier_per_quality_level?: double;
7861
8259
  base_day_sprite?: Sprite;
7862
8260
  base_engine_light?: LightDefinition;
7863
8261
  base_front_frozen?: Sprite;
@@ -7928,6 +8326,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7928
8326
  * The time to wait in the {@link launch_started | runtime:defines.rocket_silo_status.launch_started} state before switching to {@link engine_starting | runtime:defines.rocket_silo_status.engine_starting}.
7929
8327
  */
7930
8328
  launch_wait_time?: uint8;
8329
+ /**
8330
+ * When `launch_to_space_platforms` is false, the inventory has no weight restrictions, so this value is ignored.
8331
+ */
8332
+ lift_weight?: Weight;
7931
8333
  /**
7932
8334
  * The inverse of the duration in ticks of {@link lights_blinking_open | runtime:defines.rocket_silo_status.lights_blinking_open} and {@link lights_blinking_close | runtime:defines.rocket_silo_status.lights_blinking_close}.
7933
8335
  * @example ```
@@ -7960,6 +8362,11 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7960
8362
  * Whether the "no network" icon should be rendered on this entity if the entity is not within a logistics network.
7961
8363
  */
7962
8364
  render_not_in_network_icon?: boolean;
8365
+ robot_door?: RobotDoorSpecification;
8366
+ /**
8367
+ * Must be >= 0.
8368
+ */
8369
+ rocket_engine_starting_speed_modifier_per_quality_level?: double;
7963
8370
  /**
7964
8371
  * Name of a {@link RocketSiloRocketPrototype | prototype:RocketSiloRocketPrototype}.
7965
8372
  */
@@ -7978,6 +8385,10 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7978
8385
  * The time to wait in the {@link doors_opened | runtime:defines.rocket_silo_status.doors_opened} state before switching to {@link rocket_rising | runtime:defines.rocket_silo_status.rocket_rising}.
7979
8386
  */
7980
8387
  rocket_rising_delay?: uint8;
8388
+ /**
8389
+ * Must be >= 0.
8390
+ */
8391
+ rocket_rising_speed_modifier_per_quality_level?: double;
7981
8392
  rocket_shadow_overlay_sprite?: Sprite;
7982
8393
  satellite_animation?: Animation;
7983
8394
  satellite_shadow_animation?: Animation;
@@ -7990,6 +8401,9 @@ interface RocketSiloPrototype extends AssemblingMachinePrototype {
7990
8401
  * Does not affect the duration of the launch sequence.
7991
8402
  */
7992
8403
  times_to_blink: uint8;
8404
+ /**
8405
+ * When `launch_to_space_platforms` is true, the inventory has dynamic size and is weight-restricted, so this value is ignored.
8406
+ */
7993
8407
  to_be_inserted_to_rocket_inventory_size?: ItemStackIndex;
7994
8408
  }
7995
8409
  /**
@@ -8114,10 +8528,11 @@ interface RollingStockPrototype extends VehiclePrototype {
8114
8528
  /**
8115
8529
  * Maximum speed of the rolling stock in tiles/tick.
8116
8530
  *
8117
- * In-game, the max speed of a train is `min(all_rolling_stock_max_speeds) × average(all_fuel_modifiers_in_all_locomotives)`. This calculated train speed is then silently capped to 7386.3km/h.
8531
+ * In-game, the max speed of a train is `average(all_rolling_stock_max_speeds) × average(all_fuel_modifiers_in_all_locomotives)`. If this value is not provided it is ignored for the average(all_rolling_stock_max_speed) calculation. This calculated train speed is then silently capped to 7386.3km/h.
8118
8532
  */
8119
- max_speed: double;
8533
+ max_speed?: double;
8120
8534
  pictures?: RollingStockRotatedSlopedGraphics;
8535
+ quality_affects_max_speed?: boolean;
8121
8536
  stand_by_light?: LightDefinition;
8122
8537
  /**
8123
8538
  * In tiles. Used to determine how often `drive_over_tie_trigger` is triggered.
@@ -8278,12 +8693,16 @@ interface SelectionToolPrototype extends ItemWithLabelPrototype {
8278
8693
  }
8279
8694
  interface SelectorCombinatorPrototype extends CombinatorPrototype {
8280
8695
  count_symbol_sprites?: Sprite4Way;
8696
+ default_day_length_output_signal?: SignalIDConnector;
8697
+ default_day_tick_output_signal?: SignalIDConnector;
8698
+ default_game_tick_output_signal?: SignalIDConnector;
8281
8699
  max_symbol_sprites?: Sprite4Way;
8282
8700
  min_symbol_sprites?: Sprite4Way;
8283
8701
  quality_symbol_sprites?: Sprite4Way;
8284
8702
  random_symbol_sprites?: Sprite4Way;
8285
8703
  rocket_capacity_sprites?: Sprite4Way;
8286
8704
  stack_size_sprites?: Sprite4Way;
8705
+ time_symbol_sprites?: Sprite4Way;
8287
8706
  }
8288
8707
  /**
8289
8708
  * This prototype is used for receiving an achievement when the player shoots certain ammo.
@@ -8419,6 +8838,10 @@ interface SimpleEntityPrototype extends EntityWithHealthPrototype {
8419
8838
  * Used to determine render order for entities with the same `render_layer` in the same position. Entities with a higher `secondary_draw_order` are drawn on top.
8420
8839
  */
8421
8840
  secondary_draw_order?: int8;
8841
+ /**
8842
+ * If true, map generator will shuffle graphics variations for each chunk and pick the next one in sequence instead of making it purely position-based. This prevents identical entity variations from being too close to each other. This property overrides random_variation_on_create.
8843
+ */
8844
+ shuffled_variation_on_chunk_generated?: boolean;
8422
8845
  /**
8423
8846
  * Loaded and drawn with all `pictures`, `picture` and `animations`. If graphics variation is larger than number of `lower_pictures` variations this layer is not drawn.
8424
8847
  */
@@ -8781,6 +9204,10 @@ interface SpaceLocationPrototype extends Prototype {
8781
9204
  * These transitions are used for any platform stopped at this location.
8782
9205
  */
8783
9206
  platform_procession_set?: ProcessionSet;
9207
+ /**
9208
+ * Render parameters that influence platforms orbiting this space location.
9209
+ */
9210
+ platform_surface_render_parameters?: SurfaceRenderParameters;
8784
9211
  procession_audio_catalogue?: ProcessionAudioCatalogue;
8785
9212
  procession_graphic_catalogue?: ProcessionGraphicCatalogue;
8786
9213
  solar_power_in_space?: double;
@@ -8820,15 +9247,16 @@ interface SpacePlatformHubPrototype extends EntityWithOwnerPrototype {
8820
9247
  default_speed_signal?: SignalIDConnector;
8821
9248
  draw_circuit_wires?: boolean;
8822
9249
  draw_copper_wires?: boolean;
8823
- /**
8824
- * Name of a {@link ContainerPrototype | prototype:ContainerPrototype}.
8825
- */
8826
- dump_container: EntityID;
8827
9250
  graphics_set?: CargoBayConnectableGraphicsSet;
8828
9251
  inventory_size: ItemStackIndex;
8829
9252
  persistent_ambient_sounds?: PersistentWorldAmbientSoundsDefinition;
9253
+ /**
9254
+ * Repair speed of entities is multiplied by this value when they are on a space platform with this hub prototype.
9255
+ */
8830
9256
  platform_repair_speed_modifier?: float;
8831
- surface_render_parameters?: SurfaceRenderParameters;
9257
+ /**
9258
+ * Weight which this entity adds to total space platform weight when placed.
9259
+ */
8832
9260
  weight?: Weight;
8833
9261
  }
8834
9262
  interface SpacePlatformStarterPackPrototype extends ItemPrototype {
@@ -8915,13 +9343,25 @@ interface SpiderLegPrototype extends EntityWithOwnerPrototype {
8915
9343
  stretch_force_scalar?: double;
8916
9344
  target_position_randomisation_distance: double;
8917
9345
  upper_leg_dying_trigger_effects?: SpiderLegTriggerEffect[];
9346
+ /**
9347
+ * Must be larger than 0.
9348
+ */
8918
9349
  walking_sound_speed_modifier?: float;
9350
+ /**
9351
+ * Cannot be negative.
9352
+ */
8919
9353
  walking_sound_volume_modifier?: float;
8920
9354
  }
8921
9355
  interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
8922
9356
  absorptions_to_join_attack?: Record<AirbornePollutantID, float>;
8923
9357
  ai_settings?: UnitAISettings;
8924
9358
  attack_parameters: AttackParameters;
9359
+ /**
9360
+ * A list of entity prototypes that this spider unit can build when given the build base command.
9361
+ *
9362
+ * If empty or not specified, the spider unit cannot build anything.
9363
+ */
9364
+ buildable_entities?: EntityID[];
8925
9365
  distraction_cooldown: uint32;
8926
9366
  dying_sound?: Sound;
8927
9367
  graphics_set?: SpiderTorsoGraphicsSet;
@@ -8937,6 +9377,7 @@ interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
8937
9377
  radar_range?: uint32;
8938
9378
  spawning_time_modifier?: double;
8939
9379
  spider_engine: SpiderEngineSpecification;
9380
+ steering?: SteeringSettings;
8940
9381
  /**
8941
9382
  * Cannot be negative.
8942
9383
  */
@@ -9378,6 +9819,7 @@ interface StorageTankPrototype extends EntityWithOwnerPrototype {
9378
9819
  CircuitConnectorDefinition
9379
9820
  ];
9380
9821
  circuit_wire_max_distance?: double;
9822
+ default_fluid_temperature_signal?: SignalIDConnector;
9381
9823
  draw_circuit_wires?: boolean;
9382
9824
  draw_copper_wires?: boolean;
9383
9825
  /**
@@ -9394,6 +9836,10 @@ interface StorageTankPrototype extends EntityWithOwnerPrototype {
9394
9836
  * Whether the "alt-mode icon" should be drawn at all.
9395
9837
  */
9396
9838
  show_fluid_icon?: boolean;
9839
+ /**
9840
+ * When this is true, fluid pipelines will be visualized when this entity is held in the cursor.
9841
+ */
9842
+ show_fluid_visualization_when_in_cursor?: boolean;
9397
9843
  two_direction_only?: boolean;
9398
9844
  /**
9399
9845
  * The location of the window showing the contents. Note that for `window_background` the width and height are determined by the sprite and window_bounding_box only determines the drawing location. For `fluid_background` the width is determined by the sprite and the height and drawing location are determined by window_bounding_box.
@@ -9674,7 +10120,7 @@ interface TilePrototype extends Prototype {
9674
10120
  * If set to true, the game will check for collisions with entities before building or mining the tile. If entities are in the way it is not possible to mine/build the tile.
9675
10121
  */
9676
10122
  check_collision_with_entities?: boolean;
9677
- collision_mask: CollisionMaskConnector;
10123
+ collision_mask: TileCollisionMaskConnector;
9678
10124
  decorative_removal_probability?: float;
9679
10125
  default_cover_tile?: TileID;
9680
10126
  /**
@@ -9848,7 +10294,7 @@ interface TipsAndTricksItemCategory {
9848
10294
  type: 'tips-and-tricks-item-category';
9849
10295
  }
9850
10296
  /**
9851
- * Items with a "durability". Used for {@link science packs | https://wiki.factorio.com/Science_pack}.
10297
+ * Items with a "durability".
9852
10298
  */
9853
10299
  interface ToolPrototype extends ItemPrototype {
9854
10300
  /**
@@ -9990,7 +10436,7 @@ interface TreePrototype extends EntityWithHealthPrototype {
9990
10436
  colors?: Color[];
9991
10437
  darkness_of_burnt_tree?: float;
9992
10438
  /**
9993
- * The amount of health automatically regenerated. Trees will regenerate every 60 ticks with `healing_per_tick × 60`.
10439
+ * The amount of health automatically regenerated.
9994
10440
  * @example ```
9995
10441
  healing_per_tick = 0.01
9996
10442
  ```
@@ -10135,6 +10581,7 @@ interface TurretPrototype extends EntityWithOwnerPrototype {
10135
10581
  * Whether this prototype should be a high priority target for enemy forces. See {@link Military units and structures | https://wiki.factorio.com/Military_units_and_structures}.
10136
10582
  */
10137
10583
  is_military_target?: boolean;
10584
+ leave_attacking_if_shoot_fails?: boolean;
10138
10585
  prepare_range?: double;
10139
10586
  prepared_alternative_animation?: RotatedAnimation8Way;
10140
10587
  /**
@@ -10226,7 +10673,7 @@ interface TutorialDefinition extends PrototypeBase {
10226
10673
  */
10227
10674
  order?: Order;
10228
10675
  /**
10229
- * Name of the folder for this tutorial scenario in the {@link `tutorials` folder | runtime:mod-structure}.
10676
+ * Name of the folder for this tutorial scenario in the {@link `tutorials` folder | auxiliary:mod-structure}.
10230
10677
  */
10231
10678
  scenario: string;
10232
10679
  }
@@ -10264,6 +10711,12 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10264
10711
  * Requires `animation` in attack_parameters. Requires `ammo_type` in attack_parameters.
10265
10712
  */
10266
10713
  attack_parameters: AttackParameters;
10714
+ /**
10715
+ * A list of entity prototypes that this unit can build when given the build base command.
10716
+ *
10717
+ * If empty or not specified, the unit cannot build anything.
10718
+ */
10719
+ buildable_entities?: EntityID[];
10267
10720
  can_open_gates?: boolean;
10268
10721
  /**
10269
10722
  * How fast the `run_animation` frames are advanced. The animations are advanced animation_speed frames per `distance_per_frame` that the unit moves.
@@ -10312,6 +10765,7 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
10312
10765
  * Multiplier for the {@link EnemySpawnerPrototype::spawning_cooldown | prototype:EnemySpawnerPrototype::spawning_cooldown} after it spawns this unit.
10313
10766
  */
10314
10767
  spawning_time_modifier?: double;
10768
+ steering?: SteeringSettings;
10315
10769
  /**
10316
10770
  * Max is 100.
10317
10771
  *
@@ -10439,9 +10893,9 @@ interface UtilityConstants extends PrototypeBase {
10439
10893
  */
10440
10894
  blueprint_small_slots_per_row: uint8;
10441
10895
  /**
10442
- * The base game uses more entries here that are applied via the ammo-category.lua file.
10896
+ * The base game uses more entries here that are applied via the `ammo-category.lua` file.
10443
10897
  */
10444
- bonus_gui_ordering: BonusGuiOrdering;
10898
+ bonus_gui_ordering: BonusUtilityConstants;
10445
10899
  building_buildable_tint: Color;
10446
10900
  building_buildable_too_far_tint: Color;
10447
10901
  building_collision_mask: CollisionMaskConnector;
@@ -10493,7 +10947,12 @@ interface UtilityConstants extends PrototypeBase {
10493
10947
  * Must contain arrival and departure with {@link procession_style | prototype:ProcessionPrototype::procession_style} containing 0.
10494
10948
  */
10495
10949
  default_platform_procession_set: ProcessionSet;
10950
+ default_platform_surface_render_parameters: SurfaceRenderParameters;
10496
10951
  default_player_force_color: Color;
10952
+ /**
10953
+ * Used for "Rocket capacity" item tooltip and for comparing rocket silo lift weight in GUI to this value.
10954
+ */
10955
+ default_rocket_lift_weight: Weight;
10497
10956
  default_scorch_mark_color: Color;
10498
10957
  /**
10499
10958
  * The strings are entity types.
@@ -10501,7 +10960,7 @@ interface UtilityConstants extends PrototypeBase {
10501
10960
  default_trigger_target_mask_by_type?: Record<string, TriggerTargetMask>;
10502
10961
  disabled_recipe_slot_background_tint: Color;
10503
10962
  disabled_recipe_slot_tint: Color;
10504
- drop_item_radius: float;
10963
+ drop_item_radius: double;
10505
10964
  dynamic_recipe_overload_factor: double;
10506
10965
  /**
10507
10966
  * Silently clamped to be between 0 and 0.99.
@@ -10527,25 +10986,33 @@ interface UtilityConstants extends PrototypeBase {
10527
10986
  equipment_default_background_border_color: Color;
10528
10987
  equipment_default_background_color: Color;
10529
10988
  equipment_default_grabbed_background_color: Color;
10989
+ equipment_disabled_background_tint: Color;
10990
+ equipment_disabled_tint: Color;
10530
10991
  explosions_in_simulation_volume_modifier: float;
10531
10992
  factoriopedia_recycling_recipe_categories: RecipeCategoryID[];
10993
+ far_away_chunk_generation_radius: uint8;
10532
10994
  feedback_screenshot_file_name: string;
10533
10995
  feedback_screenshot_subfolder_name: string;
10534
10996
  filter_outline_color: Color;
10535
10997
  /**
10536
10998
  * Must be >= 1.
10537
10999
  */
10538
- flying_text_ttl: uint32;
11000
+ flying_text_ttl: int32;
10539
11001
  forced_enabled_recipe_slot_background_tint: Color;
11002
+ /**
11003
+ * Will be clamped to a positive number, starting at 0.
11004
+ */
10540
11005
  freezing_temperature: double;
10541
11006
  frozen_color_lookup: ColorLookupTable;
10542
11007
  ghost_layer: CollisionLayerID;
11008
+ ghost_product_count_tint: Color;
10543
11009
  ghost_shader_tint: GhostTintSet;
10544
11010
  ghost_shaderless_tint: GhostTintSet;
10545
11011
  ghost_shimmer_settings: GhostShimmerConfig;
10546
11012
  gui_remark_color: Color;
10547
11013
  gui_search_match_background_color: Color;
10548
11014
  gui_search_match_foreground_color: Color;
11015
+ huge_area_size: float;
10549
11016
  huge_platform_animation_sound_area: float;
10550
11017
  icon_shadow_color: Color;
10551
11018
  icon_shadow_inset: float;
@@ -10607,12 +11074,11 @@ interface UtilityConstants extends PrototypeBase {
10607
11074
  */
10608
11075
  main_menu_simulations?: Record<string, SimulationDefinition>;
10609
11076
  manual_rail_building_reach_modifier: double;
10610
- map_editor: MapEditorConstants;
11077
+ map_editor: EditorUtilityConstants;
10611
11078
  /**
10612
11079
  * Must be >= 1.
10613
11080
  */
10614
11081
  max_belt_stack_size: uint8;
10615
- max_fluid_flow: FluidAmount;
10616
11082
  max_logistic_filter_count: LogisticFilterIndex;
10617
11083
  max_terrain_building_size: uint8;
10618
11084
  /**
@@ -10623,11 +11089,9 @@ interface UtilityConstants extends PrototypeBase {
10623
11089
  medium_area_size: float;
10624
11090
  medium_blueprint_area_size: float;
10625
11091
  /**
10626
- * If not set, defaults to 'true' when modded and 'false' when vanilla.
11092
+ * If not set, defaults to `true` when modded and `false` when vanilla.
10627
11093
  */
10628
11094
  merge_bonus_gui_production_bonuses?: boolean;
10629
- minimap_slot_clicked_tint: Color;
10630
- minimap_slot_hovered_tint: Color;
10631
11095
  minimum_recipe_overload_multiplier: uint32;
10632
11096
  missing_preview_sprite_location: FileName;
10633
11097
  /**
@@ -10649,7 +11113,6 @@ interface UtilityConstants extends PrototypeBase {
10649
11113
  recipe_step_limit: uint32;
10650
11114
  remote_view_LPF_max_cutoff_frequency: float;
10651
11115
  remote_view_LPF_min_cutoff_frequency: float;
10652
- rocket_lift_weight: Weight;
10653
11116
  script_command_console_chat_color: Color;
10654
11117
  /**
10655
11118
  * Will be clamped to the range [1, 100].
@@ -10664,10 +11127,11 @@ interface UtilityConstants extends PrototypeBase {
10664
11127
  show_chunk_components_collision_mask: CollisionMaskConnector;
10665
11128
  small_area_size: float;
10666
11129
  small_blueprint_area_size: float;
11130
+ sound_fade_ticks: uint32;
10667
11131
  space_LPF_max_cutoff_frequency: float;
10668
11132
  space_LPF_min_cutoff_frequency: float;
10669
11133
  /**
10670
- * Variables: speed, thrust, weight, width, height
11134
+ * Variables: `speed, thrust, weight, width, height`
10671
11135
  */
10672
11136
  space_platform_acceleration_expression: MathExpression;
10673
11137
  /**
@@ -10694,6 +11158,14 @@ interface UtilityConstants extends PrototypeBase {
10694
11158
  starmap_orbit_default_color: Color;
10695
11159
  starmap_orbit_disabled_color: Color;
10696
11160
  starmap_orbit_hovered_color: Color;
11161
+ /**
11162
+ * All trivial smoke will be tinted with this value when "Hide tall entities" mode is active.
11163
+ */
11164
+ tall_entity_smoke_tint: Color;
11165
+ /**
11166
+ * Tall entities will be tinted with this value when "Hide tall entities" mode is active.
11167
+ */
11168
+ tall_entity_tint: Color;
10697
11169
  /**
10698
11170
  * The number of ticks to show a segmented unit's health bar after fully regenerating.
10699
11171
  */
@@ -10732,7 +11204,7 @@ interface UtilityConstants extends PrototypeBase {
10732
11204
  * Silently clamped to be between 0 and 1.
10733
11205
  */
10734
11206
  walking_sound_count_reduction_rate: float;
10735
- water_collision_mask: CollisionMaskConnector;
11207
+ water_collision_mask: TileCollisionMaskConnector;
10736
11208
  weapons_in_simulation_volume_modifier: float;
10737
11209
  zero_count_value_tint: Color;
10738
11210
  zoom_to_world_can_use_nightvision: boolean;
@@ -10743,74 +11215,355 @@ interface UtilityConstants extends PrototypeBase {
10743
11215
  * Sounds used by the game that are not specific to certain prototypes.
10744
11216
  */
10745
11217
  interface UtilitySounds extends PrototypeBase {
11218
+ /**
11219
+ * Sound category `"gui-effect"`.
11220
+ */
10746
11221
  achievement_unlocked: Sound;
11222
+ /**
11223
+ * Sound category `"gui-effect"`.
11224
+ */
11225
+ adjust_blueprint_snapping: Sound;
11226
+ /**
11227
+ * Sound category `"alert"`.
11228
+ */
10747
11229
  alert_destroyed: Sound;
11230
+ /**
11231
+ * Sound category `"gui-effect"`.
11232
+ */
10748
11233
  armor_insert: Sound;
11234
+ /**
11235
+ * Sound category `"gui-effect"`.
11236
+ */
10749
11237
  armor_remove: Sound;
11238
+ /**
11239
+ * Sound category `"game-effect"`.
11240
+ */
10750
11241
  axe_fighting: Sound;
11242
+ /**
11243
+ * Sound category `"game-effect"`.
11244
+ */
10751
11245
  axe_mining_ore: Sound;
11246
+ /**
11247
+ * Sound category `"game-effect"`.
11248
+ */
10752
11249
  axe_mining_stone: Sound;
11250
+ /**
11251
+ * Sound category `"gui-effect"`.
11252
+ */
11253
+ blueprint_preview_build: Sound;
11254
+ /**
11255
+ * Sound category `"gui-effect"`.
11256
+ */
11257
+ blueprint_preview_mine: Sound;
11258
+ /**
11259
+ * Sound category `"game-effect"`.
11260
+ */
10753
11261
  build_animated_huge: Sound;
11262
+ /**
11263
+ * Sound category `"game-effect"`.
11264
+ */
10754
11265
  build_animated_large: Sound;
11266
+ /**
11267
+ * Sound category `"game-effect"`.
11268
+ */
10755
11269
  build_animated_medium: Sound;
11270
+ /**
11271
+ * Sound category `"game-effect"`.
11272
+ */
10756
11273
  build_animated_small: Sound;
11274
+ /**
11275
+ * Sound category `"game-effect"`.
11276
+ */
11277
+ build_behemoth: Sound;
11278
+ /**
11279
+ * Sound category `"game-effect"`.
11280
+ */
10757
11281
  build_blueprint_huge: Sound;
11282
+ /**
11283
+ * Sound category `"game-effect"`.
11284
+ */
10758
11285
  build_blueprint_large: Sound;
11286
+ /**
11287
+ * Sound category `"game-effect"`.
11288
+ */
10759
11289
  build_blueprint_medium: Sound;
11290
+ /**
11291
+ * Sound category `"game-effect"`.
11292
+ */
10760
11293
  build_blueprint_small: Sound;
11294
+ /**
11295
+ * Sound category `"game-effect"`.
11296
+ */
10761
11297
  build_ghost_upgrade: Sound;
11298
+ /**
11299
+ * Sound category `"game-effect"`.
11300
+ */
10762
11301
  build_ghost_upgrade_cancel: Sound;
11302
+ /**
11303
+ * Sound category `"game-effect"`.
11304
+ */
10763
11305
  build_huge: Sound;
11306
+ /**
11307
+ * Sound category `"game-effect"`.
11308
+ */
10764
11309
  build_large: Sound;
11310
+ /**
11311
+ * Sound category `"game-effect"`.
11312
+ */
10765
11313
  build_medium: Sound;
11314
+ /**
11315
+ * Sound category `"game-effect"`.
11316
+ */
10766
11317
  build_small: Sound;
11318
+ /**
11319
+ * Sound category `"gui-effect"`.
11320
+ */
10767
11321
  cannot_build: Sound;
11322
+ /**
11323
+ * Sound category `"gui-effect"`.
11324
+ */
11325
+ change_quality: Sound;
11326
+ /**
11327
+ * Sound category `"gui-effect"`.
11328
+ */
10768
11329
  clear_cursor: Sound;
11330
+ /**
11331
+ * Sound category `"gui-effect"`.
11332
+ */
10769
11333
  confirm: Sound;
11334
+ /**
11335
+ * Sound category `"gui-effect"`.
11336
+ */
10770
11337
  console_message: Sound;
11338
+ /**
11339
+ * Sound category `"gui-effect"`.
11340
+ */
11341
+ console_platform_created: Sound;
11342
+ /**
11343
+ * Sound category `"gui-effect"`.
11344
+ */
11345
+ console_platform_destroyed: Sound;
11346
+ /**
11347
+ * Sound category `"gui-effect"`.
11348
+ */
11349
+ console_player_changed_logistic_group: Sound;
11350
+ /**
11351
+ * Sound category `"gui-effect"`.
11352
+ */
11353
+ console_player_died: Sound;
11354
+ /**
11355
+ * Sound category `"gui-effect"`.
11356
+ */
11357
+ console_player_joined: Sound;
11358
+ /**
11359
+ * Sound category `"gui-effect"`.
11360
+ */
11361
+ console_player_left: Sound;
11362
+ /**
11363
+ * Sound category `"gui-effect"`.
11364
+ */
11365
+ console_player_paused_game: Sound;
11366
+ /**
11367
+ * Sound category `"gui-effect"`.
11368
+ */
11369
+ console_player_research: Sound;
11370
+ /**
11371
+ * Sound category `"gui-effect"`.
11372
+ */
11373
+ console_player_respawned: Sound;
11374
+ /**
11375
+ * Sound category `"gui-effect"`.
11376
+ */
11377
+ console_player_resumed_game: Sound;
11378
+ /**
11379
+ * Sound category `"gui-effect"`.
11380
+ */
10771
11381
  crafting_finished: Sound;
11382
+ /**
11383
+ * Sound category `"gui-effect"`.
11384
+ */
11385
+ cycle_blueprint_book: Sound;
11386
+ /**
11387
+ * Sound category `"game-effect"`.
11388
+ */
11389
+ deconstruct_behemoth: Sound;
11390
+ /**
11391
+ * Sound category `"game-effect"`.
11392
+ */
10772
11393
  deconstruct_huge: Sound;
11394
+ /**
11395
+ * Sound category `"game-effect"`.
11396
+ */
10773
11397
  deconstruct_large: Sound;
11398
+ /**
11399
+ * Sound category `"game-effect"`.
11400
+ */
10774
11401
  deconstruct_medium: Sound;
11402
+ /**
11403
+ * Sound category `"game-effect"`.
11404
+ */
10775
11405
  deconstruct_robot: Sound;
11406
+ /**
11407
+ * Sound category `"game-effect"`.
11408
+ */
10776
11409
  deconstruct_small: Sound;
11410
+ /**
11411
+ * Sound category `"walking"`.
11412
+ */
10777
11413
  default_driving_sound: InterruptibleSound;
11414
+ /**
11415
+ * Sound category `"walking"`.
11416
+ */
10778
11417
  default_landing_steps: Sound;
11418
+ /**
11419
+ * Sound category `"game-effect"`.
11420
+ */
10779
11421
  default_manual_repair: Sound;
11422
+ /**
11423
+ * Sound category `"game-effect"`.
11424
+ */
10780
11425
  drop_item: Sound;
11426
+ /**
11427
+ * Sound category `"gui-effect"`.
11428
+ */
10781
11429
  entity_settings_copied: Sound;
11430
+ /**
11431
+ * Sound category `"gui-effect"`.
11432
+ */
10782
11433
  entity_settings_pasted: Sound;
11434
+ /**
11435
+ * Sound category `"gui-effect"`.
11436
+ */
10783
11437
  game_lost: Sound;
11438
+ /**
11439
+ * Sound category `"gui-effect"`.
11440
+ */
10784
11441
  game_won: Sound;
11442
+ /**
11443
+ * Sound category `"gui-effect"`.
11444
+ */
10785
11445
  gui_click: Sound;
11446
+ /**
11447
+ * Sound category `"gui-effect"`.
11448
+ */
10786
11449
  gui_switch: Sound;
11450
+ /**
11451
+ * Sound category `"gui-effect"`.
11452
+ */
11453
+ gui_tab: Sound;
11454
+ /**
11455
+ * Sound category `"gui-effect"`.
11456
+ */
11457
+ gui_toggle: Sound;
11458
+ /**
11459
+ * Sound category `"walking"`.
11460
+ */
11461
+ heat_pipe_walking_sound: Sound;
11462
+ /**
11463
+ * Sound category `"gui-effect"`.
11464
+ */
10787
11465
  inventory_click: Sound;
11466
+ /**
11467
+ * Sound category `"gui-effect"`.
11468
+ */
10788
11469
  inventory_move: Sound;
11470
+ /**
11471
+ * Sound category `"gui-effect"`.
11472
+ */
10789
11473
  item_deleted: Sound;
11474
+ /**
11475
+ * Sound category `"gui-effect"`.
11476
+ */
10790
11477
  item_spawned: Sound;
11478
+ /**
11479
+ * Sound category `"gui-effect"`.
11480
+ */
10791
11481
  list_box_click: Sound;
11482
+ /**
11483
+ * Sound category `"walking"`.
11484
+ */
10792
11485
  metal_walking_sound: Sound;
11486
+ /**
11487
+ * Sound category `"game-effect"`.
11488
+ */
10793
11489
  mining_wood: Sound;
11490
+ /**
11491
+ * Sound category `"gui-effect"`.
11492
+ */
10794
11493
  new_objective: Sound;
11494
+ /**
11495
+ * Sound category `"gui-effect"`.
11496
+ */
10795
11497
  paste_activated: Sound;
11498
+ /**
11499
+ * Sound category `"game-effect"`.
11500
+ */
10796
11501
  picked_up_item: Sound;
11502
+ /**
11503
+ * Sound category `"gui-effect"`.
11504
+ */
10797
11505
  rail_plan_start: Sound;
11506
+ /**
11507
+ * Sound category `"gui-effect"`.
11508
+ */
10798
11509
  research_completed: Sound;
11510
+ /**
11511
+ * Sound category `"game-effect"`.
11512
+ */
10799
11513
  rotated_huge: Sound;
11514
+ /**
11515
+ * Sound category `"game-effect"`.
11516
+ */
10800
11517
  rotated_large: Sound;
11518
+ /**
11519
+ * Sound category `"game-effect"`.
11520
+ */
10801
11521
  rotated_medium: Sound;
11522
+ /**
11523
+ * Sound category `"game-effect"`.
11524
+ */
10802
11525
  rotated_small: Sound;
11526
+ /**
11527
+ * Sound category `"gui-effect"`.
11528
+ */
10803
11529
  scenario_message: Sound;
10804
11530
  /**
11531
+ * Sound category `"enemy"`.
11532
+ *
10805
11533
  * Only present when the Space Age mod is loaded.
10806
11534
  */
10807
11535
  segment_dying_sound?: Sound;
11536
+ /**
11537
+ * Sound category `"gui-effect"`.
11538
+ */
10808
11539
  smart_pipette: Sound;
11540
+ /**
11541
+ * Sound category `"gui-effect"`.
11542
+ */
10809
11543
  switch_gun: Sound;
11544
+ /**
11545
+ * Sound category `"gui-effect"`.
11546
+ */
11547
+ toggle_show_entity_info: Sound;
11548
+ /**
11549
+ * Sound category `"gui-effect"`.
11550
+ */
10810
11551
  tutorial_notice: Sound;
11552
+ /**
11553
+ * Sound category `"gui-effect"`.
11554
+ */
10811
11555
  undo: Sound;
11556
+ /**
11557
+ * Sound category `"game-effect"`.
11558
+ */
10812
11559
  wire_connect_pole: Sound;
11560
+ /**
11561
+ * Sound category `"game-effect"`.
11562
+ */
10813
11563
  wire_disconnect: Sound;
11564
+ /**
11565
+ * Sound category `"game-effect"`.
11566
+ */
10814
11567
  wire_pickup: Sound;
10815
11568
  }
10816
11569
  /**
@@ -10856,6 +11609,7 @@ interface UtilitySprites extends PrototypeBase {
10856
11609
  bulk_inserter_capacity_bonus_modifier_icon: Sprite;
10857
11610
  cable_editor_icon: Sprite;
10858
11611
  cargo_bay_not_connected_icon: Sprite;
11612
+ cargo_bay_too_far_from_source_icon: Sprite;
10859
11613
  cargo_landing_pad_count_modifier_constant?: Sprite;
10860
11614
  cargo_landing_pad_count_modifier_icon: Sprite;
10861
11615
  center: Sprite;
@@ -11136,10 +11890,10 @@ interface UtilitySprites extends PrototypeBase {
11136
11890
  fluid_icon: Sprite;
11137
11891
  fluid_indication_arrow: Sprite;
11138
11892
  fluid_indication_arrow_both_ways: Sprite;
11893
+ fluid_mixing_icon: Sprite;
11139
11894
  fluid_visualization_connection: Sprite;
11140
11895
  fluid_visualization_connection_both_ways: Sprite;
11141
11896
  fluid_visualization_connection_underground: Sprite;
11142
- fluid_visualization_extent_arrow: Sprite;
11143
11897
  follower_robot_lifetime_modifier_constant?: Sprite;
11144
11898
  follower_robot_lifetime_modifier_icon: Sprite;
11145
11899
  force_editor_icon: Sprite;
@@ -11201,6 +11955,8 @@ interface UtilitySprites extends PrototypeBase {
11201
11955
  lua_snippet_tool_icon: Sprite;
11202
11956
  map: Sprite;
11203
11957
  map_exchange_string: Sprite;
11958
+ max_cargo_bay_unloading_distance_modifier_constant?: Sprite;
11959
+ max_cargo_bay_unloading_distance_modifier_icon: Sprite;
11204
11960
  max_distance_underground_remove_belts: Sprite;
11205
11961
  max_failed_attempts_per_tick_per_construction_queue_modifier_constant?: Sprite;
11206
11962
  max_failed_attempts_per_tick_per_construction_queue_modifier_icon: Sprite;
@@ -11275,6 +12031,8 @@ interface UtilitySprites extends PrototypeBase {
11275
12031
  rebuild_mark: Sprite;
11276
12032
  recharge_icon: Sprite;
11277
12033
  recipe_arrow: Sprite;
12034
+ recipe_ghost_arrow: Sprite;
12035
+ recipe_potential_arrow: Sprite;
11278
12036
  red_wire: Sprite;
11279
12037
  red_wire_highlight: Sprite;
11280
12038
  reference_point: Sprite;
@@ -11341,7 +12099,10 @@ interface UtilitySprites extends PrototypeBase {
11341
12099
  starmap_platform_stopped: Sprite;
11342
12100
  starmap_platform_stopped_clicked: Sprite;
11343
12101
  starmap_platform_stopped_hovered: Sprite;
11344
- starmap_star: Sprite;
12102
+ /**
12103
+ * Only present when the space travel flag is enabled.
12104
+ */
12105
+ starmap_star?: Sprite;
11345
12106
  station_name: Sprite;
11346
12107
  status_blue: Sprite;
11347
12108
  status_inactive: Sprite;
@@ -11380,6 +12141,8 @@ interface UtilitySprites extends PrototypeBase {
11380
12141
  underground_remove_pipes: Sprite;
11381
12142
  unlock_circuit_network_modifier_constant?: Sprite;
11382
12143
  unlock_circuit_network_modifier_icon: Sprite;
12144
+ unlock_logistic_network_modifier_constant?: Sprite;
12145
+ unlock_logistic_network_modifier_icon: Sprite;
11383
12146
  unlock_quality_modifier_constant?: Sprite;
11384
12147
  unlock_quality_modifier_icon: Sprite;
11385
12148
  unlock_recipe_modifier_constant?: Sprite;
@@ -11388,6 +12151,8 @@ interface UtilitySprites extends PrototypeBase {
11388
12151
  unlock_space_location_modifier_icon: Sprite;
11389
12152
  unlock_space_platforms_modifier_constant?: Sprite;
11390
12153
  unlock_space_platforms_modifier_icon: Sprite;
12154
+ unlock_travel_to_space_platforms_modifier_constant?: Sprite;
12155
+ unlock_travel_to_space_platforms_modifier_icon: Sprite;
11391
12156
  upgrade_blueprint: Sprite;
11392
12157
  upgrade_mark: Sprite;
11393
12158
  variations_tool_icon: Sprite;
@@ -11437,9 +12202,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
11437
12202
  allow_passengers?: boolean;
11438
12203
  allow_remote_driving?: boolean;
11439
12204
  /**
11440
- * Must be positive. There is no functional difference between the two ways to set braking power/force.
12205
+ * Must be positive.
11441
12206
  */
11442
- braking_power: Energy | double;
12207
+ braking_force: double;
11443
12208
  /**
11444
12209
  * In chunks. The radius of the radar range of the vehicle, so how many chunks it charts around itself.
11445
12210
  */
@@ -11458,9 +12223,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
11458
12223
  */
11459
12224
  equipment_grid?: EquipmentGridID;
11460
12225
  /**
11461
- * Must be positive. There is no functional difference between the two ways to set friction force.
12226
+ * Must be positive.
11462
12227
  */
11463
- friction: double;
12228
+ friction_force: double;
11464
12229
  impact_speed_to_volume_ratio?: double;
11465
12230
  /**
11466
12231
  * The sprite that represents this vehicle on the map/minimap.
@@ -11688,6 +12453,8 @@ type dataExtendType = ({
11688
12453
  } & DontUseEntityInEnergyProductionAchievementPrototype) | ({
11689
12454
  type: 'editor-controller';
11690
12455
  } & EditorControllerPrototype) | ({
12456
+ type: 'electric-energy-interface-equipment';
12457
+ } & ElectricEnergyInterfaceEquipmentPrototype) | ({
11691
12458
  type: 'electric-energy-interface';
11692
12459
  } & ElectricEnergyInterfacePrototype) | ({
11693
12460
  type: 'electric-pole';