Official Factorio Wiki - User contributions [en]

Types/Sprite

2019-12-10T06:31:30Z

Muink: /* blend_mode */

== Basics ==
Specifies one picture that can be used in the game.

When there is more than one sprite or [[Types/Animation|animation]] frame with the same source file and dimensions/position in the game, they all share the same memory.
== Mandatory properties ==

=== filename ===
'''Type''': [[Types/FileName]]

'''Default''': ""

Technically optional, but path to sprite cannot be empty.

== Optional properties ==

=== layers ===
'''Type''': [[Types/table]] of [[Types/Sprite]]

If this property is present, all Sprite definitions have to be placed as entries in the array, and they will all be loaded from there. Each item (Sprite definition) in the array may also have the <code>layers</code> property.

If this property is present, all other properties are ignored and the mandatory properties do not have to be defined.

=== hr_version ===
'''Type''': [[Types/Sprite]]

If this property exists and high resolution sprites are turned on, its contents are used to load the sprite.

=== slice ===
'''Type''': [[Types/SpriteSizeType]]

Number of slices this is sliced into when using the "optimized atlas packing" option. If you are a modder, you can just ignore this property.

Example: If this is 4, the sprite will be sliced into a 4×4 grid.

=== slice_x ===
'''Type''': [[Types/SpriteSizeType]]

Same as <code>slice</code> above, but this specifies only how many slices there are on the x axis.

=== slice_y ===
'''Type''': [[Types/SpriteSizeType]]

Same as <code>slice</code> above, but this specifies only how many slices there are on the y axis.

=== priority ===
'''Type''': [[Types/string]]

'''Default''': "medium"

Possible values:
* "extra-high-no-scale"
* "extra-high"
* "high"
* "medium"
* "low"
* "very-low"

=== flags ===
'''Type''': [[Types/SpriteFlags]]

=== size ===
'''Type''': [[Types/SpriteSizeType]] or [[Types/table]] of [[Types/SpriteSizeType]]

The width and height of the sprite. If this is an array, the first member of the array is the width and the second is the height. Otherwise the size is both width and height.

Width and height may only be in the range of 0-8192.

=== width ===
'''Type''': [[Types/SpriteSizeType]]

Mandatory if <code>size</code> is not given. Width of the picture in pixels, from 0-8192.

=== height ===
'''Type''': [[Types/SpriteSizeType]]

Mandatory if <code>size</code> is not given. Height of the picture in pixels, from 0-8192.

=== x ===
'''Type''': [[Types/SpriteSizeType]]

'''Default''': 0

Horizontal position of the sprite in the source file in pixels.

=== y ===
'''Type''': [[Types/SpriteSizeType]]

'''Default''': 0

Vertical position of the sprite in the source file in pixels.

=== position ===
'''Type''': [[Types/table]] of [[Types/SpriteSizeType]]

Loaded only when <code>x</code> and <code>y</code> are both 0. The first member of the array is x and the second is y.

=== shift ===
'''Type''': [[Types/vector]]

'''Default''': {0, 0}

In tiles. util.by_pixel() can be used to divide the shift by 32 which is the usual pixel height/width of 1 tile in normal resolution. Note that 32 pixel tile height/width is not enforced anywhere - any other tile height or width is also possible.

=== scale ===
'''Type''': [[Types/double]]

'''Default''': 1

Values different than 1 specify the scale of the sprite on default zoom.
Scale 2 means that the picture will be 2 times bigger on screen (and more pixelated).

=== draw_as_shadow ===
'''Type''': [[Types/bool]]

'''Default''': false

=== mipmap_count ===
'''Type''': [[Types/uint8]]

'''Default''': 0

Only loaded if this is an icon (has flag "icon").

=== apply_runtime_tint ===
'''Type''': [[Types/bool]]

'''Default''': false

=== tint ===
'''Type''': [[Types/Color]]

'''Default''': {r=1, g=1, b=1, a=1} (white)

=== blend_mode ===
'''Type''': [[Types/string]]

'''Default''': "normal"

Possible values:
* "normal" ''-- Result = Active_RGB * Active_Alpha + Background_RGB * ( 1 - Active_Alpha )''
* "additive" ''-- Result = Active_RGB + Background_RGB''
* "additive-soft" ''-- Result = Active_RGB * ( 1 - Background_RGB ) + Background_RGB''
* "multiplicative" ''-- Result = Active_RGB * Background_RGB''
* "overwrite" ''-- Result = Active_RGBA or Background_RGBA''

=== load_in_minimal_mode ===
'''Type''': [[Types/bool]]

'''Default''': false

Minimal mode is entered when mod loading fails. You are in it when you see the gray box after (part of) the loading screen that tells you a mod error ([https://cdn.discordapp.com/attachments/340530709712076801/532315796626472972/unknown.png Example]). If you are a modder, you can just ignore this property.

=== premul_alpha ===
'''Type''': [[Types/bool]]

'''Default''': true

Whether alpha should be premultiplied.

=== generate_sdf ===
'''Type''': [[Types/bool]]

'''Default''': false

== Example ==
<syntaxhighlight lang="lua">picture =
{
filename = "__base__/graphics/entity/basic-accumulator/basic-accumulator.png",
priority = "extra-high",
width = 124,
height = 103,
shift = {0.7, -0.2}
}</syntaxhighlight>

{{Prototype property type usage|{{FULLPAGENAME}}?Sprite]}}

Types/Sprite

2019-12-10T06:29:38Z

Muink: /* blend_mode */

== Basics ==
Specifies one picture that can be used in the game.

When there is more than one sprite or [[Types/Animation|animation]] frame with the same source file and dimensions/position in the game, they all share the same memory.
== Mandatory properties ==

=== filename ===
'''Type''': [[Types/FileName]]

'''Default''': ""

Technically optional, but path to sprite cannot be empty.

== Optional properties ==

=== layers ===
'''Type''': [[Types/table]] of [[Types/Sprite]]

If this property is present, all Sprite definitions have to be placed as entries in the array, and they will all be loaded from there. Each item (Sprite definition) in the array may also have the <code>layers</code> property.

If this property is present, all other properties are ignored and the mandatory properties do not have to be defined.

=== hr_version ===
'''Type''': [[Types/Sprite]]

If this property exists and high resolution sprites are turned on, its contents are used to load the sprite.

=== slice ===
'''Type''': [[Types/SpriteSizeType]]

Number of slices this is sliced into when using the "optimized atlas packing" option. If you are a modder, you can just ignore this property.

Example: If this is 4, the sprite will be sliced into a 4×4 grid.

=== slice_x ===
'''Type''': [[Types/SpriteSizeType]]

Same as <code>slice</code> above, but this specifies only how many slices there are on the x axis.

=== slice_y ===
'''Type''': [[Types/SpriteSizeType]]

Same as <code>slice</code> above, but this specifies only how many slices there are on the y axis.

=== priority ===
'''Type''': [[Types/string]]

'''Default''': "medium"

Possible values:
* "extra-high-no-scale"
* "extra-high"
* "high"
* "medium"
* "low"
* "very-low"

=== flags ===
'''Type''': [[Types/SpriteFlags]]

=== size ===
'''Type''': [[Types/SpriteSizeType]] or [[Types/table]] of [[Types/SpriteSizeType]]

The width and height of the sprite. If this is an array, the first member of the array is the width and the second is the height. Otherwise the size is both width and height.

Width and height may only be in the range of 0-8192.

=== width ===
'''Type''': [[Types/SpriteSizeType]]

Mandatory if <code>size</code> is not given. Width of the picture in pixels, from 0-8192.

=== height ===
'''Type''': [[Types/SpriteSizeType]]

Mandatory if <code>size</code> is not given. Height of the picture in pixels, from 0-8192.

=== x ===
'''Type''': [[Types/SpriteSizeType]]

'''Default''': 0

Horizontal position of the sprite in the source file in pixels.

=== y ===
'''Type''': [[Types/SpriteSizeType]]

'''Default''': 0

Vertical position of the sprite in the source file in pixels.

=== position ===
'''Type''': [[Types/table]] of [[Types/SpriteSizeType]]

Loaded only when <code>x</code> and <code>y</code> are both 0. The first member of the array is x and the second is y.

=== shift ===
'''Type''': [[Types/vector]]

'''Default''': {0, 0}

In tiles. util.by_pixel() can be used to divide the shift by 32 which is the usual pixel height/width of 1 tile in normal resolution. Note that 32 pixel tile height/width is not enforced anywhere - any other tile height or width is also possible.

=== scale ===
'''Type''': [[Types/double]]

'''Default''': 1

Values different than 1 specify the scale of the sprite on default zoom.
Scale 2 means that the picture will be 2 times bigger on screen (and more pixelated).

=== draw_as_shadow ===
'''Type''': [[Types/bool]]

'''Default''': false

=== mipmap_count ===
'''Type''': [[Types/uint8]]

'''Default''': 0

Only loaded if this is an icon (has flag "icon").

=== apply_runtime_tint ===
'''Type''': [[Types/bool]]

'''Default''': false

=== tint ===
'''Type''': [[Types/Color]]

'''Default''': {r=1, g=1, b=1, a=1} (white)

=== blend_mode ===
'''Type''': [[Types/string]]

'''Default''': "normal"

Possible values:
* "normal" ''Result = Active_RGB * Active_Alpha + Background_RGB * ( 1 - Active_Alpha )''
* "additive" ''Result = Active_RGB + Background_RGB''
* "additive-soft" ''Result = Active_RGB * ( 1 - Background_RGB ) + Background_RGB''
* "multiplicative" ''Result = Active_RGB * Background_RGB''
* "overwrite" ''Result = Active_RGBA or Background_RGBA''

=== load_in_minimal_mode ===
'''Type''': [[Types/bool]]

'''Default''': false

Minimal mode is entered when mod loading fails. You are in it when you see the gray box after (part of) the loading screen that tells you a mod error ([https://cdn.discordapp.com/attachments/340530709712076801/532315796626472972/unknown.png Example]). If you are a modder, you can just ignore this property.

=== premul_alpha ===
'''Type''': [[Types/bool]]

'''Default''': true

Whether alpha should be premultiplied.

=== generate_sdf ===
'''Type''': [[Types/bool]]

'''Default''': false

== Example ==
<syntaxhighlight lang="lua">picture =
{
filename = "__base__/graphics/entity/basic-accumulator/basic-accumulator.png",
priority = "extra-high",
width = 124,
height = 103,
shift = {0.7, -0.2}
}</syntaxhighlight>

{{Prototype property type usage|{{FULLPAGENAME}}?Sprite]}}

Types/Sprite

2019-12-10T06:26:35Z

Muink: /* blend_mode */

== Basics ==
Specifies one picture that can be used in the game.

When there is more than one sprite or [[Types/Animation|animation]] frame with the same source file and dimensions/position in the game, they all share the same memory.
== Mandatory properties ==

=== filename ===
'''Type''': [[Types/FileName]]

'''Default''': ""

Technically optional, but path to sprite cannot be empty.

== Optional properties ==

=== layers ===
'''Type''': [[Types/table]] of [[Types/Sprite]]

If this property is present, all Sprite definitions have to be placed as entries in the array, and they will all be loaded from there. Each item (Sprite definition) in the array may also have the <code>layers</code> property.

If this property is present, all other properties are ignored and the mandatory properties do not have to be defined.

=== hr_version ===
'''Type''': [[Types/Sprite]]

If this property exists and high resolution sprites are turned on, its contents are used to load the sprite.

=== slice ===
'''Type''': [[Types/SpriteSizeType]]

Number of slices this is sliced into when using the "optimized atlas packing" option. If you are a modder, you can just ignore this property.

Example: If this is 4, the sprite will be sliced into a 4×4 grid.

=== slice_x ===
'''Type''': [[Types/SpriteSizeType]]

Same as <code>slice</code> above, but this specifies only how many slices there are on the x axis.

=== slice_y ===
'''Type''': [[Types/SpriteSizeType]]

Same as <code>slice</code> above, but this specifies only how many slices there are on the y axis.

=== priority ===
'''Type''': [[Types/string]]

'''Default''': "medium"

Possible values:
* "extra-high-no-scale"
* "extra-high"
* "high"
* "medium"
* "low"
* "very-low"

=== flags ===
'''Type''': [[Types/SpriteFlags]]

=== size ===
'''Type''': [[Types/SpriteSizeType]] or [[Types/table]] of [[Types/SpriteSizeType]]

The width and height of the sprite. If this is an array, the first member of the array is the width and the second is the height. Otherwise the size is both width and height.

Width and height may only be in the range of 0-8192.

=== width ===
'''Type''': [[Types/SpriteSizeType]]

Mandatory if <code>size</code> is not given. Width of the picture in pixels, from 0-8192.

=== height ===
'''Type''': [[Types/SpriteSizeType]]

Mandatory if <code>size</code> is not given. Height of the picture in pixels, from 0-8192.

=== x ===
'''Type''': [[Types/SpriteSizeType]]

'''Default''': 0

Horizontal position of the sprite in the source file in pixels.

=== y ===
'''Type''': [[Types/SpriteSizeType]]

'''Default''': 0

Vertical position of the sprite in the source file in pixels.

=== position ===
'''Type''': [[Types/table]] of [[Types/SpriteSizeType]]

Loaded only when <code>x</code> and <code>y</code> are both 0. The first member of the array is x and the second is y.

=== shift ===
'''Type''': [[Types/vector]]

'''Default''': {0, 0}

In tiles. util.by_pixel() can be used to divide the shift by 32 which is the usual pixel height/width of 1 tile in normal resolution. Note that 32 pixel tile height/width is not enforced anywhere - any other tile height or width is also possible.

=== scale ===
'''Type''': [[Types/double]]

'''Default''': 1

Values different than 1 specify the scale of the sprite on default zoom.
Scale 2 means that the picture will be 2 times bigger on screen (and more pixelated).

=== draw_as_shadow ===
'''Type''': [[Types/bool]]

'''Default''': false

=== mipmap_count ===
'''Type''': [[Types/uint8]]

'''Default''': 0

Only loaded if this is an icon (has flag "icon").

=== apply_runtime_tint ===
'''Type''': [[Types/bool]]

'''Default''': false

=== tint ===
'''Type''': [[Types/Color]]

'''Default''': {r=1, g=1, b=1, a=1} (white)

=== blend_mode ===
'''Type''': [[Types/string]]

'''Default''': "normal"

Possible values:
* "normal" Result = Active_RGB * Active_Alpha + Background_RGB * ( 1 - Active_Alpha )
* "additive" Result = Active_RGB + Background_RGB
* "additive-soft" Result = Active_RGB * ( 1 - Background_RGB ) + Background_RGB
* "multiplicative" Result = Active_RGB * Background_RGB
* "overwrite" Result = Active_RGBA or Background_RGBA

=== load_in_minimal_mode ===
'''Type''': [[Types/bool]]

'''Default''': false

Minimal mode is entered when mod loading fails. You are in it when you see the gray box after (part of) the loading screen that tells you a mod error ([https://cdn.discordapp.com/attachments/340530709712076801/532315796626472972/unknown.png Example]). If you are a modder, you can just ignore this property.

=== premul_alpha ===
'''Type''': [[Types/bool]]

'''Default''': true

Whether alpha should be premultiplied.

=== generate_sdf ===
'''Type''': [[Types/bool]]

'''Default''': false

== Example ==
<syntaxhighlight lang="lua">picture =
{
filename = "__base__/graphics/entity/basic-accumulator/basic-accumulator.png",
priority = "extra-high",
width = 124,
height = 103,
shift = {0.7, -0.2}
}</syntaxhighlight>

{{Prototype property type usage|{{FULLPAGENAME}}?Sprite]}}

Modding/zh

2018-11-08T11:31:39Z

Muink:

{{Languages}}
本页面将会带领您了解如何下载和安装mod，并且为方便您创建一个mod时所需而提供了一个和mod开发相关的概述。有关更详细的mod开发说明，您可以查看[[Tutorial:Modding_tutorial| mod开发教程]].如果您正在查找mod开发所需的相关API，请前往[http://lua-api.factorio.com/latest/ 官方 Factorio Lua API 文档]（注意，该文档为英文）查看。如果您希望知道在哪里安装zip格式的mod，请查看[[Application_directory|应用程序目录]]。

== Mod 下载 & 安装 ==

您可以在以下链接下载MOD:

* [https://mods.factorio.com/ Mod门户站 (网页版)]
* Mod门户站 (游戏内)
* [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛Mod板块]

=== Mod门户站 (网页版) ===

Factorio的开发者创建论坛版块 [https://mods.factorio.com/ mod门户站 (网页版)] 使玩家可以分享各自制作的mod。注意，从论坛下载的mod是zip格式，为了安装mod你需要将zip文件复制到 [[Application_directory#User_Data_directory|user data directory]] 并且不需要解压缩它。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod门户站 (游戏内) ===

在网页 [https://mods.factorio.com/ mod门户站 (网页版)] 上的mod你可以在游戏内主菜单的mod下载页面查看。游戏内置的mod下载与网页下载的不同主要在于它可以自动的下载与安装，并且可以随时启用和停用mod（网页版下载的也可以随时启用和停用！）。

=== 论坛Mod板块 ===

某些mod制作者将他们的mod上传到官方论坛子板块[https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛Mod板块]来展示而没有提交至mod门户站，或者
想在更新发布之前获取交流反馈。这类mod被作为附件上传。有时，你从论坛下载的mod同样使用了zip格式，你仅仅需要将它复制到[[Application_directory#User_Data_directory|user data directory]]就表示安装完成了，不需要解压缩。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod依赖 ===

大多数的mod使用了factorio的base mod（包含全部官方内容的mod）。然而有些mod也可能会必须依赖于其他mod或者在其他可选依赖的mod安装之后可以提供额外功能。

==== 必须依赖 ====

当你安装一个mod时，它必须依赖于某个另外的mod才能工作，这种mod就被叫做必须依赖。

==== 可选依赖 ====

当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。

==== 注意 ====

当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。

== 开始开发一款mod ==

大纲在这里 [[Mods| Mod列表]] 和 [http://www.factorioforums.com/forum/index.php Factorio forum].

从这里开始学习会让你感到很轻松 [http://www.factorioforums.com/forum/viewforum.php?f=25 modding-Help-Board].这个社区总是有很多基佬回答具体问题。往往只要等待几分钟就有回复。或者你可以试试 [[Modding FAQ]] 页面.

=== 授权信息 ===

随着v0.11版本的到来所有mod需要有一个作者声明。如果一个MOD没有作者声明，将被视为同意开源MOD代码，与所有玩家共享：[http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)].

附录
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 this forum article].
:作者也在文中指出, 仅仅能使用 base-mod (特指Factorio中的这一部分) 来创建新的MOD, 但是不能用来 "在异星工厂游戏之外开发新的软件".
* http://www.factorio.com/terms-of-service

=== 从游戏存档（地图）中创建一个方案(scenario) ===

一个常常被提及的问题是如何从一个地图创建一个方案(scenario)(也可以通过地图编辑器创建一个方案)：
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio can convert them] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 see also this post]):
./bin/prod/factorio --map2scenario mapfoo

=== 用地图编辑器创建一个方案(scenarios) ===

自然，第一步也是用地图编辑器创建地图. 保存的地图将视为“方案(scenario)”，存储在专属的文件系统之中。可以通过这个文件去体会它的作用。或者你可以浏览这个页面：

=== 概述 ===

* [http://lua-api.factorio.com/latest/ official factorio lua API documentation]

Modding/zh

2018-11-08T11:21:45Z

Muink:

{{Languages}}
本页面将会带领您了解如何下载和安装mod，并且为方便您创建一个mod时所需而提供了一个和mod开发相关的概述。有关更详细的mod开发说明，您可以查看[[Tutorial:Modding_tutorial| mod开发教程]].如果您正在查找mod开发所需的相关API，请前往[http://lua-api.factorio.com/latest/ 官方 Factorio Lua API 文档]（注意，该文档为英文）查看。如果您希望知道在哪里安装zip格式的mod，请查看[[Application_directory|应用程序目录]]。

== Mod 下载 & 安装 ==

您可以在以下链接下载MOD:

* [https://mods.factorio.com/ Mod门户站 (网页版)]
* Mod门户站 (游戏内)
* [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛Mod板块]

=== Mod门户站 (网页版) ===

Factorio的开发者创建论坛版块 [https://mods.factorio.com/ mod门户站 (网页版)] 使玩家可以分享各自制作的mod。注意，从论坛下载的mod是zip格式，为了安装mod你需要将zip文件复制到 [[Application_directory#User_Data_directory|user data directory]] 并且不需要解压缩它。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod门户站 (游戏内) ===

在网页 [https://mods.factorio.com/ mod门户站 (网页版)] 上的mod你可以在游戏内主菜单的mod下载页面查看。游戏内置的mod下载与网页下载的不同主要在于它可以自动的下载与安装，并且可以随时启用和停用mod（网页版下载的也可以随时启用和停用！）。

=== 论坛Mod板块 ===

某些mod制作者将他们的mod上传到官方论坛子板块[https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛Mod板块]来展示而没有提交至mod门户站，或者
想在更新发布之前获取交流反馈。这类mod被作为附件上传。有时，你从论坛下载的mod同样使用了zip格式，你仅仅需要将它复制到[[Application_directory#User_Data_directory|user data directory]]就表示安装完成了，不需要解压缩。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod依赖 ===

大多数的mod使用了factorio的base mod（包含全部官方内容的mod）。然而有些mod也可能会必须依赖于其他mod或者在其他可选依赖的mod安装之后可以提供额外功能。

==== 必须依赖 ====

当你安装一个mod时，它必须依赖于某个另外的mod才能工作，这种mod就被叫做必须依赖。

==== 可选依赖 ====

当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。

==== 注意 ====

当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。

== 开始工作 ==

大纲在这里 [[Mods| Mod列表]] 和 [http://www.factorioforums.com/forum/index.php Factorio forum].

从这里开始学习会让你感到很轻松 [http://www.factorioforums.com/forum/viewforum.php?f=25 modding-Help-Board].这个社区总是有很多基佬回答具体问题。往往只要等待几分钟就有回复。或者你可以试试 [[Modding FAQ]] 页面.

== 授权信息 ==

随着v0.11版本的到来所有mod需要有一个作者声明。如果一个MOD没有作者声明，将被视为同意开源MOD代码，与所有玩家共享：[http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)].

附录
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 this forum article].
:作者也在文中指出, 仅仅能使用 base-mod (特指Factorio中的这一部分) 来创建新的MOD, 但是不能用来 "在异星工厂游戏之外开发新的软件".
* http://www.factorio.com/terms-of-service

== 从游戏存档（地图）中创建一个方案(scenario) ==

一个常常被提及的问题是如何从一个地图创建一个方案(scenario)(也可以通过地图编辑器创建一个方案)：
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio can convert them] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 see also this post]):
./bin/prod/factorio --map2scenario mapfoo

== 用地图编辑器创建一个方案(scenarios) ==

自然，第一步也是用地图编辑器创建地图. 保存的地图将视为“方案(scenario)”，存储在专属的文件系统之中。可以通过这个文件去体会它的作用。或者你可以浏览这个页面：

== 概述 ==

* [http://lua-api.factorio.com/latest/ official factorio lua API documentation]

Modding/zh

2018-11-08T11:15:17Z

Muink: /* Mod 下载 & 安装 */

{{Languages}}
本页面将会带领您了解如何下载和安装mod，并且为方便您创建一个mod时所需而提供了一个和mod开发相关的概述。有关更详细的mod开发说明，您可以查看[[Tutorial:Modding_tutorial| mod开发教程]].如果您正在查找mod开发所需的相关API，请前往[http://lua-api.factorio.com/latest/ 官方 Factorio Lua API 文档]（注意，该文档为英文）查看。如果您希望知道在哪里安装zip格式的mod，请查看[[Application_directory|应用程序目录]]。

== Mod 下载 & 安装 ==

您可以在以下链接下载MOD:

* [https://mods.factorio.com/ Mod门户站 (网页版)]
* Mod门户站 (游戏内)
* [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛mod板块]

=== Mod portal (website) ===

Factorio的开发者创建论坛版块 [https://mods.factorio.com/ mod portal (website)] 使玩家可以分享各自制作的mod。注意，从论坛下载的mod是zip格式，为了安装mod你需要将zip文件复制到 [[Application_directory#User_Data_directory|user data directory]] 并且不需要解压缩它。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod portal (in-game) ===

在网页 [https://mods.factorio.com/ mod portal (website)] 上的mod你可以在游戏内主菜单的mod下载页面查看。游戏内置的mod下载与网页下载的不同主要在于它可以自动的下载与安装，并且可以随时启用和停用mod（网页版下载的也可以随时启用和停用！）。

=== Mod subforum ===

某些mod制作者将他们的mod上传到官方论坛子板块[https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b mod subforum]来展示而没有提交至mod portal，或者
想在更新发布之前获取交流反馈。这类mod被作为附件上传。有时，你从论坛下载的mod同样使用了zip格式，你仅仅需要将它复制到[[Application_directory#User_Data_directory|user data directory]]就表示安装完成了，不需要解压缩。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod依赖 ===

大多数的mod使用了factorio的base mod（包含全部官方内容的mod）。然而有些mod也可能会必须依赖于其他mod或者在其他可选依赖的mod安装之后可以提供额外功能。

==== 必须依赖 ====

当你安装一个mod时，它必须依赖于某个另外的mod才能工作，这种mod就被叫做必须依赖。

==== 可选依赖 ====

当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。

==== 注意 ====

当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。

== 开始工作 ==

大纲在这里 [[Mods| Mod列表]] 和 [http://www.factorioforums.com/forum/index.php Factorio forum].

从这里开始学习会让你感到很轻松 [http://www.factorioforums.com/forum/viewforum.php?f=25 modding-Help-Board].这个社区总是有很多基佬回答具体问题。往往只要等待几分钟就有回复。或者你可以试试 [[Modding FAQ]] 页面.

== 授权信息 ==

随着v0.11版本的到来所有mod需要有一个作者声明。如果一个MOD没有作者声明，将被视为同意开源MOD代码，与所有玩家共享：[http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)].

附录
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 this forum article].
:作者也在文中指出, 仅仅能使用 base-mod (特指Factorio中的这一部分) 来创建新的MOD, 但是不能用来 "在异星工厂游戏之外开发新的软件".
* http://www.factorio.com/terms-of-service

== 从游戏存档（地图）中创建一个方案(scenario) ==

一个常常被提及的问题是如何从一个地图创建一个方案(scenario)(也可以通过地图编辑器创建一个方案)：
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio can convert them] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 see also this post]):
./bin/prod/factorio --map2scenario mapfoo

== 用地图编辑器创建一个方案(scenarios) ==

自然，第一步也是用地图编辑器创建地图. 保存的地图将视为“方案(scenario)”，存储在专属的文件系统之中。可以通过这个文件去体会它的作用。或者你可以浏览这个页面：

== 概述 ==

* [http://lua-api.factorio.com/latest/ official factorio lua API documentation]

Modding/zh

2018-11-08T11:12:49Z

Muink:

{{Languages}}
本页面将会带领您了解如何下载和安装mod，并且为方便您创建一个mod时所需而提供了一个和mod开发相关的概述。有关更详细的mod开发说明，您可以查看[[Tutorial:Modding_tutorial| mod开发教程]].如果您正在查找mod开发所需的相关API，请前往[http://lua-api.factorio.com/latest/ 官方 Factorio Lua API 文档]（注意，该文档为英文）查看。如果您希望知道在哪里安装zip格式的mod，请查看[[Application_directory|应用程序目录]]。

== Mod 下载 & 安装 ==

您可以在以下链接下载MOD:

* [https://mods.factorio.com/ Mod portal (网页)]
* Mod portal (游戏内)
* [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛mod板块]

=== Mod portal (website) ===

Factorio的开发者创建论坛版块 [https://mods.factorio.com/ mod portal (website)] 使玩家可以分享各自制作的mod。注意，从论坛下载的mod是zip格式，为了安装mod你需要将zip文件复制到 [[Application_directory#User_Data_directory|user data directory]] 并且不需要解压缩它。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod portal (in-game) ===

在网页 [https://mods.factorio.com/ mod portal (website)] 上的mod你可以在游戏内主菜单的mod下载页面查看。游戏内置的mod下载与网页下载的不同主要在于它可以自动的下载与安装，并且可以随时启用和停用mod（网页版下载的也可以随时启用和停用！）。

=== Mod subforum ===

某些mod制作者将他们的mod上传到官方论坛子板块[https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b mod subforum]来展示而没有提交至mod portal，或者
想在更新发布之前获取交流反馈。这类mod被作为附件上传。有时，你从论坛下载的mod同样使用了zip格式，你仅仅需要将它复制到[[Application_directory#User_Data_directory|user data directory]]就表示安装完成了，不需要解压缩。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod依赖 ===

大多数的mod使用了factorio的base mod（包含全部官方内容的mod）。然而有些mod也可能会必须依赖于其他mod或者在其他可选依赖的mod安装之后可以提供额外功能。

==== 必须依赖 ====

当你安装一个mod时，它必须依赖于某个另外的mod才能工作，这种mod就被叫做必须依赖。

==== 可选依赖 ====

当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。

==== 注意 ====

当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。

== 开始工作 ==

大纲在这里 [[Mods| Mod列表]] 和 [http://www.factorioforums.com/forum/index.php Factorio forum].

从这里开始学习会让你感到很轻松 [http://www.factorioforums.com/forum/viewforum.php?f=25 modding-Help-Board].这个社区总是有很多基佬回答具体问题。往往只要等待几分钟就有回复。或者你可以试试 [[Modding FAQ]] 页面.

== 授权信息 ==

随着v0.11版本的到来所有mod需要有一个作者声明。如果一个MOD没有作者声明，将被视为同意开源MOD代码，与所有玩家共享：[http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)].

附录
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 this forum article].
:作者也在文中指出, 仅仅能使用 base-mod (特指Factorio中的这一部分) 来创建新的MOD, 但是不能用来 "在异星工厂游戏之外开发新的软件".
* http://www.factorio.com/terms-of-service

== 从游戏存档（地图）中创建一个方案(scenario) ==

一个常常被提及的问题是如何从一个地图创建一个方案(scenario)(也可以通过地图编辑器创建一个方案)：
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio can convert them] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 see also this post]):
./bin/prod/factorio --map2scenario mapfoo

== 用地图编辑器创建一个方案(scenarios) ==

自然，第一步也是用地图编辑器创建地图. 保存的地图将视为“方案(scenario)”，存储在专属的文件系统之中。可以通过这个文件去体会它的作用。或者你可以浏览这个页面：

== 概述 ==

* [http://lua-api.factorio.com/latest/ official factorio lua API documentation]

Modding/zh

2018-11-08T11:08:58Z

Muink:

{{Languages}}
本页面将会带领您了解如何下载和安装mod，并且为方便您创建一个mod时所需而提供了一个和mod制作相关的概述。有关更详细的mod制作说明，您可以查看[[Tutorial:Modding_tutorial| mod制作教程]].如果您正在查找mod制作相关API，请前往该链接[http://lua-api.factorio.com/latest/ 官方 Factorio Lua API 文档]（注意，该文档为英文）。如果您希望如何安装zip格式的mod，请查看[[Application_directory|应用程序目录]]。

== Mod 下载 & 安装 ==

您可以在以下链接下载MOD:

* [https://mods.factorio.com/ Mod portal (网页)]
* Mod portal (游戏内)
* [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b 论坛mod板块]

=== Mod portal (website) ===

Factorio的开发者创建论坛版块 [https://mods.factorio.com/ mod portal (website)] 使玩家可以分享各自制作的mod。注意，从论坛下载的mod是zip格式，为了安装mod你需要将zip文件复制到 [[Application_directory#User_Data_directory|user data directory]] 并且不需要解压缩它。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod portal (in-game) ===

在网页 [https://mods.factorio.com/ mod portal (website)] 上的mod你可以在游戏内主菜单的mod下载页面查看。游戏内置的mod下载与网页下载的不同主要在于它可以自动的下载与安装，并且可以随时启用和停用mod（网页版下载的也可以随时启用和停用！）。

=== Mod subforum ===

某些mod制作者将他们的mod上传到官方论坛子板块[https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b mod subforum]来展示而没有提交至mod portal，或者
想在更新发布之前获取交流反馈。这类mod被作为附件上传。有时，你从论坛下载的mod同样使用了zip格式，你仅仅需要将它复制到[[Application_directory#User_Data_directory|user data directory]]就表示安装完成了，不需要解压缩。你可以在游戏主菜单查看mod列表中是否存在该mod来检查你是否正确安装该mod。

=== Mod依赖 ===

大多数的mod使用了factorio的base mod（包含全部官方内容的mod）。然而有些mod也可能会必须依赖于其他mod或者在其他可选依赖的mod安装之后可以提供额外功能。

==== 必须依赖 ====

当你安装一个mod时，它必须依赖于某个另外的mod才能工作，这种mod就被叫做必须依赖。

==== 可选依赖 ====

当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。

==== 注意 ====

当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。

== 开始工作 ==

大纲在这里 [[Mods| Mod列表]] 和 [http://www.factorioforums.com/forum/index.php Factorio forum].

从这里开始学习会让你感到很轻松 [http://www.factorioforums.com/forum/viewforum.php?f=25 modding-Help-Board].这个社区总是有很多基佬回答具体问题。往往只要等待几分钟就有回复。或者你可以试试 [[Modding FAQ]] 页面.

== 授权信息 ==

随着v0.11版本的到来所有mod需要有一个作者声明。如果一个MOD没有作者声明，将被视为同意开源MOD代码，与所有玩家共享：[http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)].

附录
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 this forum article].
:作者也在文中指出, 仅仅能使用 base-mod (特指Factorio中的这一部分) 来创建新的MOD, 但是不能用来 "在异星工厂游戏之外开发新的软件".
* http://www.factorio.com/terms-of-service

== 从游戏存档（地图）中创建一个方案(scenario) ==

一个常常被提及的问题是如何从一个地图创建一个方案(scenario)(也可以通过地图编辑器创建一个方案)：
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio can convert them] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 see also this post]):
./bin/prod/factorio --map2scenario mapfoo

== 用地图编辑器创建一个方案(scenarios) ==

自然，第一步也是用地图编辑器创建地图. 保存的地图将视为“方案(scenario)”，存储在专属的文件系统之中。可以通过这个文件去体会它的作用。或者你可以浏览这个页面：

== 概述 ==

* [http://lua-api.factorio.com/latest/ official factorio lua API documentation]