Pehkui — mod do Minecraft
Pehkui to mod-biblioteka do gry Minecraft Java Edition, który pozwala zmieniać rozmiar niemal każdej istoty, proporcjonalnie dostosowując…
Pehkui to mod-biblioteka do gry Minecraft Java Edition, który pozwala zmieniać rozmiar niemal każdej istoty, proporcjonalnie dostosowując jej atrybuty.
Pehkui — mod do Minecraft
Wersja Minecraft, na której testowano i pisano artykuł: 1.21.1
Zakres obsługiwanych wersji: 1.14.4 – 1.21.1
Zależności: Fabric API (dla paczek Fabric/Quilt)
Pehkui to mod-biblioteka do Minecraft Java Edition, który pozwala na zmianę rozmiaru niemal każdego bytu w grze: uczynienie gracza lub moba mniejszym bądź większym od standardowego. Wraz z wizualną zmianą skali proporcjonalnie dostosowuje on powiązane atrybuty — prędkość poruszania się, zasięg interakcji, obrażenia od upadku, promień eksplozji, zdrowie i obrażenia w walce.
Samo narzędzie nie dodaje przedmiotów, bloków ani nowych mobów. Jest to mechanika skalowania, którą można sterować za pomocą osobnej komendy lub innych modów, które używają jej jako fundamentu.
Co dokładnie się zmienia
Podstawowa zasada: dla każdego bytu przechowywany jest zestaw oddzielnych współczynników — osobno dla wysokości, szerokości, obrażeń, zasięgu interakcji, zdrowia, prędkości i innych parametrów. To nie jest jedna globalna liczba, ale wiele równoległych wartości, z których część jest ze sobą powiązana. Na przykład, typ pehkui:height wpływa jednocześnie na wysokość hitboxa, poziom oczu i odległość kamery z perspektywy trzeciej osoby — jeśli zmienisz tylko wysokość, powiązane parametry dostosują się automatycznie.

Powiększony CREEPER w porównaniu do zwykłego.
Taki system pozwala na precyzyjne sterowanie zachowaniem: możesz zwiększyć tylko obrażenia bez zmiany rozmiaru, tylko prędkość bez wpływu na zdrowie lub tylko zasięg interakcji bez wpływu na hitbox.

Zmniejszenie gracza i porównanie go do standardowych drzwi.
Komenda /scale
Jeśli w paczce nie ma innych modów, które dodawałyby interfejs do skalowania, rozmiarami można zarządzać bezpośrednio przez komendę konsoli. Działa ona tylko dla gracza z uprawnieniami operatora.
Podstawowa składnia ustala lub modyfikuje wartość dla określonego typu skali i konkretnego bytu:
/scale set <value> [<entity>]
/scale set <scale_type> <value> [<entity>]
/scale (add|subtract|multiply|divide) <value> [<entity>]
/scale (add|subtract|multiply|divide) <scale_type> <value> [<entity>]
/scale get [<entity>]
/scale reset [<entity>]
Wartość <value> to mnożnik. 1.0 to rozmiar standardowy, 0.5 to rozmiar o połowę mniejszy, a 2.0 to rozmiar dwukrotnie większy. Jeśli typ skali nie zostanie określony, operacja dotyczy pehkui:base — skali bazowej, która wpływa jednocześnie na szerokość, wysokość, poruszanie się, upuszczane przedmioty, pociski, eksplozje i widoczność.
Istnieje osobna podkomenda opóźniająca przejście między wartościami. Bez niej skala zmienia się natychmiast — w jednym tyku. Dzięki niej przejście jest rozłożone na określononą liczbę tyków i wygląda płynnie:
/scale delay set <ticks> [<entity>]
/scale delay set <scale_type> <ticks> [<entity>]
Na przykład, 60 tyków to trzy sekundy płynnego wzrostu lub kurczenia się.

Zmniejszony gracz obok standardowego CREEPER.
Typy skali
W sumie mod rejestruje 28 odrębnych typów. Nie musisz ich wszystkich pamiętać — w praktyce gracz musi znać tylko kilka najważniejszych.
Typ | Co zmienia |
| Główny mnożnik; wpływa na szerokość, wysokość, poruszanie się, dropy, pociski, eksplozje, widoczność |
| Szerokość modelu i hitboxa |
| Wysokość modelu, hitboxa, poziom oczu, kamera z perspektywy trzeciej osoby |
| Prędkość poruszania się |
| Wysokość skoku |
| Ogólny zasięg interakcji (bloki + byty) |
| Zadawane obrażenia |
| Otrzymywane obrażenia (wartość mniejsza niż 1.0 je zmniejsza) |
| Maksymalne zdrowie |
| Siła zadawanego odrzutu |
| Obrażenia od upadku |
| Szybkość niszczenia bloków |
| Szybkość ataku bronią |
| Dystans, z jakiego wrogowie zauważają byt |
| Szybkość lotu w trybie kreatywnym |
| Wysokość automatycznego wejścia (półbloki, schody, śnieg) |
Inne, rzadziej potrzebne typy: held_item (skala trzymanego przedmiotu), drops (rozmiar upuszczonych przedmiotów), projectiles (rozmiar pocisków — strzał, trójzębów), explosions (promień eksplozji bytu — CREEPER, END_CRYSTAL), view_bobbing (kołysanie kamery podczas chodzenia), eye_height, hitbox_width, hitbox_height, model_width, model_height, third_person, block_reach, entity_reach.
Konfiguracja
Plik konfiguracyjny znajduje się pod ścieżką config/pehkui.json. Zawiera on kilka ogólnych przełączników, które wpływają na ogólne zachowanie moda. Reszta parametrów pliku to minimalne i maksymalne limity wartości dla każdego typu skali. Nie ma potrzeby ich dotykać podczas zwykłej gry: wyznaczają one granice bezpieczeństwa dla modów używających API.
Parametr | Co robi |
| Włącza komendę |
| Jeśli |
| Lista konkretnych typów, które należy zachować po odrodzeniu. Działa, gdy |
| Jeśli |
| Mnoży obrażenia od upadku przez |
| Mnoży prędkość poruszania się przez |
| Czy skala wpływa na zasięg interakcji ( |
| Mnoży obrażenia w walce przez |
| Mnoży otrzymywane obrażenia przez |
| Mnoży maksymalne zdrowie przez |
| Skaluje modele upuszczonych przedmiotów |
| Skaluje pociski gracza lub bytu |
| Skaluje promień eksplozji bytu (CREEPER, END_CRYSTAL) |
| Włącza dodatkowe komendy do programowania; w zwykłej grze niepotrzebne |
Podsumowanie
Pehkui zapewnia osobny przełącznik dla każdej właściwości, płynne przejścia z opóźnieniem oraz zapisywanie stanu pomiędzy sesjami. Komenda /scale i konfiguracja to tylko wierzchołek; prawdziwa wartość biblioteki ukazuje się poprzez mody, które wykorzystują jej API do swoich mechanik. Nadaje się do survivalu roleplay z mechanikami transformacji, do serwerowych minigier, a także jako obowiązkowa zależność w modpackach z bossami o zmiennym rozmiarze lub systemami rasowymi.
Instalacja
Typowa instalacja zajmuje około 5 minut. Procedura jest taka sama; różni się tylko loader i odpowiedni build.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











