User:Ucrij fender/Tutorial:Modding tutorial/Gangsir/uk - Revision history

Bilka: Bilka moved page Tutorial:Modding tutorial/Gangsir/uk to User:Ucrij fender/Tutorial:Modding tutorial/Gangsir/uk without leaving a redirect: WIP pages must be in your userspace

2020-03-24T14:38:05Z

Bilka moved page Tutorial:Modding tutorial/Gangsir/uk to User:Ucrij fender/Tutorial:Modding tutorial/Gangsir/uk without leaving a redirect: WIP pages must be in your userspace

← Older revision		Revision as of 14:38, 24 March 2020
(No difference)

Ucrij fender: /* Resolving common errors in modding */

2020-03-18T13:11:52Z

Resolving common errors in modding

← Older revision		Revision as of 13:11, 18 March 2020
Line 334:		Line 334:
	Однак ви можете взяти цей мод і змінити його для власного використання, змінюючи рецепти, додаючи технології, що завгодно.		Однак ви можете взяти цей мод і змінити його для власного використання, змінюючи рецепти, додаючи технології, що завгодно.

	== ~~Resolving common errors in modding~~ ==		== Вирішення поширених помилок під час модінгу ==

	~~As you continue to write mods from scratch instead of from a tutorial~~, ~~you may encounter the infamous error~~. ~~There are several types of errors that you can encounter in modding Factorio~~, ~~and knowing how to deal with these errors will allow you to continue working~~.		Якщо ви продовжите писати моди з нуля, а не з туторіалів, ви можете зіткнутися з поширеними помилками. Існує кілька типів помилок, з якими ви можете зіткнутися в програмуванні взагалі, і знання способів вирішення цих помилок дозволить вам продовжувати працювати.
			=== Синтаксичні помилки ===

	~~=== Syntax errors ===~~		Мова програмування lua очікує, що речі будуть викладені певним чином. Якщо ви пропустите дужку, знак або крапку, ви побачите помилку синтаксису. Як приклад:

	~~The~~ lua ~~programming language expects things to be laid out a certain way~~. ~~If you miss a bracket~~, ~~= sign~~, ~~or dot, you will encounter a syntax error~~. ~~As an example, see the error below~~:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 346:		Line 345:
	</pre>		</pre>

	~~As of version~~ 0.15, ~~you'll see an error like the one above whenever you make a syntax error within the prototype definitions. The game will offer to restart~~, ~~disable the troubling mod~~, ~~disable all mods~~, ~~or exit~~. ~~Let's dissect the error~~, ~~shall we?~~		Починаючи з версії 0.15, ви побачите помилку, подібну до наведеної вище, кожного разу, коли будете робити помилки синтаксису в межах визначення прототипу. Гра запропонує перезапустити, відключити тривожний мод, відключити всі модни або вийти. Розберемо помилку.

	~~Right away~~, ~~we see the reason why~~ Factorio ~~didn't start normally~~. "Failed to load mods:". So, ~~we know that it's a mod that messed up, and by extension~~, ~~we know it's our mod. Whenever the~~ lua ~~engine of~~ Factorio ~~has a syntax error~~, ~~it will print a mini stack~~-~~trace that follows through all requires~~, ~~listing the call order~~. ~~First~~, ~~we see that the problem was indirectly caused by line~~ 1 of data.lua. ~~There's no problem there~~, ~~so it must be the next entry~~, ~~line~~ 36 of prototypes/item.lua. ~~After stating where it is line-wise~~, ~~it will attempt to give you an estimate of where in the line the problem is~~. ~~Don't trust this estimate~~, ~~only roughly trust the line number, plus or minus a few lines~~.		Відразу ми бачимо причину, чому Factorio не запустився. "Failed to load mods:" не вдалося завантажити модифікації. Отже, ми знаємо яка модифікація має помилку. Щоразу, коли у lua-рушія Factorio виникає синтаксична помилка, він надрукує міні стек-стежку, яка слідує за всіма потребами, перелічуючи порядок виклику. По-перше, ми бачимо, що проблема була опосередковано спричинена рядком 1 у data.lua. Тут немає жодних проблем, тому це повинен бути наступний запис, рядок 36 prototypes/item.lua. Після того, як він вказав, де це, він спробує дати вам оцінку, де в рядку проблема. Не довіряйте цій оцінці, лише приблизно довіряйте номеру рядка плюс-мінус кілька рядків.

	~~Going to line~~ 36 of item.lua~~, we find~~:		В лінії 36 файла item.lua можна знайти:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 356:		Line 355:
	</pre>		</pre>

	~~Hmm~~, ~~that doesn't look right. Can you see what's missing~~? ~~We left off an = between enabled and true. Thus, syntax error~~. ~~Fixing these can be difficult for new programmers, who don't know what to look for~~.		Це не виглядає правильно. Ви можете бачити, чого не вистачає? Ми залишили "знак прирівнювання". Для новачків в програмуванні такі може бути неочевидним.
			=== Нелогічні дії та нуль(nil) ===
	=== ~~Illogical actions, indexing~~ nil ===

	In lua, "~~nothing~~" ~~is defined as the keyword~~ nil. ~~This is similar to~~ null ~~in other programming languages~~. ~~Whenever the programmer tries to access something in a table that is nil~~, ~~they will get an error like the following~~:		У lua "нічого" визначається як nil. Це схоже на null в інших мовах програмування. Кожен раз, коли програміст намагається отримати доступ до чогось у таблиці, яка є нульовою, вони отримають помилку на зразок наступного:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 367:		Line 365:
	</pre>		</pre>

	~~The~~ "attempt to index field ..." ~~error is often caused by the modder making an assumption that didn't work out~~. ~~These types of errors will always be identifiable by their signature line~~, "~~attempt to index field~~". ~~If we look at line~~ 3 of control.lua ~~(where the error is)~~, ~~we see~~:		Помилка "attempt to index field ..."(спроба індексувати поле) часто викликана тим, що моддер вибирає з таблиці неіснуючих даних. Ці типи помилок завжди будуть ідентифіковані за їх рядком підпису, "спроба індексувати поле". Якщо ми подивимось на рядок 3 з control.lua, ми побачимо:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 373:		Line 371:
	</pre>		</pre>

	~~What assumption has the modder made here~~? ~~Well~~, ~~there's actually two problems with this line~~. ~~The first thing is that the modder has assumed that~~ <code>game.players[23]</code> ~~is a valid player~~, ~~which isn't the case; this is why we get the "index field '?'" bit~~. ~~The game doesn't know what the field is that we tried to index~~, ~~because it hasn't been created yet. These errors are difficult to debug unless you know the ins and outs of the modding~~ API ~~well~~.		Яке припущення зробив тут моддер? Ну, насправді є дві проблеми. Перше, що моддер припустив, що <code>game.players[23]</code> є дійсним гравцем, що не так. Ці помилки важко налагодити, якщо ви добре не знаєте входів та виходів модуляційного API.

	~~The second issue is a lot more subtle~~, ~~and won't work~~. ~~The modder is attempting to print a userdata table~~. [http://lua-api.factorio.com/latest/LuaPlayer ~~A player~~] ~~is a table of several values~~. ~~Trying to print it will error~~, ~~instead a function to print it is needed~~.		Друга проблема набагато тонкіша, і вона не спрацює. Модер намагається надрукувати таблицю даних користувачів. [http://lua-api.factorio.com/latest/LuaPlayer Гравець] - це таблиця з кількома значеннями. Спробу надрукувати його буде помилкою, замість цього потрібна функція для друку.

	=== Error while running event ===		=== Error while running event ===

Ucrij fender: /* The finished tutorial mod */

2020-03-18T08:19:12Z

The finished tutorial mod

← Older revision		Revision as of 08:19, 18 March 2020
Line 328:		Line 328:
	Зверніть увагу, щр це не файл lua. Локальна обробка обробляється файлами конфігурації C, тому формат відрізняється.		Зверніть увагу, щр це не файл lua. Локальна обробка обробляється файлами конфігурації C, тому формат відрізняється.

	== ~~The finished tutorial mod~~ ==		== Закінчення підручника ==

	~~Well~~, ~~the mod is finished~~. ~~Since this mod is only a tutorial~~, ~~there isn't much balance to it. Additionally, don't try submitting it to the mod portal as your own, since it's from the Wiki~~.		Ну, мод закінчений. Оскільки цей мод є лише навчальним, балансу в ньому мало.

	~~However~~, ~~you're free to take this mod and modify it for your own use~~, ~~changing recipes~~, ~~adding technologies, whatever~~.		Однак ви можете взяти цей мод і змінити його для власного використання, змінюючи рецепти, додаючи технології, що завгодно.

	== Resolving common errors in modding ==		== Resolving common errors in modding ==

Ucrij fender: /* Locale */

2020-03-18T08:14:44Z

Locale

← Older revision		Revision as of 08:14, 18 March 2020
Line 308:		Line 308:
	За допомогою коментарів lua у вищенаведеному коді досить легко зрозуміти як все працює, як ви отримаєте поточну броню, яку носить гравець, з defines.inventory.character_armor, яка є постійною інвентарем та як створювати вогонь. Прочитати список визначень [http://lua-api.factorio.com/latest/defines.html#defines.inventory можливо тут].		За допомогою коментарів lua у вищенаведеному коді досить легко зрозуміти як все працює, як ви отримаєте поточну броню, яку носить гравець, з defines.inventory.character_armor, яка є постійною інвентарем та як створювати вогонь. Прочитати список визначень [http://lua-api.factorio.com/latest/defines.html#defines.inventory можливо тут].

	=== ~~Locale~~ ===		=== Локалізація ===

	~~If you've already tried loading up~~ Factorio ~~and trying the mod so far (which you can at this point without it crashing)~~, ~~you may have noticed that the item name of the armor says~~ "Unknown key". ~~This means that~~ Factorio ~~has the internal name~~, ~~but it doesn't know what it should look like to the user~~. So, ~~we need to create locale for our mod~~.		Якщо ви вже пробували завантажувати Factorio і намагаєтеся з модифікацією, можливо, ви помітили, що назва предмета броні говорить "Unknown key"(невідоме значення). Це означає, що Factorio має внутрішню назву, але він не знає, як він повинен виглядати для користувача. Отже, нам потрібно створити локалізацію для нашого мода.

	~~In the mod folder, create a folder called~~ <code>locale</code>, ~~then create another folder inside that called~~ <code>en</code>, ~~then a file called~~ <code>config.cfg</code>.		У папці створіть папку під назвою <code>locale</code>, потім створіть іншу папку всередині, яка називається <code>en</code>([https://uk.wikipedia.org/wiki/ISO_639-1 ISO 639] для більшого), потім файл під назвою <code>config.cfg</code>.

	~~If you know another language~~, ~~you can also translate your mod by making other language code files inside locale~~, ~~such as~~ de ~~for German~~.		Якщо ви знаєте іншу мову, ви також можете перекласти свій мод, зробивши інші файли кодових мов всередині локалі, наприклад de для німецької.

	~~Inside~~ config.cfg, ~~paste the following~~:		В config.cfg, вставте наступне:

	<pre style="background-color:#AAFFAA!important; color:black">		<pre style="background-color:#AAFFAA!important; color:black">

	[item-name]		[item-name]
	fire-armor=Fire armor		fire-armor=Fire armor
Line 327:		Line 326:
	</pre>		</pre>

	~~Notice how this is not a~~ lua ~~file~~. ~~Locale is handled with~~ C ~~config files, so the format is different.~~		Зверніть увагу, щр це не файл lua. Локальна обробка обробляється файлами конфігурації C, тому формат відрізняється.

	~~Finally~~, ~~the mod will look like [https://github.com/TheRealGangsir/FactorioModdingTutorial this]~~.

	== The finished tutorial mod ==		== The finished tutorial mod ==

Ucrij fender: /* The control scripting */

2020-03-18T08:02:36Z

The control scripting

← Older revision		Revision as of 08:02, 18 March 2020
Line 279:		Line 279:
	Це також може бути застосоване до інших мод, а не лише до бази Факторио. Ви не можете модифікувати мод до тих пір, поки ви не додасте мод (який ви змінили своїм модом) до залежностей, щоб він завантажився першим.		Це також може бути застосоване до інших мод, а не лише до бази Факторио. Ви не можете модифікувати мод до тих пір, поки ви не додасте мод (який ви змінили своїм модом) до залежностей, щоб він завантажився першим.

	=== ~~The control scripting~~ ===		=== Контрольні сценарії ===

	~~And now~~, ~~to finalize the mod~~, ~~we have to make it be more than just simple armor~~. ~~Let's think about what we want the armor to do~~. ~~We want the armor to periodically create fire on the ground as we walk with the armor on~~. ~~The event we're going to use is called~~ on_tick, ~~since we want the fire to be periodically created~~.		А тепер, щоб доопрацювати мод, ми мусимо зробити це не просто простою бронею. Давайте подумаємо, що ми хочемо зробити броні. Ми хочемо, щоб броня періодично створювала вогонь по землі, коли ми ходимо з обладунками. Подія, яку ми будемо використовувати, називається on_tick, оскільки ми хочемо, щоб вогонь періодично створювався.

	~~In our mod folder, create a file called~~ <code>control.lua</code>. ~~The game will automatically execute this file~~, ~~so requiring it is not necessary~~.		У папці мод створіть файл під назвою <code>control.lua</code>. Гра автоматично виконає цей файл, тому додавати до вимог його не потрібно.

	~~Inside~~ control.lua~~, copy and paste the following~~:		Всередині control.lua скопіюйте та вставте наступне:

	<pre style="background-color:#AAFFAA!important; color:black;">		<pre style="background-color:#AAFFAA!important; color:black;">
Line 292:		Line 292:
	script.on_event({defines.events.on_tick},		script.on_event({defines.events.on_tick},
	function (e)		function (e)
	if e.tick % 30 == 0 then --~~common trick to reduce how often this runs~~, ~~we don't want it running every tick~~, ~~just every~~ 30 ~~ticks~~, ~~so twice per second~~		if e.tick % 30 == 0 then --поширений трюк, щоб зменшити частоту праці, ми не хочемо, щоб він виконувався не кожнен тік а кожні 30, коротше двічі на секунду
	for index,player in pairs(game.connected_players) do --~~loop through all online players on the server~~		for index,player in pairs(game.connected_players) do --цикл для всих гравців на сервері або в локальній грі
			--якщо гравець носить нашу броню
	--~~if they're wearing our armor~~
	if player.character and player.get_inventory(defines.inventory.character_armor).get_item_count("fire-armor") >= 1 then		if player.character and player.get_inventory(defines.inventory.character_armor).get_item_count("fire-armor") >= 1 then
	--~~create the fire where they're standing~~		--створити вогонь на місці стояння гравця
	player.surface.create_entity{name="fire-flame", position=player.position, force="neutral"}		player.surface.create_entity{name="fire-flame", position=player.position, force="neutral"}
	end		end
Line 307:		Line 306:
	</pre>		</pre>

	~~I've used~~ lua ~~comments in the code above to explain each step. It's fairly easy to understand~~, ~~and it shows how you would get the current armor that the player is wearing~~, ~~with~~ defines.inventory.character_armor, ~~which is an inventory constant~~. ~~You can read the list of defines~~ [http://lua-api.factorio.com/latest/defines.html#defines.inventory ~~here].~~		За допомогою коментарів lua у вищенаведеному коді досить легко зрозуміти як все працює, як ви отримаєте поточну броню, яку носить гравець, з defines.inventory.character_armor, яка є постійною інвентарем та як створювати вогонь. Прочитати список визначень [http://lua-api.factorio.com/latest/defines.html#defines.inventory можливо тут].

	~~At this point, the mod will look like [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/26b75c799834b9a8323d500af11b0233b824d002 this~~].

	=== Locale ===		=== Locale ===

Ucrij fender: /* More on data.raw */

2020-03-18T07:31:49Z

Ucrij fender: /* Prototype creation */

2020-03-15T17:34:14Z

Prototype creation

← Older revision		Revision as of 17:34, 15 March 2020
Line 196:		Line 196:
	Зверніть увагу на зазначення каталогів та файлів.		Зверніть увагу на зазначення каталогів та файлів.

	=== ~~Prototype creation~~ ===		=== Створення прототипу ===

	~~Now, there are two ways to create prototypes in~~ Factorio. ~~There's the short way~~, ~~and the long way. The long way requires copying an existing definition from one of the default lua files provided with an install of~~ Factorio, ~~and the short way just uses a~~ lua ~~function to copy and modify a definition~~. ~~For the sake of this tutorial, we'll do it the short way~~.		Зараз у Factorio є два способи створення прототипів: короткий і довгий шлях. Довгий шлях вимагає копіювання існуючого визначення з одного з файлів lua за замовчуванням, забезпечених установкою Factorio, а короткий шлях просто використовує функцію lua для копіювання та зміни визначення. В цьому посыбнику ми зробимо це коротким шляхом.
			В item.lua, зкопіюйте:
	In item.lua, ~~copy and paste the following~~:

	<pre style="background-color:#AAFFAA!important; color:black">		<pre style="background-color:#AAFFAA!important; color:black">
Line 248:		Line 247:
	</pre>		</pre>

	~~What we've just done here is we've copied the definition of heavy armor~~, ~~then changed it's properties, and injected it into the~~ Factorio ~~init with~~ data:extend. ~~The first line of code is probably the most interesting~~. <code>table.deepcopy</code> ~~copies a table fully into another table. We do this from~~ data.raw. ~~The~~ <code>data</code> ~~part is a table~~, ~~which will be used by game to setup the~~ Factorio ~~universe~~. ~~In fact, it contains the function~~ <code>extend(self,prototypes)</code> ~~and a table called~~ <code>raw</code>. ~~The former is customary way to add new stuff to the latter~~. ~~It is actually~~ data.raw ~~that holds the prototypes for the game~~. (~~You can view the implementation in the file~~ [https://github.com/wube/factorio-data/blob/master/core/lualib/dataloader.lua /factorio/data/core/lualib/dataloader.lua]). ~~It is important to note that~~ data.raw ~~only exists during the data loading stage of the game~~. ~~During the control stage~~, ~~when the game is running and being played~~, ~~you cannot read this data~~; ~~instead you read processed values through the~~ API ~~from the various types like~~ LuaEntityPrototype.		Ми скопіювали визначення важкої броні, потім змінили її властивості та ввели її в ініціалізацію Factorio з data:extend. Перший рядок коду, мабуть, найцікавіший. <code>table.deepcopy</code> повністю копіює таблицю в іншу з data.raw. <code>data</code> - це таблиця, яка буде використовуватися грою для налаштування всесвіту Factorio. Насправді він містить функцію <code>extend(self,prototypes)</code> та таблицю, яку називають <code>raw</code>. Перший - звичний спосіб додавання нових речей до другого. Фактично в data.raw описані усі прототипи для гри. (Ви можете переглянути реалізацію у файлі [https://github.com/wube/factorio-data/blob/master/core/lualib/dataloader.lua /factorio/data/core/lualib/dataloader.lua]). Важливо зазначити, що data.raw існує лише на етапі завантаження даних у грі. На етапі управління, коли гра працює, ви не можете прочитати ці дані; натомість ви читаєте оброблені значення через API з різних типів, таких як LuaEntityPrototype.

	~~In addition to defining the item prototype~~, ~~we also define a recipe for it~~. ~~This is necessary if you want to be able to craft the thing~~. ~~We also set it to enabled so it doesn't need a technology to unlock~~.		Окрім визначення прототипу елемента, ми також визначаємо його рецепт. Це необхідно, якщо ви хочете вміти зробити річ. Ми також встановлюємо його як увімкнене, для розблокування не потрібна технологія.

	~~At this point, the mod looks like~~ [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/2fc7dc944f5d523216762793f7c1bd31c6792b40 ~~this~~].		На даний момент мод виглядає [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/2fc7dc944f5d523216762793f7c1bd31c6792b40 приблизно так].

	=== More on data.raw ===		=== More on data.raw ===

Ucrij fender: /* info.json */

2020-03-15T17:09:45Z

info.json

← Older revision		Revision as of 17:09, 15 March 2020
Line 185:		Line 185:
	</pre>		</pre>

	Це досить простий файл, все, що ми робимо тут, - це лише змушуємо гру виконати файл під назвою item.lua в прототипах, який ми збираємося створити. Створіть у FireArmor_0.1.0 папку під назвою <code>prototypes</code>, потім всередині прототипів створіть файл під назвою <code>item.lua</code>. Ваш каталог мод тепер повинен[https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/cf505cf536e136bccef3d675bf2fc5648c659d97 виглядати так]:		Це досить простий файл, все, що ми робимо тут, - це лише змушуємо гру виконати файл під назвою item.lua в прототипах, який ми збираємося створити. Створіть у FireArmor_0.1.0 папку під назвою <code>prototypes</code>, потім всередині прототипів створіть файл під назвою <code>item.lua</code>. Ваш каталог мод тепер повинен [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/cf505cf536e136bccef3d675bf2fc5648c659d97 виглядати так]:
	* (каталог користувача)		* (каталог користувача)
	** mods		** mods

Ucrij fender: /* Туторіал */

2020-03-15T17:08:59Z

Туторіал

← Older revision		Revision as of 17:08, 15 March 2020
Line 185:		Line 185:
	</pre>		</pre>

	Це досить простий файл, все, що ми робимо тут, - це лише змушуємо гру виконати файл під назвою item.lua в прототипах, який ми збираємося створити. Створіть у FireArmor_0.1.0 папку під назвою <code>prototypes</code>, потім всередині прототипів створіть файл під назвою <code>item.lua</code>. Ваш каталог мод тепер повинен ~~відповідати~~ [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/cf505cf536e136bccef3d675bf2fc5648c659d97 ~~цим знімкам github~~].		Це досить простий файл, все, що ми робимо тут, - це лише змушуємо гру виконати файл під назвою item.lua в прототипах, який ми збираємося створити. Створіть у FireArmor_0.1.0 папку під назвою <code>prototypes</code>, потім всередині прототипів створіть файл під назвою <code>item.lua</code>. Ваш каталог мод тепер повинен[https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/cf505cf536e136bccef3d675bf2fc5648c659d97 виглядати так]:
			* (каталог користувача)
			** mods
			*** FireArmor_0.1.0
			**** data.lua
			**** info.json
			*** prototypes
			**** item.lua

	Зверніть увагу на зазначення каталогів та файлів.		Зверніть увагу на зазначення каталогів та файлів.

Ucrij fender at 17:06, 15 March 2020

2020-03-15T17:06:44Z

← Older revision		Revision as of 17:06, 15 March 2020
Line 146:		Line 146:

	{\| class="wikitable"		{\| class="wikitable"
	! ~~Item~~		! Об'єкт
	! ~~Explanation~~		! Пояснення
	\|-		\|-
	\| name		\| name
	\| ~~This is the internal name of your mod~~, ~~it is used to identify your mod in code~~.		\| Внутрішнє ім'я модифікації, воно використовується для ідентифікації вашого мода в коді.
	\|-		\|-
	\| version		\| version
	\| ~~This is the version of your mod~~. ~~This can be anything you want~~, ~~provided it's a number~~. ~~Some mods start at~~ 0.0.1 or 0.1.0, ~~while others follow~~ Factorio ~~versions and start at~~ 0.17.0 (~~for~~ Factorio ~~version~~ 0.17.x)		\| Версія модифікації. Це може бути все, що завгодно, за умови, що це числа розділені точками. Деякі моди починаються з 0.0.1 або 0.1.0, а інші слідують за версіями Factorio і починаються з 0.17.0 (для версії Factorio 0.17.x)
	\|-		\|-
	\| title		\| title
	\| ~~The pretty title of your mod~~, ~~this will be displayed on the mods screen and when you submit it to the mod portal~~.		\| Примітна назва вашого мода, це відображатиметься на екрані управління модифікаціями та під час надсилання його на портал модів.
	\|-		\|-
	\| author		\| author
	\| ~~Your name! You can change this in the example above~~.		\| Назвисько(nickname) або ім'я.
	\|-		\|-
	\| contact		\| contact
	\| ~~Put contact info here~~, ~~so someone can find you in the event of a problem~~.		\| Контактна інформація, щоб хтось міг знайти вас у разі проблеми.
	\|-		\|-
	\| homepage		\| homepage
	\| ~~The homepage of your mod, put a website here if you have one for the mod~~. ~~Not required~~.		\| Ваш власний веб-сайт свого мода. Не вимагається.
	\|-		\|-
	\| factorio_version		\| factorio_version
	\| ~~This tells the game what version the mod is for~~, ~~this must match the version you're developing the mod for~~, 0.17 ~~in this case~~.		\| Версія гри для якої призначений мод, вона повинна відповідати версії, для якої ви розробляєте мод, 0.17 в цьому випадку.
	\|-		\|-
	\| dependencies		\| dependencies
	\| ~~Any dependencies of your mod~~. ~~Some form of~~ "base" ~~should always be here~~, ~~so base gets loaded first~~.		\| Будь-які залежності вашого мода. "base" завжди мусить бути тут, тому база спочатку завантажується.
	\|-		\|-
	\| description		\| description
	\| A ''~~short~~'' ~~description of your mod.~~		\| ''Короткий'' опис модифікації
	\|}		\|}

	~~And that's all for~~ info.json! ~~Next, in the~~ data.lua ~~file~~:		І це все, щодо info.json! Наступний файл - це data.lua:

	<pre style="background-color:#AAFFAA!important; color:black">		<pre style="background-color:#AAFFAA!important; color:black">
Line 185:		Line 185:
	</pre>		</pre>

	~~It's a pretty simple file~~, ~~all we're doing here is just telling the game to execute the file called~~ item.lua ~~in prototypes~~, ~~which we're about to create~~. ~~Create a folder in~~ FireArmor_0.1.0 ~~called~~ <code>prototypes</code>, ~~then inside prototypes, create a file called~~ <code>item.lua</code>. ~~Your mod directory should now match~~ [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/cf505cf536e136bccef3d675bf2fc5648c659d97 ~~this~~ github ~~snapshot~~].		Це досить простий файл, все, що ми робимо тут, - це лише змушуємо гру виконати файл під назвою item.lua в прототипах, який ми збираємося створити. Створіть у FireArmor_0.1.0 папку під назвою <code>prototypes</code>, потім всередині прототипів створіть файл під назвою <code>item.lua</code>. Ваш каталог мод тепер повинен відповідати [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/cf505cf536e136bccef3d675bf2fc5648c659d97 цим знімкам github].

	~~Notice how our earlier require used the folder and file name in it?~~		Зверніть увагу на зазначення каталогів та файлів.

	=== Prototype creation ===		=== Prototype creation ===

← Older revision		Revision as of 07:31, 18 March 2020
Line 253:		Line 253:
	На даний момент мод виглядає [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/2fc7dc944f5d523216762793f7c1bd31c6792b40 приблизно так].		На даний момент мод виглядає [https://github.com/TheRealGangsir/FactorioModdingTutorial/tree/2fc7dc944f5d523216762793f7c1bd31c6792b40 приблизно так].

	=== ~~More on~~ data.raw ===		=== Більше data.raw ===

	~~When~~ Factorio ~~initializes~~, ~~all prototypes are put into a table called~~ data.raw. ~~This table holds all types~~, ~~and within those types~~, ~~individual entities. You saw earlier how we~~ deepcopied ~~from the definition of heavy armor, and modified some fields~~. ~~In fact, let's go over each part of the deepcopy line~~:		Коли Factorio ініціалізується, всі прототипи поміщаються в таблицю під назвою data.raw. Ця таблиця містить усі типи, а в межах цих типів - окремі сутності. Ви раніше бачили, як ми скопіювали(deepcopied) визначення важкої броні та змінили деякі поля. Насправді переглянемо кожну лінію коду:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 261:		Line 261:
	</pre>		</pre>

	~~We assign a~~ variable ~~called~~ fireArmor ~~that holds our copy of the heavy armor definition~~. ~~Notice how in~~ data.raw, ~~there is a type table that holds all armors~~, ~~and the specific armor we're looking for is called heavy-armor~~. ~~For example~~, ~~the player's prototype would be~~:		Ми призначаємо змінну(variable) під назвою fireArmor, яка містить нашу копію визначення важкої броні. Зауважте як у data.raw знаходиться таблиця типів, яка містить усі визначення броні, а конкретна броня, яку ми шукаємо, називається важкою бронею. Наприклад, прототипом гравця буде:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 267:		Line 267:
	</pre>		</pre>

	~~Because the player is ''the'' player~~, ~~his type matches his name~~. ~~You could define a new type of player with a mod~~. ~~You can see all the prototype fields for an entity in it's long declaration in the~~ Factorio ~~install~~, ~~at (Install)~~/data/base/prototypes.		Оскільки прототипом гравця(в лапках) є гравець, той тип відповідає його імені. Ви можете визначити новий тип гравця за допомогою модифікації. Ви можете побачити всі прототипи поля для сутності в її довгій декларації в програмі Factorio, за адресою /data/base/prototypes.

	~~You may be thinking at this point~~, "~~Can I modify~~ Factorio~~'s existing prototypes without making new ones~~?" ~~Well~~, ~~the answer is yes~~! ~~You would simply access the~~ data.raw ~~table during init~~, in data-final-fixes.lua~~, and change a property~~. ~~For example~~, ~~make the iron chest instead have~~ 1000 ~~health~~:		Ви, можливо, думаєте в цей момент: "Чи можу я змінити існуючі прототипи Factorio без створення нових?" Ну, відповідь - так! Ви просто отримаєте доступ до таблиці data.raw під час ініціадізації, у data-final-fixes.lua та зміните властивість. Наприклад, встановіть залізній скрині 1000 здоров'я:

	<pre style="background-color:#DDA0DD!important; color:black">		<pre style="background-color:#DDA0DD!important; color:black">
Line 275:		Line 275:
	</pre>		</pre>

	~~The reason why this code must be in~~ data-final-fixes.lua or data-updates.lua ~~is because that is the last file run~~, ~~after all mod files have been run~~. ~~This prevents~~ (~~to a degree~~) ~~your changes from being messed with by other mods~~. ~~Of course~~, ~~it is still possible to have incompatibilities~~. ~~You should note any that you know of in your mod's description~~. ~~Again, the~~ [http://lua-api.factorio.com/latest/Data-Lifecycle.html ~~dev's documentation~~] ~~on this should be looked at~~.		Причина, по якій цей код повинен бути у data-final-fixes.lua або data-updates.lua, полягає в тому, що це останній запуск файлу після запуску всіх файлів мод. Це запобігає (певною мірою) вашим змінам не змішуватись іншими модами. Звичайно, все-таки можливі несумісності. Ви повинні зазначити все, що вам відомо в описі вашого мода. Слід переглянути [http://lua-api.factorio.com/latest/Data-Lifecycle.html документацію розробника] про дані для більшої зрозумілості та точності.

	~~This can also be applied to other mods~~, ~~not just Factorio's base~~. ~~You could mod a mod~~, ~~as long as you add the mod~~ (~~that you modified with your mod~~) ~~to your dependencies so it gets loaded first~~.		Це також може бути застосоване до інших мод, а не лише до бази Факторио. Ви не можете модифікувати мод до тих пір, поки ви не додасте мод (який ви змінили своїм модом) до залежностей, щоб він завантажився першим.

	=== The control scripting ===		=== The control scripting ===