Structure Gel API

API upraszczające tworzenie generowanych struktur od strony deweloperskiej.

Structure Gel to mod API zaprojektowany, aby ułatwić deweloperom tworzenie struktur, szczególnie tych korzystających z systemu jigsaw. Cały kod jest open source i udokumentowany. Niektóre z jego funkcji obejmują:

📚 Przeczytaj dokumentację Structure Gel API tutaj

Przykład open source tego API w działaniu znajdziesz w modzie Dungeons Plus.

Szczegółowe informacje o tym, jak tworzyć i używać tego API w zależności od wersji Minecrafta, znajdziesz poniżej.

Najnowsza dokumentacja

• https://gitlab.com/modding-legacy/structure-gel-api/-/blob/1.21.4/README.md?ref_type=heads

🧪 Najnowsze funkcje

🛠️ Narzędzia budowlane

Narzędzie budowlane to nowy przedmiot dostępny tylko w trybie kreatywnym, służący do wykonywania różnorodnych modyfikacji bloków na dużą skalę.

• Można je znaleźć w zakładce przedmiotów strukturalnych w trybie kreatywnym.
• Kliknij prawym przyciskiem myszy Narzędzie budowlane w powietrzu, aby otworzyć GUI. Po otwarciu możesz wybrać tryb, cofnąć, ponowić, ustawić pozycję i wiele więcej.

GUI

GUI zawiera różne przyciski do modyfikowania ustawień Narzędzia budowlanego, a także kilka przydatnych narzędzi.

• Naciśnięcie enter, e, escape lub kliknięcie w dowolne miejsce na ekranie, które nie jest przyciskiem, zamknie GUI.
• Najazd kursorem na dowolny element GUI spowoduje wyświetlenie podpowiedzi po prawej stronie, wyjaśniającej jego działanie i sposób użycia.
• Za pomocą menu radialnego możesz wybrać tryb, którego chcesz użyć.
• Niektóre tryby obsługują pozycje. Jeśli tak, w lewym górnym rogu pojawi się przycisk umożliwiający wybranie pozycji na podstawie twojej aktualnej lokalizacji. Jest to przydatne głównie wtedy, gdy kliknięcie prawym przyciskiem bloku jest niemożliwe lub bardzo niewygodne.
• Przyciski Cofnij i Ponów po lewej stronie służą do cofania lub ponawiania ostatniej czynności wykonanej Narzędziem budowlanym. Zapisanych i możliwych do cofnięcia jest do 32 czynności.
• Niektóre tryby mają dodatkowe ustawienia – pojawią się one poniżej przycisków Cofnij i Ponów.
• Przycisk na środku służy do wyboru bloku, którego chcesz użyć. Po kliknięciu otworzy się pole tekstowe, w którym możesz wpisać stan bloku. Można to zrobić również w grze, ale niektóre bloki, jak woda, są trudne do kliknięcia.

Sterowanie

• Środkowy przycisk myszy: Wybiera aktualny stan bloku, na który patrzysz (można to również zrobić w GUI).
• Lewy przycisk myszy: To ogólny klawisz do „wykonania czynności” w zależności od trybu, w którym się znajdujesz.
• Prawy przycisk myszy w powietrzu: Otwiera GUI.
• Prawy przycisk myszy na bloku: Niektóre tryby używają go do ustawiania pozycji, ale te, które tego nie robią, również pozwalają na „wykonanie czynności”.
• Shift + Prawy przycisk myszy: Czyści aktualnie wybrane pozycje.

Tryby

Tryby Narzędzia budowlanego to różne operacje, które może ono wykonywać.

• Rozszerzanie: Wykrywa wzór na podstawie strony klikniętego bloku i próbuje umieścić bloki przed nim, kontynuując ten wzór. Jeśli znasz stary mod Builder's Wands, to w zasadzie ten sam pomysł.

• Zalewanie: Wypełnia wszystkie bloki powietrza w obrębie warstwy Y, którą klikniesz, aż do napotkania granicy, a następnie kontynuuje wypełnianie w dół. Przydatne na przykład do wypełniania jeziora wodą.

• Wypełnianie: Bardzo podobne do standardowej komendy fill. Wybierz dwa rogi, a następnie kliknij lewym przyciskiem, aby wypełnić obszar między nimi aktualnie wybranym blokiem. Posiada opcje zastępowania konkretnych bloków oraz umieszczania tylko ramy lub pustego pudełka.

• Linia: Umieszcza linię bloków między wybranymi pozycjami, używając aktualnie wybranego bloku.

• Klonowanie: Kopiuje zaznaczony region i wkleja go w miejscu kliknięcia. Umożliwia obracanie, odbicie lustrzane i wycinanie zamiast kopiowania.

• Przesuwanie: Przesuwa zaznaczony region w kierunku, w którym uderzasz.

• Czyszczenie: Usuwa wszystkie bloki w obrębie wybranych pozycji.

• Kształt: Umieszcza kształt w miejscu kliknięcia. Kształt i zastępowane bloki można zmienić za pomocą właściwości trybu w GUI.

Właściwości trybów

Niektóre tryby obsługują dodatkowe ustawienia modyfikujące ich działanie. Przykłady:

• Integralność: Określa, ile bloków faktycznie zostanie umieszczonych.
• Zastąp: Określa, co tryb zastąpi podczas umieszczania bloków. Wszystko zastępuje wszystko, Powietrze zastępuje tylko powietrze, a Kliknięte zastępuje blok, który kliknąłeś.
• Obrót i Odbicie lustrzane: Obraca lub odbija lustrzanie sklonowany region. Umożliwia również wybór losowej wartości.

🍡 Blok żelu strukturalnego

Ten blok to narzędzie kreatywne do łatwego wypełniania wnętrz struktur. Żel jest zastępowany powietrzem podczas generowania struktury, a całe powietrze jest ignorowane podczas umieszczania. Dzięki temu twoje struktury nie będą miały naturalnego terenu tam, gdzie nie powinien się znajdować. Blok żelu zachowuje się podobnie do pustek strukturalnych – możesz przez niego przechodzić, ale jest widoczny.

Umieszczając żel podczas kucania, możesz uruchomić mechanizm rozprzestrzeniania. Każdy żel rozprzestrzenia się inaczej – sposób działania możesz sprawdzić, najeżdżając kursorem na przedmiot.

🍮 Poznaj żele!

🟥 Czerwony żel

Czerwony żel używa domyślnego mechanizmu rozprzestrzeniania – rozchodzi się wzdłuż kierunków kardynalnych, zastępując tylko powietrze.

🟦 Niebieski żel

Niebieski żel działa podobnie do czerwonego, z tą różnicą, że nie rozprzestrzenia się w miejsca, w których widoczne jest niebo.

🟩 Zielony żel

Zielony żel rozprzestrzenia się tak samo jak czerwony, z dodatkiem rozchodzenia się po przekątnej. Pozwala to na przedostanie się przez rogi utworzone przez pnącza lub inne złożone konstrukcje. Uważaj, aby nie wyciekł poza twoją budowlę.

🟦 Cyjanowy żel

Cyjanowy żel działa jak połączenie zielonego i niebieskiego – rozprzestrzenia się po przekątnej i unika nieba.

🟧 Pomarańczowy żel

Pomarańczowy żel zachowuje się jak czerwony, ale odległość, na jaką się rozprzestrzenia, zależy od tego, ile trzymasz go w ręce podczas umieszczania. Jest przydatny do budowli na otwartych przestrzeniach.

🟨 Żółty żel

Żółty żel rozprzestrzenia się tylko wzdłuż płaszczyzny, w którą jesteś zwrócony podczas umieszczania. Świetnie nadaje się do uszczelniania ścian, okien lub innych otworów, przez które żel mógłby się przedostać.

Usuwanie żeli

Żel można usunąć, używając na nim prochu strzelniczego. Spowoduje to reakcję łańcuchową, usuwającą wszystkie połączone żele tego samego typu.

Przykłady

Oto przykład, jak można go użyć w budowli. Gdyby ta struktura została załadowana do gry, żel w środku zostałby zastąpiony powietrzem, a powietrze na zewnątrz nie zostałoby umieszczone.

Kod tego bloku został zaprojektowany w taki sposób, że możesz go łatwo rozszerzyć i podpiąć się pod jego zachowanie za pomocą metod w blokach.IStructureGel, jeśli potrzebujesz zachowania, które nie zostało jeszcze zaimplementowane.

Jest to mod podstawowy, który modyfikuje kilka wewnętrznych klas. Jeśli wystąpi crash z tym modem, który pojawia się tylko w połączeniu z innym modem, może to być przyczyną. Przed zgłoszeniem problemu przetestuj.

🌐 Tłumacz Structure Gel API – pomóż przełamać barierę językową!

Wszyscy tłumacze są tutaj wymienieni. Dzięki OneSkyApp możesz łatwo tłumaczyć!

Tłumaczenia na Deutsch: A1403, Barion
Tłumaczenia na Português (Brasil): gabisaoo, simsgameboh
Tłumaczenia na Nederlands (Nederland): faas.mr
Tłumaczenia na Español (España): Minaderm, guillermojuegostablet, juggernogk
Tłumaczenia na Українська (Ukrayins'ka): Queez
Tłumaczenia na Türkçe (Türkiye): asimemir58, demirgokler406
Tłumaczenia na עברית ('Ivriyþ): pecan1245
Tłumaczenia na Español (Argentina): patriciofagetti
Tłumaczenia na Italiano (Italia): antonioauciello226
Tłumaczenia na Lietuvių: WaryRGMCA