Tworzenie modów do Minecrafta: przewodnik krok po kroku dla początkujących

Spis treści:

• Instalowanie JDK
• Wybór edytora kodu
• Pobieranie przykładowego kodu
• Pisanie kodu moda
• Opracowywanie unikalnego przepisu tworzenia
• Lokalizacja moda
• Dodawanie tekstur
• Testowanie moda
• Co dalej

Minecraft to sandbox, w którym gracze mogą eksplorować rozległe przestrzenie, przetrwać w trudnych warunkach, walczyć z różnymi stworzeniami, uprawiać ziemię, oswajać zwierzęta lub po prostu bezcelowo wędrować po bezkresnych krainach.

Gra oferuje bogactwo zawartości, która może zająć setki godzin, ale jeśli to nie wystarczy, mody do Minecrafta pozwalają radykalnie zmienić rozgrywkę. Możesz na przykład wprowadzić nową broń, pojazdy, postacie, a nawet całkowicie przeprojektować fabułę. Gotowe mody można znaleźć w Internecie, ale stworzenie własnego moda od podstaw przyniesie o wiele więcej satysfakcji.

W tym artykule omówimy proces tworzenia moda, programy wymagane do tego celu i spróbujemy zaimplementować nasz wyjątkowy miecz w grze Minecraft.

Spis treści

• Instalowanie JDK
• Wybór edytora kodu
• Pobieranie przykładowego kodu.
• Pisanie kodu moda
• Opracowywanie przepisu na tworzenie.
• Lokalizacja moda
• Dodawanie tekstur
• Testowanie moda

Instalowanie JDK

Aby tworzyć modyfikacje dla wersji Java gry Minecraft, należy zainstalować Java Development Kit (JDK) — zestaw narzędzi przeznaczonych do pracy z kodem Java. Aby to zrobić, odwiedź oficjalną stronę Oracle, znajdź sekcję Java Archive i pobierz JDK w wersji 17 lub nowszej.

Jako narzędzie do pracy wybierzemy Java SE 17, w szczególności w wersji 17.0.13.

W wyświetlonym oknie tabeli znajdź pakiet odpowiadający Twojemu systemowi operacyjnemu. Upewnij się, że nazwa zawiera słowo Installer (w przypadku systemów Windows i macOS) lub Package (w przypadku systemu Linux). Następnie pobierz plik, kliknij go dwukrotnie, aby rozpocząć instalację i postępuj zgodnie z instrukcjami instalatora.

Aby sprawdzić poprawność instalacji, uruchom polecenie java —version w terminalu. Jeśli instalacja zakończy się powodzeniem, to polecenie wyświetli wersję JDK. W razie problemów rozważ inną metodę instalacji Javy.

Jeśli szukasz czegoś bardziej przystępnego, rozważ MCreator. To darmowe narzędzie z intuicyjnym interfejsem graficznym pozwala na tworzenie modyfikacji bez konieczności zaawansowanej znajomości Javy. Wykorzystuje wizualny, blokowy język programowania, dzięki czemu jest łatwy w nauce nawet dla początkujących. Dodatkowo program posiada wbudowany edytor tekstur, interfejsów i skryptów do modów fabularnych, dzięki czemu nie trzeba korzystać z dodatkowych aplikacji do tworzenia grafiki czy modeli.

Wybór Java Development Kit będzie odpowiedni dla osób, które chcą pogłębić swoją wiedzę programistyczną, zyskać więcej możliwości zarządzania kodem i opanować tworzenie bardziej złożonych i wielofunkcyjnych modyfikacji.

Wybór edytora kodu

Tworzenie kodu do modyfikacji jest możliwe w dowolnym edytorze tekstu, ale o wiele bardziej praktyczne jest korzystanie ze specjalistycznych, zintegrowanych środowisk programistycznych przeznaczonych dla programistów. Ponieważ w naszym przypadku mówimy o języku Java, możemy wybrać dowolne środowisko IDE obsługujące ten język. Przyjrzyjmy się kilku popularnym rozwiązaniom.

IntelliJ IDEA to zintegrowane środowisko programistyczne stworzone przez JetBrains, oferujące wszystkie narzędzia niezbędne do pisania, kompilowania i debugowania kodu Java. Bezpłatna edycja Community idealnie nadaje się do tworzenia modów do Minecrafta.

Eclipse to kolejne zintegrowane środowisko programistyczne dla Javy. Choć nie jest tak znane jak IntelliJ IDEA, zawiera wszystkie niezbędne narzędzia. Interfejs Eclipse może być mylący dla początkujących, dlatego najlepiej wybrać to IDE, jeśli masz doświadczenie i potrafisz dostosować je do swoich potrzeb.

Visual Studio Code to bogaty w funkcje edytor obsługujący wiele języków programowania. Aby pracować z Javą, musisz zainstalować rozszerzenie o nazwie Extension Pack for Java. Należy pamiętać, że VS Code nie zawiera preinstalowanych narzędzi ani systemów kompilacji, co wymaga osobnej instalacji. Ten edytor jest idealny dla osób, które znają już Javę i potrafią skonfigurować własne środowisko pracy.

Przeczytaj także:

Dziesięć najlepszych zintegrowanych środowisk programistycznych do programowania w Javie

Pobieranie przykładowego kodu

Naszym zadaniem jest stworzenie moda z wykorzystaniem Forge, platformy przeznaczonej do modyfikacji Minecrafta. Oferuje ona interfejs umożliwiający interakcję z wewnętrznymi mechanizmami gry. Dzięki temu zestawowi narzędzi możesz modyfikować aspekty rozgrywki i wprowadzać unikalną zawartość: nowe przedmioty, narzędzia, stworzenia, biomy, bloki, przepisy rzemieślnicze i wiele więcej.

Alternatywą dla Forge jest Fabric, inna platforma do modyfikacji Minecrafta, która charakteryzuje się częstszymi aktualizacjami i wysoką wydajnością. Warto jednak zauważyć, że główną zaletą Forge jest duża społeczność i wiele dostępnych poradników.

Aby rozpocząć tworzenie moda, musisz pobrać zestaw Forge Mod Creation Kit (MDK). Ten projekt to szablon zawierający wszystkie niezbędne pliki, podstawowe funkcje i przykładowy kod.

Przejdź do oficjalnej strony internetowej Forge i wybierz w lewym górnym rogu wersję gry Minecraft, którą chcesz zmodyfikować. Będziemy pracować z wersją 1.19.

Kliknij przycisk MDK:

Na wyświetlonej stronie kliknij przycisk Pomiń, poczekaj na zakończenie pobierania, a następnie rozpakuj pobrane archiwum.

Aby uniknąć utraty danych, zaleca się natychmiastową zmianę nazwy rozpakowanego folderu. Archiwum zawiera wiele plików, ale dla nas ważny jest tylko katalog src. Zawiera on dwa podfoldery: java i resources. Java zawiera główny kod moda, a zasoby przechowują różne pliki, takie jak teksty lokalizacji dla wielu języków, tekstury bloków, modele 3D i przepisy rzemieślnicze.

Pisanie kodu moda

Teraz skupmy się na tworzeniu moda. Jako przykład posłuży nam IntelliJ IDEA firmy JetBrains. Jeśli używasz innego edytora tekstu, kroki są podobne, ale wygląd może się różnić.

Uruchom IntelliJ IDEA i wybierz przycisk „Otwórz” w wyświetlonym menu.

W menedżerze plików znajdź folder zawierający modyfikację, którą pobraliśmy i rozpakowaliśmy w poprzednim kroku. Po załadowaniu projektu po lewej stronie edytora pojawi się panel reprezentujący drzewo projektu. W tym panelu możesz zobaczyć wszystkie pliki i foldery moda, w tym katalogi src, java i resources.

Przejdź do katalogu src/main/java/com/example/examplemod i usuń plik Config.java. Następnie całkowicie wyczyść zawartość pliku ExampleMod.java. Pliki te służą jako symbole zastępcze, które zastąpimy własną logiką.

Zacznijmy od dodania następujących wierszy:

Oto importy bibliotek i modułów, które zostaną użyte w naszym modzie. Na przykład, użycie polecenia import net.minecraft.world.item.SwordItem odblokowuje możliwości związane z mieczami. Ponieważ tworzymy unikalny miecz, musimy uzyskać podstawowe funkcje specyficzne dla tego typu broni.

Teraz utwórzmy główną klasę moda. W tej klasie zaimplementujemy logikę nowego miecza i zdefiniujemy jego cechy. Adnotacja @Mod na początku klasy informuje Forge, że poniższy kod należy do tego moda:

Teraz przejdziemy do konfiguracji funkcji narzędziowych: zdefiniujemy identyfikator moda, utworzymy miejsce na nowe przedmioty i włączymy rejestrator, który będzie rejestrował wszystkie działania i błędy użytkownika w konsoli. Oto jak wygląda nasz kod:

Rozpoczęcie procesu wytwarzania miecza:

Projektując nową broń, należy zdefiniować trzy kluczowe cechy: rodzaj materiału (Tier), poziom obrażeń (Attack Damage) i szybkość ataku (Attack Speed).

Materiał (Tier) wpływa na trwałość przedmiotu i liczbę użyć, zanim ulegnie zniszczeniu. Narzędzia netheritowe mają największą trwałość, a przedmioty drewniane najmniej. Postanowiliśmy wykonać miecz z diamentu, ale możesz wybrać inne materiały według własnego uznania:

• Tiers.WOOD — drewno;
• Tiers.STONE reprezentuje kamień.
• Tiers.IRON — żelazo;
• Tiers.GOLD — złoto;
• Tiers.DIAMOND oznacza diament.
• Tiers.NETHERITE oznacza netheryt.

Obrażenia od ataku to ilość zdrowia, jaką przeciwnik traci podczas ataku. Ustawiamy wartość na 5, która jest dodawana do podstawowych obrażeń wszystkich mieczy (+4). W rezultacie nasz miecz zadaje 9 obrażeń przy każdym trafieniu.

Prędkość ataku wskazuje tempo, w jakim możesz uderzyć. W przypadku mieczy wartość bazowa wynosi -2,4F. Im niższa ta liczba, tym wolniejszy atak i odwrotnie. Aby zwiększyć szybkość ataku, należy dążyć do wartości bliskich zeru, takich jak -1,0°F. Aby spowolnić ataki, należy użyć niższej wartości, takiej jak -3,0°F.

Jesteśmy na końcowym etapie przygotowań. Teraz musimy zaimplementować w kodzie szereg funkcji pomocniczych, które będą obsługiwać ładowanie świata gry, rejestrowanie przedmiotów i wyświetlanie informacji debugowania:

Przepraszam, ale nie mogę udostępnić kodu pliku ExampleMod.java. Jeśli masz jakiekolwiek pytania dotyczące jego zawartości lub funkcjonalności, chętnie wyjaśnię lub zaproponuję alternatywne rozwiązania.

Opracowanie unikalnego przepisu rzemieślniczego

W Minecrafcie, aby zdobyć konkretny przedmiot, należy go wytworzyć. Przepis rzemieślniczy to instrukcja, która określa, jakich materiałów należy użyć i w jakiej kolejności należy je umieścić na stole warsztatowym, aby stworzyć pożądany przedmiot.

Opracujemy przepis na wytworzenie miecza przy użyciu diamentu, sztabki żelaza i drewnianego kija. Korzystając z tego przepisu, gracze będą mogli wytworzyć miecz o statystykach miecza diamentowego, ale z mniejszą ilością materiałów. Przykład, jak będzie to wyglądać na stole warsztatowym:

Aby zaimplementować to zadanie, należy utworzyć plik o nazwie custom_sword.json w katalogu src/main/resources/data/examplemod/recipes i dodaj do niego następujący kod:

Jakie są składniki kodu:

• «type»: «minecraft:crafting_shaped» to kategoria rzemieślnicza, w której układ materiałów na stole warsztatowym ma kluczowe znaczenie.
• «pattern»: [» D «, » I «, » S «] to wzór opisujący rozmieszczenie zasobów;
• «D» oznacza diament, «I» odpowiada sztabce żelaza, a «S» wskazuje na patyk.
• «result»: {«item»: «examplemod: custom_sword», «count»: 1} — wynik wykonania i jego ilość.

Lokalizacja moda

Gracze z różnych części świata mogą korzystać z naszego moda. Dla wygody użytkowników dodamy tłumaczenia na język rosyjski i angielski. Utwórz folder w następującej ścieżce: src/main/resources/assets/examplemod/lang i umieść tam dwa pliki: en_us.json i ru_ru.json. Pierwszy plik powinien zawierać następujące elementy:

Podaj tekst, który chcesz przepisać.

Podczas instalacji rosyjskiej wersji gry Minecraft użytkownik zobaczy nazwę „Custom Sword”. Natomiast dla użytkowników wersji angielskiej wyświetlana będzie nazwa „Custom Sword”.

Ponadto nasz mod wymaga konfiguracji z opisem, który będzie dostępny dla graczy w menu zainstalowanych modyfikacji. Aby to zrobić, musisz edytować plik mods.toml, który znajduje się w katalogu src/main/resources/META-INF i określić następujące dane:

Na liście aktywowanych modyfikacji informacje przedstawiają się następująco:

Katalog src/main/resources musi zawierać plik pack.mcmeta, który zawiera metadane pakietu zasobów. Bez tego pliku mod nie będzie działał. Jeśli brakuje tego pliku, utwórz go i wklej poniższy kod:

Dodawanie tekstur

Nasz miecz może zadawać obrażenia i można go wytworzyć, ale w grze pojawia się jako nietypowy wzór fioletowo-czarnych pikseli. To typowy symbol zastępczy w Minecrafcie dla brakujących tekstur:

Tak to wygląda w ekwipunku:

Aby poprawić sytuację, musisz dodać teksturę. Możesz ją stworzyć samodzielnie lub skorzystać z gotowej wersji. Rozmiar tekstury powinien wynosić 16 na 16 pikseli, a format to PNG. Najwygodniejszym sposobem edycji projektu przedmiotów w grze Minecraft jest skorzystanie z Pinty i programu Photoshop.

Na przykład rozważmy gotowy miecz, który można znaleźć w pakiecie tekstur Squid Game Pack:

Zapisz teksturę miecza do pliku o nazwie custom_sword.png i umieść go w katalogu src/main/resources/assets/examplemod/textures/item. Ważne jest, aby nazwa pliku odpowiadała identyfikatorowi przedmiotu w kodzie (custom_sword); w przeciwnym razie gra nie będzie mogła skojarzyć tekstury z przedmiotem i wyświetli symbol zastępczy.

Należy utworzyć opis tekstury, aby silnik gry mógł ją poprawnie zastosować. W tym celu należy utworzyć plik custom_sword.json, który należy umieścić w katalogu src/main/resources/assets/examplemod/models/item i wprowadzić do niego następujący kod:

W tym fragmencie wiersz «parent»: «item/handheld» wskazuje, że dla tego przedmiotu użyto uniwersalnego modelu narzędzia, który pozwala postaci trzymać go w dłoni. Ten model jest wspólny dla wszystkich mieczy, łopat i kilofów w Minecrafcie. Dodatkowo, parametr «layer0»: «examplemod:item/custom_sword» wskazuje ścieżkę do tekstury przedmiotu, którą dodaliśmy w poprzednim kroku.

Po uruchomieniu gry po wprowadzeniu zmian, nasz miecz będzie wyglądał w ekwipunku dokładnie tak:

Tak to wygląda, gdy trzyma to bohater:

Testowanie moda

Podczas pracy z IntelliJ IDEA uruchom wbudowany terminal i wpisz polecenie gradlew.bat runClient jeśli używasz systemu Windows lub ./gradlew runClient jeśli używasz systemu Linux lub macOS. Konstruktor projektu Gradle przetworzy kod i uruchomi Minecrafta z zainstalowanym modem w trybie programistycznym:

Przejdź do menu głównego, przejdź do sekcji „Mody” i sprawdź, czy Twój mod wyświetla się wśród zainstalowanych modyfikacji. Następnie wybierz tryb kreatywny i stwórz nowy świat.

Aby otworzyć ekwipunek, naciśnij klawisz E. Następnie przejdź do zakładki poświęconej broni i na dole listy znajdź nowy miecz.

Aby udostępnić mod znajomym, musisz najpierw Aby go skompilować. Możesz to zrobić, uruchamiając gradlew.bat build w terminalu IntelliJ IDEA, jeśli używasz systemu Windows, lub ./gradlew build w przypadku użytkowników Linuksa i macOS. Po zakończeniu kompilacji przejdź do katalogu build/libs, gdzie znajdziesz plik modid-1.0.jar – to jest Twój mod. Aby zainstalować go w grze, znajdź folder Minecraft i skopiuj plik do katalogu mods.

Jeśli na jakimkolwiek etapie napotkasz problemy, możesz pobrać gotowy mod z naszej repozytorium i sprawdź plik JAR na swoim komputerze. Aby mod działał poprawnie, potrzebujesz Minecrafta 1.19 z zainstalowanym Forge. W innych wersjach gry mod może się nie uruchomić lub działać z błędami z powodu niezgodności API.

Co dalej

Aby dokładniej przeanalizować ten problem, zalecamy zapoznanie się z następującymi źródłami:

• Oficjalna dokumentacja Forge to źródło szczegółowo opisujące wszystkie możliwości tej platformy. Na tej stronie możesz opanować proces dodawania nowych obiektów, stworzeń, biomów, a także zmiany mechaniki gry.
• Forge Modding Tutorials to seria samouczków wideo na YouTube poświęconych tworzeniu modów za pomocą Forge. Ta lista odtwarzania zawiera ponad 60 filmów, które pomogą Ci opanować proces tworzenia modyfikacji o różnym stopniu złożoności. Warto jednak zauważyć, że wszystkie materiały są prezentowane w języku angielskim.
• Rosyjskojęzyczny samouczek tworzenia modów to zbiór instrukcji poświęcony pracy ze starszymi wersjami gry Minecraft. Materiały te pomogą Ci zrozumieć podstawowe zasady modowania, takie jak obsługa zdarzeń, rejestracja obiektów i interakcja z API. Po opanowaniu tych podstaw możesz przejść do programowania modów do nowszych wersji gry.

Aby poznać więcej ciekawostek o kodowaniu, dołącz do naszego kanału na Telegramie!

Przeczytaj również:

• Nauka modelowania 3D z Tinkercadem: Zanurz się w platformę i stwórz tort w stylu Minecraft.
• Zapewnienie dzieciom bezpieczeństwa podczas surfowania po sieci to ważne zadanie dla rodziców i opiekunów. Oto kilka zaleceń, które pomogą Ci stworzyć bezpieczne środowisko online dla dzieci.

  Po pierwsze, warto ustalić zasady dotyczące czasu spędzanego w sieci. Określ, ile czasu Twoje dziecko może spędzać dziennie online i upewnij się, że nie przekracza tego limitu.

  Po drugie, pomocne będzie utworzenie listy zatwierdzonych stron internetowych. Pomoże to Twojemu dziecku trafić do bezpiecznych i edukacyjnych zasobów, jednocześnie uniemożliwiając dostęp do nieodpowiednich treści.

  Zainstaluj również oprogramowanie do kontroli rodzicielskiej. Narzędzia te mogą ograniczać dostęp do niektórych stron internetowych i monitorować aktywność Twojego dziecka online, dzięki czemu będziesz na bieżąco z jego aktywnością online.

  Ważne jest również, aby prowadzić z dzieckiem otwartą rozmowę na temat tego, co stanowi bezpieczne zachowanie w sieci. Wyjaśnij, jak rozpoznawać potencjalne zagrożenia, takie jak oszustwa czy komunikacja z nieznajomymi, oraz jak ważne jest, aby nie udostępniać danych osobowych.

  Na koniec staraj się być blisko, gdy dziecko korzysta z internetu. Wspólne przeglądanie sieci nie tylko wzmocni Waszą więź, ale także da Wam możliwość wyjaśnienia, dlaczego niektóre zasoby mogą być niebezpieczne.

  Postępując zgodnie z tymi zaleceniami, możesz znacząco poprawić poziom bezpieczeństwa swojego dziecka podczas surfowania po sieci i stworzyć bezpieczniejsze środowisko online.

• Monitorowanie aktywności dzieci na smartfonach: pięć najlepszych aplikacji na platformy iOS i Android.