Modding/zh - Revision history

Cardinal: /* 模组开发 */ Removed unnecessary notes.

2025-12-16T02:15:46Z

模组开发: Removed unnecessary notes.

← Older revision		Revision as of 02:15, 16 December 2025
Line 46:		Line 46:
	* [https://github.com/wube/factorio-data 异星工厂GitHub数据库] — 跟踪不同版本之间Lua原型定义的变化。		* [https://github.com/wube/factorio-data 异星工厂GitHub数据库] — 跟踪不同版本之间Lua原型定义的变化。
	* [[Data.raw]] — 列出所有内置原型的名称和类型		* [[Data.raw]] — 列出所有内置原型的名称和类型

	~~<small>''（注：除模组结构外，以上文档均为英文）''</small>~~

	=== Lua 脚本 ===		=== Lua 脚本 ===

Cardinal: Sync with English version.

2025-09-19T08:05:33Z

Sync with English version.

← Older revision		Revision as of 08:05, 19 September 2025
Line 1:		Line 1:
	{{Languages}}{{Translation verification\|revisionID=~~214723~~}}		{{Languages}}{{Translation verification\|revisionID=215846}}
	本页面将会介绍{{Translation\|Modding}}（Mod）的下载和安装方法，并简述创建模组时的注意事项。关于模组开发的详细内容，可以参阅{{L\|Tutorial:Modding tutorial}}。如果需要查找模组API，请查阅[http://lua-api.factorio.com/latest/ 官方Lua-API文档]（英文）。如果需要了解如何安装压缩包格式的模组，请参考{{L\|Application directory}}页面上的相关说明。		本页面将会介绍{{Translation\|Modding}}（Mod）的下载和安装方法，并简述创建模组时的注意事项。关于模组开发的详细内容，可以参阅{{L\|Tutorial:Modding tutorial}}。如果需要查找模组API，请查阅[http://lua-api.factorio.com/latest/ 官方Lua-API文档]（英文）。如果需要了解如何安装压缩包格式的模组，请参考{{L\|Application directory}}页面上的相关说明。

Line 42:		Line 42:
	** [https://lua-api.factorio.com/latest/index-prototype.html 原型文档] — 可以添加到游戏中的原型，以及它们的属性		** [https://lua-api.factorio.com/latest/index-prototype.html 原型文档] — 可以添加到游戏中的原型，以及它们的属性
	** [https://lua-api.factorio.com/latest/index-runtime.html Runtime API文档] — 监听事件，改变玩家周围的世界		** [https://lua-api.factorio.com/latest/index-runtime.html Runtime API文档] — 监听事件，改变玩家周围的世界
	* [[~~Tutorial~~:~~Mod~~ structure~~/zh\|~~模组结构]] — ~~所有模组的基本结构~~		** [https://lua-api.factorio.com/latest/index-auxiliary.html 模组API辅助文档]
			*** [https://lua-api.factorio.com/latest/auxiliary/mod-structure.html 模组结构] — 关于模组需要如何结构化以被游戏加载的更多细节
	* [https://github.com/wube/factorio-data 异星工厂GitHub数据库] — 跟踪不同版本之间Lua原型定义的变化。		* [https://github.com/wube/factorio-data 异星工厂GitHub数据库] — 跟踪不同版本之间Lua原型定义的变化。
	* [[Data.raw]] — 列出所有内置原型的名称和类型		* [[Data.raw]] — 列出所有内置原型的名称和类型

Bilka: en page adapted change from here

2025-06-20T15:29:14Z

en page adapted change from here

← Older revision		Revision as of 15:29, 20 June 2025
Line 1:		Line 1:
	{{Languages}}{{Translation verification\|revisionID=~~207334~~}}		{{Languages}}{{Translation verification\|revisionID=214723}}
	本页面将会介绍{{Translation\|Modding}}（Mod）的下载和安装方法，并简述创建模组时的注意事项。关于模组开发的详细内容，可以参阅{{L\|Tutorial:Modding tutorial}}。如果需要查找模组API，请查阅[http://lua-api.factorio.com/latest/ 官方Lua-API文档]（英文）。如果需要了解如何安装压缩包格式的模组，请参考{{L\|Application directory}}页面上的相关说明。		本页面将会介绍{{Translation\|Modding}}（Mod）的下载和安装方法，并简述创建模组时的注意事项。关于模组开发的详细内容，可以参阅{{L\|Tutorial:Modding tutorial}}。如果需要查找模组API，请查阅[http://lua-api.factorio.com/latest/ 官方Lua-API文档]（英文）。如果需要了解如何安装压缩包格式的模组，请参考{{L\|Application directory}}页面上的相关说明。

Cardinal: Translation verification.

2025-05-07T03:58:41Z

Translation verification.

← Older revision		Revision as of 03:58, 7 May 2025
Line 1:		Line 1:
	{{Languages}}		{{Languages}}{{Translation verification\|revisionID=207334}}
	本页面将会介绍{{Translation\|Modding}}（Mod）的下载和安装方法，并简述创建模组时的注意事项。关于模组开发的详细内容，可以参阅{{L\|Tutorial:Modding tutorial}}。如果需要查找模组API，请查阅[http://lua-api.factorio.com/latest/ 官方Lua-API文档]（英文）。如果需要了解如何安装压缩包格式的模组，请参考{{L\|Application directory}}页面上的相关说明。		本页面将会介绍{{Translation\|Modding}}（Mod）的下载和安装方法，并简述创建模组时的注意事项。关于模组开发的详细内容，可以参阅{{L\|Tutorial:Modding tutorial}}。如果需要查找模组API，请查阅[http://lua-api.factorio.com/latest/ 官方Lua-API文档]（英文）。如果需要了解如何安装压缩包格式的模组，请参考{{L\|Application directory}}页面上的相关说明。

Cardinal: Categorized.

2025-04-17T02:30:59Z

Categorized.

← Older revision		Revision as of 02:30, 17 April 2025
Line 64:		Line 64:
	* [[:Category:Technical\|技术文档]] — 与模组无关的技术格式和API的文档（英文）		* [[:Category:Technical\|技术文档]] — 与模组无关的技术格式和API的文档（英文）

	{{C\|Modding{{!}}#}}		{{C\|Modding/zh{{!}}#}}

Cardinal: Sync with English version.

2025-04-17T02:30:03Z

Sync with English version.

Show changes

Bilka: Linked to migrated prototype docs

2024-10-25T14:22:37Z

Linked to migrated prototype docs

← Older revision		Revision as of 14:22, 25 October 2024
Line 44:		Line 44:
	=== API 文档 ===		=== API 文档 ===

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

Plexpt: /* 注意 */

2022-03-26T17:24:55Z

注意

← Older revision		Revision as of 17:24, 26 March 2022
Line 35:		Line 35:
	当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。		当一个mod建议你安装另一个mod并且在不安装被建议的mod也能工作时，这种mod即为可选依赖。

	==== 注意 ====		==== 不兼容 ====

	~~当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。~~		依赖关系也可以用来声明一个 mod 与其他 mod 不兼容，从而阻止它们一起加载。

	== 开始开发一款Mod ==		== 开始开发一款Mod ==

Apple Sa at 03:24, 10 March 2019

2019-03-10T03:24:35Z

← Older revision		Revision as of 03:24, 10 March 2019
Line 80:		Line 80:
	* [https://choosealicense.com/licenses/ 选择许可类型]		* [https://choosealicense.com/licenses/ 选择许可类型]

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

Apple Sa: Update New Page

2019-03-10T03:23:49Z

Update New Page

← Older revision		Revision as of 03:23, 10 March 2019
Line 39:		Line 39:
	当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。		当前的游戏内置mod下载平台不会下载任何依赖mod，因此那些依赖的mod需要玩家手动下载。然而这个功能在将来会被实现（该功能以及被提上日程）。

	== ~~开始开发一款mod~~ ==		== 开始开发一款Mod ==
			: ''另请参见: [[Tutorial:Modding]]''

			=== API 文档 ===

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

	~~从这里开始学习会让你感到很轻松 [http://www.factorioforums.com/forum/viewforum.php?f~~=~~25 modding-Help-Board].这个社区总是有很多基佬回答具体问题。往往只要等待几分钟就有回复。或者你可以试试 [[Modding FAQ]] 页面.~~		=== 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 在线运行环境，本质上是一个沙盒

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

	附录		Factorio 的Mod是一个Zip格式的文件，里面包含了 Factorio 在加载Mod时会查找的几个重要文件。下面列出了这些文件，必需得文件显示为红色字体
	* [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) ===~~		* ExampleMod_0.0.1.zip
			** <span style="color:#FF5555">info.json</span>
			** control.lua
			** data.lua
			** data-updates.lua
			** data-final-fixes.lua

	~~一个常常被提及的问题是如何从一个地图创建一个方案(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~~) ~~===~~		随着'''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.

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

	=== ~~概述 ===~~		* [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/ 选择许可类型]

	* [~~http~~:~~//lua-api.factorio.com/latest/ official factorio lua API documentation~~]		== See also ==
			* [[:Category:Technical]] — 与API无关的格式文档