Official Factorio Wiki - User contributions [en]

Belt transport system

2018-02-05T13:24:29Z

M16:

{{Languages}}
The belt transport system is the first system the [[player]] will use to transport items from place to place. It, along
with [[Railway|trains]], and [[Logistic network|Logistic robots]], makes up the systems of item transportation in
Factorio.

Belts specifically are used to transport items and run without using energy. Belts can also interact with other moving entities such as [[player]]s, [[vehicle]]s and [[enemies|biters]], also allowing for faster or slower movement speed.

== All types of Transport belts ==

Below is a chart of all the Transport Belts present and available for use in Factorio.

{| class="wikitable"
! [[Transport belts]] !! [[Underground belts]] !! [[Splitters]] !! Max. throughput (Items per [[game-second]])<sup>1</sup> !! Needed research
|-
| {{Imagelink|Transport belt|Transport belt}}
| {{Imagelink|Underground belt|Underground belt}}
| {{Imagelink|Splitter|Splitter}}
| 13.333
| [[Logistics (research)]]<sup>2</sup>
|-
| {{Imagelink|Fast transport belt|Fast transport belt}}
| {{Imagelink|Fast underground belt|Fast underground belt}}
| {{Imagelink|Fast splitter|Fast splitter}}
| 26.666
| [[Logistics 2 (research)]]
|-
| {{Imagelink|Express transport belt|Express transport belt}}
| {{Imagelink|Express underground belt|Express underground belt}}
| {{Imagelink|Express splitter|Express splitter}}
| 40.0
| [[Logistics 3 (research)]]
|-
|}

(1) See '''[[Transport_belts/Physics|Physics of Transport Belts]]''' for more detailed information.

(2) Only for the underground belt and splitter. The basic transport belt is available at the start of the game.

== Tiers of belts ==

[[File:Transport_belts_speed.gif|300px|thumb|top|Animation showing the three types of belt and their speed (from top to bottom: regular belts, fast belts and express belts).]]
There are 3 different tiers of belts available for use. [[Transport belt|The basic type]] has a yellow color and is
the slowest. [[Fast transport belt|Next tier up]] has a red color, and is twice is fast as the yellow tier. [[Express transport belt|The third]] and final tier is colored blue and is three times as fast as the basic belt.
{{clear}}

== Mechanics of belts ==

This section describes the mechanics of transport belts.

=== Merging and un-merging belts ===

Belts of all tiers have 2 lanes for items to ride on. This allows for either a double flow of one material, or with
some careful setup, transporting two different materials on the same belt. Mixed belts can be beneficial for
smelting ore, or producing items with many different ingredients such as [[science pack 3]]. Un-merging a mixed belt is
fairly easy too, since an underground belt will block half of the belt.

[[File:Transport_belts_merge.gif|300px|top]]   [[File:Transport_belts_unmerge.gif|300px|top]]

Commonly, merging and un-merging is done by using a [[splitter]]. The trick in the second picture is better described in the '''[[Belt_transport_system#Underground_Belt_as_blocker_of_one_side_of_belt|Underground Belt]]''' section.

=== Lane balance ===

:''Main article: [[Balancers#Lane_Balancers|Lane Balancers]]''

Due to how items are placed onto belts by [[inserters]], their lanes can sometimes become unbalanced. In order to
maintain throughput, balancing the lanes may be necessary. The gifs below show a few ways how to do this:

[[File:Transport_belts_balance1.gif|top]]   [[File:Transport_belts_balance2.gif|top]]

=== Belt Throughput ===

Maximizing the throughput is important, since it will keep belts efficient. Therefore some definitions need to
be introduced:

; Speed
: How fast a belt moves.
; Density
: How tight are the items put onto the belts.
; Throughput
: This is speed * density. It describes how many items pass by in a given time.

So, there are three opportunities to enhance the throughput:

* More density

Sometimes items have little spaces next to each other that aren't big enough for other items to fit
in. In this case reordering the items can still increase the density. This can be done by temporarily increasing the
belt speed on a single tile or by merging 2 lanes with an inserter.

The gif below shows the problem with a low density belt, and the right shows how it can be rectified. (Notice the red belt)

[[File:Transport_belts_density.gif|top|300px]]

* More speed

If the belts in the factory are already at maximum density, their speed can still be upgraded with better belts. Finding the bottleneck is the first thing that needs to be done, usually it can be discovered quite
easily. There will be a part of the belt where the items don't move quickly (or at all) or stop at maximum density
and suddenly they come to a point where this 'stop and go' effect releases itself, the bottleneck has been found.
In most cases, this will be the place where belt optimization is needed.

* More belts

Adding additional parallel belts can also increase the throughput. Simply place more belts carrying the item that needs throughput, and add [[splitter]]s to balance items between them.

=== Belt Tricks ===

Moving fast can be essential to defend alien attacks in time. Running on a belt will increase or decrease the movement
speed of the [[player]] accordingly to the belts speed. That is why building a belt towards your [[defense]]s can
be beneficial.

However, the player is not the only unit that can be moved by transport belts. Additionally, biters and spitters can be
moved. This can be abused to improve your defense. Firstly, biters will have a harder time to reach your walls when
placing express transport belt in front of them. Secondly, spitters can be moved closer to your walls. That way more
turrets can attack a single spitter at once.

Another useful usage are [[car]]s on transport belts. Cars have an inventory and can be filled by [[inserters]].
So, they can be used as moving boxes on belts. This has several advantages: Firstly the throughput of the
belt-car-boxes is amazingly high, secondly the inserter stack size bonus does apply here and make inserters more
effective.

=== Placement ===
{| style="float:right; padding-left:10px; padding-right:10px;"
| style="padding-right:1em" | [[File:Transport_belts_doplace.gif|300px|top]]
| [[File:Transport_belts_replace.gif|300px|top]]
|}

While conveyor belts can be placed in a line by clicking and dragging the mouse, it is often easier to hold the mouse down and move your character. Conveyor belts can be rotated after being placed by hovering over them with an empty hand and pressing {{keybinding|r}}, or by building over them with another conveyor belt. Conveyor belts can also be upgraded in this manner, by placing another belt over top of it.

{{clear}}

== Splitters ==

[[Splitters]] are another form of item manipulation. Splitters are a 2x1 tile that split incoming items on belts
from one input to two outputs, in a 50/50 ratio. They are used to divide resources between two belts, or balance
multiple belts.

=== Mechanics of splitters ===

The behavior of splitters looks simple at first glance. But they are not that simple. Splitters have an astonishing amount of uses.

* Splitters have two input belts, and two output belts. If the splitter receives items on one belt, it will split the input evenly between its two sides.

* If one of the outputs is fully backed-up and the splitter cannot split evenly, it will put all input on its other output.

* Splitters can also take two inputs and one output.

The output will be an even mix of both the inputs. This can be used to efficiently merge two belts together. When it does this, the items will not be shuffled.

In order to join/split belts, the splitter must be the same speed as the incoming belts, otherwise the splitter will
become a bottleneck.



However, when both belts are at full capacity, the splitter will prefer one side (the left input), and use the other to fill gaps. This
behavior is due to the game being unable to fairly reverse-split the belts. Explained by the developers:

''"But there are fundamental problems with equal joining. How exactly will you define it? Once you have an available
item to move to the belt on the left belt, you would have to wait, if some other item on the right belt doesn't
arrive, as it would be the time for the right belt to be activated. But how long do you wait? And once you wait you
limit the throughput of the splitter."''

This behavior can be used to prioritize input from certain belts, such as from a storage.
=== Balancing ===

{{Main|Balancers}}

Balancers are used to evenly distribute items over multiple belts or multiple belt lanes.

== Underground belts ==

Underground belts can be used to cross different flows of items without interfering. They move items like a [[Transport belts|normal belt]].

* You can cross any number of entities and all types of ground, like water, swamps, etc. (as long as the input and output endpoints are on land)
* You can cross other underground stuff (any number of underground belts or underground pipes). They won't be mixed.
* For the connection only the endpoints (entry-side and exit-side) are relevant.
* The maximum distance underground is 8 [[tile]]s with [[express underground belt]]s.
* An underground belt pair of that bridges a gap of 4 tiles stores up to 44 items. An express underground belt pair at max length stores up to 72 items.
* The half of the underground belt tile with a belt can accept input from the side. The other half (with a tunnel entrance) blocks incoming items.

''This last fact is important, because it can be used to do some tricks.''

:[[File:Split-swap.png|thumb|300x400px|You can turn the order of the lanes or split the lanes completely with the underground belts trick]][[File:Split&swap2.PNG|thumb|300x400px|Narrower version with reversed underground belt flow. Used 1 Fast underground belt to prevent connection]]

=== Underground Belt as blocker of one side of belt ===

To build this you need to place one underground belt and then press R to reverse its direction. This converts the underground belt entrance to an exit (and vice versa).

This trick and similars has several more usage cases. See down.

=== Splitting Belt-Lanes with Underground Belt ===

With the same trick the underground belts can be used to split the left and right lane of a belt!
:[[File:Transport_belts_unmerge.gif]]
On the right is an example how to swap lanes first and then splitting and filling belt with materials of one lane.
To understand the picture start at top. The inserters place just copper- and iron-plates on left and right lane of the belt. Then place a splitter and split into two belts. Place an underground belts orthogonal (90 degrees left or right) to each end of the belts. Place the exit-side directly at the next tile. The result is that only one lane of the incoming belt is transported.
In the next splitter this procedure is repeated to prove, that the transformation can be reversed.
Use splitters to fill two belt-lanes again.

This trick is of course also useful with one underground belt, when you want to transport only one lane and keep the other. You need then of course no splitter.

The big advantage of this construction is, that it doesn't need any energy to run (smart inserters, which sort that, need always energy) and it is much faster than a single smart splitter and cannot "forget" one item. The biggest disadvantage is, that it is a little bit complicated to built (and expensive) and needs some more space (but not much more, when building the same throughput with inserters). But this is definitely a good idea, when you have lots of items on different lanes of a belt and want to have them distincted.

=== Swapping lanes ===

<div><ul>
<li style="display:inline-block;"> With curves: [[File:SplittingLaneSimple.jpg|300x200px]] </li>
<li style="display:inline-block;"> Without curves: [[File:LaneSwapperWithoutTurns.jpg|300x200px]] </li>
</ul></div>

== See also ==
* [[Splitter]]
* [[Transport belt]]
* [[Underground belt]]
* [https://www.youtube.com/watch?v=tnj8YhvJE_o A Video about Factorio Belt Mechanics, Tipps & Tricks (Youtube, 5min)]

{{C|Belt transport system}}

Belt transport system

2018-02-05T13:23:01Z

M16: clarification about underground belts

{{Languages}}
The belt transport system is the first system the [[player]] will use to transport items from place to place. It, along
with [[Railway|trains]], and [[Logistic network|Logistic robots]], makes up the systems of item transportation in
Factorio.

Belts specifically are used to transport items and run without using energy. Belts can also interact with other moving entities such as [[player]]s, [[vehicle]]s and [[enemies|biters]], also allowing for faster or slower movement speed.

== All types of Transport belts ==

Below is a chart of all the Transport Belts present and available for use in Factorio.

{| class="wikitable"
! [[Transport belts]] !! [[Underground belts]] !! [[Splitters]] !! Max. throughput (Items per [[game-second]])<sup>1</sup> !! Needed research
|-
| {{Imagelink|Transport belt|Transport belt}}
| {{Imagelink|Underground belt|Underground belt}}
| {{Imagelink|Splitter|Splitter}}
| 13.333
| [[Logistics (research)]]<sup>2</sup>
|-
| {{Imagelink|Fast transport belt|Fast transport belt}}
| {{Imagelink|Fast underground belt|Fast underground belt}}
| {{Imagelink|Fast splitter|Fast splitter}}
| 26.666
| [[Logistics 2 (research)]]
|-
| {{Imagelink|Express transport belt|Express transport belt}}
| {{Imagelink|Express underground belt|Express underground belt}}
| {{Imagelink|Express splitter|Express splitter}}
| 40.0
| [[Logistics 3 (research)]]
|-
|}

(1) See '''[[Transport_belts/Physics|Physics of Transport Belts]]''' for more detailed information.

(2) Only for the underground belt and splitter. The basic transport belt is available at the start of the game.

== Tiers of belts ==

[[File:Transport_belts_speed.gif|300px|thumb|top|Animation showing the three types of belt and their speed (from top to bottom: regular belts, fast belts and express belts).]]
There are 3 different tiers of belts available for use. [[Transport belt|The basic type]] has a yellow color and is
the slowest. [[Fast transport belt|Next tier up]] has a red color, and is twice is fast as the yellow tier. [[Express transport belt|The third]] and final tier is colored blue and is three times as fast as the basic belt.
{{clear}}

== Mechanics of belts ==

This section describes the mechanics of transport belts.

=== Merging and un-merging belts ===

Belts of all tiers have 2 lanes for items to ride on. This allows for either a double flow of one material, or with
some careful setup, transporting two different materials on the same belt. Mixed belts can be beneficial for
smelting ore, or producing items with many different ingredients such as [[science pack 3]]. Un-merging a mixed belt is
fairly easy too, since an underground belt will block half of the belt.

[[File:Transport_belts_merge.gif|300px|top]]   [[File:Transport_belts_unmerge.gif|300px|top]]

Commonly, merging and un-merging is done by using a [[splitter]]. The trick in the second picture is better described in the '''[[Belt_transport_system#Underground_Belt_as_blocker_of_one_side_of_belt|Underground Belt]]''' section.

=== Lane balance ===

:''Main article: [[Balancers#Lane_Balancers|Lane Balancers]]''

Due to how items are placed onto belts by [[inserters]], their lanes can sometimes become unbalanced. In order to
maintain throughput, balancing the lanes may be necessary. The gifs below show a few ways how to do this:

[[File:Transport_belts_balance1.gif|top]]   [[File:Transport_belts_balance2.gif|top]]

=== Belt Throughput ===

Maximizing the throughput is important, since it will keep belts efficient. Therefore some definitions need to
be introduced:

; Speed
: How fast a belt moves.
; Density
: How tight are the items put onto the belts.
; Throughput
: This is speed * density. It describes how many items pass by in a given time.

So, there are three opportunities to enhance the throughput:

* More density

Sometimes items have little spaces next to each other that aren't big enough for other items to fit
in. In this case reordering the items can still increase the density. This can be done by temporarily increasing the
belt speed on a single tile or by merging 2 lanes with an inserter.

The gif below shows the problem with a low density belt, and the right shows how it can be rectified. (Notice the red belt)

[[File:Transport_belts_density.gif|top|300px]]

* More speed

If the belts in the factory are already at maximum density, their speed can still be upgraded with better belts. Finding the bottleneck is the first thing that needs to be done, usually it can be discovered quite
easily. There will be a part of the belt where the items don't move quickly (or at all) or stop at maximum density
and suddenly they come to a point where this 'stop and go' effect releases itself, the bottleneck has been found.
In most cases, this will be the place where belt optimization is needed.

* More belts

Adding additional parallel belts can also increase the throughput. Simply place more belts carrying the item that needs throughput, and add [[splitter]]s to balance items between them.

=== Belt Tricks ===

Moving fast can be essential to defend alien attacks in time. Running on a belt will increase or decrease the movement
speed of the [[player]] accordingly to the belts speed. That is why building a belt towards your [[defense]]s can
be beneficial.

However, the player is not the only unit that can be moved by transport belts. Additionally, biters and spitters can be
moved. This can be abused to improve your defense. Firstly, biters will have a harder time to reach your walls when
placing express transport belt in front of them. Secondly, spitters can be moved closer to your walls. That way more
turrets can attack a single spitter at once.

Another useful usage are [[car]]s on transport belts. Cars have an inventory and can be filled by [[inserters]].
So, they can be used as moving boxes on belts. This has several advantages: Firstly the throughput of the
belt-car-boxes is amazingly high, secondly the inserter stack size bonus does apply here and make inserters more
effective.

=== Placement ===
{| style="float:right; padding-left:10px; padding-right:10px;"
| style="padding-right:1em" | [[File:Transport_belts_doplace.gif|300px|top]]
| [[File:Transport_belts_replace.gif|300px|top]]
|}

While conveyor belts can be placed in a line by clicking and dragging the mouse, it is often easier to hold the mouse down and move your character. Conveyor belts can be rotated after being placed by hovering over them with an empty hand and pressing {{keybinding|r}}, or by building over them with another conveyor belt. Conveyor belts can also be upgraded in this manner, by placing another belt over top of it.

{{clear}}

== Splitters ==

[[Splitters]] are another form of item manipulation. Splitters are a 2x1 tile that split incoming items on belts
from one input to two outputs, in a 50/50 ratio. They are used to divide resources between two belts, or balance
multiple belts.

=== Mechanics of splitters ===

The behavior of splitters looks simple at first glance. But they are not that simple. Splitters have an astonishing amount of uses.

* Splitters have two input belts, and two output belts. If the splitter receives items on one belt, it will split the input evenly between its two sides.

* If one of the outputs is fully backed-up and the splitter cannot split evenly, it will put all input on its other output.

* Splitters can also take two inputs and one output.

The output will be an even mix of both the inputs. This can be used to efficiently merge two belts together. When it does this, the items will not be shuffled.

In order to join/split belts, the splitter must be the same speed as the incoming belts, otherwise the splitter will
become a bottleneck.



However, when both belts are at full capacity, the splitter will prefer one side (the left input), and use the other to fill gaps. This
behavior is due to the game being unable to fairly reverse-split the belts. Explained by the developers:

''"But there are fundamental problems with equal joining. How exactly will you define it? Once you have an available
item to move to the belt on the left belt, you would have to wait, if some other item on the right belt doesn't
arrive, as it would be the time for the right belt to be activated. But how long do you wait? And once you wait you
limit the throughput of the splitter."''

This behavior can be used to prioritize input from certain belts, such as from a storage.
=== Balancing ===

{{Main|Balancers}}

Balancers are used to evenly distribute items over multiple belts or multiple belt lanes.

== Underground belts ==

Underground belts can be used to cross different flows of items without interfering. They move items like a [[Transport belts|normal belt]].

* You can cross any number of entities and all types of ground, like water, swamps, etc. (as long as the input and output underground belts are on land)
* You can cross other underground stuff (any number of underground belts or underground pipes). They won't be mixed.
* For the connection only the endpoints (entry-side and exit-side) are relevant.
* The maximum distance underground is 8 [[tile]]s with [[express underground belt]]s.
* An underground belt pair of that bridges a gap of 4 tiles stores up to 44 items. An express underground belt pair at max length stores up to 72 items.
* The half of the underground belt tile with a belt can accept input from the side. The other half (with a tunnel entrance) blocks incoming items.

''This last fact is important, because it can be used to do some tricks.''

:[[File:Split-swap.png|thumb|300x400px|You can turn the order of the lanes or split the lanes completely with the underground belts trick]][[File:Split&swap2.PNG|thumb|300x400px|Narrower version with reversed underground belt flow. Used 1 Fast underground belt to prevent connection]]

=== Underground Belt as blocker of one side of belt ===

To build this you need to place one underground belt and then press R to reverse its direction. This converts the underground belt entrance to an exit (and vice versa).

This trick and similars has several more usage cases. See down.

=== Splitting Belt-Lanes with Underground Belt ===

With the same trick the underground belts can be used to split the left and right lane of a belt!
:[[File:Transport_belts_unmerge.gif]]
On the right is an example how to swap lanes first and then splitting and filling belt with materials of one lane.
To understand the picture start at top. The inserters place just copper- and iron-plates on left and right lane of the belt. Then place a splitter and split into two belts. Place an underground belts orthogonal (90 degrees left or right) to each end of the belts. Place the exit-side directly at the next tile. The result is that only one lane of the incoming belt is transported.
In the next splitter this procedure is repeated to prove, that the transformation can be reversed.
Use splitters to fill two belt-lanes again.

This trick is of course also useful with one underground belt, when you want to transport only one lane and keep the other. You need then of course no splitter.

The big advantage of this construction is, that it doesn't need any energy to run (smart inserters, which sort that, need always energy) and it is much faster than a single smart splitter and cannot "forget" one item. The biggest disadvantage is, that it is a little bit complicated to built (and expensive) and needs some more space (but not much more, when building the same throughput with inserters). But this is definitely a good idea, when you have lots of items on different lanes of a belt and want to have them distincted.

=== Swapping lanes ===

<div><ul>
<li style="display:inline-block;"> With curves: [[File:SplittingLaneSimple.jpg|300x200px]] </li>
<li style="display:inline-block;"> Without curves: [[File:LaneSwapperWithoutTurns.jpg|300x200px]] </li>
</ul></div>

== See also ==
* [[Splitter]]
* [[Transport belt]]
* [[Underground belt]]
* [https://www.youtube.com/watch?v=tnj8YhvJE_o A Video about Factorio Belt Mechanics, Tipps & Tricks (Youtube, 5min)]

{{C|Belt transport system}}

User:M16

2017-12-15T18:39:19Z

M16:

I am a programmer and coder, studying to be a computer engineer because I also love engineering. By complete coincidence, I happen to like Factorio. I know, crazy right? Anyway, I have one completed mod, and a couple half completed turned abandoned mods. I have spotted quite a few misspellings over time, and I'm not going to change anything major, it just is a thorn in my side when I see a grammar mistake or spelling mistake and can't change it.

Mod portal API

2017-12-15T17:22:22Z

M16: /* /api/messages */

{{stub}}

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

== Endpoints ==

TODO!!!

=== /api/mods ===

GET Parameters:

{| class="wikitable"
! Key !! Values !! Description
|-
| order ||updated, alpha, top||How to order the mods, by most recently updated, alphabetically, or by most downloaded.
|-
| owner ||||
|-
| page ||||
|-
| page_size ||||
|-
| q ||||
|-
| tags ||||
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

=== /api/messages ===

GET Parameters:

{| class="wikitable"
! Key !! Values !! Description
|-
| page_size || {an integer} || How many messages on one page
|-
| page || {an integer} || Which page of messages
|-
| mod || {name of mod} || Name of the specific mod that you want messages for
|-
| tag || {a letter} || The letter that represents the different message tags
|}

=== /api/users ===

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "Short" column, and those returned the the api/mods/{name} endpoint are marked with a check in the "Full" column.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| created_at || String(ISO 8601) || ✓ || ✓
| The datetime the mod was uploaded, in the full ISO 8601 format, with a space separator instead of 'T'.
|-
| current_user_rating || Null || ✓ || ✓
| Doesn't seem to be implemented yet. Always null.
|-
| description || String || || ✓
| A longer description of the mod, in text only format.
|-
| description_html || String(HTML) || || ✓
| A longer description of the mod, with HTML tags.
|-
| downloads_count || Integer || ✓ || ✓
| Number of downloads.
|-
| first_media_file || [[#Media Files|Media File]] || ✓ ||
| The first media file in the "media_files" list.
|-
| game_versions || String[] || ✓ || ✓
| A list of major Factorio version strings (e.g. "0.13") starting with 0.13 that the mod is compatible with, ''in addition to'' the version(s) found in "latest_release" / "releases".
|-
| github_path || String || ✓ || ✓
| A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || ✓ || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| id || Integer || ✓ || ✓
| A numerical mod ID used to identify the mod in other API endpoints.
|-
| latest_release || [[#Releases|Release]] || ✓ ||
| The latest version of the mod available for download. See [[#Releases]]
|-
| license_flags || Integer(11 bit) || ✓ || ✓
| A bit field describing what permissions the mod's license grants. See [[#License Flags]]
|-
| license_name || String || ✓ || ✓
| The mod's license name.
|-
| license_url || String || ✓ || ✓
| A URL link to the full license agreement. Can be any string in case of custom licenses.
|-
| media_files || [[#Media Files|Media File]][] || || ✓
| A list of media files, such as screen shots of the mod in action. See [[#Media Files]].
|-
| name || String || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓
| The Factorio username of the mod's author.
|-
| ratings_count || Integer || ✓ || ✓
| Doesn't seem to be implemented yet. Always 0.
|-
| releases || [[#Releases|Release]][] || || ✓
| A list of different versions of the mod available for download. See [[#Releases]]
|-
| summary || String || ✓ || ✓
| A shorter mod description.
|-
| tags || [[#Tags|Tag]][] || ✓ || ✓
| A list of tag objects that categorize the mod. See [[#Tags]].
|-
| title || String || ✓ || ✓
| The mod's human-readable name.
|-
| updated_at || String(ISO 8601) || ✓ || ✓
| The datetime the mod was last updated, in the full ISO 8601 format, with a space separator instead of 'T'.
|-
| visits_count || Integer || ✓ || ✓
| The number of times the mod was viewed, but perhaps only counted on the web interface???
|}

=== License Flags ===

The "license_flags" is an 11 bit number that describe generally what permissions the mod's license grants.

{| class="wikitable"
! 2<sup>n</sup> !! Title !! Description
|-
! colspan=3 | Permissions
|-
| 0 || Commercial Use || This software and derivatives may be used for commercial purposes
|-
| 1 || Modification || The software may be modified.
|-
| 2 || Distribution || You may distribute this software.
|-
| 3 || Patent Use || This license provides an express grant of patent rights from the contributor to the recipient.
|-
| 4 || Private Use || You may use and modify the software without distributing it.
|-
! colspan=3 | Conditions
|-
| 5 || Disclose Source || Source code must be made available when distributing the software.
|-
| 6 || License & Copyright Notice || Include a copy of the license and copyright notice with the code.
|-
| 7 || Same License || Modifications must be released under the same license when distributing the software. In some cases a similar or related license may be used.
|-
| 8 || State Changes || Indicate changes made to the code.
|-
! colspan=3 | Limitations
|-
| 9 || Hold Liable || Software is provided without warranty and the software author/license owner cannot be held liable for damages.
|-
| 10 || Trademark Use || This license explicitly states that it does NOT grant you trademark rights, even though licenses without such a statement probably do not grant you any implicit trademark rights.
|}

=== Tags ===

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this tag.
|-
| name || String || An all lower-case string used to identify this tag internally.
|-
| title || String || The tag's human-readable tag name.
|-
| description || String || A short description for the tag.
|-
| type || String ||
|}

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 1 || t || general || General || Mods that cannot be sorted into other categories
|-
| 2 || t || non-game-changing || Non-Game-Changing || Changes only look&feel. New graphics, new sounds, ... such things.
|-
| 3 || t || helper-mods || Helper Mods || These mods are not game-changing, but enhance the gameplay by helping you with useful functions. Mods like showing the current game-time, keep track over your resources, rail-laying...
|-
| 6 || t || big-mods || Big Mods || Too big and/or changes too much of the game to be fit anywhere else
|-
| 12 || t || transportation || Transportation || Player transport
|-
| 13 || t || logistics || Logistics || Transport of materials
|-
| 14 || t || utility || Utility || Helps with certain things the player is doing.
|-
| 15 || t || balancing || Balancing ||
|-
| 17 || t || enemies || Enemies ||
|-
| 16 || t || weapons || Weapons ||
|-
| 18 || t || armor || Armor || Armors or armor equipment related.
|-
| 19 || t || oil || Oil || Things related to oil related manufacture
|-
| 20 || t || logistics-network || Logistics Network || Related to roboports and logistic robots
|-
| 21 || t || storage || Storage ||
|-
| 22 || t || power-production || Power Production ||
|-
| 23 || t || manufacture || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints ||
|-
| 25 || t || cheats || Cheats ||
|-
| 26 || t || defense || Defense ||
|-
| 27 || t || mining || Mining ||
|-
| 28 || t || info || Info || Mods that provide additional information to the player
|-
| 29 || t || trains || Trains ||
|}

=== Media Files ===

A media file object describes a single image, along with a smaller thumbnail sized version of the image.

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this media file.
|-
| width || Integer || Width of the full sized image in pixels.
|-
| height || Integer || Height of the full sized image in pixels.
|-
| size || Integer || Size of the full image in bytes.
|-
| urls || [[#Media URLs|Media URL]] || URLs to the full sized image and a thumbnail, see below.
|}

=== Media URLs ===

{| class="wikitable"
! Key !! Type !! Description
|-
| original || String(URL) || URL to full sized image.
|-
| thumb || String(URL) || URL to 128x128px sized thumbnail of image.
|}

The original image is in either PNG, JPEG, or GIF formats, with the extensions ".png", ".jpg", or ".gif". All image URLs seem to be located at https://mods-data.factorio.com/pub_data/media_files/ with a file name consisting of 12 alphanumerical characters (of the base64 alphabet) followed by the file extension. The thumbnail URL contains the same code, but instead with a file extension of ".thumb.png".

=== Releases ===

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String ||
|-
| downloads_count || Integer ||
|-
| factorio_version || String ||
|-
| file_name || String || The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| file_size || Integer ||
|-
| game_version || String ||
|-
| id || Integer || A numerical ID unique to this release.
|-
| info_json || Object || A copy of the mod's info.json file.
|-
| released_at || String(ISO 8601) ||
|-
| version || String || The version string of this mod release. Used to determine dependencies.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| detail || String ||
|}

{{Languages}}[[Category:Technical]]

Mod portal API

2017-12-15T15:11:51Z

M16: Moar changes!!!!

{{stub}}

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

== Endpoints ==

TODO!!!

=== /api/mods ===

GET Parameters:

{| class="wikitable"
! Key !! Values !! Description
|-
| order ||updated, alpha, top||How to order the mods, by most recently updated, alphabetically, or by most downloaded.
|-
| owner ||||
|-
| page ||||
|-
| page_size ||||
|-
| q ||||
|-
| tags ||||
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

=== /api/messages ===

GET Parameters:

{| class="wikitable"
! Key !! Values !! Description
|-
| page_size ||{an integer}||How many messages on one page
|-
| page ||{an integer}||Which page of messages
|-
| mod ||{name of mod}||Name of the specific mod that you want messages for
|}

=== /api/users ===

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "Short" column, and those returned the the api/mods/{name} endpoint are marked with a check in the "Full" column.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| created_at || String(ISO 8601) || ✓ || ✓
| The datetime the mod was uploaded, in the full ISO 8601 format, with a space separator instead of 'T'.
|-
| current_user_rating || Null || ✓ || ✓
| Doesn't seem to be implemented yet. Always null.
|-
| description || String || || ✓
| A longer description of the mod, in text only format.
|-
| description_html || String(HTML) || || ✓
| A longer description of the mod, with HTML tags.
|-
| downloads_count || Integer || ✓ || ✓
| Number of downloads.
|-
| first_media_file || [[#Media Files|Media File]] || ✓ ||
| The first media file in the "media_files" list.
|-
| game_versions || String[] || ✓ || ✓
| A list of major Factorio version strings (e.g. "0.13") starting with 0.13 that the mod is compatible with, ''in addition to'' the version(s) found in "latest_release" / "releases".
|-
| github_path || String || ✓ || ✓
| A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || ✓ || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| id || Integer || ✓ || ✓
| A numerical mod ID used to identify the mod in other API endpoints.
|-
| latest_release || [[#Releases|Release]] || ✓ ||
| The latest version of the mod available for download. See [[#Releases]]
|-
| license_flags || Integer(11 bit) || ✓ || ✓
| A bit field describing what permissions the mod's license grants. See [[#License Flags]]
|-
| license_name || String || ✓ || ✓
| The mod's license name.
|-
| license_url || String || ✓ || ✓
| A URL link to the full license agreement. Can be any string in case of custom licenses.
|-
| media_files || [[#Media Files|Media File]][] || || ✓
| A list of media files, such as screen shots of the mod in action. See [[#Media Files]].
|-
| name || String || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓
| The Factorio username of the mod's author.
|-
| ratings_count || Integer || ✓ || ✓
| Doesn't seem to be implemented yet. Always 0.
|-
| releases || [[#Releases|Release]][] || || ✓
| A list of different versions of the mod available for download. See [[#Releases]]
|-
| summary || String || ✓ || ✓
| A shorter mod description.
|-
| tags || [[#Tags|Tag]][] || ✓ || ✓
| A list of tag objects that categorize the mod. See [[#Tags]].
|-
| title || String || ✓ || ✓
| The mod's human-readable name.
|-
| updated_at || String(ISO 8601) || ✓ || ✓
| The datetime the mod was last updated, in the full ISO 8601 format, with a space separator instead of 'T'.
|-
| visits_count || Integer || ✓ || ✓
| The number of times the mod was viewed, but perhaps only counted on the web interface???
|}

=== License Flags ===

The "license_flags" is an 11 bit number that describe generally what permissions the mod's license grants.

{| class="wikitable"
! 2<sup>n</sup> !! Title !! Description
|-
! colspan=3 | Permissions
|-
| 0 || Commercial Use || This software and derivatives may be used for commercial purposes
|-
| 1 || Modification || The software may be modified.
|-
| 2 || Distribution || You may distribute this software.
|-
| 3 || Patent Use || This license provides an express grant of patent rights from the contributor to the recipient.
|-
| 4 || Private Use || You may use and modify the software without distributing it.
|-
! colspan=3 | Conditions
|-
| 5 || Disclose Source || Source code must be made available when distributing the software.
|-
| 6 || License & Copyright Notice || Include a copy of the license and copyright notice with the code.
|-
| 7 || Same License || Modifications must be released under the same license when distributing the software. In some cases a similar or related license may be used.
|-
| 8 || State Changes || Indicate changes made to the code.
|-
! colspan=3 | Limitations
|-
| 9 || Hold Liable || Software is provided without warranty and the software author/license owner cannot be held liable for damages.
|-
| 10 || Trademark Use || This license explicitly states that it does NOT grant you trademark rights, even though licenses without such a statement probably do not grant you any implicit trademark rights.
|}

=== Tags ===

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this tag.
|-
| name || String || An all lower-case string used to identify this tag internally.
|-
| title || String || The tag's human-readable tag name.
|-
| description || String || A short description for the tag.
|-
| type || String ||
|}

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 1 || t || general || General || Mods that cannot be sorted into other categories
|-
| 2 || t || non-game-changing || Non-Game-Changing || Changes only look&feel. New graphics, new sounds, ... such things.
|-
| 3 || t || helper-mods || Helper Mods || These mods are not game-changing, but enhance the gameplay by helping you with useful functions. Mods like showing the current game-time, keep track over your resources, rail-laying...
|-
| 6 || t || big-mods || Big Mods || Too big and/or changes too much of the game to be fit anywhere else
|-
| 12 || t || transportation || Transportation || Player transport
|-
| 13 || t || logistics || Logistics || Transport of materials
|-
| 14 || t || utility || Utility || Helps with certain things the player is doing.
|-
| 15 || t || balancing || Balancing ||
|-
| 17 || t || enemies || Enemies ||
|-
| 16 || t || weapons || Weapons ||
|-
| 18 || t || armor || Armor || Armors or armor equipment related.
|-
| 19 || t || oil || Oil || Things related to oil related manufacture
|-
| 20 || t || logistics-network || Logistics Network || Related to roboports and logistic robots
|-
| 21 || t || storage || Storage ||
|-
| 22 || t || power-production || Power Production ||
|-
| 23 || t || manufacture || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints ||
|-
| 25 || t || cheats || Cheats ||
|-
| 26 || t || defense || Defense ||
|-
| 27 || t || mining || Mining ||
|-
| 28 || t || info || Info || Mods that provide additional information to the player
|-
| 29 || t || trains || Trains ||
|}

=== Media Files ===

A media file object describes a single image, along with a smaller thumbnail sized version of the image.

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this media file.
|-
| width || Integer || Width of the full sized image in pixels.
|-
| height || Integer || Height of the full sized image in pixels.
|-
| size || Integer || Size of the full image in bytes.
|-
| urls || [[#Media URLs|Media URL]] || URLs to the full sized image and a thumbnail, see below.
|}

=== Media URLs ===

{| class="wikitable"
! Key !! Type !! Description
|-
| original || String(URL) || URL to full sized image.
|-
| thumb || String(URL) || URL to 128x128px sized thumbnail of image.
|}

The original image is in either PNG, JPEG, or GIF formats, with the extensions ".png", ".jpg", or ".gif". All image URLs seem to be located at https://mods-data.factorio.com/pub_data/media_files/ with a file name consisting of 12 alphanumerical characters (of the base64 alphabet) followed by the file extension. The thumbnail URL contains the same code, but instead with a file extension of ".thumb.png".

=== Releases ===

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String ||
|-
| downloads_count || Integer ||
|-
| factorio_version || String ||
|-
| file_name || String || The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| file_size || Integer ||
|-
| game_version || String ||
|-
| id || Integer || A numerical ID unique to this release.
|-
| info_json || Object || A copy of the mod's info.json file.
|-
| released_at || String(ISO 8601) ||
|-
| version || String || The version string of this mod release. Used to determine dependencies.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| detail || String ||
|}

{{Languages}}[[Category:Technical]]

Mod portal API

2017-12-15T02:16:06Z

M16: /* /api/mods */ Changing table format to include options for parameters. Will change some more and add some more later

{{stub}}

The Mod Portal API is used to both browse and download all mods available on the [https://mods.factorio.com/ official Factorio mod portal]. Using the API does not require any kind of authentication or account information and can be viewed simply by following the URLs below in any web browser.

<code>https://mods.factorio.com/api/mods</code>

More detailed information about a particular mod can be obtained by retrieving the following URL, where {name} is the mod's name field in the result object.

<code>https://mods.factorio.com/api/mods/{name}</code>

== Endpoints ==

TODO!!!

=== /api/mods ===

GET Parameters:

{| class="wikitable"
! Key !! Values !! Description
|-
| order ||updated, top, mods||
|-
| owner ||||
|-
| page ||||
|-
| page_size ||||
|-
| q ||||
|-
| tags ||||
|}

Returns [[#Mod List Response]]

=== /api/mods/{mod_name} ===

=== /api/messages ===

=== /api/users ===

== JSON Object Types ==

=== Mod List Response ===

{| class="wikitable"
! Key !! Type !! Description
|-
| pagination || [[#Pagination|Pagination]] || See [[#Pagination]]
|-
| results || [[#Result Entry|Result]][] || A list of mods, matching any filters you specified.
|}

=== Pagination ===

{| class="wikitable"
! Key !! Type !! Description
|-
| count || Integer || Total number of mods that match your specified filters.
|-
| links || [[#Pagination_Links|Links]] || Utility links to mod portal api requests, preserving all filters and search queries.
|-
| page || Integer || The current page number.
|-
| page_count || Integer || The total number of pages returned.
|-
| page_size || Integer || The number of results per page.
|}

=== Pagination Links ===

{| class="wikitable"
! Key !! Type !! Description
|-
| first || String(URL) || URL to the first page of the results, or null if you're already on the first page.
|-
| prev || String(URL) || URL to the previous page of the results, or null if you're already on the first page.
|-
| next || String(URL) || URL to the next page of the results, or null if you're already on the last page.
|-
| last || String(URL) || URL to the last page of the results, or null if you're already on the last page.
|}

=== Result Entry ===

Fields returned by the api/mods endpoint are marked with a check (✓) in the "Short" column, and those returned the the api/mods/{name} endpoint are marked with a check in the "Full" column.

{| class="wikitable"
! Key !! Type !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Short !!+ style='writing-mode:vertical-lr;vertical-align:bottom;font-size:90%' | Full !! Description
|-
| created_at || String(ISO 8601) || ✓ || ✓
| The datetime the mod was uploaded, in the full ISO 8601 format, with a space separator instead of 'T'.
|-
| current_user_rating || Null || ✓ || ✓
| Doesn't seem to be implemented yet. Always null.
|-
| description || String || || ✓
| A longer description of the mod, in text only format.
|-
| description_html || String(HTML) || || ✓
| A longer description of the mod, with HTML tags.
|-
| downloads_count || Integer || ✓ || ✓
| Number of downloads.
|-
| first_media_file || [[#Media Files|Media File]] || ✓ ||
| The first media file in the "media_files" list.
|-
| game_versions || String[] || ✓ || ✓
| A list of major Factorio version strings (e.g. "0.13") starting with 0.13 that the mod is compatible with, ''in addition to'' the version(s) found in "latest_release" / "releases".
|-
| github_path || String || ✓ || ✓
| A link to the mod's github project page, just prepend "github.com/". Can be blank ("").
|-
| homepage || String || ✓ || ✓
| Usually a URL to the mod's main project page, but can be any string.
|-
| id || Integer || ✓ || ✓
| A numerical mod ID used to identify the mod in other API endpoints.
|-
| latest_release || [[#Releases|Release]] || ✓ ||
| The latest version of the mod available for download. See [[#Releases]]
|-
| license_flags || Integer(11 bit) || ✓ || ✓
| A bit field describing what permissions the mod's license grants. See [[#License Flags]]
|-
| license_name || String || ✓ || ✓
| The mod's license name.
|-
| license_url || String || ✓ || ✓
| A URL link to the full license agreement. Can be any string in case of custom licenses.
|-
| media_files || [[#Media Files|Media File]][] || || ✓
| A list of media files, such as screen shots of the mod in action. See [[#Media Files]].
|-
| name || String || ✓ || ✓
| The mod's machine-readable ID string.
|-
| owner || String || ✓ || ✓
| The Factorio username of the mod's author.
|-
| ratings_count || Integer || ✓ || ✓
| Doesn't seem to be implemented yet. Always 0.
|-
| releases || [[#Releases|Release]][] || || ✓
| A list of different versions of the mod available for download. See [[#Releases]]
|-
| summary || String || ✓ || ✓
| A shorter mod description.
|-
| tags || [[#Tags|Tag]][] || ✓ || ✓
| A list of tag objects that categorize the mod. See [[#Tags]].
|-
| title || String || ✓ || ✓
| The mod's human-readable name.
|-
| updated_at || String(ISO 8601) || ✓ || ✓
| The datetime the mod was last updated, in the full ISO 8601 format, with a space separator instead of 'T'.
|-
| visits_count || Integer || ✓ || ✓
| The number of times the mod was viewed, but perhaps only counted on the web interface???
|}

=== License Flags ===

The "license_flags" is an 11 bit number that describe generally what permissions the mod's license grants.

{| class="wikitable"
! 2<sup>n</sup> !! Title !! Description
|-
! colspan=3 | Permissions
|-
| 0 || Commercial Use || This software and derivatives may be used for commercial purposes
|-
| 1 || Modification || The software may be modified.
|-
| 2 || Distribution || You may distribute this software.
|-
| 3 || Patent Use || This license provides an express grant of patent rights from the contributor to the recipient.
|-
| 4 || Private Use || You may use and modify the software without distributing it.
|-
! colspan=3 | Conditions
|-
| 5 || Disclose Source || Source code must be made available when distributing the software.
|-
| 6 || License & Copyright Notice || Include a copy of the license and copyright notice with the code.
|-
| 7 || Same License || Modifications must be released under the same license when distributing the software. In some cases a similar or related license may be used.
|-
| 8 || State Changes || Indicate changes made to the code.
|-
! colspan=3 | Limitations
|-
| 9 || Hold Liable || Software is provided without warranty and the software author/license owner cannot be held liable for damages.
|-
| 10 || Trademark Use || This license explicitly states that it does NOT grant you trademark rights, even though licenses without such a statement probably do not grant you any implicit trademark rights.
|}

=== Tags ===

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this tag.
|-
| name || String || An all lower-case string used to identify this tag internally.
|-
| title || String || The tag's human-readable tag name.
|-
| description || String || A short description for the tag.
|-
| type || String ||
|}

Currently, there are only a fixed number of tags available, these include:

{| class="wikitable"
! id !! type !! name !! title !! description
|-
| 1 || t || general || General || Mods that cannot be sorted into other categories
|-
| 2 || t || non-game-changing || Non-Game-Changing || Changes only look&feel. New graphics, new sounds, ... such things.
|-
| 3 || t || helper-mods || Helper Mods || These mods are not game-changing, but enhance the gameplay by helping you with useful functions. Mods like showing the current game-time, keep track over your resources, rail-laying...
|-
| 6 || t || big-mods || Big Mods || Too big and/or changes too much of the game to be fit anywhere else
|-
| 12 || t || transportation || Transportation || Player transport
|-
| 13 || t || logistics || Logistics || Transport of materials
|-
| 14 || t || utility || Utility || Helps with certain things the player is doing.
|-
| 15 || t || balancing || Balancing ||
|-
| 17 || t || enemies || Enemies ||
|-
| 16 || t || weapons || Weapons ||
|-
| 18 || t || armor || Armor || Armors or armor equipment related.
|-
| 19 || t || oil || Oil || Things related to oil related manufacture
|-
| 20 || t || logistics-network || Logistics Network || Related to roboports and logistic robots
|-
| 21 || t || storage || Storage ||
|-
| 22 || t || power-production || Power Production ||
|-
| 23 || t || manufacture || Manufacture || Furnaces, assembling machines, production chains
|-
| 24 || t || blueprints || Blueprints ||
|-
| 25 || t || cheats || Cheats ||
|-
| 26 || t || defense || Defense ||
|-
| 27 || t || mining || Mining ||
|-
| 28 || t || info || Info || Mods that provide additional information to the player
|-
| 29 || t || trains || Trains ||
|}

=== Media Files ===

A media file object describes a single image, along with a smaller thumbnail sized version of the image.

{| class="wikitable"
! Key !! Type !! Description
|-
| id || Integer || A numerical ID unique to this media file.
|-
| width || Integer || Width of the full sized image in pixels.
|-
| height || Integer || Height of the full sized image in pixels.
|-
| size || Integer || Size of the full image in bytes.
|-
| urls || [[#Media URLs|Media URL]] || URLs to the full sized image and a thumbnail, see below.
|}

=== Media URLs ===

{| class="wikitable"
! Key !! Type !! Description
|-
| original || String(URL) || URL to full sized image.
|-
| thumb || String(URL) || URL to 128x128px sized thumbnail of image.
|}

The original image is in either PNG, JPEG, or GIF formats, with the extensions ".png", ".jpg", or ".gif". All image URLs seem to be located at https://mods-data.factorio.com/pub_data/media_files/ with a file name consisting of 12 alphanumerical characters (of the base64 alphabet) followed by the file extension. The thumbnail URL contains the same code, but instead with a file extension of ".thumb.png".

=== Releases ===

{| class="wikitable"
! Key !! Type !! Description
|-
| download_url || String ||
|-
| downloads_count || Integer ||
|-
| factorio_version || String ||
|-
| file_name || String || The file name of the release. Always seems to follow the pattern "{name}_{version}.zip"
|-
| file_size || Integer ||
|-
| game_version || String ||
|-
| id || Integer || A numerical ID unique to this release.
|-
| info_json || Object || A copy of the mod's info.json file.
|-
| released_at || String(ISO 8601) ||
|-
| version || String || The version string of this mod release. Used to determine dependencies.
|}

=== Error ===

{| class="wikitable"
! Key !! Type !! Description
|-
| detail || String ||
|}

{{Languages}}[[Category:Technical]]

Main Page/Latest versions

2017-12-14T14:40:49Z

M16: Many bugs were squashed here (new experimental version)

* [[File:Steel-bar_darker.png|link=]] {{Translation|Latest stable version}}: [[Version_history/0.15.0#0.15.40|0.15.40]]
* [[File:Science pack 1.png|link=]] {{Translation|Latest experimental version}}: [https://forums.factorio.com/54754 0.16.2]
* [[File:Speed module 3.png|link=]] {{Translation|The wiki is based on version}} [[Version history/0.16.0|0.16]]
----

* [[File:Blueprint book.png|link=]] [[Roadmap/Coming_Releases{{If language suffix}}|{{Translation|Planned releases}}]]
** [[File:Blueprint.png|link=]] [[Upcoming_features{{If language suffix}}|{{Translation|Planned features}}]]
<noinclude>
{{C|Main}}
</noinclude>

Main Page/Latest versions

2017-11-30T13:57:15Z

M16: New experimental version

* [[File:Steel-bar_darker.png|link=]] {{Translation|Latest stable version}}: [[Version_history/0.15.0#0.15.37|0.15.37]]
* [[File:Space science pack.png|link=]] {{Translation|Latest experimental version}}: [https://forums.factorio.com/54307 0.15.40]
* [[File:Speed module 3.png|link=]] {{Translation|The wiki is based on version}} [[Version history/0.15.0|0.15]]
----

* [[File:Blueprint book.png|link=]] [[Roadmap/Coming_Releases{{If language suffix}}|{{Translation|Planned releases}}]]
** [[File:Blueprint.png|link=]] [[Upcoming_features{{If language suffix}}|{{Translation|Planned features}}]]
<noinclude>
{{C|Main}}
</noinclude>

Raw fish

2017-05-03T13:41:18Z

M16: Includes .15 Info

{{Languages}}
{{:Raw fish/infobox}}
'''Raw fish''' can be harvested from water. Since alpha version 0.7 they can be used to refill a small amount of health instantly. In order to catch raw fish, look at a body of water and see if you see moving dark spots, then mine them the same way you would do with ore. To use the fish, just pick it up out of your inventory and eat it by clicking your left mouse button by default.

As of 0.15, each dark spot is a school of fish, which drops 5 raw fish when mined.

== Achievements ==
{{Main|Achievements}}
Raw fish is directly connected to the following achievement:
{{spoiler|button-text=Spoiler!|message = So long and thanks for all the fish — Send a raw fish into space via rocket.}}

{{IntermediateNav}}