На других языках: Deutsch English Українська 中文

Modding/ru: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
m (removed links to soon to be deleted pages)
(updated to English version)
Line 1: Line 1:
{{Languages}}
{{Languages}}
[[File:Fff-18-entity-graph.jpg|400px|thumb|'Диаграмма объектов' (объекты на карте) структура наследования классов, сгенерированная doxygen. Источник: Пятничные Факты #18 http://www.factorio.com/blog/post/fff-18]]


Модификации Factorio открывают доступ к новому контенту, созданному сообществом.
На этой странице рассказывается, как загружать и устанавливать моды, и дает краткий обзор того, что вы должны иметь в виду при создании мода. Для получения более подробных инструкций по созданию модов вы можете ознакомиться с [[Tutorial:Modding_tutorial/ru|учебной страницей моддинга]]. Если вы ищете API-интерфейс для моддинга, ознакомьтесь с [http://lua-api.factorio.com/latest/ официальной документацией Factorio Lua API (англ.)]. Если вы хотите узнать, где установить мод, который находится в зашифрованном формате, ознакомьтесь с инструкциями на странице [[Application_directory/ru|каталога приложений]].


== Начало работы ==
== '''''Загрузка и установка модов''''' ==
Обзор существующих модов можно найти в [[Mods/ru|списке модов]] или на [http://www.factorioforums.com/forum/index.php официальном форуме].


Хорошим местом для старта станет [http://www.factorioforums.com/forum/viewforum.php?f=25 тематичный подфорум]. Сообщество моддеров всегда готово ответить на конкретные вопросы. Иногда в течение минут. Популярные вопросы можно найти на странице [[Modding FAQ/ru|FAQ по модам]].
Вы можете скачать моды из следующих мест:


== Лицензирование ==
* [https://mods.factorio.com/ Портал модов (веб-сайт)]
Начиная с версии v0.11 всем модам необходима лицензия. Если создатель мода не выбрал лицензию, то по умолчанию присваивается Лицензия Creative Commons [http://creativecommons.org/licenses/by-nc/4.0 Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)].
* Портал модов (в игре)
* [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b Подфорум модов]


См. также:
=== Портал модов (веб-сайт) ===
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=6202&p=48971#p48968 Тема о лицензировании на форуме].
: В данной теме разработчики поясняют, что базовый мод (который является частью Factorio) можно применять для создания новых модов, но он не может использоваться "вне Factorio".
* [http://www.factorio.com/terms-of-service Пользовательское соглашение].


== Создание сценария на основе сохранённой игры==
Разработчики Factorio создали [https://mods.factorio.com/ портал модов (веб-сайт)], чтобы позволить игрокам делиться модами. Мод, который вы загружаете с веб-сайта, поставляется в виде заархивированного файла. Чтобы установить мод, вам нужно скопировать заархивированный файл в каталог модов, расположенный под [[Application_directory#User_Data_directory|каталогом данных пользователя]], без его распаковки. Вы можете проверить, правильно ли вы установили его, просмотрев список мод, доступ к которому вы можете получить через главное меню игры.
Одним из популярных вопросов является возможность создания сценария (который может редактироваться через редактор карты) на основе сохранения:
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=2844 Factorio может конвертировать карты в сценарии] ([http://www.factorioforums.com/forum/viewtopic.php?f=5&t=3801&p=28289#p28289 см. также данный пост]):


./bin/prod/factorio --map2scenario mapfoo
=== Портал модов (в игре) ===


[[GameClient/ru|Больше о параметрах клиента]].
Моды, отображаемые на [https://mods.factorio.com/ портале модов (веб-сайт)], должны отображаться на портале модов, который вы можете получить в главном меню игры. Различия в игровом портале модов - это то, что вы можете использовать его для автоматической загрузки и установки модов, а также для включения или отключения модов.


== Создание сценариев через редактор карты ==
=== Подфорум модов ===
Другим вариантом создания сценария является использование игрового редактора карт, который сохранит карту в качестве '''сценария''', который является просто отдельной директорией с файлами. Вы можете заглянуть в файлы и познакомиться с их назначением. Также полезными будут следующие статьи:


== Обзор ==
Некоторые создатели модов загружают свои моды в официальный [https://forums.factorio.com/viewforum.php?f=14&sid=68de6ef9ee46dcd7566653335917752b подфорум модов], чтобы продемонстрировать свою работу, не отправляясь на портал модов, или получать отзывы от сообщества об их модах перед обновлением или отправкой их на портал модов. Загруженный мод должен отображаться как вложение. Иногда мод, которую вы загружаете из подфорума, приходит в виде заархивированного файла. Вам нужно скопировать его в каталог модов, расположенный под [[Application_directory#User_Data_directory|каталогом данных пользователя]], чтобы его установить - вам не нужно его распаковывать. Вы можете проверить, правильно ли вы установили его, просмотрев список модов, доступ к которому вы можете получить в главном меню игры.
* [[Modding overview/ru|Обзор моддинга]]
* [[Script interfaces/ru|Интерфейсы скриптов]]
* [[Migration scripts/ru|Миграция скриптов]]
* [[Modding FAQ/ru|FAQ по моддингу]]
* [[Modding Tutorial/ru|Руководство по моддингу]]


== Дополнительная информация ==
=== Зависимости ===
* Руководство: [http://www.factorioforums.com/forum/viewtopic.php?f=15&t=8613 Создаем графику для мода...], генерируем спрайтовые карты.
 
Многие моды используют базовый мод Factorio как свою единственную зависимость, которую вам не нужно устанавливать отдельно. Однако некоторые моды могут потребовать установки других модов для их работы, а также могут предложить вам установить другие моды, чтобы они могли расширить их функциональность.
 
==== Требуемая зависимость ====
 
Когда установленный мод требует установки другого мода для его работы, другой мод в этом случае является необходимой зависимостью.
 
==== Необязательная зависимость ====
 
Когда мод делает предложение установить другой мод, но если ему не нужен этот другой мод для его работы, другой мод в этом случае является необязательной зависимостью. Вы можете установить дополнительные зависимости, которые расширяют функциональность мода, чтобы улучшить игровой процесс с помощью мода.
 
==== Примечание ====
 
В настоящее время портал модов в игре не загружает автоматически ни необходимые, ни дополнительные зависимости; поэтому пользователь может их найти и установить. Однако ожидается, что в будущем такой процесс будет выполнен автоматически.
 
== '''''Создание модов''''' ==
: ''См. также:
::* [[Tutorials/ru#Моддинг|Учебник по моддинг]]
::* [http://www.factorioforums.com/forum/viewtopic.php?f=15&t=8613 Создание графики для мода...], генерация спрайтовых карт.
 
=== API документация ===
 
* [[Prototype definitions/ru|Документация прототипов]] — Какие прототипы могут быть добавлены в игру, и каковы их свойства.
* [http://lua-api.Factorio.com/latest Документация по API среды выполнения (англ.)] — Захватите события и измените мир вокруг игрока.
* [https://github.com/wube/factorio-data Хранилище данных Factorio github] — Отслеживает изменения определений прототипов lua в factorio между релизами.
* [[Data.raw]] — Перечисляет имена и типы всех встроенных прототипов.
 
=== Lua скриптинг ===
 
Для создания любых модов в Factorio вам необходимо использовать язык программирования Lua. Система модов игры вводит ваш код в запуск и на этапе построения данных игры. Вы можете использовать любой текстовый редактор для написания кода для своего мода. Известными текстовыми редакторами, которые предлагают подсветку синтаксиса для Lua, являются Notepad++ и Sublime Text.
 
Полезные ресурсы для Lua:
 
:Англоязычные учебники:
:* [http://lua-users.org/wiki/TutorialDirectory Учебник по Lua]
:* [https://www.lua.org/manual/5.3/ Справочное руководство по Lua]
:* [https://repl.it/languages/lua Lua REPL] : Песочница Lua.
 
:Русскоязычные учебники:
:* [https://antirek.github.io/luabook/ Lua 5.3 Руководство пользователя]
:* [https://www.mediawiki.org/wiki/Extension:Scribunto/Lua_reference_manual/ru Справочное руководство по языку Lua 5.1 (включая дополнительные библиотеки, используемые при работе с MediaWiki)]
 
=== Базовая структура мода ===
 
Моды Factorio распространяются в ZIP-архивах и содержат несколько важных файлов, которые Factorio ищет при загрузке модов. Эти файлы перечислены ниже, а требуемые файлы окрашены в красный цвет.
 
* ExampleMod_0.0.1.zip
** <span style="color:#FF5555">info.json</span>
** control.lua
** data.lua
** data-updates.lua
** data-final-fixes.lua
 
=== Лицензирование ===
 
Каждый мод требует лицензии начиная с Factorio '''в0.11'''. Если мод не имеет лицензии, предполагается, что он имеет лицензию Creative Commons — [http://creativecommons.org/licenses/by-nc/4.0 Атрибуция-Некоммерческая 4.0 Всемирная (CC BY-NC 4.0)]. Тем не менее, можно намеренно сделать мод [https://choosealicense.com/licenses/unlicense/ нелицензированным], чтобы код в нем был доступен для общественного достояния. Наиболее популярными лицензиями на распространение модов Factorio являются [https://choosealicense.com/licenses/mit/ лицензия MIT] и лицензия [https://choosealicense.com/licenses/gpl-3.0/ GPLv3].
 
Другие полезные юридические ссылки включают:
 
* [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, не связанных с моддингом
* [[Tutorial:Modding_FAQ/ru|ЧаВо по моддингу]]

Revision as of 16:11, 28 June 2018


На этой странице рассказывается, как загружать и устанавливать моды, и дает краткий обзор того, что вы должны иметь в виду при создании мода. Для получения более подробных инструкций по созданию модов вы можете ознакомиться с учебной страницей моддинга. Если вы ищете API-интерфейс для моддинга, ознакомьтесь с официальной документацией Factorio Lua API (англ.). Если вы хотите узнать, где установить мод, который находится в зашифрованном формате, ознакомьтесь с инструкциями на странице каталога приложений.

Загрузка и установка модов

Вы можете скачать моды из следующих мест:

Портал модов (веб-сайт)

Разработчики Factorio создали портал модов (веб-сайт), чтобы позволить игрокам делиться модами. Мод, который вы загружаете с веб-сайта, поставляется в виде заархивированного файла. Чтобы установить мод, вам нужно скопировать заархивированный файл в каталог модов, расположенный под каталогом данных пользователя, без его распаковки. Вы можете проверить, правильно ли вы установили его, просмотрев список мод, доступ к которому вы можете получить через главное меню игры.

Портал модов (в игре)

Моды, отображаемые на портале модов (веб-сайт), должны отображаться на портале модов, который вы можете получить в главном меню игры. Различия в игровом портале модов - это то, что вы можете использовать его для автоматической загрузки и установки модов, а также для включения или отключения модов.

Подфорум модов

Некоторые создатели модов загружают свои моды в официальный подфорум модов, чтобы продемонстрировать свою работу, не отправляясь на портал модов, или получать отзывы от сообщества об их модах перед обновлением или отправкой их на портал модов. Загруженный мод должен отображаться как вложение. Иногда мод, которую вы загружаете из подфорума, приходит в виде заархивированного файла. Вам нужно скопировать его в каталог модов, расположенный под каталогом данных пользователя, чтобы его установить - вам не нужно его распаковывать. Вы можете проверить, правильно ли вы установили его, просмотрев список модов, доступ к которому вы можете получить в главном меню игры.

Зависимости

Многие моды используют базовый мод Factorio как свою единственную зависимость, которую вам не нужно устанавливать отдельно. Однако некоторые моды могут потребовать установки других модов для их работы, а также могут предложить вам установить другие моды, чтобы они могли расширить их функциональность.

Требуемая зависимость

Когда установленный мод требует установки другого мода для его работы, другой мод в этом случае является необходимой зависимостью.

Необязательная зависимость

Когда мод делает предложение установить другой мод, но если ему не нужен этот другой мод для его работы, другой мод в этом случае является необязательной зависимостью. Вы можете установить дополнительные зависимости, которые расширяют функциональность мода, чтобы улучшить игровой процесс с помощью мода.

Примечание

В настоящее время портал модов в игре не загружает автоматически ни необходимые, ни дополнительные зависимости; поэтому пользователь может их найти и установить. Однако ожидается, что в будущем такой процесс будет выполнен автоматически.

Создание модов

См. также:

API документация

Lua скриптинг

Для создания любых модов в Factorio вам необходимо использовать язык программирования Lua. Система модов игры вводит ваш код в запуск и на этапе построения данных игры. Вы можете использовать любой текстовый редактор для написания кода для своего мода. Известными текстовыми редакторами, которые предлагают подсветку синтаксиса для Lua, являются Notepad++ и Sublime Text.

Полезные ресурсы для Lua:

Англоязычные учебники:
Русскоязычные учебники:

Базовая структура мода

Моды Factorio распространяются в ZIP-архивах и содержат несколько важных файлов, которые Factorio ищет при загрузке модов. Эти файлы перечислены ниже, а требуемые файлы окрашены в красный цвет.

  • ExampleMod_0.0.1.zip
    • info.json
    • control.lua
    • data.lua
    • data-updates.lua
    • data-final-fixes.lua

Лицензирование

Каждый мод требует лицензии начиная с Factorio в0.11. Если мод не имеет лицензии, предполагается, что он имеет лицензию Creative Commons — Атрибуция-Некоммерческая 4.0 Всемирная (CC BY-NC 4.0). Тем не менее, можно намеренно сделать мод нелицензированным, чтобы код в нем был доступен для общественного достояния. Наиболее популярными лицензиями на распространение модов Factorio являются лицензия MIT и лицензия GPLv3.

Другие полезные юридические ссылки включают:

См. также