Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Metody wspierania¶

Godot Engine jest projektem non profit, kierowanym przez społeczność, wolnym i otwarto-źródłowym. Prawie wszyscy (oprócz głównego dewelopera Juana, więcej na ten temat poniżej) deweloperzy pracują pro bono w swoim czasie wolnym, z osobistego zainteresowania i z miłości do tworzenia wolnego i otwartego silnika o wyjątkowej jakości.

Oznacza to, że aby dobrze się rozwijać, Godot potrzebuje jak największej liczby użytkowników zaangażowanych we wspieranie silnika. Istnieje wiele sposobów, aby pomóc w tak dużym projekcie, dzięki czemu każdy będzie mógł wnieść do silnika coś pozytywnego, niezależnie od zestawu swoich umiejętności:

Bądź częścią społeczności. Najlepszym sposobem, aby przyczynić się do rozwoju Godota i pomóc mu stać się jeszcze lepszym jest po prostu używanie silnika i promowanie go ustnie, w napisach końcowych lub ekranie powitalnym Twoich gier, w postach na blogu, poradnikach, materiałach wideo, demach, na wydarzeniach związanych z gamedevem lub wolnym oprogramowaniem, poprzez wsparcie w Q&A, na forach, Czacie Wspierających, Discordzie, itp. Dołącz do nas! Bycie użytkownikiem i zwolennikiem pomaga rozpowszechniać informacje na temat naszego wspaniałego silnika, który nie ma budżetu na marketing i dlatego może polegać tylko na swojej społeczności, aby stać się bardziej popularnym.
Twórz gry. Nie jest tajemnicą, że aby przekonać nowych użytkowników, a w szczególności ogólnie pojętą branżę, że Godot jest istotnym graczem na rynku, potrzebujemy świetnych gier zrobionych w Godocie. Wiemy, że silnik ma duży potencjał, zarówno dla gier 2D jak i 3D, ale biorąc pod uwagę jego młody, wiek wciąż brakuje nam dużych produkcji, które zwrócą uwagę na Godota. Kontynuuj więc prace nad Twoimi wspaniałymi projektami, każda nowa gra zwiększa naszą wiarygodność na rynku gier!
Zaangażuj się w rozwój silnika. Może to być poprzez dodawanie kodu przez pull requesty, testowanie wydań deweloperskich lub bezpośrednio gałęzi master z gita, zgłaszanie błędów lub sugerowanie ulepszeń w issue trackerze, ulepszanie oficjalnej dokumentacji (zarówno referencji klas jak i poradników) oraz jej tłumaczeń. Kolejne sekcje obejmują każdy z tych "bezpośrednich" sposobów wspierania silnika.
Wesprzyj finansowo. Godot jest projektem non profit, ale do wielu rzeczy nadal może korzystać z darowizn od użytkowników. Poza zwykłymi wydatkami, takimi jak koszty hostingu lub materiały promocyjne na wydarzeniach, w razie potrzeby wykorzystujemy również pieniądze z darowizn do nabycia sprzętu (np. użyliśmy darowizn na zakup MacBooka Pro w celu wdrożenia obsługi Retina/HiDPI i różnych innych funkcji związanych z macOS). Co najważniejsze, pieniądze z darowizn przeznaczyliśmy również na zatrudnienie kluczowych deweloperów, aby mogli oni pracować przy silniku na pełnym etacie. Nawet przy niskich miesięcznych płacach, potrzebujemy stałego dochodu z darowizn, aby nadal tak robić, co do tej pory było dla projektu bardzo korzystne. Jeśli więc chcesz przekazać trochę pieniędzy na projekt, sprawdź naszą stronę, aby znaleźć więcej szczegółów.

Pisanie kodu silnika¶

Możliwość studiowania, używania, modyfikacji i redystrybucji modyfikacji kodu źródłowego silnika to fundamentalne prawa, które daje Ci licencja MIT Godota, czyniąc go wolnym i otwartym oprogramowaniem.

Skoro tak, to każdy jest uprawniony do modyfikacji kodu źródłowego Godota, oraz wysyłania tych modyfikacji z powrotem do pierwotnego projektu, w formie patcha (pliku tekstowego opisującego zmiany w gotowy do zastosowania sposób), lub - we współczesnym cyklu pracy, który wykorzystujemy - przez tak zwany "pull request" (PR), np. propozycję bezpośredniego połączenia jednego lub więcej commitów Gita (patchy) z główną gałęzią deweloperską.

Pisanie oficjalnych zmian w kodzie silnika ma dwie duże zalety:

Twój własny kod będzie zrewidowany i ulepszony przez innych deweloperów i będzie dalej utrzymywany już bezpośrednio w głównym projekcie, więc nie będziesz musiał ponownie aplikować swoich własnych zmian za każdym razem, kiedy przenosisz się do nowszej wersji. Z drugiej strony wiąże się to z odpowiedzialnością, jako że Twoje zmiany muszą być wystarczająco ogólne, aby były przydatne dla wszystkich użytkowników, a nie tylko dla Twojego projektu; więc w pewnych wypadkach wciąż może być właściwe zachowanie swoich zmian tylko do własnego projektu, jeśli są one zbyt specyficzne.
The whole community will benefit from your work, and other contributors will behave the same way, contributing code that will be beneficial to you. At the time of this writing, over 2,000 developers have contributed code changes to the engine!

Aby zapewnić dobrą współpracę i ogólną jakość, twórcy Godota narzucają pewne zasady dotyczące pisania kodu, na przykład odnośnie stylu używanego w C++ (wcięcia, nawiasy itp.) lub sposobu pracy z Git i PR.

Dobry sposób, aby zacząć to wyszukanie na GitHubie problemów oznaczonych jako good first issue.

Zobacz także

Szczegóły techniczne na temat sposobu pracy z PR nakreślone są w odrębnej sekcji, Pull request workflow.

Szczegóły na temat wytycznych stylu kodu oraz narzędzia clang-format używanego do ich egzekwowania są nakreślone w sekcji Styl pisania kodu źródłowego Godota.

Wszystkie pull requesty, zanim zostaną zaakceptowane, muszą przejść przez proces rewizji. Zależnie od zakresu zmian, dokonanie przeglądu osobie odpowiedzialnej za zmodyfikowaną część silnika może zająć trochę czasu. Tymczasem cenimy wszystkich naszych wspierających i prosimy ich o cierpliwość, ponieważ można się spodziewać, że w projekcie otwarto-źródłowym, takim jak Godot, będzie dużo więcej wspierających, niż ludzi ich sprawdzających.

Aby upewnić się, że Twój czas i wysiłek nie pójdzie na marne, zaleca się najpierw zweryfikować pomysł przed jego implementacją i umieścić go do recenzji jako PR. W tym celu Godot posiada system propozycji. Zachęca się do jego użycia w celu zaplanowania zmian i omówienia ich ze społecznością. Na Czacie Wspierających Godota można także przedyskutować z innymi wspierającymi szczegóły implementacyjne.

Informacja

Propozycje są wymagane tylko w przypadku pracy nad udoskonaleniami i nową funkcjonalnością. W celu naprawy problemów wystarczą zgłoszenia błędów.

Testowanie i zgłaszanie problemów¶

Innym świetnym sposobem na udoskonalenie silnika jest testowanie wersji rozwojowych lub gałęzi rozwojowej i zgłaszanie problemów. Pomocne jest również zgłaszanie problemów wykrytych w stabilnych wersjach, tak aby w gałęzi rozwojowej i przyszłych wersjach użytkowych można je było naprawić.

Testowanie wersji deweloperskich¶

Masz kilka możliwości by pomóc z testowaniem:

Skompiluj samodzielnie silnik ze źródła, postępując zgodnie z instrukcjami dla Twojej platformy na stronie Kompilowanie.
Testuj oficjalne przedpremierowe wydania tuż po ich ogłoszeniu (zazwyczaj na blogu i innych platformach społecznościowych), takie jak kompilacje alfa, beta i kandydaci do wydania (RC).
Testuj "zaufane" nieoficjalne kompilacje gałęzi rozwojowej; po prostu zapytaj członków społeczności o wiarygodnych dostawców. Jeśli to tylko możliwe, najlepiej jest użyć oficjalnych plików binarnych lub jednak skompilować samemu, aby mieć pewność ich pochodzenia.

Jak wspomniano poprzednio, dobrze jest także mieć oczy szeroko otwarte na potencjalne błędy, które wciąż mogą być obecne w stabilnych wersjach, zwłaszcza podczas używania jakichś niszowych funkcjonalności silnika, które mogą być słabiej przetestowane przez deweloperów.

Zgłaszanie problemu na GitHubie¶

Godot uses GitHub's issue tracker for bug reports. When you start filing a bug report, you’ll be given a form to fill out. Please try to follow it so that all issues are consistent and provide the required information.

Wspieranie dokumentacji¶

W Godocie istnieją dwa oddzielne zasoby zwane "dokumentacją":

The class reference. This is the documentation for the complete Godot API as exposed to GDScript and the other scripting languages. It can be consulted offline, directly in Godot's code editor, or online at Godot Class Reference. To contribute to the class reference, you have to edit the XML file corresponding to the class and make a pull request. See Contributing to the class reference and Class reference primer for more details.
Poradniki i dokumentacja silnika oraz ich tłumaczenia To ta część, którą teraz czytasz, a która jest rozpowszechniana w formacie HTML. Jej zawartość jest generowana z plików tekstowych w formacie reStructured Text (rst), do których rozwoju możesz się przyczynić poprzez pull requesty w repozytorium GitHuba godot-docs. Po więcej szczegółów zajrzyj do sekcji doc_documentation_guidelines.

Wspieranie tłumaczeń¶

By uczynić Godota dostępnym dla wszystkich, włączając użytkowników, którzy mogą preferować zasoby w swoim ojczystym języku a nie w angielskim, nasza społeczność pomaga tłumaczyć na wiele języków zarówno edytor Godota jaki i jego dokumentację.

Więcej szczegółów znajdziesz w sekcji Editor and documentation localization.