Official Factorio Wiki - User contributions [en]

Types/RotatedAnimation

2022-03-26T18:12:43Z

Plexpt: /* line_length */

== Mandatory properties ==

=== direction_count ===
'''Type''': [[Types/uint32]]

The sequential animation instance is loaded equal to the entities direction within the direction_count setting.

Direction count to [[Types/Direction]] (animation sequence number):
*'''1''' - '''North''' (1)
*'''2''' - '''North''' (1), South (2)
*'''4''' - '''North''' (1), '''East''' (2), '''South''' (3), '''West''' (4)
*'''8''' - '''North''' (1), '''Northeast''' (2), '''East''' (3), '''Southeast''' (4), '''South''' (5), '''Southwest''' (6), '''West''' (7), '''Northwest''' (8)

== Optional properties ==

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

If this property is present, all RotatedAnimation definitions have to be placed as entries in the array, and they will all be loaded from there. Each item (RotatedAnimation 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.

Layers may not be an empty table.

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

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

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

'''Default''': ""

Mandatory if <code>stripes</code> and <code>filenames</code> is not specified.

=== filenames ===
'''Type''': [[types/table]] of [[Types/FileName]]

'''Default''': ""

Only loaded if <code>stripes</code> is not present.

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

Mandatory if <code>filenames</code> is present.

=== lines_per_file ===
'''Type''': [[Types/uint32]]

Mandatory if <code>filenames</code> is present.

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

'''Default''': "medium"

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

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

The width and height of the one frame. 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 one frame in pixels, from 0-8192.

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

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

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

'''Default''': 0

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

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

'''Default''': 0

Vertical position of the animation 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}

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

'''Default''': 1

Values different than 1 specify the scale of the animation 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

Only one of <code>draw_as_shadow</code>, <code>draw_as_glow</code> and <code>draw_as_light</code> can be true. <code>draw_as_shadow</code> takes precedence over <code>draw_as_glow</code> and <code>draw_as_light</code>.

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

'''Default''': false

Only one of <code>draw_as_shadow</code>, <code>draw_as_glow</code> and <code>draw_as_light</code> can be true. <code>draw_as_glow</code> takes precedence over <code>draw_as_light</code>.

Draws first as a normal sprite, and again as a light layer.<sup>[https://forums.factorio.com/91682]</sup>

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

'''Default''': false

Only one of <code>draw_as_shadow</code>, <code>draw_as_glow</code> and <code>draw_as_light</code> can be true.

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

'''Default''': 0

Only loaded if this is an icon (has flag "group=icon" or "group=gui").

=== 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/BlendMode]]

'''Default''': "normal"''

=== 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

Unused.

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

'''Default''': "forward"

Possible values are:
*forward
*backward
*forward-then-backward

=== frame_count ===
'''Type''': [[Types/uint32]]

'''Default''': 1

Can't be 0.

=== line_length ===
'''Type''': [[Types/uint32]]

'''Default''': 0

Once the specified number of pictures is loaded, other pictures are loaded on other line.
This is to allow having longer animations in matrix, to avoid pictures with too big width.
The game engine limits the width of any input picture to 8048px, so it is compatible with most graphics cards.

=== animation_speed ===
'''Type''': [[Types/float]]

'''Default''': 1

Modifier of the animation playing speed, the default is 1, which means one animation frame per tick (60 fps).
The speed of playing can often vary depending on the usage (output of steam engine for example). Has to be greater than 0.

=== max_advance ===
'''Type''': [[Types/float]]

'''Default''': MAX_FLOAT

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

'''Default''': 1

Can't be 0.

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

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

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

=== frame_sequence ===
'''Type''': [[Types/AnimationFrameSequence]]

=== still_frame ===
'''Type''': [[Types/uint32]]

'''Default''': 0

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

'''Default''': false

If true, <code>direction_count</code> must be greater than 1.

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

'''Default''': false

=== middle_orientation ===
'''Type''': [[Types/RealOrientation]]

'''Default''': 0.5

=== orientation_range ===
'''Type''': [[Types/float]]

'''Default''': 1

Automatically clamped to be between 0 and 1.

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

'''Default''': true

=== stripes ===
'''Type''': [[Types/table|table]] (array) of [[Types/Stripe|Stripe]]

{{Prototype property type usage|{{FULLPAGENAME}}}}

Modding/zh

2022-03-26T17:24:55Z

Plexpt: /* 注意 */

{{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 ==
: ''另请参见: [[Tutorial:Modding]]''

=== API 文档 ===

* [[Prototype definitions|原型文档]] — 可以在游戏中添加哪些原型，以及它们的属性
* [http://lua-api.Factorio.com/latest 最新的API文档] — 监听事件，改变玩家周围的世界
* [https://github.com/wube/factorio-data Factorio 在GitHub上的数据存储库] — 跟踪在版本之间异星工厂的Lua原型定义的变化。
* [[Data.raw]] — 列出所有内置原型的名称和类型

=== Lua 脚本 ===

你需要使用 Lua(版本: 5.2.1) 编程语言来制作 Factorio 的任意Mod。游戏的Mod系统将会把你的代码在游戏启动和数据构建阶段注入游戏。你可以使用任意文本编辑器来编辑你的Mod。已知为 Lua 提供代码提示以及高亮的编辑器有 [https://notepad-plus-plus.org Notepad++] 和 [http://www.sublimetext.com Sublime Text]

有用的 Lua 资源:

* [http://lua-users.org/wiki/TutorialDirectory Lua 教程]
* [https://www.lua.org/manual/5.2/ Lua 参考手册]
* [https://repl.it/languages/lua Lua REPL] : 一个 Lua 在线运行环境，本质上是一个沙盒

=== Mod的基本结构 ===

Factorio 的Mod是一个Zip格式的文件，里面包含了 Factorio 在加载Mod时会查找的几个重要文件。下面列出了这些文件，必需得文件显示为红色字体

* ExampleMod_0.0.1.zip
** <span style="color:#FF5555">info.json</span>
** control.lua
** data.lua
** data-updates.lua
** data-final-fixes.lua

=== 授权信息 ===

随着'''v0.11'''版本的到来所有mod需要有一个许可类型。如果一个MOD没有指定许可类型，将使用默认的 [http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)]。然而，可以有目的地使Mod使用[https://choosealicense.com/licenses/unlicense/ unlicensed] 协议，使代码可以被公共域修改及分发。Factorio Mod最受欢迎的分发许可证为 [https://choosealicense.com/licenses/mit/ MIT license] 和 [https://choosealicense.com/licenses/gpl-3.0/ GPLv3] license.

其他有用的法律链接包括:

* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 关于允许使用base-mod内容的论坛帖子]
* [http://www.factorio.com/terms-of-service Factorio服务条款]
* [https://choosealicense.com/licenses/ 选择许可类型]

== 另请参见 ==
* [[:Category:Technical]] — 与API无关的格式文档