A Minecraft egy örökzöld jelenség, egy digitális játszótér, ahol a képzelet szab határt. De mi van akkor, ha már túllépted a játék adta alap lehetőségeket? Mi történik, ha valami igazán egyedit, valami sajátot szeretnél hozzáadni a kedvenc kockavilágodhoz? Akkor jön el az ideje, hogy belevágj a **Minecraft Bedrock Edition** (korábbi nevén Pocket Edition) kiegészítők, vagy ahogy sokan hívják, a „pluginek” készítésébe! Ne ijedj meg, nem kell programozó zseninek lenned ahhoz, hogy elkezdd; csak egy kis kitartás, logikus gondolkodás és némi alapvető tudás. Ebben a részletes útmutatóban lépésről lépésre végigvezetlek a folyamaton, hogy te is megalkothasd álmaid egyedi kiegészítőjét.
### Miért Vágj Bele a Saját Kiegészítők Készítésébe? 💡
Először is tisztázzuk: a Minecraft Java Editionhöz írt „pluginek” (amik általában Java nyelven futnak szervereken, mint pl. Spigot vagy Paper) és a **Minecraft Bedrock Editionhöz** készült kiegészítők kissé eltérő megközelítést igényelnek. A Bedrock Edition esetében valójában úgynevezett **add-onokat** és **scripting API**-kat használunk, amelyek **JavaScript** nyelven íródnak. Ezek a szkriptek a játék motorjával kommunikálnak, és lehetővé teszik a dinamikus viselkedések, egyedi parancsok, események kezelését és sok más dolog megvalósítását, amire a hagyományos viselkedés- vagy erőforráscsomagok önmagukban nem képesek.
De miért éri meg foglalkozni ezzel?
* **Korlátlan Személyre Szabhatóság:** Alapvetően bármit megvalósíthatsz, amit csak elképzelsz. Új játékmechanikák, egyedi tárgyak viselkedése, komplex eseménysorok – a határ tényleg a fantáziád.
* **Tanulás Játékosan:** A szkriptírás kiváló módja annak, hogy elsajátíts alapvető programozási ismereteket **JavaScript** nyelven, ami rendkívül keresett a modern technológiai iparban.
* **Kreatív Kibontakozás:** Hozd létre a saját szabályaidat, történeteidet, vagy akár egy teljesen új játékmódot a Minecrafton belül.
* **Közösségi Hozzájárulás:** Oszd meg alkotásaidat a barátaiddal, vagy akár a szélesebb Minecraft közösséggel. Talán a te add-onod lesz a következő nagy szenzáció!
* **Pénzkereseti Lehetőség:** A Mojang Marketplace-en keresztül sikeres add-onok értékesítésével akár bevételre is szert tehetsz.
### Mire Lesz Szükséged? – Az Előkészületek 🛠️
Mielőtt belevágnánk a kódolásba, győződj meg róla, hogy az alábbi eszközök és ismeretek a rendelkezésedre állnak. Ne aggódj, a legtöbb ingyenes és könnyen beszerezhető!
1. **Minecraft Bedrock Edition:** Természetesen szükséged lesz magára a játékra. A fejlesztéshez a legkényelmesebb a Windows 10/11 verzió, de az Android vagy iOS eszközökön is működnek a kész add-onok.
2. **Kód Szerkesztő (IDE):** A legnépszerűbb és legajánlottabb választás a **Visual Studio Code (VS Code)**. Ingyenes, rengeteg hasznos kiegészítővel rendelkezik, és kiválóan támogatja a **JavaScript** fejlesztést. 💻
3. **Node.js:** Ez egy JavaScript futtatókörnyezet, amire a legtöbb modern fejlesztői eszköz épül, beleértve a Bridge.js-t is, amiről később lesz szó. Telepítése egyszerű, csak töltsd le a hivatalos weboldalról.
4. **Alapvető JavaScript Tudás:** Nem kell profinak lenned, de ha van némi fogalmad a változókról, függvényekről, feltételes utasításokról (if/else) és ciklusokról (for/while), az nagyban megkönnyíti a dolgodat. Számtalan ingyenes online kurzus és tutorial elérhető, ha most ismerkedsz a nyelvvel.
5. **Bridge.js CLI (Command Line Interface):** Ez a legfontosabb eszköz a munkafolyamat automatizálásához. Segít a projektstruktúra létrehozásában, a kód fordításában és a játékba való telepítésében. Nélkülözhetetlen a hatékony fejlesztéshez! 🌉
### A Bedrock Edition Specifikumai – Plugin Helyett Add-on és Scripting API 🧠
Ahogy említettem, a Bedrock Edition nem támogatja a Java-alapú plugineket. Helyette a **Minecraft Creator API**-t (más néven Scripting API-t) használja, ami lehetővé teszi, hogy **JavaScript** kódokat írj, amelyek közvetlenül interakcióba lépnek a játék motorjával. Ezek a szkriptek a **viselkedéscsomagok (Behavior Packs)** részét képezik. A viselkedéscsomagok definiálják az entitások viselkedését, a tárgyak tulajdonságait, a receptekeket és most már a szkripteket is. Mellettük az **erőforráscsomagok (Resource Packs)** felelnek a textúrákért, modellekért, hangokért. A kettő gyakran együtt jár, ha egyedi tárgyakat vagy mobokat szeretnél bevezetni.
### Lépésről Lépésre – Első Saját Add-onod Megalkotása ✨
Most pedig vágjunk bele a gyakorlatba!
#### 1. Környezet Beállítása 💻
* **VS Code telepítése:** Látogass el a `code.visualstudio.com` oldalra, töltsd le és telepítsd az operációs rendszerednek megfelelő verziót.
* **Node.js telepítése:** Menj a `nodejs.org` weboldalra, töltsd le az ajánlott LTS (Long Term Support) verziót, és futtasd a telepítőt.
* **Bridge.js CLI telepítése:** Nyisd meg a parancssort (Windows: `cmd` vagy `PowerShell`, macOS/Linux: `Terminal`), és írd be a következő parancsot:
„`bash
npm install -g bridge.js
„`
Ez a parancs globálisan telepíti a Bridge.js-t, így bármelyik mappából elérheted.
#### 2. Új Projekt Létrehozása Bridge.js-szel 🚀
Navigálj abba a mappába a parancssorban, ahol a projektjeidet szeretnéd tárolni. Ezután hozz létre egy új add-on projektet a Bridge.js segítségével:
„`bash
bridge create my_first_addon
„`
Ezzel létrejön egy `my_first_addon` nevű mappa, benne az alapvető fájlstruktúrával:
* `BP` (Behavior Pack)
* `RP` (Resource Pack)
* `scripts` (ide kerülnek a JavaScript fájlok)
* `manifest.json` (a csomag leírása)
* és sok más, amit a Bridge.js generál.
Nyisd meg ezt a mappát a VS Code-ban (`File -> Open Folder…`).
#### 3. A `manifest.json` – A Lélek a Projektben 📄
Minden Bedrock add-on alapja a `manifest.json` fájl. Ez írja le a játék számára, hogy mi is ez a csomag, mi a neve, ki a szerzője, milyen verziójú, és milyen modulokat tartalmaz.
A Bridge.js már generált egy alap fájlt, de érdemes megérteni a legfontosabb részeit:
* `format_version`: A manifest fájl verziója.
* `header`: A csomag alapadatai – `name`, `description`, „version` (pl. `[1, 0, 0]`), és egy egyedi `uuid`. Az UUID (Universally Unique Identifier) kritikus, minden csomagnak egyedi UUID-vel kell rendelkeznie!
* `modules`: Itt definiáljuk a csomag tartalmát. A script modul fogja tartalmazni a JavaScript kódunkat. Szintén van `uuid`-ja és `version`-ja.
* `dependencies`: Ha a szkripted függ egy másik csomagtól (pl. egy erőforráscsomagtól), azt itt adhatod meg.
Amikor a Bridge.js létrehozza a projektet, automatikusan generál egyedi UUID-ket. Ha később klónozod a projektet, vagy több projektet is futtatsz, figyelj oda, hogy mindegyiknek egyedi UUID-je legyen a `header` és a `modules` szekciójában!
#### 4. Az Első Kódod – Üdvözlő Üzenet és Interakció 📝
Nyisd meg a `scripts/server/index.js` fájlt a VS Code-ban. Ez az a hely, ahol a varázslat történik! Töröld az alap tartalmat, és illessz be egy egyszerű üdvözlő üzenetet:
„`javascript
import { world, system } from ‘@minecraft/server’;
// Ez a függvény akkor fut le, amikor a script elindul a világban
system.run(async () => {
world.sendMessage(„§a[Saját Add-on] Hello, Minecraft Világ!”);
});
// Eseménykezelő: amikor egy játékos csatlakozik a világhoz
world.events.playerJoin.subscribe(playerJoinEvent => {
const { player } = playerJoinEvent;
player.sendMessage(`§eÜdvözöllek a szerveren, ${player.name}! Reméljük jól érzed magad.`);
world.sendMessage(`§9${player.name} csatlakozott a játékhoz!`);
});
// Eseménykezelő: amikor egy blokkot leraknak
world.events.blockPlace.subscribe(blockPlaceEvent => {
const { player, block } = blockPlaceEvent;
if (block.typeId === „minecraft:dirt”) { // Ha föld blokkot rak le
player.sendMessage(`§bTiszta földet raktál le! Micsoda természetszeretet!`);
// Létrehozhatunk egy eseményt is, ami X másodperc múlva történik
system.runTimeout(() => {
world.sendMessage(`§7[Saját Add-on] Eltelt 5 másodperc a földlerakás óta.`);
}, 100); // 100 tick = 5 másodperc (20 tick = 1 másodperc)
}
});
„`
Ez a kód három dolgot csinál:
1. Amint az add-on betöltődik, kiír egy üdvözlő üzenetet a chatbe.
2. Amikor egy játékos csatlakozik, üdvözli őt, és jelzi a többi játékosnak is a belépését.
3. Ha egy játékos `minecraft:dirt` (föld) blokkot rak le, visszajelez neki.
A `§a`, `§e`, `§b`, `§9`, `§7` karakterek a Minecraft színes formázó kódjai.
#### 5. Tesztelés Játék Közben 🎮
Ez az a pont, ahol a Bridge.js igazán megmutatja az erejét!
1. Nyisd meg a parancssort abban a mappában, ahol a `my_first_addon` projekted van.
2. Futtasd a következő parancsot:
„`bash
bridge watch
„`
Ez a parancs figyeli a fájlok változásait, automatikusan fordítja a kódot, és telepíti az add-onodat a Minecraft fejlesztői mappáiba (általában `C:Users[Felhasználónév]AppDataLocalPackagesMicrosoft.MinecraftUWP_8wekyb3d8bbweLocalStategamescom.mojangdevelopment_behavior_packs`).
3. Indítsd el a Minecraft Bedrock Editiont.
4. Hozz létre egy **új világot**, vagy szerkessz egy meglévőt. Fontos, hogy a világ beállításainál:
* Kapcsold be az **”Experimentals”** (Kísérleti funkciók) alatt a **”Beta APIs”** vagy **”MoLang Features”** lehetőséget, ami lehetővé teszi a szkriptinget. Enélkül nem fog működni!
* A „Viselkedéscsomagok” (Behavior Packs) fül alatt **aktiváld a „My First Addon” nevű csomagodat**.
* Győződj meg róla, hogy az „Erőforráscsomagok” (Resource Packs) fül alatt is aktív az add-on, ha van hozzá erőforráscsomagod (jelen esetben valószínűleg nincs).
5. Lépj be a világba! Láthatod az üdvözlő üzenetet. Próbálj meg lerakni egy föld blokkot, és nézd meg, mi történik!
#### 6. Hibakeresés és Finomhangolás 🐞
A fejlesztés elengedhetetlen része a hibakeresés. Ha valami nem működik:
* **Bridge.js kimenet:** Figyeld a `bridge watch` parancs kimenetét a parancssorban. Ha szintaktikai hiba van a kódban, vagy a `manifest.json` hibás, a Bridge.js jelezni fogja.
* **Minecraft logok:** A játékon belüli hibákat, vagy a `console.log()` hívásokat a **Content Log** képernyőn láthatod. Ezt a `Ctrl + Shift + L` billentyűkombinációval hozhatod elő a játékban.
* **VS Code debuggolás:** A VS Code-ban van beépített debugger, amit a Bedrock scripting API-val is lehet használni, de ez egy kicsit haladóbb téma. Kezdésnek a `Content Log` bőven elég.
* **Helyes UUID-k:** Győződj meg róla, hogy a `manifest.json`-ban minden UUID egyedi. Használhatsz online UUID generátorokat.
* **Kísérleti funkciók:** Mindig ellenőrizd, hogy a szükséges kísérleti funkciók be vannak-e kapcsolva a világodban.
### Haladó Tippek és Lehetőségek 🚀
Ha már kényelmesen mozogsz az alapokban, íme néhány ötlet a további felfedezéshez:
* **Egyedi Tárgyak és Blokkok:** Kombináld a szkripteket az erőforrás- és viselkedéscsomagokkal. Hozz létre egyedi modelleket (akár Blockbench segítségével), textúrákat, és rendelj hozzájuk egyedi viselkedést a szkriptekkel.
* **Felhasználói Felület (UI) Módosítás:** A Bedrock Edition lehetővé teszi a felhasználói felület (screen.json fájlokkal) testreszabását. Kombináld ezt szkriptekkel, hogy interaktív UI elemeket hozz létre.
* **Entity Viselkedés:** Módosítsd a létező mobok AI-ját, vagy hozz létre teljesen új entitásokat egyedi viselkedéssel, támadásokkal, mozgási mintákkal.
* **Chat Parancsok:** Valósíts meg saját chat parancsokat (`!mysupercommand`), amelyekre a szkripted reagál.
* **Websockets:** A Creator API támogatja a Websocket kapcsolatokat, ami lehetővé teszi, hogy a játékod külső alkalmazásokkal kommunikáljon, vagy akár egy weboldalról vezéreld a játék eseményeit!
### Gyakori Hibák és Megoldásuk 🚧
* **Elfelejtett kísérleti funkciók:** Ha a script nem fut, először ellenőrizd a világ beállításait!
* **Helytelen UUID-k:** Az „Addon not found” vagy „Failed to load pack” hibák gyakori oka.
* **Elírások (typos) a kódban:** Minden programozó rémálma. A VS Code jelzi a legtöbbet, de a `Content Log` is segíthet.
* **Régi Bridge.js vagy Node.js verzió:** Frissítsd rendszeresen a `npm update -g bridge.js` és a Node.js-t.
* **Túl sok szkript egy fájlban:** Rendezett kód érdekében oszd szét a funkciókat több, logikusan elnevezett fájlba, és használd az `import`/`export` parancsokat.
A Minecraft Bedrock Edition fejlesztői közössége az elmúlt években exponenciálisan növekedett. A Mojang Studios által közzétett adatok szerint 2023-ban már több mint 150 millió aktív havi játékosa van a Bedrock Editionnek, és a Marketplace-en keresztül több ezer egyedi tartalom érhető el. A független fejlesztők és tartalomkészítők száma folyamatosan emelkedik, sokan hivatásos szintre emelték a hobbit, bevételt generálva a saját készítésű add-onjaikkal és világukkal. Ez a hatalmas ökoszisztéma bizonyítja, hogy a személyre szabott élmény iránti igény óriási, és a Creator API valós lehetőséget kínál arra, hogy bárki a részese legyen ennek a sikertörténetnek. Ez a trend nem csak a játékélményt mélyíti el, hanem lehetőséget ad arra is, hogy az alkotók a hobbijukból építsenek karriert.
### Összefoglalás – Indulj El a Saját Utadon! 🎉
A **Minecraft Bedrock Edition** add-onok készítése egy fantasztikus kaland, ami nemcsak a játékélményedet emeli új szintre, hanem értékes, modern programozási készségeket is ad a kezedbe. Ne feledd, a kezdet mindig a legnehezebb, de a kitartás és a kísérletezés meghozza gyümölcsét. Kezdd kicsiben, építs egyszerű dolgokat, és fokozatosan haladj a komplexebb projektek felé. A Minecraft közösség hatalmas és segítőkész; rengeteg online forrás, fórum és Discord szerver áll rendelkezésedre, ahol kérdezhetsz, ötleteket cserélhetsz és inspirálódhatsz.
Ragadd meg a lehetőséget, és tedd a Minecraft világát még inkább a sajátodévá. Ki tudja, talán éppen a te kreatív ötleted forradalmasítja majd a Bedrock Edition modding világát! Sok sikert a kódoláshoz, és jó szórakozást a fejlesztéshez!
