-20% na pakiety Standard i Premium do 14.10, 23:59. Zobacz oferte →
Spis stron dokumentacji

Modele i przedmioty 2D

Jakie pliki przyjmuje folder pack/blueprint i co się z nimi dzieje.

Jakie pliki możesz wrzucić

Modele wrzucasz do jednego z dwóch folderów. Oba przyjmują te same trzy rodzaje plików.

FolderCo tam wrzucaszWpis trafia do
pack/blueprintPrzedmioty i blokiitems/<kategoria>.yml
pack/furnitureMeble, dekoracje i roślinyfurniture/<kategoria>.yml

1. Projekt Blockbencha (.bbmodel)

Wrzucasz sam plik .bbmodel. Tekstury są w nim zapisane, więc niczego nie eksportujesz. Projekt musi mieć format Java Block/Item.

Przenosi sięPomijane (z ostrzeżeniem w konsoli)
kostki, inflate, obroty kostek (od 1.21.11 dowolny kąt, także w kilku osiach), UV, obrót i kolor (tint) ścian, świecenie (light_emission), ustawienia Display, animowane teksturysiatki (mesh), obroty całych grup
Model musi mieścić się w obszarze od −16 do 32 (w jednostkach Blockbencha). Większy model gra pokaże jako fioletowo-czarną szachownicę.

2. Eksport z Blockbencha (.json + .png)

W Blockbenchu kliknij File, Export, Export Block/Item Model. Dostaniesz plik .json. Wrzuć go razem z teksturą .png.

  • Tekstura ma nazwę taką jak w Blockbenchu. Gdy się nie zgadza, plugin weźmie <nazwa_modelu>.png.
  • Model ma kilka tekstur? Wrzuć kilka plików PNG.
  • Animowana tekstura: połóż obok PNG plik .png.mcmeta.
  • Odwołania do tekstur z gry (np. block/stone) zostają bez zmian.

3. Sam obrazek (.png)

Obrazek 16 x 16, 32 x 32 albo większy zamienia się w płaski przedmiot, taki jak zwykłe przedmioty w grze.

Id przedmiotu

Id to nazwa pliku małymi literami, bez polskich znaków i bez spacji. Id wpisujesz w komendzie /qt give.

PlikId przedmiotu
Krzesło Ogrodowe.bbmodelkrzeslo_ogrodowe
rubin.pngrubin

Kategorie

Podfolder w pack/blueprint albo pack/furniture to kategoria. Każda kategoria ma swój plik configu i swoją zakładkę w menu.

plugins/Qubustexture/pack
pack/
├── blueprint/
│   ├── bron/
│   │   ├── miecz_ognia.bbmodel   → items/bron.yml
│   │   └── luki/
│   │       └── luk.bbmodel       → items/bron.yml (głębszy folder tylko porządkuje pliki)
│   └── rubin.png                 → items/Inne.yml (kategoria z menu.default-category)
└── furniture/
    └── meble/
        └── krzeslo.bbmodel       → furniture/meble.yml
  • Plik leży prosto w pack/blueprint albo pack/furniture? Trafia do kategorii z ustawienia menu.default-category (domyślnie Inne).
  • Głębsze podfoldery tylko porządkują pliki. Kategorią jest zawsze podfolder pierwszego poziomu.
  • Kategorią jest nazwa pliku configu. items/meble.yml i furniture/meble.yml to jedna kategoria meble w menu.
  • Przeniosłeś model do innego folderu? Wpis sam znajdzie go po nazwie pliku.

Starsze wersje gry (1.21.4 do 1.21.10)

Dowolne obroty kostek gra zna dopiero od wersji 1.21.11. Dla starszych wersji plugin sam robi przeliczone kopie modeli:

  • obroty o 90°, 180° i 270° wychodzą dokładnie tak samo,
  • inne kąty plugin zaokrągla do najbliższego z: −45°, −22,5°, 22,5°, 45° (i pisze o tym w konsoli).
Chcesz, żeby model wyglądał identycznie na każdej wersji? W Blockbenchu używaj tylko kątów −45, −22,5, 22,5, 45 albo wielokrotności 90.