Poradnik: jak wgrać grafiki na serwer

GUI i rangi z QubusStudio to obrazki, które gra pokazuje zamiast zwykłego wyglądu skrzyni albo zamiast napisu rangi. W tej wersji poradnika wgrywasz je w zwykłej paczce zasobów, bez żadnego pluginu od grafik. Każdy obrazek dostaje niewidzialny znak, a gra rysuje obrazek wszędzie tam, gdzie ten znak wkleisz.

Potrzebujesz:

• dowolnego serwera Minecraft (Paper, Purpur, a nawet zwykły Spigot),
• dostępu do plików serwera (panel hostingu z menedżerem plików albo FTP, np. FileZilla),
• miejsca na plik .zip z bezpośrednim linkiem do pobrania (np. MCPacks albo własny hosting plików),
• plików PNG pobranych z QubusStudio (wystarczy darmowy pakiet).

Configi Nexo to zwykłe pliki tekstowe z końcówką .yml. Czasem pobierasz config jako tekst do skopiowania albo plik .txt. Zamiana na .yml jest prosta:

1. Włącz widoczność rozszerzeń plików (Windows)
   W Eksploratorze plików kliknij Widok, potem Pokaż i zaznacz Rozszerzenia nazw plików. Bez tego nie zobaczysz, czy plik kończy się na .txt czy .yml.
2. Otwórz Notatnik i wklej config
   Skopiuj tekst configu ze strony (przycisk Kopiuj) i wklej go do pustego Notatnika.
3. Zapisz jako .yml
   Kliknij Plik, Zapisz jako. Na dole w „Zapisz jako typ” wybierz Wszystkie pliki, a w nazwie wpisz np. gui.yml. Kodowanie zostaw UTF‑8.
4. Wrzuć plik do plugins/Nexo/glyphs
   Masz już plik .txt? Wystarczy zmienić mu nazwę z gui.txt na gui.yml.

Każdy obrazek (GUI albo ranga) dostaje w paczce własny, niewidzialny znak. Gdziekolwiek wkleisz ten znak (tytuł menu, prefiks rangi), gra narysuje w tym miejscu Twój obrazek. Paczkę przygotowujesz raz, a potem tylko dopisujesz do niej nowe obrazki.

Krok 1: ułóż foldery paczki

Na komputerze załóż folder, np. moj_pack, i ułóż w nim pliki tak jak niżej. PNG weź z pobranego GUI albo z paczki rang (w paczce rang leżą w pack/assets/nexo/textures/ranks, stamtąd je przenieś).

moj_pack/
├── pack.mcmeta
└── assets/
    └── minecraft/
        ├── font/
        │   └── default.json        ← z generatora niżej
        └── textures/
            └── qubus/
                ├── sklep.png       ← Twoje GUI
                └── ranga_admin.png ← Twoja ranga

Plik pack.mcmeta (zwykły tekst, zapisany jako pack.mcmeta):

{
  "pack": {
    "pack_format": 34,
    "description": "Moj serwer"
  }
}

pack_format dobierz do wersji gry z tabeli w sekcji Texturepack.

Krok 2: wygeneruj default.json

Wpisz nazwy swoich plików PNG. Generator poda gotowy plik default.json i znaki, które potem wkleisz w menu i w LuckPerms.

{
  "providers": [
    { "type": "space", "advances": { "\uF000": -8 } },
    { "type": "bitmap", "file": "minecraft:qubus/sklep.png", "ascent": 13, "height": 256, "chars": ["\uE000"] },
    { "type": "bitmap", "file": "minecraft:qubus/ranga_admin.png", "ascent": 8, "height": 9, "chars": ["\uE001"] }
  ]
}

Krok 3: spakuj i wyślij graczom

1. Spakuj zawartość folderu do .zip
   Wejdź do środka folderu moj_pack, zaznacz pack.mcmeta i assets, kliknij prawym i wybierz Kompresuj do pliku ZIP. W zipie pack.mcmeta musi leżeć od razu na wierzchu, nie w dodatkowym folderze.
2. Wrzuć zip tam, gdzie dostaniesz bezpośredni link
   Np. MCPacks albo własny hosting plików. Link musi od razu pobierać plik .zip.
3. Wpisz link w server.properties i zrestartuj serwer
   server.propertiesKopiuj

   resource-pack=https://twoj-link-do-paczki.zip
   require-resource-pack=true

Gracze przy wejściu dostaną pytanie o pobranie paczki. Po każdej zmianie w paczce wgraj nowy zip pod ten sam link i zrestartuj serwer.

Obrazek GUI wyświetla się w tytule okna skrzyni. W pliku menu .yml wpisujesz znaki jako kod w podwójnym cudzysłowie. &f na początku to biały kolor, bez niego GUI będzie szare:

menu_title: "&f\uF000\uE000"
open_command: sklep
size: 54

\uF000 przesuwa obrazek o 8 pikseli w lewo, na krawędź skrzyni. \uE000 to Twoje GUI (numer z generatora). Cudzysłów musi być podwójny ", w pojedynczym kod się nie zamieni.

size to liczba slotów: 9 na każdy rząd skrzyni (3 rzędy = 27, 6 rzędów = 54). Musi się zgadzać z liczbą rzędów z edytora.

LuckPerms to plugin od rang. Każda grupa (np. admin, vip) może mieć prefiks, czyli to, co stoi przed nickiem. W komendzie kod typu \uE001 nie zadziała, więc wklejasz prawdziwy znak. Skopiuj go przyciskiem Kopiuj znak do LuckPerms przy randze w generatorze i wklej między cudzysłowy:

/lp group admin meta setprefix 100 "&f[tu wklej znak] "

/lp user NickGracza parent add admin

Liczba 100 to ważność prefiksu: im wyższa, tym ważniejsza ranga (admin 100, vip 50, gracz 10). Prefiks odświeży się po ponownym wejściu na serwer.

W edytorze texturepacka malujesz przedmioty piksel po pikselu. Paczka zasobów podmienia wygląd zwykłych przedmiotów z gry, więc najważniejsza jest nazwa tekstury.

W grze jednoosobowej (albo tylko dla siebie)

1. Pobierz paczkę
   W zakładce Eksport pobierz paczkę .zip. Nie rozpakowuj jej.
2. Otwórz folder paczek zasobów
   W grze: Opcje, Paczki zasobów, Otwórz folder paczek.
3. Wrzuć plik .zip do tego folderu
   Przeciągnij go tam w całości.
4. Włącz paczkę
   Wróć do gry, kliknij strzałkę przy swojej paczce, żeby przeszła na prawą stronę, i kliknij Gotowe.

Na serwerze

Masz już paczkę z GUI i rangami (sekcja Paczka zasobów)? Wrzuć tekstury do tej samej paczki. Serwer może wysłać graczom tylko jedną paczkę naraz.

moj_pack/
├── pack.mcmeta
└── assets/minecraft/
    ├── font/default.json          ← GUI i rangi
    └── textures/
        ├── qubus/...              ← obrazki GUI i rang
        └── item/diamond_sword.png ← Twój miecz

Nie masz osobnej paczki? Wtedy wrzuć pobrany .zip z texturepackiem na stronę z bezpośrednim linkiem do pobrania (np. MCPacks albo własny hosting plików) i wpisz link w pliku server.properties:

resource-pack=https://twoj-link-do-paczki.zip
require-resource-pack=true

Zrestartuj serwer. Gracze dostaną pytanie o pobranie paczki przy wejściu.

Wersja gry (pack_format)

Pole pack_format w eksporcie mówi grze, dla której wersji jest paczka. Jak się nie zgadza, gra pokaże napis „stworzona dla innej wersji”, ale zwykle i tak zadziała. Żeby go nie było, ustaw:

Dalej nie działa? Napisz na naszym Discordzie, pomożemy. Wklej zrzut ekranu i to, co wypisuje konsola serwera przy starcie.