Bedrock add-ons en packs op je server installeren

Bedrock add-ons op je server installeren gaat in drie stappen: pak de .mcaddon of .mcpack uit, zet het behavior pack in behavior_packs/ en het resource pack in resource_packs/, en activeer ze in de wereld via world_behavior_packs.json en world_resource_packs.json, met de uuid en version uit het manifest.json van elk pack. Gebruikt de add-on Beta APIs, dan moet dat experiment ook in de wereld aanstaan. Een installatieknop heeft Bedrock Dedicated Server niet. De serverkant hebben we getest op versie 1.26.52, de actuele serverversie op 30 september 2026.

Behavior pack of resource pack: wat draait er op de server?

Een add-on bestaat meestal uit twee delen. Het behavior pack bevat de logica: gedrag van mobs, recepten, loot tables, functies en scripts. Dat draait op de server. Het resource pack bevat wat je ziet en hoort: textures, modellen, animaties en geluiden. Dat krijgen spelers van de server binnen als ze joinen. Een texturepack is gewoon een resource pack. In manifest.json zie je het verschil aan het moduletype: data of script is een behavior pack, resources een resource pack.

Een .mcpack bevat één pack; een .mcaddon bundelt meerdere packs, als mappen of als .mcpack-bestanden, zo beschrijft de community-wiki wiki.bedrock.dev het. Het zijn zip-bestanden met een andere extensie: hernoem ze naar .zip en elk uitpakprogramma opent ze.

Stap 1: uitpakken en manifest.json lezen

Pak de add-on uit op je computer. Elke map met een manifest.json is één pack; zit er nog een .mcpack in, pak die ook uit. Noteer per pack twee waarden uit het blok header:

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

De uuid onder modules heb je hier niet nodig: volgens Microsoft hoort die juist anders te zijn dan de pack-uuid, en gebruik je hem toch, dan laadt het pack niet. Verwijst het behavior pack onder dependencies naar een resource pack, dan moeten ze allebei op de server.

Stap 2: uploaden naar behavior_packs/ en resource_packs/

Stop de server in het paneel en upload de uitgepakte mappen: behavior packs naar behavior_packs/, resource packs naar resource_packs/, allebei in de hoofdmap van je server. Voor een paar bestanden volstaat het bestandsbeheer in het paneel; grote add-ons gaan makkelijker via SFTP (zie verbinden met WinSCP of FileZilla). Laat de standaardpacks, zoals vanilla, met rust.

Packs in deze hoofdmappen zijn beschikbaar voor elke wereld; in worlds/<wereld>/behavior_packs/ horen ze alleen bij die ene wereld.

Stap 3: de packs in de wereld activeren

Uploaden alleen is niet genoeg: de wereld moet weten welke packs hij laadt. Dat staat in twee bestanden in worlds/<level-name>/. De mapnaam staat bij level-name in server.properties; standaard is dat Bedrock level. In een verse wereld bestaan ze nog niet; maak ze dan zelf aan. world_behavior_packs.json:

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

En world_resource_packs.json, met de uuid en versie van het resource pack:

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

Meer add-ons? Extra regels in dezelfde lijst, met komma's ertussen maar niet na de laatste. Neem de versie exact over. In onze test negeerde de server het pack als het eerste getal afweek (2.0.0 in plaats van 1.0.0) of als de JSON een lagere versie noemde dan het manifest. Start de server en kijk in de console. Een geladen behavior pack ziet er zo uit:

Pack Stack - [00] Mijn add-on BP (id: 0b6f7e2a-..., version: 1.0.0) @ behavior_packs/mijnaddon_BP

Resource packs verplicht maken met texturepack-required

Met texturepack-required=true in server.properties dwing je af dat spelers de resource packs van de wereld gebruiken; standaard staat hij op false. Zet hem aan als je add-on eigen blokken, items of mobs toevoegt, want hoe die eruitzien staat in het resource pack. Die sleutel wijzig je in het bestandsbeheer; alleen sleutels als gamemode en difficulty zet ons paneel bij elke start uit de startup-variabelen.

Beta APIs en andere experimenten: in de wereld aanzetten

Sommige add-ons gebruiken de bètaversie van de script-API. Dat herken je in het manifest aan een dependency op @minecraft/server met een versie die eindigt op -beta. Dan moet het experiment Beta APIs in de wereld aanstaan. Staat het uit, dan meldt de console:

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

De server heeft daar geen instelling voor. Zet het experiment daarom lokaal aan:

1. Stop de server, maak een back-up en download de map worlds/<level-name>/.
2. Zip de inhoud van die map, hernoem het bestand naar .mcworld en open het op je pc; Minecraft importeert de wereld.
3. Zet in de wereldinstellingen bij de experimenten Beta APIs aan. Minecraft maakt dan een kopie met "Copy of" voor de naam; werk in die kopie.
4. Exporteer de kopie als .mcworld, pak hem uit en vervang daarmee de inhoud van de wereldmap op de server. Controleer of beide world_..._packs.json-bestanden er nog in staan; zet ze anders terug uit je back-up.

Een nieuwe wereld maak je lokaal aan met het experiment aan. Zonder omweg kan ook: de community-wiki wiki.bedrock.dev beschrijft hoe je met een NBT-editor in level.dat, in het compound experiments, een byte gametest met waarde 1 zet. In onze test werkte dat; de console toont dan Experiment(s) active: gtst.

Let op: een wereld met experimenten wordt volgens Microsoft nooit meer een gewone wereld, en bètafuncties kunnen bij een Bedrock-update veranderen of verdwijnen, waardoor zo'n add-on stukgaat tot de maker hem bijwerkt. Vraagt een add-on om @minecraft/server-net, dan moet je die module toestaan. Microsoft raadt aan dat per scriptmodule te doen, in config/<uuid-van-de-scriptmodule>/permissions.json, en config/default/permissions.json minimaal te houden. Handig: een herinstallatie via ons paneel (zoals bij een versiewissel) zet dat standaardbestand terug en laat je eigen mappen, packs en wereld staan.

Marketplace-add-ons kun je niet op je eigen server zetten

Wat je in de Marketplace koopt, kun je niet op een eigen server installeren. Minecraft bewaart gekochte content versleuteld in een aparte map (premium_cache, volgens de community-wiki minecraft.wiki), dus er valt niets te uploaden. Add-ons die makers zelf als .mcaddon of .mcpack aanbieden, werken wel.

Testen: zet de contentlog aan en lees de console

Zet content-log-console-output-enabled=true in server.properties; dan komen ook fouten uit de packs in de console van het paneel. Deze meldingen zagen we in onze test:

• Module-uuid of verkeerde versie: Configured pack (id: …) was not found and was ignored, en daarna Pack Stack - None.
• Een komma na de laatste regel in world_behavior_packs.json: géén foutmelding, alleen Pack Stack - None. Laadt er niets en klaagt er niets, controleer dan de JSON.
• Complete .mcaddon in behavior_packs/: Multiple manifests found at the same directory level, of bij .mcpack-bestanden erin alleen was not found.
• Behavior pack in resource_packs/: Defaulting to resource pack, en het pack doet niets.

Nieuwe versie van een add-on? Vervang de map, pas de versie in de JSON aan en herstart.

Wanneer je geen add-on nodig hebt

Wil je alleen een spelregel aanpassen, zoals spullen houden na je dood, dan is een gamerule genoeg: keepInventory instellen kost één commando en maakt je wereld niet experimenteel. Een add-on loont voor echt nieuwe dingen, zoals eigen mobs of proximity voice chat, maar zware add-ons vragen meer van de server dan een texturepack. Onze Bedrock-servers draaien de officiële Bedrock Dedicated Server, vanaf € 2,50 per maand (Apple, 2 GB); Cookey met 4 GB kost € 5,00. Alles is maandelijks opzegbaar.

Veelgestelde vragen

Kun je add-ons gebruiken op een Bedrock-server?

Ja. Bedrock Dedicated Server laadt behavior en resource packs die je in behavior_packs en resource_packs zet en in de wereld activeert via world_behavior_packs.json en world_resource_packs.json. Alleen gekochte Marketplace-content kun je niet op een eigen server installeren.

Waarom laadt mijn add-on niet op mijn Bedrock-server?

Kijk in de console naar de regel Pack Stack. Staat daar None met 'Configured pack ... was not found and was ignored', dan kloppen de uuid of de versie niet: neem uuid en version over uit het header-blok van manifest.json, niet de uuid van de module. Zonder enige melding is het vaak een JSON-fout, zoals een komma na de laatste regel.

Hoe zet je Beta APIs aan op een Bedrock Dedicated Server?

Niet via de server zelf. Zet Beta APIs lokaal aan in de wereldinstellingen en upload de wereld opnieuw, of zet met een NBT-editor in level.dat onder experiments een byte gametest op 1. Maak eerst een back-up: een wereld met experimenten wordt nooit meer een gewone wereld.

Kun je Marketplace-add-ons op je eigen server installeren?

Nee. Gekochte Marketplace-content wordt versleuteld opgeslagen, dus je kunt hem niet als pack uploaden. Add-ons die de maker zelf als .mcaddon of .mcpack aanbiedt, werken wel.

Verder lezen

• Voice chat op een Bedrock-server: wat werkt wél (en wat niet)
• Bedrock 26.50 en 26.51: waarom spelers niet meer op je server kunnen (en wat je doet)
• Minecraft Java of Bedrock: het verschil en welke server je nodig hebt