Jak dodać addony i paczki na serwer Bedrock

Jak dodać addony na serwer Bedrock? W trzech krokach: rozpakuj plik .mcaddon lub .mcpack, wrzuć behavior pack do behavior_packs/, a resource pack do resource_packs/, i aktywuj je w świecie przez world_behavior_packs.json i world_resource_packs.json, podając uuid i version z pliku manifest.json każdej paczki. Jeśli addon korzysta z API w wersji beta (Beta APIs), ten eksperyment też musi być włączony w świecie. Bedrock Dedicated Server nie ma przycisku do instalacji. Stronę serwerową przetestowaliśmy na wersji 1.26.52, aktualnej wersji serwera na dzień 30 września 2026.

Behavior pack czy resource pack: co działa na serwerze?

Addon (w polskiej wersji gry: dodatek) zwykle składa się z dwóch części. Behavior pack (w grze: paczka zachowań) zawiera logikę: zachowanie mobów, przepisy, tabele łupów, funkcje i skrypty. To działa na serwerze. Resource pack (paczka zasobów) zawiera to, co widzisz i słyszysz: tekstury, modele, animacje i dźwięki. Gracze dostają go od serwera, gdy dołączają. Texture pack to po prostu resource pack. W manifest.json różnicę poznasz po typie modułu: data lub script oznacza behavior pack, resources resource pack.

Plik .mcpack zawiera jedną paczkę; .mcaddon łączy kilka paczek, jako foldery albo jako pliki .mcpack, tak opisuje to wiki społeczności wiki.bedrock.dev. To zwykłe pliki zip z innym rozszerzeniem: zmień je na .zip, a otworzy je każdy program do rozpakowywania.

Krok 1: rozpakuj addon i przeczytaj manifest.json

Rozpakuj addon na komputerze. Każdy folder z plikiem manifest.json to jedna paczka; jeśli w środku jest jeszcze plik .mcpack, jego też rozpakuj. Dla każdej paczki zanotuj dwie wartości z bloku header:

"header": {
  "name": "Mój addon BP",
  "uuid": "0b6f7e2a-4c1d-4e5b-9a3f-2d8c7b6a5e41",
  "version": [1, 0, 0]
},
"modules": [
  { "type": "data", "uuid": "5c2e9d1b-7a3f-4b8e-a6d2-1f0e9c8b7a62", "version": [1, 0, 0] }
]

Uuid spod modules nie jest ci tu potrzebny: według Microsoftu musi się on właśnie różnić od uuid paczki, a jeśli mimo to go użyjesz, paczka się nie załaduje. Jeśli behavior pack w sekcji dependencies odwołuje się do resource packa, na serwer muszą trafić oba.

Krok 2: wgraj paczki do behavior_packs/ i resource_packs/

Zatrzymaj serwer w panelu i wgraj rozpakowane foldery: behavior packi do behavior_packs/, resource packi do resource_packs/, oba w głównym folderze serwera. Przy kilku plikach wystarczy menedżer plików w panelu; duże addony wygodniej wgrać przez SFTP (zobacz łączenie przez WinSCP lub FileZillę). Domyślnych paczek, takich jak vanilla, nie ruszaj.

Paczki w tych głównych folderach są dostępne dla każdego świata; w worlds/<świat>/behavior_packs/ należą tylko do tego jednego świata.

Krok 3: aktywuj paczki w świecie

Samo wgranie nie wystarczy: świat musi wiedzieć, które paczki ma załadować. Zapisuje się to w dwóch plikach w worlds/<level-name>/. Nazwę folderu znajdziesz przy level-name w server.properties; domyślnie to Bedrock level. W świeżym świecie tych plików jeszcze nie ma; wtedy utwórz je sam. world_behavior_packs.json:

[
  { "pack_id": "0b6f7e2a-4c1d-4e5b-9a3f-2d8c7b6a5e41", "version": [1, 0, 0] }
]

Oraz world_resource_packs.json, z uuid i wersją resource packa:

[
  { "pack_id": "9e4d3c2b-1a0f-4e9d-8c7b-6a5f4e3d2c13", "version": [1, 0, 0] }
]

Więcej addonów? Dopisz kolejne wiersze do tej samej listy, z przecinkami między nimi, ale nie po ostatnim. Przepisz wersję dokładnie. W naszym teście serwer ignorował paczkę, gdy pierwsza liczba się różniła (2.0.0 zamiast 1.0.0) albo gdy w JSON-ie była niższa wersja niż w manifeście. Uruchom serwer i zajrzyj do konsoli. Załadowany behavior pack wygląda tak:

Pack Stack - [00] Mój addon BP (id: 0b6f7e2a-..., version: 1.0.0) @ behavior_packs/mojaddon_BP

Obowiązkowe resource packi dzięki texturepack-required

Ustawiając texturepack-required=true w server.properties, wymuszasz, by gracze używali resource packów świata; domyślnie ta wartość to false. Włącz ją, jeśli twój addon dodaje własne bloki, przedmioty lub moby, bo to, jak wyglądają, jest zapisane w resource packu. Ten klucz zmieniasz w menedżerze plików; nasz panel przy każdym starcie ustawia ze zmiennych startowych tylko klucze takie jak gamemode i difficulty.

API w wersji beta i inne eksperymenty: jak je włączyć w świecie

Niektóre addony korzystają z wersji beta API skryptów. Poznasz to w manifeście po zależności od @minecraft/server z wersją kończącą się na -beta. Wtedy w świecie musi być włączony eksperyment Interfejsy API w wersji beta (po angielsku Beta APIs). Jeśli jest wyłączony, konsola zgłasza:

[Scripting] Plugin [Mój addon BP - 1.0.0] - requesting dependency on beta APIs [@minecraft/server - 2.11.0-beta], but the Beta APIs experiment is not enabled.

Serwer nie ma na to żadnego ustawienia. Dlatego włącz eksperyment lokalnie:

1. Zatrzymaj serwer, zrób kopię zapasową i pobierz folder worlds/<level-name>/.
2. Spakuj do zipa zawartość tego folderu, zmień rozszerzenie pliku na .mcworld i otwórz go na komputerze; Minecraft zaimportuje świat.
3. W ustawieniach świata, w zakładce Eksperymenty, włącz Interfejsy API w wersji beta. Minecraft utworzy wtedy kopię z dopiskiem „Kopia:” przed nazwą; pracuj na tej kopii.
4. Wyeksportuj kopię jako .mcworld, rozpakuj ją i zastąp nią zawartość folderu świata na serwerze. Sprawdź, czy oba pliki world_..._packs.json nadal tam są; jeśli nie, przywróć je z kopii zapasowej.

Nowy świat od razu utwórz lokalnie z włączonym eksperymentem. Da się też bez tego objazdu: wiki społeczności wiki.bedrock.dev opisuje, jak edytorem NBT ustawić w level.dat, w tagu compound experiments, bajt gametest o wartości 1. W naszym teście to zadziałało; konsola pokazuje wtedy Experiment(s) active: gtst.

Uwaga: według Microsoftu świat z eksperymentami nigdy już nie stanie się zwykłym światem, a funkcje beta mogą się zmienić lub zniknąć przy aktualizacji Bedrocka, przez co taki addon przestanie działać, dopóki twórca go nie zaktualizuje. Jeśli addon wymaga @minecraft/server-net, musisz zezwolić na ten moduł. Microsoft zaleca robić to osobno dla każdego modułu skryptowego, w config/<uuid-modułu-skryptowego>/permissions.json, a config/default/permissions.json ograniczyć do minimum. Warto wiedzieć: ponowna instalacja przez nasz panel (np. przy zmianie wersji) przywraca ten domyślny plik, a twoje własne foldery, paczki i świat zostawia w spokoju.

Addonów z Marketplace nie wgrasz na własny serwer

Tego, co kupisz na Rynku (Marketplace), nie zainstalujesz na własnym serwerze. Minecraft przechowuje kupione treści w postaci zaszyfrowanej w osobnym folderze (premium_cache, według wiki społeczności minecraft.wiki), więc nie ma czego wgrać. Addony, które twórcy sami udostępniają jako .mcaddon lub .mcpack, działają bez problemu.

Testowanie: włącz dziennik treści (content log) i czytaj konsolę

Ustaw content-log-console-output-enabled=true w server.properties; wtedy w konsoli panelu pojawią się też błędy z paczek. Takie komunikaty widzieliśmy w naszym teście:

• Uuid modułu lub zła wersja: Configured pack (id: …) was not found and was ignored, a potem Pack Stack - None.
• Przecinek po ostatnim wierszu w world_behavior_packs.json: żadnego komunikatu o błędzie, tylko Pack Stack - None. Jeśli nic się nie ładuje i nic nie zgłasza błędu, sprawdź JSON.
• Cały .mcaddon w behavior_packs/: Multiple manifests found at the same directory level, a gdy w środku są pliki .mcpack, tylko was not found.
• Behavior pack w resource_packs/: Defaulting to resource pack, a paczka nic nie robi.

Nowa wersja addonu? Podmień folder, zmień wersję w JSON-ie i zrestartuj serwer.

Kiedy addon nie jest ci potrzebny

Jeśli chcesz tylko zmienić regułę gry, na przykład żeby po śmierci zachować przedmioty, wystarczy gamerule: ustawienie keepInventory to jedna komenda i nie robi z twojego świata świata eksperymentalnego. Addon opłaca się przy naprawdę nowych rzeczach, takich jak własne moby czy zbliżeniowy czat głosowy, ale ciężkie addony obciążają serwer bardziej niż texture pack. Nasze serwery Bedrock działają na oficjalnym Bedrock Dedicated Server, od 2,50 € miesięcznie (Apple, 2 GB); Cookey z 4 GB kosztuje 5,00 €. Wszystko możesz wypowiedzieć co miesiąc.

Najczęściej zadawane pytania

Czy można używać addonów na serwerze Bedrock?

Tak. Bedrock Dedicated Server ładuje behavior i resource packi, które umieścisz w behavior_packs i resource_packs i aktywujesz w świecie przez world_behavior_packs.json i world_resource_packs.json. Jedynie kupionych treści z Marketplace nie zainstalujesz na własnym serwerze.

Dlaczego mój addon nie ładuje się na serwerze Bedrock?

Poszukaj w konsoli wiersza Pack Stack. Jeśli jest tam None i 'Configured pack ... was not found and was ignored', to nie zgadza się uuid albo wersja: przepisz uuid i version z bloku header w manifest.json, a nie uuid modułu. Jeśli nie ma żadnego komunikatu, to często błąd w JSON-ie, na przykład przecinek po ostatnim wierszu.

Jak włączyć Beta APIs na Bedrock Dedicated Server?

Nie przez sam serwer. Włącz Interfejsy API w wersji beta lokalnie w ustawieniach świata i wgraj świat ponownie albo edytorem NBT ustaw w level.dat, w experiments, bajt gametest na 1. Najpierw zrób kopię zapasową: świat z eksperymentami nigdy już nie stanie się zwykłym światem.

Czy addony z Marketplace można zainstalować na własnym serwerze?

Nie. Kupione treści z Marketplace są przechowywane w postaci zaszyfrowanej, więc nie wgrasz ich jako paczki. Addony, które twórca sam udostępnia jako .mcaddon lub .mcpack, działają.

Czytaj dalej

• Czat głosowy na serwerze Minecraft Bedrock: co działa (a co nie)
• Bedrock 26.50 i 26.51: dlaczego gracze nie mogą wejść na serwer (i co z tym zrobić)
• Minecraft Java czy Bedrock: różnice i jakiego serwera potrzebujesz