Вступ

func _ready():
    $Label.text = "Hello world!"

Ласкаво просимо в офіційну документацію Godot Engine, безплатного та керованого спільнотою з відкритим сирцевим кодом 2D та 3D-ігровим рушієм! За цим описом, ви знайдете потужний, але дружній до користувача інструмент, який ви можете використовувати для розробки будь-якої гри на будь-якій платформі і без будь-яких обмежень використання.

Ця сторінка дає загальне уявлення про Godot та вміст цієї документації, щоб ви знали, з чого почати, якщо ви є новачком, або де шукати, якщо вам потрібна інформація про певну функцію.

Перед початком

Сторінка Посібники та ресурси перераховує відеоуроки, надані спільнотою. Якщо ви надаєте перевагу відео, а не тексту, то, можливо, варто на неї глянути.

Якщо у вас виникнуть проблеми з одним з уроків, або з вашим проєктом, то ви зможете знайти допомогу на різних Каналах спільноти, особливо у спільноті Godot Discord, запитаннях та відповідях (Q&A) і IRC.

Про Godot Engine

Ігровий рушій є складним інструментом, і тому важко описати Godot кількома словами. Тут невелике резюме, яке ви можете вільно використовувати, якщо вам потрібний короткий опис Godot Engine.

Godot Engine - це багатофункціональний, багато-платформовий ігровий рушій для створення 2D та 3D-ігор з уніфікованим інтерфейсом. Він надає повний набір загальних інструментів, завдяки чому користувачі можуть зосередити увагу на створенні ігор без необхідності винаходити колесо. Ігри можна експортувати одним клацанням на декілька платформ, включаючи основні настільні платформи (Linux, macOS, Windows), а також мобільні пристрої (Android, iOS) та вебплатформи (HTML5).

Godot є повністю безплатним, з відкритим кодом під ліцензією MIT. Без будь-яких платежів, відрахувань, і тому подібного. Ігри користувачів є їхніми, до останнього рядка коду рушія. Розвиток Godot є цілком незалежним і керованим спільнотою, що дозволяє користувачам формувати свій рушій відповідно до їхніх очікувань. Це підтримується некомерційною організацією Software Freedom Conservancy.

Для глибшого огляду рушія рекомендується прочитати цю документацію, зокрема посібник Крок за кроком.

Про документацію

Ця документація постійно пишеться, коректується, редагується та перекроюється членами спільноти Godot Engine. Вона редагується за допомогою текстових файлів на мові розмітки reStructuredText, а потім укладається у статичний вебсайт/автономний документ за допомогою інструментів з відкритим вихідним кодом Sphinx та ReadTheDocs.

Примітка

Ви можете зробити свій внесок у документацію Godot, повідомляючи про проблеми, або надсилаючи поправки, через "pull requests" у репозиторії GitHub, або перекладаючи її на свою мову на Hosted Weblate.

Весь вміст знаходиться під дозвільною ліцензією Creative Commons Attribution 3.0 (CC-BY 3.0), із зазначенням авторства "Juan Linietsky, Ariel Manzur та Godot Engine спільноти ".

Організація документації

Ця документація складається з п'яти розділів з суттєво незбалансованим розподілом змісту, але спосіб його розбиття має бути відносно інтуїтивним:

  • Розділ About містить цей вступ, а також інформацію про рушій, його історію, ліцензування, авторів тощо. Він також містить Поширені запитання.

  • Розділ Перші кроки є головною raison d'être (причиною існування) цієї документації, оскільки містить всю необхідну інформацію про використання рушія для створення ігор. Він починається з посібника Крок за кроком, який повинен бути точкою входу для всіх нових користувачів.

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

  • Розділ Розробка призначений для досвідчених користувачів і учасників розробки рушія, з інформацією про компіляцію рушія, розробці модулів мовою C++ або плаґінів редактора.

  • Розділ Спільнота надає інформацію, що стосується сприяння розвитку рушія та життя його спільноти, наприклад, як повідомити про помилки, допомогти з документацією, тощо. Він також вказує на різні канали спільноти, такі як IRC та Discord, і містить список рекомендованих сторонніх навчальних посібників за межами цієї документації.

  • Наприкінці Довідник з класів - це документація Godot API, яка також доступна безпосередньо в редакторі скриптів рушія. Вона автоматично генерується з файлу в головному репозиторії коду, тому згенеровані файли документації не повинні бути змінені. Див. Contributing to the class reference для подробиць.

Окрім цієї документації, ви також можете поглянути на різні демонстраційні проєкти "Godot".

Веселого читання і створення ігор з Godot Engine!