Wprowadzenie

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

Witaj w oficjalnej dokumentacji silnika Godot, darmowego i rozwijanego przez społeczność silnika do tworzenia gier 2D oraz 3D. Za tymi słowami stoi potężne, lecz przyjazne użytkownikowi narzędzie, dzięki któremu możesz stworzyć dowolny rodzaj gry, na dowolną platformę i bez żadnych ograniczeń.

Ta strona przedstawia obszerny opis możliwości silnika oraz zawartości dokumentacji. Dzięki temu dowiesz się, od czego zacząć, jeśli jesteś początkujący, lub gdzie szukać informacji, jeśli potrzebujesz wiedzy na konkretny temat.

Zanim zaczniesz

Strona Kursy i zasoby zawiera listę kursów wideo stworzonych przez społeczność. Jeśli wolisz materiały wideo zamiast tekstu, może warto się im przyjrzeć.

W przypadku wystąpienia problemów z tutorialami lub twoim projektem możesz znaleźć pomoc na wielu Kanałach społeczności, szczególnie na platformie Discord, Q&A, i IRC.

O silniku Godot

Silnik gry to złożone narzędzie, które trudno opisać w kilku słowach. Poniżej podajemy krótkie podsumowanie, z którego możesz swobodnie korzystać, jeśli chcesz szybko przedstawić czym jest Godot Engine.

Godot Engine to rozbudowany, wieloplatformowy silnik do tworzenia gier 2D i 3D z poziomu ujednoliconego interfejsu. Dzięki kompleksowemu zestawowi narzędzi, użytkownicy mogą skupić się na tworzeniu gier, bez konieczności odkrywania na nowo Ameryki. Ponadto, za pomocą jednego kliknięcia możesz wyeksportować projekt na wiele platform, w tym na najpopularniejsze systemy na komputery stacjonarne (Linux, macOS, Windows) i mobilne (Android i iOS), jak również platformę webową (HTML5).

Godot jest całkowicie darmowym i otwartym oprogramowaniem na bardzo liberalnej licencji MIT. Bez zobowiązań, opłat i niczego podobnego. Gry stworzone przez użytkowników są ich własnością, aż do ostatniej linii kodu silnika. Rozwój Godota jest w pełni niezależny i napędzany przez społeczność, dając użytkownikom możliwość modyfikacji silnika tak, aby spełniał ich oczekiwania. Jest on wspierany przez nie komercyjną organizację Software Freedom Conservancy.

Po więcej szczegółowych informacji zachęcamy do zapoznania się z dalszą dokumentacją, zwłaszcza z samouczkiem Krok po kroku.

O dokumentacji

Poniższa dokumentacja jest cały czas uzupełniana, poprawiana, edytowana i reorganizowana przez członków społeczności z użyciem plików tekstowych w języku reStructuredText, a następnie kompilowana do statycznej strony internetowej lub dokumentu offline przy pomocy narzędzi open source`Sphinx <http://www.sphinx-doc.org>`_ oraz ReadTheDocs .

Informacja

Możesz wspomóc dokumentację Godot'a poprzez otwieranie spraw lub wysyłanie aktualizacji poprzez pull request'y`na naszym repozytorium źródłowym na GitHub'ie <https://github.com/godotengine/godot-docs>`_, lub poprzez tłumaczenie go do twojego języka za pomocą Hosted Weblate.

Zawartość jest chroniona licencją Creative Commons Attribution 3.0 (CC-BY 3.0), z dopiskiem "Juan Linietsky, Ariel Manzur and the Godot Engine community".

Organizacja dokumentacji

Dokumentacja ta podzielona jest na pięć części o imponująco niezrównoważonej dystrybucji treści - ale sposób jej podziału powinien być stosunkowo intuicyjny:

  • Sekcja :ref:'sec-general' zawiera zarówno to wprowadzenie, jak i informacje na temat silnika, jego historii, jego licencjonowania, autorów itp. Zawiera także :ref:'doc_faq'.
  • Sekcja Jak rozpocząć jest głównym raison d'être tej dokumentacji, ponieważ zawiera wszystkie niezbędne informacje na temat korzystania z silnika do tworzenia gier. Rozpoczyna się od samouczka Krok po kroku, od którego nowi użytkownicy powinni zaczynać swoją przygodę z silnikiem Godot.
  • Sekcję Samouczki można czytać według potrzeb i w dowolnej kolejności. Znajduje się tu wiele samouczków i materiałów dotyczących poszczególnych funkcji.
  • Sekcja :ref:'sec-devel' jest przeznaczona dla zaawansowanych użytkowników i osoby wspierające rozwój silnika, zawiera informację kompilowania silnika, rozwoju modułów C++ lub edytorem pluginów.
  • W sekcji Społeczność dowiesz się, jak możesz wesprzeć rozwój silnika. Pokazuje m.in. w jaki sposób możesz zgłaszać błędy i pomagać tworzyć dokumentację. Podano tu również kilka dróg komunikacji ze społecznością, takich jak IRC i Discord, a także listę polecanych poradników niebędących częścią tej dokumentacji.
  • W końcu, klasa secass-ref opisuje Godot API, która jest również dostępna bezpośrednio w edytorze skryptów silnika. Jest ona generowana automatycznie z pliku w głównym repozytorium źródłowym, dlatego generowane pliki dokumentacji nie są przeznaczone do modyfikowania. Patrz Contributing to the class reference.

Oprócz tej dokumentacji możesz również rzucić okiem na różne `projekty - dema Godot'a <https://github.com/godotengine/godot-demo-projects> `_.

Miłej zabawy podczas czytania i tworzenia gier w silniku Godot!