typed-factorio 3.21.0 → 3.23.0

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.
@@ -13,7 +13,7 @@ declare module "factorio:runtime" {
13
13
  * script.on_event("my-potato-control", function(event)
14
14
  * game.print("Keyboard shortcut pressed on tick: " ..tostring(event.tick))
15
15
  * end)
16
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#CustomInputEvent Online documentation}
16
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#CustomInputEvent Online documentation}
17
17
  */
18
18
  interface CustomInputEvent extends EventData {
19
19
  /**
@@ -51,7 +51,7 @@ declare module "factorio:runtime" {
51
51
  }
52
52
  /**
53
53
  * Called when an achievement is gained.
54
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_achievement_gained Online documentation}
54
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_achievement_gained Online documentation}
55
55
  */
56
56
  interface OnAchievementGainedEvent extends EventData {
57
57
  /**
@@ -70,7 +70,7 @@ declare module "factorio:runtime" {
70
70
  }
71
71
  /**
72
72
  * Called when a unit/group completes a command.
73
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_ai_command_completed Online documentation}
73
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_ai_command_completed Online documentation}
74
74
  */
75
75
  interface OnAiCommandCompletedEvent extends EventData {
76
76
  /**
@@ -93,7 +93,7 @@ declare module "factorio:runtime" {
93
93
  }
94
94
  /**
95
95
  * Called when an area of the map is cloned.
96
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_area_cloned Online documentation}
96
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_area_cloned Online documentation}
97
97
  */
98
98
  interface OnAreaClonedEvent extends EventData {
99
99
  readonly source_surface: LuaSurface
@@ -119,7 +119,7 @@ declare module "factorio:runtime" {
119
119
  * Called when a biter migration builds a base.
120
120
  *
121
121
  * This will be called multiple times for each migration, once for every biter that is sacrificed to build part of the new base.
122
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_biter_base_built Online documentation}
122
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_biter_base_built Online documentation}
123
123
  */
124
124
  interface OnBiterBaseBuiltEvent extends EventData {
125
125
  /**
@@ -137,7 +137,7 @@ declare module "factorio:runtime" {
137
137
  }
138
138
  /**
139
139
  * Called when a set of positions on the map is cloned.
140
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_brush_cloned Online documentation}
140
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_brush_cloned Online documentation}
141
141
  */
142
142
  interface OnBrushClonedEvent extends EventData {
143
143
  readonly source_offset: TilePosition
@@ -162,7 +162,7 @@ declare module "factorio:runtime" {
162
162
  }
163
163
  /**
164
164
  * Called when a {@link defines.command.build_base} command reaches its destination, and before building starts.
165
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_build_base_arrived Online documentation}
165
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_build_base_arrived Online documentation}
166
166
  */
167
167
  interface OnBuildBaseArrivedEvent extends EventData {
168
168
  /**
@@ -186,11 +186,20 @@ declare module "factorio:runtime" {
186
186
  * Called when player builds something.
187
187
  *
188
188
  * Event filter: [LuaPlayerBuiltEntityEventFilter](LuaPlayerBuiltEntityEventFilter]
189
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_built_entity Online documentation}
189
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_built_entity Online documentation}
190
190
  */
191
191
  interface OnBuiltEntityEvent extends EventData {
192
+ /**
193
+ * The entity that was built.
194
+ */
192
195
  readonly entity: LuaEntity
196
+ /**
197
+ * The player who did the building.
198
+ */
193
199
  readonly player_index: PlayerIndex
200
+ /**
201
+ * A temporary inventory containing all items that the game used to build the entity. This inventory is temporary and thus invalidated after the event.
202
+ */
194
203
  readonly consumed_items: LuaInventory
195
204
  /**
196
205
  * The tags associated with this entity if any.
@@ -209,7 +218,7 @@ declare module "factorio:runtime" {
209
218
  * Called when the deconstruction of an entity is canceled.
210
219
  *
211
220
  * Event filter: [LuaEntityDeconstructionCancelledEventFilter](LuaEntityDeconstructionCancelledEventFilter]
212
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cancelled_deconstruction Online documentation}
221
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cancelled_deconstruction Online documentation}
213
222
  */
214
223
  interface OnCancelledDeconstructionEvent extends EventData {
215
224
  readonly entity: LuaEntity
@@ -227,7 +236,7 @@ declare module "factorio:runtime" {
227
236
  * Called when the upgrade of an entity is canceled.
228
237
  *
229
238
  * Event filter: [LuaUpgradeCancelledEventFilter](LuaUpgradeCancelledEventFilter]
230
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cancelled_upgrade Online documentation}
239
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cancelled_upgrade Online documentation}
231
240
  */
232
241
  interface OnCancelledUpgradeEvent extends EventData {
233
242
  readonly entity: LuaEntity
@@ -245,7 +254,7 @@ declare module "factorio:runtime" {
245
254
  }
246
255
  /**
247
256
  * Called after a cargo pod has delivered its cargo.
248
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cargo_pod_delivered_cargo Online documentation}
257
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cargo_pod_delivered_cargo Online documentation}
249
258
  */
250
259
  interface OnCargoPodDeliveredCargoEvent extends EventData {
251
260
  readonly cargo_pod: LuaEntity
@@ -264,7 +273,7 @@ declare module "factorio:runtime" {
264
273
  }
265
274
  /**
266
275
  * Called when a cargo pod departs a surface.
267
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cargo_pod_finished_ascending Online documentation}
276
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cargo_pod_finished_ascending Online documentation}
268
277
  */
269
278
  interface OnCargoPodFinishedAscendingEvent extends EventData {
270
279
  readonly cargo_pod: LuaEntity
@@ -287,7 +296,7 @@ declare module "factorio:runtime" {
287
296
  }
288
297
  /**
289
298
  * Called when a cargo pods lands on a surface, either at a station or on the ground.
290
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cargo_pod_finished_descending Online documentation}
299
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cargo_pod_finished_descending Online documentation}
291
300
  */
292
301
  interface OnCargoPodFinishedDescendingEvent extends EventData {
293
302
  readonly cargo_pod: LuaEntity
@@ -312,7 +321,7 @@ declare module "factorio:runtime" {
312
321
  * Called when a character corpse expires due to timeout or all of the items being removed from it.
313
322
  *
314
323
  * this is not called if the corpse is mined. See {@link defines.events.on_pre_player_mined_item} to detect that.
315
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_character_corpse_expired Online documentation}
324
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_character_corpse_expired Online documentation}
316
325
  */
317
326
  interface OnCharacterCorpseExpiredEvent extends EventData {
318
327
  /**
@@ -330,7 +339,7 @@ declare module "factorio:runtime" {
330
339
  }
331
340
  /**
332
341
  * Called when a chart tag is created.
333
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_chart_tag_added Online documentation}
342
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_chart_tag_added Online documentation}
334
343
  */
335
344
  interface OnChartTagAddedEvent extends EventData {
336
345
  readonly tag: LuaCustomChartTag
@@ -347,7 +356,7 @@ declare module "factorio:runtime" {
347
356
  }
348
357
  /**
349
358
  * Called when a chart tag is modified by a player.
350
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_chart_tag_modified Online documentation}
359
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_chart_tag_modified Online documentation}
351
360
  */
352
361
  interface OnChartTagModifiedEvent extends EventData {
353
362
  readonly tag: LuaCustomChartTag
@@ -369,7 +378,7 @@ declare module "factorio:runtime" {
369
378
  }
370
379
  /**
371
380
  * Called just before a chart tag is deleted.
372
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_chart_tag_removed Online documentation}
381
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_chart_tag_removed Online documentation}
373
382
  */
374
383
  interface OnChartTagRemovedEvent extends EventData {
375
384
  readonly tag: LuaCustomChartTag
@@ -386,7 +395,7 @@ declare module "factorio:runtime" {
386
395
  }
387
396
  /**
388
397
  * Called when a chunk is charted or re-charted.
389
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_chunk_charted Online documentation}
398
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_chunk_charted Online documentation}
390
399
  */
391
400
  interface OnChunkChartedEvent extends EventData {
392
401
  readonly surface_index: SurfaceIndex
@@ -407,7 +416,7 @@ declare module "factorio:runtime" {
407
416
  }
408
417
  /**
409
418
  * Called when one or more chunks are deleted using {@link LuaSurface#delete_chunk LuaSurface::delete_chunk}.
410
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_chunk_deleted Online documentation}
419
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_chunk_deleted Online documentation}
411
420
  */
412
421
  interface OnChunkDeletedEvent extends EventData {
413
422
  readonly surface_index: SurfaceIndex
@@ -426,7 +435,7 @@ declare module "factorio:runtime" {
426
435
  }
427
436
  /**
428
437
  * Called when a chunk is generated.
429
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_chunk_generated Online documentation}
438
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_chunk_generated Online documentation}
430
439
  */
431
440
  interface OnChunkGeneratedEvent extends EventData {
432
441
  /**
@@ -452,7 +461,7 @@ declare module "factorio:runtime" {
452
461
  }
453
462
  /**
454
463
  * Called when a combat robot expires through a lack of energy, or timeout.
455
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_combat_robot_expired Online documentation}
464
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_combat_robot_expired Online documentation}
456
465
  */
457
466
  interface OnCombatRobotExpiredEvent extends EventData {
458
467
  readonly robot: LuaEntity
@@ -473,7 +482,7 @@ declare module "factorio:runtime" {
473
482
  * Called when a message is sent to the in-game console, either by a player or through the server interface.
474
483
  *
475
484
  * This event only fires for plain messages, not for any commands (including `/shout` or `/whisper`).
476
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_console_chat Online documentation}
485
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_console_chat Online documentation}
477
486
  */
478
487
  interface OnConsoleChatEvent extends EventData {
479
488
  /**
@@ -495,7 +504,7 @@ declare module "factorio:runtime" {
495
504
  }
496
505
  /**
497
506
  * Called when someone enters a command-like message regardless of it being a valid command.
498
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_console_command Online documentation}
507
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_console_command Online documentation}
499
508
  */
500
509
  interface OnConsoleCommandEvent extends EventData {
501
510
  /**
@@ -521,7 +530,7 @@ declare module "factorio:runtime" {
521
530
  }
522
531
  /**
523
532
  * Called when a cutscene is cancelled by the player or by script.
524
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cutscene_cancelled Online documentation}
533
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cutscene_cancelled Online documentation}
525
534
  */
526
535
  interface OnCutsceneCancelledEvent extends EventData {
527
536
  /**
@@ -539,7 +548,7 @@ declare module "factorio:runtime" {
539
548
  }
540
549
  /**
541
550
  * Called when a cutscene finishes naturally (was not cancelled).
542
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cutscene_finished Online documentation}
551
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cutscene_finished Online documentation}
543
552
  */
544
553
  interface OnCutsceneFinishedEvent extends EventData {
545
554
  /**
@@ -557,7 +566,7 @@ declare module "factorio:runtime" {
557
566
  }
558
567
  /**
559
568
  * Called when a cutscene starts.
560
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cutscene_started Online documentation}
569
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cutscene_started Online documentation}
561
570
  */
562
571
  interface OnCutsceneStartedEvent extends EventData {
563
572
  /**
@@ -577,7 +586,7 @@ declare module "factorio:runtime" {
577
586
  * Called when a cutscene is playing, each time it reaches a waypoint in that cutscene.
578
587
  *
579
588
  * This refers to an index in the table previously passed to set_controller which started the cutscene.
580
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_cutscene_waypoint_reached Online documentation}
589
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_cutscene_waypoint_reached Online documentation}
581
590
  */
582
591
  interface OnCutsceneWaypointReachedEvent extends EventData {
583
592
  /**
@@ -601,7 +610,7 @@ declare module "factorio:runtime" {
601
610
  * Called when an entity is cloned. The filter applies to the source entity.
602
611
  *
603
612
  * Event filter: [LuaEntityClonedEventFilter](LuaEntityClonedEventFilter]
604
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_cloned Online documentation}
613
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_cloned Online documentation}
605
614
  */
606
615
  interface OnEntityClonedEvent extends EventData {
607
616
  readonly source: LuaEntity
@@ -619,7 +628,7 @@ declare module "factorio:runtime" {
619
628
  * Called after an entity has been recolored either by the player or through script.
620
629
  *
621
630
  * Automatic recoloring due to {@link LuaPlayer#color LuaPlayer::color} will not raise events, as that is a separate mechanism.
622
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_color_changed Online documentation}
631
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_color_changed Online documentation}
623
632
  */
624
633
  interface OnEntityColorChangedEvent extends EventData {
625
634
  /**
@@ -639,7 +648,7 @@ declare module "factorio:runtime" {
639
648
  * Called when an entity is damaged. This is not called when an entities health is set directly by another mod.
640
649
  *
641
650
  * Event filter: [LuaEntityDamagedEventFilter](LuaEntityDamagedEventFilter]
642
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_damaged Online documentation}
651
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_damaged Online documentation}
643
652
  */
644
653
  interface OnEntityDamagedEvent extends EventData {
645
654
  readonly entity: LuaEntity
@@ -681,7 +690,7 @@ declare module "factorio:runtime" {
681
690
  * Called when an entity dies.
682
691
  *
683
692
  * Event filter: [LuaEntityDiedEventFilter](LuaEntityDiedEventFilter]
684
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_died Online documentation}
693
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_died Online documentation}
685
694
  */
686
695
  interface OnEntityDiedEvent extends EventData {
687
696
  /**
@@ -715,7 +724,7 @@ declare module "factorio:runtime" {
715
724
  }
716
725
  /**
717
726
  * Called when one of an entity's logistic slots changes.
718
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_logistic_slot_changed Online documentation}
727
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_logistic_slot_changed Online documentation}
719
728
  */
720
729
  interface OnEntityLogisticSlotChangedEvent extends EventData {
721
730
  /**
@@ -745,7 +754,7 @@ declare module "factorio:runtime" {
745
754
  }
746
755
  /**
747
756
  * Called after an entity has been renamed either by the player or through script.
748
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_renamed Online documentation}
757
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_renamed Online documentation}
749
758
  */
750
759
  interface OnEntityRenamedEvent extends EventData {
751
760
  /**
@@ -766,7 +775,7 @@ declare module "factorio:runtime" {
766
775
  }
767
776
  /**
768
777
  * Called after entity copy-paste is done.
769
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_settings_pasted Online documentation}
778
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_settings_pasted Online documentation}
770
779
  */
771
780
  interface OnEntitySettingsPastedEvent extends EventData {
772
781
  readonly player_index: PlayerIndex
@@ -789,7 +798,7 @@ declare module "factorio:runtime" {
789
798
  }
790
799
  /**
791
800
  * Called when an entity is spawned by a EnemySpawner
792
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_entity_spawned Online documentation}
801
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_entity_spawned Online documentation}
793
802
  */
794
803
  interface OnEntitySpawnedEvent extends EventData {
795
804
  readonly spawner: LuaEntity
@@ -805,7 +814,7 @@ declare module "factorio:runtime" {
805
814
  }
806
815
  /**
807
816
  * Called after equipment is inserted into an equipment grid.
808
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_equipment_inserted Online documentation}
817
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_equipment_inserted Online documentation}
809
818
  */
810
819
  interface OnEquipmentInsertedEvent extends EventData {
811
820
  /**
@@ -827,7 +836,7 @@ declare module "factorio:runtime" {
827
836
  }
828
837
  /**
829
838
  * Called after equipment is removed from an equipment grid.
830
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_equipment_removed Online documentation}
839
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_equipment_removed Online documentation}
831
840
  */
832
841
  interface OnEquipmentRemovedEvent extends EventData {
833
842
  /**
@@ -857,7 +866,7 @@ declare module "factorio:runtime" {
857
866
  }
858
867
  /**
859
868
  * Called when the a forces cease fire values change.
860
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_force_cease_fire_changed Online documentation}
869
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_force_cease_fire_changed Online documentation}
861
870
  */
862
871
  interface OnForceCeaseFireChangedEvent extends EventData {
863
872
  /**
@@ -885,7 +894,7 @@ declare module "factorio:runtime" {
885
894
  * Called when a new force is created using `game.create_force()`
886
895
  *
887
896
  * This is not called when the default forces (`'player'`, `'enemy'`, `'neutral'`) are created as they will always exist.
888
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_force_created Online documentation}
897
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_force_created Online documentation}
889
898
  */
890
899
  interface OnForceCreatedEvent extends EventData {
891
900
  /**
@@ -903,7 +912,7 @@ declare module "factorio:runtime" {
903
912
  }
904
913
  /**
905
914
  * Called when the a forces friends change.
906
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_force_friends_changed Online documentation}
915
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_force_friends_changed Online documentation}
907
916
  */
908
917
  interface OnForceFriendsChangedEvent extends EventData {
909
918
  /**
@@ -929,7 +938,7 @@ declare module "factorio:runtime" {
929
938
  }
930
939
  /**
931
940
  * Called when {@link LuaForce#reset LuaForce::reset} is finished.
932
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_force_reset Online documentation}
941
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_force_reset Online documentation}
933
942
  */
934
943
  interface OnForceResetEvent extends EventData {
935
944
  readonly force: LuaForce
@@ -946,7 +955,7 @@ declare module "factorio:runtime" {
946
955
  * Called after two forces have been merged using `game.merge_forces()`.
947
956
  *
948
957
  * The source force is invalidated before this event is called and the name can be re-used in this event if desired.
949
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_forces_merged Online documentation}
958
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_forces_merged Online documentation}
950
959
  */
951
960
  interface OnForcesMergedEvent extends EventData {
952
961
  /**
@@ -972,7 +981,7 @@ declare module "factorio:runtime" {
972
981
  }
973
982
  /**
974
983
  * Called when two forces are about to be merged using `game.merge_forces()`.
975
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_forces_merging Online documentation}
984
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_forces_merging Online documentation}
976
985
  */
977
986
  interface OnForcesMergingEvent extends EventData {
978
987
  /**
@@ -996,7 +1005,7 @@ declare module "factorio:runtime" {
996
1005
  * Called when a game is created from a scenario. This is fired for every mod, even when the scenario's save data already includes it. In those cases however, {@link LuaBootstrap#on_init LuaBootstrap::on_init} is not fired.
997
1006
  *
998
1007
  * This event is not fired when the scenario is loaded via the map editor.
999
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_game_created_from_scenario Online documentation}
1008
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_game_created_from_scenario Online documentation}
1000
1009
  */
1001
1010
  interface OnGameCreatedFromScenarioEvent extends EventData {
1002
1011
  /**
@@ -1010,7 +1019,7 @@ declare module "factorio:runtime" {
1010
1019
  }
1011
1020
  /**
1012
1021
  * Called when {@link LuaGuiElement} checked state is changed (related to checkboxes and radio buttons).
1013
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_checked_state_changed Online documentation}
1022
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_checked_state_changed Online documentation}
1014
1023
  */
1015
1024
  interface OnGuiCheckedStateChangedEvent extends EventData {
1016
1025
  /**
@@ -1032,7 +1041,7 @@ declare module "factorio:runtime" {
1032
1041
  }
1033
1042
  /**
1034
1043
  * Called when {@link LuaGuiElement} is clicked.
1035
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_click Online documentation}
1044
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_click Online documentation}
1036
1045
  */
1037
1046
  interface OnGuiClickEvent extends EventData {
1038
1047
  /**
@@ -1078,7 +1087,7 @@ declare module "factorio:runtime" {
1078
1087
  * This can only be raised when the GUI's player controller is still valid. If a GUI is thus closed due to the player disconnecting, dying, or becoming a spectator in other ways, it won't cause this event to be raised.
1079
1088
  *
1080
1089
  * It's not advised to open any other GUI during this event because if this is run as a request to open a different GUI the game will force close the new opened GUI without notice to ensure the original requested GUI is opened.
1081
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_closed Online documentation}
1090
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_closed Online documentation}
1082
1091
  */
1083
1092
  interface OnGuiClosedEvent extends EventData {
1084
1093
  /**
@@ -1132,7 +1141,7 @@ declare module "factorio:runtime" {
1132
1141
  }
1133
1142
  /**
1134
1143
  * Called when a {@link LuaGuiElement} is confirmed, for example by pressing Enter in a textfield.
1135
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_confirmed Online documentation}
1144
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_confirmed Online documentation}
1136
1145
  */
1137
1146
  interface OnGuiConfirmedEvent extends EventData {
1138
1147
  /**
@@ -1166,7 +1175,7 @@ declare module "factorio:runtime" {
1166
1175
  }
1167
1176
  /**
1168
1177
  * Called when {@link LuaGuiElement} element value is changed (related to choose element buttons).
1169
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_elem_changed Online documentation}
1178
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_elem_changed Online documentation}
1170
1179
  */
1171
1180
  interface OnGuiElemChangedEvent extends EventData {
1172
1181
  /**
@@ -1190,7 +1199,7 @@ declare module "factorio:runtime" {
1190
1199
  * Called when {@link LuaGuiElement} is hovered by the mouse.
1191
1200
  *
1192
1201
  * Only fired for events whose {@link LuaGuiElement#raise_hover_events LuaGuiElement::raise_hover_events} is `true`.
1193
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_hover Online documentation}
1202
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_hover Online documentation}
1194
1203
  */
1195
1204
  interface OnGuiHoverEvent extends EventData {
1196
1205
  /**
@@ -1214,7 +1223,7 @@ declare module "factorio:runtime" {
1214
1223
  * Called when the player's cursor leaves a {@link LuaGuiElement} that was previously hovered.
1215
1224
  *
1216
1225
  * Only fired for events whose {@link LuaGuiElement#raise_hover_events LuaGuiElement::raise_hover_events} is `true`.
1217
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_leave Online documentation}
1226
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_leave Online documentation}
1218
1227
  */
1219
1228
  interface OnGuiLeaveEvent extends EventData {
1220
1229
  /**
@@ -1236,7 +1245,7 @@ declare module "factorio:runtime" {
1236
1245
  }
1237
1246
  /**
1238
1247
  * Called when {@link LuaGuiElement} element location is changed (related to frames in `player.gui.screen`).
1239
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_location_changed Online documentation}
1248
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_location_changed Online documentation}
1240
1249
  */
1241
1250
  interface OnGuiLocationChangedEvent extends EventData {
1242
1251
  /**
@@ -1258,7 +1267,7 @@ declare module "factorio:runtime" {
1258
1267
  }
1259
1268
  /**
1260
1269
  * Called when the player opens a GUI.
1261
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_opened Online documentation}
1270
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_opened Online documentation}
1262
1271
  */
1263
1272
  interface OnGuiOpenedEvent extends EventData {
1264
1273
  /**
@@ -1304,7 +1313,7 @@ declare module "factorio:runtime" {
1304
1313
  }
1305
1314
  /**
1306
1315
  * Called when {@link LuaGuiElement} selected tab is changed (related to tabbed-panes).
1307
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_selected_tab_changed Online documentation}
1316
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_selected_tab_changed Online documentation}
1308
1317
  */
1309
1318
  interface OnGuiSelectedTabChangedEvent extends EventData {
1310
1319
  /**
@@ -1326,7 +1335,7 @@ declare module "factorio:runtime" {
1326
1335
  }
1327
1336
  /**
1328
1337
  * Called when {@link LuaGuiElement} selection state is changed (related to drop-downs and listboxes).
1329
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_selection_state_changed Online documentation}
1338
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_selection_state_changed Online documentation}
1330
1339
  */
1331
1340
  interface OnGuiSelectionStateChangedEvent extends EventData {
1332
1341
  /**
@@ -1348,7 +1357,7 @@ declare module "factorio:runtime" {
1348
1357
  }
1349
1358
  /**
1350
1359
  * Called when {@link LuaGuiElement} switch state is changed (related to switches).
1351
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_switch_state_changed Online documentation}
1360
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_switch_state_changed Online documentation}
1352
1361
  */
1353
1362
  interface OnGuiSwitchStateChangedEvent extends EventData {
1354
1363
  /**
@@ -1370,7 +1379,7 @@ declare module "factorio:runtime" {
1370
1379
  }
1371
1380
  /**
1372
1381
  * Called when {@link LuaGuiElement} text is changed by the player.
1373
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_text_changed Online documentation}
1382
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_text_changed Online documentation}
1374
1383
  */
1375
1384
  interface OnGuiTextChangedEvent extends EventData {
1376
1385
  /**
@@ -1396,7 +1405,7 @@ declare module "factorio:runtime" {
1396
1405
  }
1397
1406
  /**
1398
1407
  * Called when {@link LuaGuiElement} slider value is changed (related to the slider element).
1399
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_gui_value_changed Online documentation}
1408
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_gui_value_changed Online documentation}
1400
1409
  */
1401
1410
  interface OnGuiValueChangedEvent extends EventData {
1402
1411
  /**
@@ -1418,7 +1427,7 @@ declare module "factorio:runtime" {
1418
1427
  }
1419
1428
  /**
1420
1429
  * Called when a land mine is armed.
1421
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_land_mine_armed Online documentation}
1430
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_land_mine_armed Online documentation}
1422
1431
  */
1423
1432
  interface OnLandMineArmedEvent extends EventData {
1424
1433
  readonly mine: LuaEntity
@@ -1433,7 +1442,7 @@ declare module "factorio:runtime" {
1433
1442
  }
1434
1443
  /**
1435
1444
  * Called when a custom {@link import("factorio:prototype").ShortcutPrototype Lua shortcut} is pressed.
1436
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_lua_shortcut Online documentation}
1445
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_lua_shortcut Online documentation}
1437
1446
  */
1438
1447
  interface OnLuaShortcutEvent extends EventData {
1439
1448
  readonly player_index: PlayerIndex
@@ -1454,7 +1463,7 @@ declare module "factorio:runtime" {
1454
1463
  * Called when an entity is marked for deconstruction with the Deconstruction planner or via script.
1455
1464
  *
1456
1465
  * Event filter: [LuaEntityMarkedForDeconstructionEventFilter](LuaEntityMarkedForDeconstructionEventFilter]
1457
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_marked_for_deconstruction Online documentation}
1466
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_marked_for_deconstruction Online documentation}
1458
1467
  */
1459
1468
  interface OnMarkedForDeconstructionEvent extends EventData {
1460
1469
  readonly entity: LuaEntity
@@ -1472,7 +1481,7 @@ declare module "factorio:runtime" {
1472
1481
  * Called when an entity is marked for upgrade with the Upgrade planner or via script.
1473
1482
  *
1474
1483
  * Event filter: [LuaEntityMarkedForUpgradeEventFilter](LuaEntityMarkedForUpgradeEventFilter]
1475
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_marked_for_upgrade Online documentation}
1484
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_marked_for_upgrade Online documentation}
1476
1485
  */
1477
1486
  interface OnMarkedForUpgradeEvent extends EventData {
1478
1487
  readonly player_index?: PlayerIndex
@@ -1490,7 +1499,7 @@ declare module "factorio:runtime" {
1490
1499
  }
1491
1500
  /**
1492
1501
  * Called after a player purchases some offer from a `market` entity.
1493
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_market_item_purchased Online documentation}
1502
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_market_item_purchased Online documentation}
1494
1503
  */
1495
1504
  interface OnMarketItemPurchasedEvent extends EventData {
1496
1505
  /**
@@ -1520,7 +1529,7 @@ declare module "factorio:runtime" {
1520
1529
  }
1521
1530
  /**
1522
1531
  * Called when the player uses the 'Open item GUI' control on an item defined with the 'mod-openable' flag
1523
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_mod_item_opened Online documentation}
1532
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_mod_item_opened Online documentation}
1524
1533
  */
1525
1534
  interface OnModItemOpenedEvent extends EventData {
1526
1535
  /**
@@ -1546,7 +1555,7 @@ declare module "factorio:runtime" {
1546
1555
  }
1547
1556
  /**
1548
1557
  * Called when {@link LuaGameScript#is_multiplayer LuaGameScript::is_multiplayer} changes to true. May also be raised when it was already true but a game was loaded from a save file and with hosting.
1549
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_multiplayer_init Online documentation}
1558
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_multiplayer_init Online documentation}
1550
1559
  */
1551
1560
  interface OnMultiplayerInitEvent extends EventData {
1552
1561
  /**
@@ -1562,7 +1571,7 @@ declare module "factorio:runtime" {
1562
1571
  * Called after an object is destroyed which was registered with {@link LuaBootstrap#register_on_object_destroyed LuaBootstrap::register_on_object_destroyed} previously.
1563
1572
  *
1564
1573
  * Depending on when a given object is destroyed, this event will be fired at the end of the current tick or at the end of the next tick. The event's timing is independent of the in-world object being destroyed.
1565
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_object_destroyed Online documentation}
1574
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_object_destroyed Online documentation}
1566
1575
  */
1567
1576
  interface OnObjectDestroyedEvent extends EventData {
1568
1577
  /**
@@ -1588,7 +1597,7 @@ declare module "factorio:runtime" {
1588
1597
  }
1589
1598
  /**
1590
1599
  * Called directly after a permission group is added.
1591
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_permission_group_added Online documentation}
1600
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_permission_group_added Online documentation}
1592
1601
  */
1593
1602
  interface OnPermissionGroupAddedEvent extends EventData {
1594
1603
  /**
@@ -1610,7 +1619,7 @@ declare module "factorio:runtime" {
1610
1619
  }
1611
1620
  /**
1612
1621
  * Called directly after a permission group is deleted.
1613
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_permission_group_deleted Online documentation}
1622
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_permission_group_deleted Online documentation}
1614
1623
  */
1615
1624
  interface OnPermissionGroupDeletedEvent extends EventData {
1616
1625
  /**
@@ -1636,7 +1645,7 @@ declare module "factorio:runtime" {
1636
1645
  }
1637
1646
  /**
1638
1647
  * Called directly after a permission group is edited in some way.
1639
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_permission_group_edited Online documentation}
1648
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_permission_group_edited Online documentation}
1640
1649
  */
1641
1650
  interface OnPermissionGroupEditedEvent extends EventData {
1642
1651
  /**
@@ -1685,7 +1694,7 @@ declare module "factorio:runtime" {
1685
1694
  }
1686
1695
  /**
1687
1696
  * Called directly after a permission string is imported.
1688
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_permission_string_imported Online documentation}
1697
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_permission_string_imported Online documentation}
1689
1698
  */
1690
1699
  interface OnPermissionStringImportedEvent extends EventData {
1691
1700
  /**
@@ -1703,7 +1712,7 @@ declare module "factorio:runtime" {
1703
1712
  }
1704
1713
  /**
1705
1714
  * Called when a player picks up an item.
1706
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_picked_up_item Online documentation}
1715
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_picked_up_item Online documentation}
1707
1716
  */
1708
1717
  interface OnPickedUpItemEvent extends EventData {
1709
1718
  readonly item_stack: SimpleItemStack
@@ -1719,7 +1728,7 @@ declare module "factorio:runtime" {
1719
1728
  }
1720
1729
  /**
1721
1730
  * Called after a player alt-reverse-selects an area with a selection-tool item.
1722
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_alt_reverse_selected_area Online documentation}
1731
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_alt_reverse_selected_area Online documentation}
1723
1732
  */
1724
1733
  interface OnPlayerAltReverseSelectedAreaEvent extends EventData {
1725
1734
  /**
@@ -1757,7 +1766,7 @@ declare module "factorio:runtime" {
1757
1766
  }
1758
1767
  /**
1759
1768
  * Called after a player alt-selects an area with a selection-tool item.
1760
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_alt_selected_area Online documentation}
1769
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_alt_selected_area Online documentation}
1761
1770
  */
1762
1771
  interface OnPlayerAltSelectedAreaEvent extends EventData {
1763
1772
  /**
@@ -1799,7 +1808,7 @@ declare module "factorio:runtime" {
1799
1808
  }
1800
1809
  /**
1801
1810
  * Called after a players ammo inventory changed in some way.
1802
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_ammo_inventory_changed Online documentation}
1811
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_ammo_inventory_changed Online documentation}
1803
1812
  */
1804
1813
  interface OnPlayerAmmoInventoryChangedEvent extends EventData {
1805
1814
  readonly player_index: PlayerIndex
@@ -1814,7 +1823,7 @@ declare module "factorio:runtime" {
1814
1823
  }
1815
1824
  /**
1816
1825
  * Called after a players armor inventory changed in some way.
1817
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_armor_inventory_changed Online documentation}
1826
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_armor_inventory_changed Online documentation}
1818
1827
  */
1819
1828
  interface OnPlayerArmorInventoryChangedEvent extends EventData {
1820
1829
  readonly player_index: PlayerIndex
@@ -1829,7 +1838,7 @@ declare module "factorio:runtime" {
1829
1838
  }
1830
1839
  /**
1831
1840
  * Called when a player is banned.
1832
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_banned Online documentation}
1841
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_banned Online documentation}
1833
1842
  */
1834
1843
  interface OnPlayerBannedEvent extends EventData {
1835
1844
  /**
@@ -1859,7 +1868,7 @@ declare module "factorio:runtime" {
1859
1868
  }
1860
1869
  /**
1861
1870
  * Called after a player builds tiles.
1862
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_built_tile Online documentation}
1871
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_built_tile Online documentation}
1863
1872
  */
1864
1873
  interface OnPlayerBuiltTileEvent extends EventData {
1865
1874
  readonly player_index: PlayerIndex
@@ -1898,7 +1907,7 @@ declare module "factorio:runtime" {
1898
1907
  }
1899
1908
  /**
1900
1909
  * Called when a player cancels crafting.
1901
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_cancelled_crafting Online documentation}
1910
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_cancelled_crafting Online documentation}
1902
1911
  */
1903
1912
  interface OnPlayerCancelledCraftingEvent extends EventData {
1904
1913
  /**
@@ -1928,7 +1937,7 @@ declare module "factorio:runtime" {
1928
1937
  }
1929
1938
  /**
1930
1939
  * Called after a player changes forces.
1931
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_changed_force Online documentation}
1940
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_changed_force Online documentation}
1932
1941
  */
1933
1942
  interface OnPlayerChangedForceEvent extends EventData {
1934
1943
  /**
@@ -1950,7 +1959,7 @@ declare module "factorio:runtime" {
1950
1959
  }
1951
1960
  /**
1952
1961
  * Called when the tile position a player is located at changes.
1953
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_changed_position Online documentation}
1962
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_changed_position Online documentation}
1954
1963
  */
1955
1964
  interface OnPlayerChangedPositionEvent extends EventData {
1956
1965
  /**
@@ -1968,7 +1977,7 @@ declare module "factorio:runtime" {
1968
1977
  }
1969
1978
  /**
1970
1979
  * Called after a player changes surfaces.
1971
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_changed_surface Online documentation}
1980
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_changed_surface Online documentation}
1972
1981
  */
1973
1982
  interface OnPlayerChangedSurfaceEvent extends EventData {
1974
1983
  /**
@@ -1990,7 +1999,7 @@ declare module "factorio:runtime" {
1990
1999
  }
1991
2000
  /**
1992
2001
  * Called when cheat mode is disabled on a player.
1993
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_cheat_mode_disabled Online documentation}
2002
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_cheat_mode_disabled Online documentation}
1994
2003
  */
1995
2004
  interface OnPlayerCheatModeDisabledEvent extends EventData {
1996
2005
  /**
@@ -2008,7 +2017,7 @@ declare module "factorio:runtime" {
2008
2017
  }
2009
2018
  /**
2010
2019
  * Called when cheat mode is enabled on a player.
2011
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_cheat_mode_enabled Online documentation}
2020
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_cheat_mode_enabled Online documentation}
2012
2021
  */
2013
2022
  interface OnPlayerCheatModeEnabledEvent extends EventData {
2014
2023
  /**
@@ -2026,7 +2035,7 @@ declare module "factorio:runtime" {
2026
2035
  }
2027
2036
  /**
2028
2037
  * Called when a player clicks a gps tag
2029
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_clicked_gps_tag Online documentation}
2038
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_clicked_gps_tag Online documentation}
2030
2039
  */
2031
2040
  interface OnPlayerClickedGpsTagEvent extends EventData {
2032
2041
  /**
@@ -2052,7 +2061,7 @@ declare module "factorio:runtime" {
2052
2061
  }
2053
2062
  /**
2054
2063
  * Called when a player clicks the "confirm" button in the configure Blueprint GUI.
2055
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_configured_blueprint Online documentation}
2064
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_configured_blueprint Online documentation}
2056
2065
  */
2057
2066
  interface OnPlayerConfiguredBlueprintEvent extends EventData {
2058
2067
  /**
@@ -2070,7 +2079,7 @@ declare module "factorio:runtime" {
2070
2079
  }
2071
2080
  /**
2072
2081
  * Called after a player changes controller types.
2073
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_controller_changed Online documentation}
2082
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_controller_changed Online documentation}
2074
2083
  */
2075
2084
  interface OnPlayerControllerChangedEvent extends EventData {
2076
2085
  /**
@@ -2092,7 +2101,7 @@ declare module "factorio:runtime" {
2092
2101
  }
2093
2102
  /**
2094
2103
  * Called when the player finishes crafting an item. This event fires just before the results are inserted into the player's inventory, not when the crafting is queued (see {@link OnPrePlayerCraftedItemEvent on_pre_player_crafted_item}).
2095
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_crafted_item Online documentation}
2104
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_crafted_item Online documentation}
2096
2105
  */
2097
2106
  interface OnPlayerCraftedItemEvent extends EventData {
2098
2107
  /**
@@ -2118,7 +2127,7 @@ declare module "factorio:runtime" {
2118
2127
  }
2119
2128
  /**
2120
2129
  * Called after the player was created.
2121
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_created Online documentation}
2130
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_created Online documentation}
2122
2131
  */
2123
2132
  interface OnPlayerCreatedEvent extends EventData {
2124
2133
  readonly player_index: PlayerIndex
@@ -2135,7 +2144,7 @@ declare module "factorio:runtime" {
2135
2144
  * Called after a player's {@link LuaControl#cursor_stack cursor stack} changed in some way.
2136
2145
  *
2137
2146
  * This is fired in the same tick that the change happens, but not instantly.
2138
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_cursor_stack_changed Online documentation}
2147
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_cursor_stack_changed Online documentation}
2139
2148
  */
2140
2149
  interface OnPlayerCursorStackChangedEvent extends EventData {
2141
2150
  readonly player_index: PlayerIndex
@@ -2150,7 +2159,7 @@ declare module "factorio:runtime" {
2150
2159
  }
2151
2160
  /**
2152
2161
  * Called when a player selects an area with a deconstruction planner.
2153
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_deconstructed_area Online documentation}
2162
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_deconstructed_area Online documentation}
2154
2163
  */
2155
2164
  interface OnPlayerDeconstructedAreaEvent extends EventData {
2156
2165
  /**
@@ -2196,7 +2205,7 @@ declare module "factorio:runtime" {
2196
2205
  }
2197
2206
  /**
2198
2207
  * Called when a player is demoted.
2199
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_demoted Online documentation}
2208
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_demoted Online documentation}
2200
2209
  */
2201
2210
  interface OnPlayerDemotedEvent extends EventData {
2202
2211
  /**
@@ -2214,7 +2223,7 @@ declare module "factorio:runtime" {
2214
2223
  }
2215
2224
  /**
2216
2225
  * Called after a player dies.
2217
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_died Online documentation}
2226
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_died Online documentation}
2218
2227
  */
2219
2228
  interface OnPlayerDiedEvent extends EventData {
2220
2229
  readonly player_index: PlayerIndex
@@ -2230,7 +2239,7 @@ declare module "factorio:runtime" {
2230
2239
  }
2231
2240
  /**
2232
2241
  * Called when the display density scale changes for a given player. The display density scale is the scale value automatically applied based on the player's display DPI. This is only relevant on platforms that support high-density displays.
2233
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_display_density_scale_changed Online documentation}
2242
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_display_density_scale_changed Online documentation}
2234
2243
  */
2235
2244
  interface OnPlayerDisplayDensityScaleChangedEvent extends EventData {
2236
2245
  /**
@@ -2252,7 +2261,7 @@ declare module "factorio:runtime" {
2252
2261
  }
2253
2262
  /**
2254
2263
  * Called when the display resolution changes for a given player.
2255
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_display_resolution_changed Online documentation}
2264
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_display_resolution_changed Online documentation}
2256
2265
  */
2257
2266
  interface OnPlayerDisplayResolutionChangedEvent extends EventData {
2258
2267
  /**
@@ -2274,7 +2283,7 @@ declare module "factorio:runtime" {
2274
2283
  }
2275
2284
  /**
2276
2285
  * Called when the display scale changes for a given player.
2277
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_display_scale_changed Online documentation}
2286
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_display_scale_changed Online documentation}
2278
2287
  */
2279
2288
  interface OnPlayerDisplayScaleChangedEvent extends EventData {
2280
2289
  /**
@@ -2298,7 +2307,7 @@ declare module "factorio:runtime" {
2298
2307
  * Called when the player's driving state has changed, meaning a player has either entered or left a vehicle.
2299
2308
  *
2300
2309
  * This event is not raised when the player is ejected from a vehicle due to it being destroyed.
2301
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_driving_changed_state Online documentation}
2310
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_driving_changed_state Online documentation}
2302
2311
  */
2303
2312
  interface OnPlayerDrivingChangedStateEvent extends EventData {
2304
2313
  readonly player_index: PlayerIndex
@@ -2317,7 +2326,7 @@ declare module "factorio:runtime" {
2317
2326
  }
2318
2327
  /**
2319
2328
  * Called when a player drops an item on the ground.
2320
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_dropped_item Online documentation}
2329
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_dropped_item Online documentation}
2321
2330
  */
2322
2331
  interface OnPlayerDroppedItemEvent extends EventData {
2323
2332
  readonly player_index: PlayerIndex
@@ -2336,7 +2345,7 @@ declare module "factorio:runtime" {
2336
2345
  }
2337
2346
  /**
2338
2347
  * Called when a player fast-transfers something to or from an entity.
2339
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_fast_transferred Online documentation}
2348
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_fast_transferred Online documentation}
2340
2349
  */
2341
2350
  interface OnPlayerFastTransferredEvent extends EventData {
2342
2351
  /**
@@ -2368,7 +2377,7 @@ declare module "factorio:runtime" {
2368
2377
  * Called when the player flips an entity. This event is only fired when the entity actually changes its orientation or mirroring, so it won't be triggered when pressing the flip keys on an entity that can't be flipped.
2369
2378
  *
2370
2379
  * This event reflects a change in the {@link LuaEntity#mirroring LuaEntity::mirroring} property.
2371
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_flipped_entity Online documentation}
2380
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_flipped_entity Online documentation}
2372
2381
  */
2373
2382
  interface OnPlayerFlippedEntityEvent extends EventData {
2374
2383
  /**
@@ -2391,7 +2400,7 @@ declare module "factorio:runtime" {
2391
2400
  }
2392
2401
  /**
2393
2402
  * Called after player flushed fluid
2394
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_flushed_fluid Online documentation}
2403
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_flushed_fluid Online documentation}
2395
2404
  */
2396
2405
  interface OnPlayerFlushedFluidEvent extends EventData {
2397
2406
  /**
@@ -2425,7 +2434,7 @@ declare module "factorio:runtime" {
2425
2434
  }
2426
2435
  /**
2427
2436
  * Called after a players gun inventory changed in some way.
2428
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_gun_inventory_changed Online documentation}
2437
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_gun_inventory_changed Online documentation}
2429
2438
  */
2430
2439
  interface OnPlayerGunInventoryChangedEvent extends EventData {
2431
2440
  readonly player_index: PlayerIndex
@@ -2440,7 +2449,7 @@ declare module "factorio:runtime" {
2440
2449
  }
2441
2450
  /**
2442
2451
  * Called when a player's input method changes. See {@link LuaPlayer#input_method LuaPlayer::input_method}.
2443
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_input_method_changed Online documentation}
2452
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_input_method_changed Online documentation}
2444
2453
  */
2445
2454
  interface OnPlayerInputMethodChangedEvent extends EventData {
2446
2455
  /**
@@ -2458,7 +2467,7 @@ declare module "factorio:runtime" {
2458
2467
  }
2459
2468
  /**
2460
2469
  * Called after a player joins the game. This is not called when loading a save file in singleplayer, as the player doesn't actually leave the game, and the save is just on pause until they rejoin.
2461
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_joined_game Online documentation}
2470
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_joined_game Online documentation}
2462
2471
  */
2463
2472
  interface OnPlayerJoinedGameEvent extends EventData {
2464
2473
  readonly player_index: PlayerIndex
@@ -2473,7 +2482,7 @@ declare module "factorio:runtime" {
2473
2482
  }
2474
2483
  /**
2475
2484
  * Called when a player is kicked.
2476
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_kicked Online documentation}
2485
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_kicked Online documentation}
2477
2486
  */
2478
2487
  interface OnPlayerKickedEvent extends EventData {
2479
2488
  /**
@@ -2499,7 +2508,7 @@ declare module "factorio:runtime" {
2499
2508
  }
2500
2509
  /**
2501
2510
  * Called after a player leaves the game. This is not called when closing a save file in singleplayer, as the player doesn't actually leave the game, and the save is just on pause until they rejoin.
2502
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_left_game Online documentation}
2511
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_left_game Online documentation}
2503
2512
  */
2504
2513
  interface OnPlayerLeftGameEvent extends EventData {
2505
2514
  readonly player_index: PlayerIndex
@@ -2515,7 +2524,7 @@ declare module "factorio:runtime" {
2515
2524
  }
2516
2525
  /**
2517
2526
  * Called when a player's active locale changes. See {@link LuaPlayer#locale LuaPlayer::locale}.
2518
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_locale_changed Online documentation}
2527
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_locale_changed Online documentation}
2519
2528
  */
2520
2529
  interface OnPlayerLocaleChangedEvent extends EventData {
2521
2530
  /**
@@ -2537,7 +2546,7 @@ declare module "factorio:runtime" {
2537
2546
  }
2538
2547
  /**
2539
2548
  * Called after a players main inventory changed in some way.
2540
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_main_inventory_changed Online documentation}
2549
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_main_inventory_changed Online documentation}
2541
2550
  */
2542
2551
  interface OnPlayerMainInventoryChangedEvent extends EventData {
2543
2552
  readonly player_index: PlayerIndex
@@ -2558,7 +2567,7 @@ declare module "factorio:runtime" {
2558
2567
  * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
2559
2568
  *
2560
2569
  * Event filter: [LuaPlayerMinedEntityEventFilter](LuaPlayerMinedEntityEventFilter]
2561
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_mined_entity Online documentation}
2570
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_mined_entity Online documentation}
2562
2571
  */
2563
2572
  interface OnPlayerMinedEntityEvent extends EventData {
2564
2573
  /**
@@ -2584,7 +2593,7 @@ declare module "factorio:runtime" {
2584
2593
  }
2585
2594
  /**
2586
2595
  * Called when the player mines something.
2587
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_mined_item Online documentation}
2596
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_mined_item Online documentation}
2588
2597
  */
2589
2598
  interface OnPlayerMinedItemEvent extends EventData {
2590
2599
  /**
@@ -2603,7 +2612,7 @@ declare module "factorio:runtime" {
2603
2612
  }
2604
2613
  /**
2605
2614
  * Called after a player mines tiles.
2606
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_mined_tile Online documentation}
2615
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_mined_tile Online documentation}
2607
2616
  */
2608
2617
  interface OnPlayerMinedTileEvent extends EventData {
2609
2618
  readonly player_index: PlayerIndex
@@ -2626,7 +2635,7 @@ declare module "factorio:runtime" {
2626
2635
  }
2627
2636
  /**
2628
2637
  * Called when a player is muted.
2629
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_muted Online documentation}
2638
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_muted Online documentation}
2630
2639
  */
2631
2640
  interface OnPlayerMutedEvent extends EventData {
2632
2641
  /**
@@ -2644,7 +2653,7 @@ declare module "factorio:runtime" {
2644
2653
  }
2645
2654
  /**
2646
2655
  * Called when a player invokes the "smart pipette" over an entity.
2647
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_pipette Online documentation}
2656
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_pipette Online documentation}
2648
2657
  */
2649
2658
  interface OnPlayerPipetteEvent extends EventData {
2650
2659
  /**
@@ -2674,7 +2683,7 @@ declare module "factorio:runtime" {
2674
2683
  }
2675
2684
  /**
2676
2685
  * Called after the player puts equipment in an equipment grid
2677
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_placed_equipment Online documentation}
2686
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_placed_equipment Online documentation}
2678
2687
  */
2679
2688
  interface OnPlayerPlacedEquipmentEvent extends EventData {
2680
2689
  readonly player_index: PlayerIndex
@@ -2697,7 +2706,7 @@ declare module "factorio:runtime" {
2697
2706
  }
2698
2707
  /**
2699
2708
  * Called when a player is promoted.
2700
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_promoted Online documentation}
2709
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_promoted Online documentation}
2701
2710
  */
2702
2711
  interface OnPlayerPromotedEvent extends EventData {
2703
2712
  /**
@@ -2715,7 +2724,7 @@ declare module "factorio:runtime" {
2715
2724
  }
2716
2725
  /**
2717
2726
  * Called when a player is removed (deleted) from the game. This is markedly different from a player temporarily {@link OnPlayerLeftGameEvent leaving} the game, and instead behaves like the player never existed in the save file.
2718
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_removed Online documentation}
2727
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_removed Online documentation}
2719
2728
  */
2720
2729
  interface OnPlayerRemovedEvent extends EventData {
2721
2730
  /**
@@ -2733,7 +2742,7 @@ declare module "factorio:runtime" {
2733
2742
  }
2734
2743
  /**
2735
2744
  * Called after the player removes equipment from an equipment grid
2736
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_removed_equipment Online documentation}
2745
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_removed_equipment Online documentation}
2737
2746
  */
2738
2747
  interface OnPlayerRemovedEquipmentEvent extends EventData {
2739
2748
  readonly player_index: PlayerIndex
@@ -2766,7 +2775,7 @@ declare module "factorio:runtime" {
2766
2775
  * Called when a player repairs an entity.
2767
2776
  *
2768
2777
  * Event filter: [LuaPlayerRepairedEntityEventFilter](LuaPlayerRepairedEntityEventFilter]
2769
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_repaired_entity Online documentation}
2778
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_repaired_entity Online documentation}
2770
2779
  */
2771
2780
  interface OnPlayerRepairedEntityEvent extends EventData {
2772
2781
  readonly player_index: PlayerIndex
@@ -2782,7 +2791,7 @@ declare module "factorio:runtime" {
2782
2791
  }
2783
2792
  /**
2784
2793
  * Called after a player respawns.
2785
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_respawned Online documentation}
2794
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_respawned Online documentation}
2786
2795
  */
2787
2796
  interface OnPlayerRespawnedEvent extends EventData {
2788
2797
  readonly player_index: PlayerIndex
@@ -2801,7 +2810,7 @@ declare module "factorio:runtime" {
2801
2810
  }
2802
2811
  /**
2803
2812
  * Called after a player reverse-selects an area with a selection-tool item.
2804
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_reverse_selected_area Online documentation}
2813
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_reverse_selected_area Online documentation}
2805
2814
  */
2806
2815
  interface OnPlayerReverseSelectedAreaEvent extends EventData {
2807
2816
  /**
@@ -2841,7 +2850,7 @@ declare module "factorio:runtime" {
2841
2850
  * Called when the player rotates an entity. This event is only fired when the entity actually changes its orientation -- pressing the rotate key on an entity that can't be rotated won't fire this event.
2842
2851
  *
2843
2852
  * Entities being flipped will not fire this event, even if the flip involves rotating. See {@link OnPlayerFlippedEntityEvent on_player_flipped_entity}.
2844
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_rotated_entity Online documentation}
2853
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_rotated_entity Online documentation}
2845
2854
  */
2846
2855
  interface OnPlayerRotatedEntityEvent extends EventData {
2847
2856
  /**
@@ -2864,7 +2873,7 @@ declare module "factorio:runtime" {
2864
2873
  }
2865
2874
  /**
2866
2875
  * Called after a player selects an area with a selection-tool item.
2867
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_selected_area Online documentation}
2876
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_selected_area Online documentation}
2868
2877
  */
2869
2878
  interface OnPlayerSelectedAreaEvent extends EventData {
2870
2879
  /**
@@ -2906,7 +2915,7 @@ declare module "factorio:runtime" {
2906
2915
  }
2907
2916
  /**
2908
2917
  * Called when a player sets a quickbar slot to anything (new value, or set to empty).
2909
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_set_quick_bar_slot Online documentation}
2918
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_set_quick_bar_slot Online documentation}
2910
2919
  */
2911
2920
  interface OnPlayerSetQuickBarSlotEvent extends EventData {
2912
2921
  readonly player_index: PlayerIndex
@@ -2921,7 +2930,7 @@ declare module "factorio:runtime" {
2921
2930
  }
2922
2931
  /**
2923
2932
  * Called when a player selects an area with a blueprint.
2924
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_setup_blueprint Online documentation}
2933
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_setup_blueprint Online documentation}
2925
2934
  */
2926
2935
  interface OnPlayerSetupBlueprintEvent extends EventData {
2927
2936
  /**
@@ -2971,7 +2980,7 @@ declare module "factorio:runtime" {
2971
2980
  }
2972
2981
  /**
2973
2982
  * Called when a player toggles alt mode, also known as "show entity info".
2974
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_toggled_alt_mode Online documentation}
2983
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_toggled_alt_mode Online documentation}
2975
2984
  */
2976
2985
  interface OnPlayerToggledAltModeEvent extends EventData {
2977
2986
  readonly player_index: PlayerIndex
@@ -2990,7 +2999,7 @@ declare module "factorio:runtime" {
2990
2999
  }
2991
3000
  /**
2992
3001
  * Called when a player toggles the map editor on or off.
2993
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_toggled_map_editor Online documentation}
3002
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_toggled_map_editor Online documentation}
2994
3003
  */
2995
3004
  interface OnPlayerToggledMapEditorEvent extends EventData {
2996
3005
  readonly player_index: PlayerIndex
@@ -3005,7 +3014,7 @@ declare module "factorio:runtime" {
3005
3014
  }
3006
3015
  /**
3007
3016
  * Called after a players trash inventory changed in some way.
3008
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_trash_inventory_changed Online documentation}
3017
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_trash_inventory_changed Online documentation}
3009
3018
  */
3010
3019
  interface OnPlayerTrashInventoryChangedEvent extends EventData {
3011
3020
  readonly player_index: PlayerIndex
@@ -3020,7 +3029,7 @@ declare module "factorio:runtime" {
3020
3029
  }
3021
3030
  /**
3022
3031
  * Called when a player is un-banned.
3023
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_unbanned Online documentation}
3032
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_unbanned Online documentation}
3024
3033
  */
3025
3034
  interface OnPlayerUnbannedEvent extends EventData {
3026
3035
  /**
@@ -3050,7 +3059,7 @@ declare module "factorio:runtime" {
3050
3059
  }
3051
3060
  /**
3052
3061
  * Called when a player is unmuted.
3053
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_unmuted Online documentation}
3062
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_unmuted Online documentation}
3054
3063
  */
3055
3064
  interface OnPlayerUnmutedEvent extends EventData {
3056
3065
  /**
@@ -3068,7 +3077,7 @@ declare module "factorio:runtime" {
3068
3077
  }
3069
3078
  /**
3070
3079
  * Called when a player uses a capsule that results in some game action.
3071
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_used_capsule Online documentation}
3080
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_used_capsule Online documentation}
3072
3081
  */
3073
3082
  interface OnPlayerUsedCapsuleEvent extends EventData {
3074
3083
  /**
@@ -3098,7 +3107,7 @@ declare module "factorio:runtime" {
3098
3107
  }
3099
3108
  /**
3100
3109
  * Called when a player uses spidertron remote to send all selected units to a given position
3101
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_player_used_spidertron_remote Online documentation}
3110
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_player_used_spidertron_remote Online documentation}
3102
3111
  */
3103
3112
  interface OnPlayerUsedSpidertronRemoteEvent extends EventData {
3104
3113
  /**
@@ -3122,7 +3131,7 @@ declare module "factorio:runtime" {
3122
3131
  * Called after an entity dies.
3123
3132
  *
3124
3133
  * Event filter: [LuaPostEntityDiedEventFilter](LuaPostEntityDiedEventFilter]
3125
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_post_entity_died Online documentation}
3134
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_post_entity_died Online documentation}
3126
3135
  */
3127
3136
  interface OnPostEntityDiedEvent extends EventData {
3128
3137
  /**
@@ -3172,7 +3181,7 @@ declare module "factorio:runtime" {
3172
3181
  }
3173
3182
  /**
3174
3183
  * Called when players uses an item to build something. Called before {@link OnBuiltEntityEvent on_built_entity}.
3175
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_build Online documentation}
3184
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_build Online documentation}
3176
3185
  */
3177
3186
  interface OnPreBuildEvent extends EventData {
3178
3187
  /**
@@ -3218,7 +3227,7 @@ declare module "factorio:runtime" {
3218
3227
  }
3219
3228
  /**
3220
3229
  * Called before one or more chunks are deleted using {@link LuaSurface#delete_chunk LuaSurface::delete_chunk}.
3221
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_chunk_deleted Online documentation}
3230
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_chunk_deleted Online documentation}
3222
3231
  */
3223
3232
  interface OnPreChunkDeletedEvent extends EventData {
3224
3233
  readonly surface_index: SurfaceIndex
@@ -3237,7 +3246,7 @@ declare module "factorio:runtime" {
3237
3246
  }
3238
3247
  /**
3239
3248
  * Called before entity copy-paste is done.
3240
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_entity_settings_pasted Online documentation}
3249
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_entity_settings_pasted Online documentation}
3241
3250
  */
3242
3251
  interface OnPreEntitySettingsPastedEvent extends EventData {
3243
3252
  readonly player_index: PlayerIndex
@@ -3264,7 +3273,7 @@ declare module "factorio:runtime" {
3264
3273
  * Also called for item request proxies before they are destroyed as a result of being marked for deconstruction.
3265
3274
  *
3266
3275
  * Event filter: [LuaPreGhostDeconstructedEventFilter](LuaPreGhostDeconstructedEventFilter]
3267
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_ghost_deconstructed Online documentation}
3276
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_ghost_deconstructed Online documentation}
3268
3277
  */
3269
3278
  interface OnPreGhostDeconstructedEvent extends EventData {
3270
3279
  /**
@@ -3285,7 +3294,7 @@ declare module "factorio:runtime" {
3285
3294
  * Called before a ghost entity is upgraded.
3286
3295
  *
3287
3296
  * Event filter: [LuaPreGhostUpgradedEventFilter](LuaPreGhostUpgradedEventFilter]
3288
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_ghost_upgraded Online documentation}
3297
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_ghost_upgraded Online documentation}
3289
3298
  */
3290
3299
  interface OnPreGhostUpgradedEvent extends EventData {
3291
3300
  /**
@@ -3306,7 +3315,7 @@ declare module "factorio:runtime" {
3306
3315
  }
3307
3316
  /**
3308
3317
  * Called directly before a permission group is deleted.
3309
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_permission_group_deleted Online documentation}
3318
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_permission_group_deleted Online documentation}
3310
3319
  */
3311
3320
  interface OnPrePermissionGroupDeletedEvent extends EventData {
3312
3321
  /**
@@ -3328,7 +3337,7 @@ declare module "factorio:runtime" {
3328
3337
  }
3329
3338
  /**
3330
3339
  * Called directly before a permission string is imported.
3331
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_permission_string_imported Online documentation}
3340
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_permission_string_imported Online documentation}
3332
3341
  */
3333
3342
  interface OnPrePermissionStringImportedEvent extends EventData {
3334
3343
  /**
@@ -3346,7 +3355,7 @@ declare module "factorio:runtime" {
3346
3355
  }
3347
3356
  /**
3348
3357
  * Called when a player queues something to be crafted.
3349
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_player_crafted_item Online documentation}
3358
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_player_crafted_item Online documentation}
3350
3359
  */
3351
3360
  interface OnPrePlayerCraftedItemEvent extends EventData {
3352
3361
  /**
@@ -3376,7 +3385,7 @@ declare module "factorio:runtime" {
3376
3385
  }
3377
3386
  /**
3378
3387
  * Called before a players dies.
3379
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_player_died Online documentation}
3388
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_player_died Online documentation}
3380
3389
  */
3381
3390
  interface OnPrePlayerDiedEvent extends EventData {
3382
3391
  readonly player_index: PlayerIndex
@@ -3392,7 +3401,7 @@ declare module "factorio:runtime" {
3392
3401
  }
3393
3402
  /**
3394
3403
  * Called before a player leaves the game.
3395
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_player_left_game Online documentation}
3404
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_player_left_game Online documentation}
3396
3405
  */
3397
3406
  interface OnPrePlayerLeftGameEvent extends EventData {
3398
3407
  readonly player_index: PlayerIndex
@@ -3410,7 +3419,7 @@ declare module "factorio:runtime" {
3410
3419
  * Called when the player completes a mining action, but before the entity is potentially removed from the map. This is called even if the entity does not end up being removed.
3411
3420
  *
3412
3421
  * Event filter: [LuaPrePlayerMinedEntityEventFilter](LuaPrePlayerMinedEntityEventFilter]
3413
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_player_mined_item Online documentation}
3422
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_player_mined_item Online documentation}
3414
3423
  */
3415
3424
  interface OnPrePlayerMinedItemEvent extends EventData {
3416
3425
  /**
@@ -3429,7 +3438,7 @@ declare module "factorio:runtime" {
3429
3438
  }
3430
3439
  /**
3431
3440
  * Called before a player is removed (deleted) from the game. This is markedly different from a player temporarily {@link OnPlayerLeftGameEvent leaving} the game, and instead behaves like the player never existed in the save file.
3432
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_player_removed Online documentation}
3441
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_player_removed Online documentation}
3433
3442
  */
3434
3443
  interface OnPrePlayerRemovedEvent extends EventData {
3435
3444
  /**
@@ -3447,7 +3456,7 @@ declare module "factorio:runtime" {
3447
3456
  }
3448
3457
  /**
3449
3458
  * Called before a player toggles the map editor on or off.
3450
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_player_toggled_map_editor Online documentation}
3459
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_player_toggled_map_editor Online documentation}
3451
3460
  */
3452
3461
  interface OnPrePlayerToggledMapEditorEvent extends EventData {
3453
3462
  readonly player_index: PlayerIndex
@@ -3462,7 +3471,7 @@ declare module "factorio:runtime" {
3462
3471
  }
3463
3472
  /**
3464
3473
  * Called directly before a robot explodes cliffs.
3465
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_robot_exploded_cliff Online documentation}
3474
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_robot_exploded_cliff Online documentation}
3466
3475
  */
3467
3476
  interface OnPreRobotExplodedCliffEvent extends EventData {
3468
3477
  readonly robot: LuaEntity
@@ -3486,7 +3495,7 @@ declare module "factorio:runtime" {
3486
3495
  }
3487
3496
  /**
3488
3497
  * Called just before the scenario finishes.
3489
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_scenario_finished Online documentation}
3498
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_scenario_finished Online documentation}
3490
3499
  */
3491
3500
  interface OnPreScenarioFinishedEvent extends EventData {
3492
3501
  /**
@@ -3504,7 +3513,7 @@ declare module "factorio:runtime" {
3504
3513
  }
3505
3514
  /**
3506
3515
  * Called just before a script inventory is resized.
3507
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_script_inventory_resized Online documentation}
3516
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_script_inventory_resized Online documentation}
3508
3517
  */
3509
3518
  interface OnPreScriptInventoryResizedEvent extends EventData {
3510
3519
  /**
@@ -3535,7 +3544,7 @@ declare module "factorio:runtime" {
3535
3544
  }
3536
3545
  /**
3537
3546
  * Called just before a surface is cleared (all entities removed and all chunks deleted).
3538
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_surface_cleared Online documentation}
3547
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_surface_cleared Online documentation}
3539
3548
  */
3540
3549
  interface OnPreSurfaceClearedEvent extends EventData {
3541
3550
  readonly surface_index: SurfaceIndex
@@ -3550,7 +3559,7 @@ declare module "factorio:runtime" {
3550
3559
  }
3551
3560
  /**
3552
3561
  * Called just before a surface is deleted.
3553
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_pre_surface_deleted Online documentation}
3562
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_pre_surface_deleted Online documentation}
3554
3563
  */
3555
3564
  interface OnPreSurfaceDeletedEvent extends EventData {
3556
3565
  readonly surface_index: SurfaceIndex
@@ -3565,7 +3574,7 @@ declare module "factorio:runtime" {
3565
3574
  }
3566
3575
  /**
3567
3576
  * Called when the player triggers "redo".
3568
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_redo_applied Online documentation}
3577
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_redo_applied Online documentation}
3569
3578
  */
3570
3579
  interface OnRedoAppliedEvent extends EventData {
3571
3580
  /**
@@ -3587,7 +3596,7 @@ declare module "factorio:runtime" {
3587
3596
  }
3588
3597
  /**
3589
3598
  * Called when research is cancelled.
3590
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_research_cancelled Online documentation}
3599
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_research_cancelled Online documentation}
3591
3600
  */
3592
3601
  interface OnResearchCancelledEvent extends EventData {
3593
3602
  /**
@@ -3609,7 +3618,7 @@ declare module "factorio:runtime" {
3609
3618
  }
3610
3619
  /**
3611
3620
  * Called when a research finishes.
3612
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_research_finished Online documentation}
3621
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_research_finished Online documentation}
3613
3622
  */
3614
3623
  interface OnResearchFinishedEvent extends EventData {
3615
3624
  /**
@@ -3631,7 +3640,7 @@ declare module "factorio:runtime" {
3631
3640
  }
3632
3641
  /**
3633
3642
  * Called when research is moved forwards or backwards in the research queue.
3634
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_research_moved Online documentation}
3643
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_research_moved Online documentation}
3635
3644
  */
3636
3645
  interface OnResearchMovedEvent extends EventData {
3637
3646
  /**
@@ -3649,7 +3658,7 @@ declare module "factorio:runtime" {
3649
3658
  }
3650
3659
  /**
3651
3660
  * Called when a research is reversed (unresearched).
3652
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_research_reversed Online documentation}
3661
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_research_reversed Online documentation}
3653
3662
  */
3654
3663
  interface OnResearchReversedEvent extends EventData {
3655
3664
  /**
@@ -3671,7 +3680,7 @@ declare module "factorio:runtime" {
3671
3680
  }
3672
3681
  /**
3673
3682
  * Called when a technology research starts.
3674
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_research_started Online documentation}
3683
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_research_started Online documentation}
3675
3684
  */
3676
3685
  interface OnResearchStartedEvent extends EventData {
3677
3686
  /**
@@ -3690,7 +3699,7 @@ declare module "factorio:runtime" {
3690
3699
  }
3691
3700
  /**
3692
3701
  * Called when a resource entity reaches 0 or its minimum yield for infinite resources.
3693
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_resource_depleted Online documentation}
3702
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_resource_depleted Online documentation}
3694
3703
  */
3695
3704
  interface OnResourceDepletedEvent extends EventData {
3696
3705
  readonly entity: LuaEntity
@@ -3707,7 +3716,7 @@ declare module "factorio:runtime" {
3707
3716
  * Called when a construction robot builds an entity.
3708
3717
  *
3709
3718
  * Event filter: [LuaRobotBuiltEntityEventFilter](LuaRobotBuiltEntityEventFilter]
3710
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_built_entity Online documentation}
3719
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_built_entity Online documentation}
3711
3720
  */
3712
3721
  interface OnRobotBuiltEntityEvent extends EventData {
3713
3722
  /**
@@ -3737,7 +3746,7 @@ declare module "factorio:runtime" {
3737
3746
  }
3738
3747
  /**
3739
3748
  * Called after a robot builds tiles.
3740
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_built_tile Online documentation}
3749
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_built_tile Online documentation}
3741
3750
  */
3742
3751
  interface OnRobotBuiltTileEvent extends EventData {
3743
3752
  /**
@@ -3779,7 +3788,7 @@ declare module "factorio:runtime" {
3779
3788
  }
3780
3789
  /**
3781
3790
  * Called directly after a robot explodes cliffs.
3782
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_exploded_cliff Online documentation}
3791
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_exploded_cliff Online documentation}
3783
3792
  */
3784
3793
  interface OnRobotExplodedCliffEvent extends EventData {
3785
3794
  readonly robot: LuaEntity
@@ -3802,7 +3811,7 @@ declare module "factorio:runtime" {
3802
3811
  }
3803
3812
  /**
3804
3813
  * Called when a robot mines an entity.
3805
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_mined Online documentation}
3814
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_mined Online documentation}
3806
3815
  */
3807
3816
  interface OnRobotMinedEvent extends EventData {
3808
3817
  /**
@@ -3830,7 +3839,7 @@ declare module "factorio:runtime" {
3830
3839
  * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
3831
3840
  *
3832
3841
  * Event filter: [LuaRobotMinedEntityEventFilter](LuaRobotMinedEntityEventFilter]
3833
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_mined_entity Online documentation}
3842
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_mined_entity Online documentation}
3834
3843
  */
3835
3844
  interface OnRobotMinedEntityEvent extends EventData {
3836
3845
  /**
@@ -3856,7 +3865,7 @@ declare module "factorio:runtime" {
3856
3865
  }
3857
3866
  /**
3858
3867
  * Called after a robot mines tiles.
3859
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_mined_tile Online documentation}
3868
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_mined_tile Online documentation}
3860
3869
  */
3861
3870
  interface OnRobotMinedTileEvent extends EventData {
3862
3871
  /**
@@ -3884,7 +3893,7 @@ declare module "factorio:runtime" {
3884
3893
  * Called before a robot mines an entity.
3885
3894
  *
3886
3895
  * Event filter: [LuaPreRobotMinedEntityEventFilter](LuaPreRobotMinedEntityEventFilter]
3887
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_robot_pre_mined Online documentation}
3896
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_robot_pre_mined Online documentation}
3888
3897
  */
3889
3898
  interface OnRobotPreMinedEvent extends EventData {
3890
3899
  /**
@@ -3906,7 +3915,7 @@ declare module "factorio:runtime" {
3906
3915
  }
3907
3916
  /**
3908
3917
  * Called when a rocket silo is ordered to be launched.
3909
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_rocket_launch_ordered Online documentation}
3918
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_rocket_launch_ordered Online documentation}
3910
3919
  */
3911
3920
  interface OnRocketLaunchOrderedEvent extends EventData {
3912
3921
  readonly rocket: LuaEntity
@@ -3926,7 +3935,7 @@ declare module "factorio:runtime" {
3926
3935
  }
3927
3936
  /**
3928
3937
  * Called when a rocket finishes ascending. (Triggers listening for finished rocket launch past 2.0 have been moved to 'on_cargo_pod_finished_ascending' as rocket and cargo pod are two separate entities)
3929
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_rocket_launched Online documentation}
3938
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_rocket_launched Online documentation}
3930
3939
  */
3931
3940
  interface OnRocketLaunchedEvent extends EventData {
3932
3941
  readonly rocket: LuaEntity
@@ -3942,7 +3951,7 @@ declare module "factorio:runtime" {
3942
3951
  }
3943
3952
  /**
3944
3953
  * Called when a runtime mod setting is changed by a player.
3945
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_runtime_mod_setting_changed Online documentation}
3954
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_runtime_mod_setting_changed Online documentation}
3946
3955
  */
3947
3956
  interface OnRuntimeModSettingChangedEvent extends EventData {
3948
3957
  /**
@@ -3965,7 +3974,7 @@ declare module "factorio:runtime" {
3965
3974
  }
3966
3975
  /**
3967
3976
  * Called just after a script inventory is resized.
3968
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_script_inventory_resized Online documentation}
3977
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_script_inventory_resized Online documentation}
3969
3978
  */
3970
3979
  interface OnScriptInventoryResizedEvent extends EventData {
3971
3980
  /**
@@ -4000,7 +4009,7 @@ declare module "factorio:runtime" {
4000
4009
  }
4001
4010
  /**
4002
4011
  * Called when a {@link LuaSurface#request_path LuaSurface::request_path} call completes.
4003
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_script_path_request_finished Online documentation}
4012
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_script_path_request_finished Online documentation}
4004
4013
  */
4005
4014
  interface OnScriptPathRequestFinishedEvent extends EventData {
4006
4015
  /**
@@ -4026,7 +4035,7 @@ declare module "factorio:runtime" {
4026
4035
  }
4027
4036
  /**
4028
4037
  * Called when a script trigger effect is triggered.
4029
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_script_trigger_effect Online documentation}
4038
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_script_trigger_effect Online documentation}
4030
4039
  */
4031
4040
  interface OnScriptTriggerEffectEvent extends EventData {
4032
4041
  /**
@@ -4045,6 +4054,7 @@ declare module "factorio:runtime" {
4045
4054
  * The entity that originally caused the sequence of triggers
4046
4055
  */
4047
4056
  readonly cause_entity?: LuaEntity
4057
+ readonly quality?: string
4048
4058
  /**
4049
4059
  * Identifier of the event
4050
4060
  */
@@ -4058,7 +4068,7 @@ declare module "factorio:runtime" {
4058
4068
  * Called when an entity of type `radar` finishes scanning a sector.
4059
4069
  *
4060
4070
  * Event filter: [LuaSectorScannedEventFilter](LuaSectorScannedEventFilter]
4061
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_sector_scanned Online documentation}
4071
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_sector_scanned Online documentation}
4062
4072
  */
4063
4073
  interface OnSectorScannedEvent extends EventData {
4064
4074
  /**
@@ -4084,7 +4094,7 @@ declare module "factorio:runtime" {
4084
4094
  }
4085
4095
  /**
4086
4096
  * Called when an individual segment of a SegmentedUnit is created.
4087
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_segment_entity_created Online documentation}
4097
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_segment_entity_created Online documentation}
4088
4098
  */
4089
4099
  interface OnSegmentEntityCreatedEvent extends EventData {
4090
4100
  readonly entity: LuaEntity
@@ -4099,7 +4109,7 @@ declare module "factorio:runtime" {
4099
4109
  }
4100
4110
  /**
4101
4111
  * Called after the selected entity changes for a given player.
4102
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_selected_entity_changed Online documentation}
4112
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_selected_entity_changed Online documentation}
4103
4113
  */
4104
4114
  interface OnSelectedEntityChangedEvent extends EventData {
4105
4115
  /**
@@ -4121,7 +4131,7 @@ declare module "factorio:runtime" {
4121
4131
  }
4122
4132
  /**
4123
4133
  * Called when {@link LuaGameScript#is_multiplayer LuaGameScript::is_multiplayer} changes to false. May also be raised when it was already false but a game was loaded from a save file without hosting.
4124
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_singleplayer_init Online documentation}
4134
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_singleplayer_init Online documentation}
4125
4135
  */
4126
4136
  interface OnSingleplayerInitEvent extends EventData {
4127
4137
  /**
@@ -4137,7 +4147,7 @@ declare module "factorio:runtime" {
4137
4147
  * Called when a space platform builds an entity.
4138
4148
  *
4139
4149
  * Event filter: [LuaPlatformBuiltEntityEventFilter](LuaPlatformBuiltEntityEventFilter]
4140
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_built_entity Online documentation}
4150
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_built_entity Online documentation}
4141
4151
  */
4142
4152
  interface OnSpacePlatformBuiltEntityEvent extends EventData {
4143
4153
  /**
@@ -4167,7 +4177,7 @@ declare module "factorio:runtime" {
4167
4177
  }
4168
4178
  /**
4169
4179
  * Called after a space platform builds tiles.
4170
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_built_tile Online documentation}
4180
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_built_tile Online documentation}
4171
4181
  */
4172
4182
  interface OnSpacePlatformBuiltTileEvent extends EventData {
4173
4183
  /**
@@ -4209,7 +4219,7 @@ declare module "factorio:runtime" {
4209
4219
  }
4210
4220
  /**
4211
4221
  * Called when a space platform changes state
4212
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_changed_state Online documentation}
4222
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_changed_state Online documentation}
4213
4223
  */
4214
4224
  interface OnSpacePlatformChangedStateEvent extends EventData {
4215
4225
  readonly platform: LuaSpacePlatform
@@ -4231,7 +4241,7 @@ declare module "factorio:runtime" {
4231
4241
  * The buffer inventory is special in that it's only valid during this event and has a dynamic size expanding as more items are transferred into it.
4232
4242
  *
4233
4243
  * Event filter: [LuaPlatformMinedEntityEventFilter](LuaPlatformMinedEntityEventFilter]
4234
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_mined_entity Online documentation}
4244
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_mined_entity Online documentation}
4235
4245
  */
4236
4246
  interface OnSpacePlatformMinedEntityEvent extends EventData {
4237
4247
  /**
@@ -4257,7 +4267,7 @@ declare module "factorio:runtime" {
4257
4267
  }
4258
4268
  /**
4259
4269
  * Called when a platform mines an entity.
4260
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_mined_item Online documentation}
4270
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_mined_item Online documentation}
4261
4271
  */
4262
4272
  interface OnSpacePlatformMinedItemEvent extends EventData {
4263
4273
  /**
@@ -4279,7 +4289,7 @@ declare module "factorio:runtime" {
4279
4289
  }
4280
4290
  /**
4281
4291
  * Called after a platform mines tiles.
4282
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_mined_tile Online documentation}
4292
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_mined_tile Online documentation}
4283
4293
  */
4284
4294
  interface OnSpacePlatformMinedTileEvent extends EventData {
4285
4295
  /**
@@ -4307,7 +4317,7 @@ declare module "factorio:runtime" {
4307
4317
  * Called before a platform mines an entity.
4308
4318
  *
4309
4319
  * Event filter: [LuaPrePlatformMinedEntityEventFilter](LuaPrePlatformMinedEntityEventFilter]
4310
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_space_platform_pre_mined Online documentation}
4320
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_space_platform_pre_mined Online documentation}
4311
4321
  */
4312
4322
  interface OnSpacePlatformPreMinedEvent extends EventData {
4313
4323
  /**
@@ -4329,7 +4339,7 @@ declare module "factorio:runtime" {
4329
4339
  }
4330
4340
  /**
4331
4341
  * Called when a spider finishes moving to its autopilot position.
4332
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_spider_command_completed Online documentation}
4342
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_spider_command_completed Online documentation}
4333
4343
  */
4334
4344
  interface OnSpiderCommandCompletedEvent extends EventData {
4335
4345
  /**
@@ -4347,7 +4357,7 @@ declare module "factorio:runtime" {
4347
4357
  }
4348
4358
  /**
4349
4359
  * Called when a translation request generated through {@link LuaPlayer#request_translation LuaPlayer::request_translation} or {@link LuaPlayer#request_translations LuaPlayer::request_translations} has been completed.
4350
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_string_translated Online documentation}
4360
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_string_translated Online documentation}
4351
4361
  */
4352
4362
  interface OnStringTranslatedEvent extends EventData {
4353
4363
  /**
@@ -4381,7 +4391,7 @@ declare module "factorio:runtime" {
4381
4391
  }
4382
4392
  /**
4383
4393
  * Called just after a surface is cleared (all entities removed and all chunks deleted).
4384
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_surface_cleared Online documentation}
4394
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_surface_cleared Online documentation}
4385
4395
  */
4386
4396
  interface OnSurfaceClearedEvent extends EventData {
4387
4397
  readonly surface_index: SurfaceIndex
@@ -4398,7 +4408,7 @@ declare module "factorio:runtime" {
4398
4408
  * Called when a surface is created.
4399
4409
  *
4400
4410
  * This is not called when the default surface is created as it will always exist.
4401
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_surface_created Online documentation}
4411
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_surface_created Online documentation}
4402
4412
  */
4403
4413
  interface OnSurfaceCreatedEvent extends EventData {
4404
4414
  readonly surface_index: SurfaceIndex
@@ -4413,7 +4423,7 @@ declare module "factorio:runtime" {
4413
4423
  }
4414
4424
  /**
4415
4425
  * Called after a surface is deleted.
4416
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_surface_deleted Online documentation}
4426
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_surface_deleted Online documentation}
4417
4427
  */
4418
4428
  interface OnSurfaceDeletedEvent extends EventData {
4419
4429
  readonly surface_index: SurfaceIndex
@@ -4428,7 +4438,7 @@ declare module "factorio:runtime" {
4428
4438
  }
4429
4439
  /**
4430
4440
  * Called after a surface is imported via the map editor.
4431
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_surface_imported Online documentation}
4441
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_surface_imported Online documentation}
4432
4442
  */
4433
4443
  interface OnSurfaceImportedEvent extends EventData {
4434
4444
  readonly surface_index: SurfaceIndex
@@ -4447,7 +4457,7 @@ declare module "factorio:runtime" {
4447
4457
  }
4448
4458
  /**
4449
4459
  * Called when a surface is renamed.
4450
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_surface_renamed Online documentation}
4460
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_surface_renamed Online documentation}
4451
4461
  */
4452
4462
  interface OnSurfaceRenamedEvent extends EventData {
4453
4463
  readonly surface_index: SurfaceIndex
@@ -4464,7 +4474,7 @@ declare module "factorio:runtime" {
4464
4474
  }
4465
4475
  /**
4466
4476
  * Called when {@link LuaForce#reset_technology_effects LuaForce::reset_technology_effects} is finished.
4467
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_technology_effects_reset Online documentation}
4477
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_technology_effects_reset Online documentation}
4468
4478
  */
4469
4479
  interface OnTechnologyEffectsResetEvent extends EventData {
4470
4480
  readonly force: LuaForce
@@ -4479,7 +4489,7 @@ declare module "factorio:runtime" {
4479
4489
  }
4480
4490
  /**
4481
4491
  * It is fired once every tick. Since this event is fired every tick, its handler shouldn't include performance heavy code.
4482
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_tick Online documentation}
4492
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_tick Online documentation}
4483
4493
  */
4484
4494
  interface OnTickEvent extends EventData {
4485
4495
  /**
@@ -4493,7 +4503,7 @@ declare module "factorio:runtime" {
4493
4503
  }
4494
4504
  /**
4495
4505
  * Called when a train changes state (started to stopped and vice versa)
4496
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_train_changed_state Online documentation}
4506
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_train_changed_state Online documentation}
4497
4507
  */
4498
4508
  interface OnTrainChangedStateEvent extends EventData {
4499
4509
  readonly train: LuaTrain
@@ -4509,7 +4519,7 @@ declare module "factorio:runtime" {
4509
4519
  }
4510
4520
  /**
4511
4521
  * Called when a new train is created either through disconnecting/connecting an existing one or building a new one.
4512
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_train_created Online documentation}
4522
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_train_created Online documentation}
4513
4523
  */
4514
4524
  interface OnTrainCreatedEvent extends EventData {
4515
4525
  readonly train: LuaTrain
@@ -4532,7 +4542,7 @@ declare module "factorio:runtime" {
4532
4542
  }
4533
4543
  /**
4534
4544
  * Called when a trains schedule is changed either by the player or through script.
4535
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_train_schedule_changed Online documentation}
4545
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_train_schedule_changed Online documentation}
4536
4546
  */
4537
4547
  interface OnTrainScheduleChangedEvent extends EventData {
4538
4548
  readonly train: LuaTrain
@@ -4551,7 +4561,7 @@ declare module "factorio:runtime" {
4551
4561
  }
4552
4562
  /**
4553
4563
  * Called when an entity with a trigger prototype (such as capsules) create an entity AND that trigger prototype defined `trigger_created_entity=true`.
4554
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_trigger_created_entity Online documentation}
4564
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_trigger_created_entity Online documentation}
4555
4565
  */
4556
4566
  interface OnTriggerCreatedEntityEvent extends EventData {
4557
4567
  readonly entity: LuaEntity
@@ -4567,7 +4577,7 @@ declare module "factorio:runtime" {
4567
4577
  }
4568
4578
  /**
4569
4579
  * Called when an entity with a trigger prototype (such as capsules) fire an artillery projectile AND that trigger prototype defined `trigger_fired_artillery=true`.
4570
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_trigger_fired_artillery Online documentation}
4580
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_trigger_fired_artillery Online documentation}
4571
4581
  */
4572
4582
  interface OnTriggerFiredArtilleryEvent extends EventData {
4573
4583
  readonly entity: LuaEntity
@@ -4583,7 +4593,7 @@ declare module "factorio:runtime" {
4583
4593
  }
4584
4594
  /**
4585
4595
  * Called when the player triggers "undo".
4586
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_undo_applied Online documentation}
4596
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_undo_applied Online documentation}
4587
4597
  */
4588
4598
  interface OnUndoAppliedEvent extends EventData {
4589
4599
  /**
@@ -4605,7 +4615,7 @@ declare module "factorio:runtime" {
4605
4615
  }
4606
4616
  /**
4607
4617
  * Called when a unit is added to a unit group.
4608
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_unit_added_to_group Online documentation}
4618
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_unit_added_to_group Online documentation}
4609
4619
  */
4610
4620
  interface OnUnitAddedToGroupEvent extends EventData {
4611
4621
  readonly unit: LuaEntity
@@ -4621,7 +4631,7 @@ declare module "factorio:runtime" {
4621
4631
  }
4622
4632
  /**
4623
4633
  * Called when a new unit group is created, before any members are added to it.
4624
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_unit_group_created Online documentation}
4634
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_unit_group_created Online documentation}
4625
4635
  */
4626
4636
  interface OnUnitGroupCreatedEvent extends EventData {
4627
4637
  readonly group: LuaCommandable
@@ -4636,7 +4646,7 @@ declare module "factorio:runtime" {
4636
4646
  }
4637
4647
  /**
4638
4648
  * Called when a unit group finishes gathering and starts executing its command.
4639
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_unit_group_finished_gathering Online documentation}
4649
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_unit_group_finished_gathering Online documentation}
4640
4650
  */
4641
4651
  interface OnUnitGroupFinishedGatheringEvent extends EventData {
4642
4652
  readonly group: LuaCommandable
@@ -4651,7 +4661,7 @@ declare module "factorio:runtime" {
4651
4661
  }
4652
4662
  /**
4653
4663
  * Called when a unit is removed from a unit group.
4654
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_unit_removed_from_group Online documentation}
4664
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_unit_removed_from_group Online documentation}
4655
4665
  */
4656
4666
  interface OnUnitRemovedFromGroupEvent extends EventData {
4657
4667
  readonly unit: LuaEntity
@@ -4667,7 +4677,7 @@ declare module "factorio:runtime" {
4667
4677
  }
4668
4678
  /**
4669
4679
  * Called when a worker (construction or logistic) robot expires through a lack of energy.
4670
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#on_worker_robot_expired Online documentation}
4680
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#on_worker_robot_expired Online documentation}
4671
4681
  */
4672
4682
  interface OnWorkerRobotExpiredEvent extends EventData {
4673
4683
  readonly robot: LuaEntity
@@ -4684,7 +4694,7 @@ declare module "factorio:runtime" {
4684
4694
  * A static event mods can use to tell other mods they built something by script. This event is only raised if a mod does so with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event} or {@link LuaBootstrap#raise_script_built LuaBootstrap::raise_script_built}, or when `raise_built` is passed to {@link LuaSurface#create_entity LuaSurface::create_entity}.
4685
4695
  *
4686
4696
  * Event filter: [LuaScriptRaisedBuiltEventFilter](LuaScriptRaisedBuiltEventFilter]
4687
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#script_raised_built Online documentation}
4697
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#script_raised_built Online documentation}
4688
4698
  */
4689
4699
  interface ScriptRaisedBuiltEvent extends EventData {
4690
4700
  /**
@@ -4704,7 +4714,7 @@ declare module "factorio:runtime" {
4704
4714
  * A static event mods can use to tell other mods they destroyed something by script. This event is only raised if a mod does so with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event} or {@link LuaBootstrap#raise_script_destroy LuaBootstrap::raise_script_destroy}, or when `raise_destroy` is passed to {@link LuaEntity#destroy LuaEntity::destroy}.
4705
4715
  *
4706
4716
  * Event filter: [LuaScriptRaisedDestroyEventFilter](LuaScriptRaisedDestroyEventFilter]
4707
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#script_raised_destroy Online documentation}
4717
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#script_raised_destroy Online documentation}
4708
4718
  */
4709
4719
  interface ScriptRaisedDestroyEvent extends EventData {
4710
4720
  /**
@@ -4724,7 +4734,7 @@ declare module "factorio:runtime" {
4724
4734
  * A static event mods can use to tell other mods they revived something by script. This event is only raised if a mod does so with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event} or {@link LuaBootstrap#raise_script_revive LuaBootstrap::raise_script_revive}, or when `raise_revive` is passed to {@link LuaEntity#revive LuaEntity::revive}.
4725
4735
  *
4726
4736
  * Event filter: [LuaScriptRaisedReviveEventFilter](LuaScriptRaisedReviveEventFilter]
4727
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#script_raised_revive Online documentation}
4737
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#script_raised_revive Online documentation}
4728
4738
  */
4729
4739
  interface ScriptRaisedReviveEvent extends EventData {
4730
4740
  /**
@@ -4746,7 +4756,7 @@ declare module "factorio:runtime" {
4746
4756
  }
4747
4757
  /**
4748
4758
  * A static event mods can use to tell other mods they changed tiles on a surface by script. This event is only raised if a mod does so with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event} or {@link LuaBootstrap#raise_script_set_tiles LuaBootstrap::raise_script_set_tiles}, or when `raise_event` is passed to {@link LuaSurface#set_tiles LuaSurface::set_tiles}.
4749
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#script_raised_set_tiles Online documentation}
4759
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#script_raised_set_tiles Online documentation}
4750
4760
  */
4751
4761
  interface ScriptRaisedSetTilesEvent extends EventData {
4752
4762
  /**
@@ -4770,7 +4780,7 @@ declare module "factorio:runtime" {
4770
4780
  * A static event mods can use to tell other mods they teleported something by script. This event is only raised if a mod does so with {@link LuaBootstrap#raise_event LuaBootstrap::raise_event} or {@link LuaBootstrap#raise_script_teleported LuaBootstrap::raise_script_teleported}, or when `raise_teleported` is passed to {@link LuaControl#teleport LuaControl::teleport}.
4771
4781
  *
4772
4782
  * Event filter: [LuaScriptRaisedTeleportedEventFilter](LuaScriptRaisedTeleportedEventFilter]
4773
- * @see {@link https://lua-api.factorio.com/2.0.47/events.html#script_raised_teleported Online documentation}
4783
+ * @see {@link https://lua-api.factorio.com/2.0.52/events.html#script_raised_teleported Online documentation}
4774
4784
  */
4775
4785
  interface ScriptRaisedTeleportedEvent extends EventData {
4776
4786
  /**