یک Add-on معمولاً می‌تواند چنین ساختاری داشته باشد:

my_addon/ │ ├── behavior_pack/ │ ├── manifest.json │ ├── pack_icon.png │ ├── blocks/ │ ├── entities/ │ ├── items/ │ ├── recipes/ │ ├── scripts/ │ │ └── main.js │ ├── loot_tables/ │ ├── spawn_rules/ │ └── texts/ │ ├── resource_pack/ │ ├── manifest.json │ ├── pack_icon.png │ ├── animations/ │ ├── entity/ │ ├── models/ │ ├── render_controllers/ │ ├── textures/ │ │ ├── blocks/ │ │ ├── entity/ │ │ └── items/ │ └── texts/ │ ├── README.md └── CHANGELOG.md

━━━━━━━━━━━━━━━━━━━━ 🧠 بخش 3 — Behavior Pack چیست؟ ━━━━━━━━━━━━━━━━━━━━

Behavior Pack برای کنترل رفتار و منطق بازی استفاده می‌شود.

برای مثال:

• رفتار ماب‌ها
• Loot
• Spawn Rules
• آیتم‌ها
• Recipeها
• Trade
• بعضی سیستم‌های گیم‌پلی
• Scriptها

اگر بخواهیم مثلاً یک ماب رفتار متفاوتی داشته باشد، معمولاً Behavior Pack لازم داریم.

━━━━━━━━━━━━━━━━━━━━ 🎨 بخش 4 — Resource Pack چیست؟ ━━━━━━━━━━━━━━━━━━━━

Resource Pack برای بخش‌های ظاهری بازی استفاده می‌شود.

برای مثال:

• Texture
• مدل
• انیمیشن
• صدای اختصاصی
• ظاهر آیتم
• ظاهر بلاک
• ظاهر ماب

اگر یک آیتم جدید ساخته باشیم و بخواهیم تصویر اختصاصی داشته باشد، معمولاً باید Resource Pack هم داشته باشیم.

━━━━━━━━━━━━━━━━━━━━ 📂 بخش 5 — محل Development Packها ━━━━━━━━━━━━━━━━━━━━

برای توسعه Add-on بهتر است از Development Packها استفاده کنیم.

در ویندوز معمولاً مسیر com.mojang شامل این پوشه‌هاست:

development_behavior_packs

development_resource_packs

در هنگام توسعه، Packها را داخل این پوشه‌ها قرار می‌دهیم.

بعد از کامل شدن پروژه می‌توان آن را برای انتشار بسته‌بندی کرد.

━━━━━━━━━━━━━━━━━━━━ ⚙️ بخش 6 — manifest.json ━━━━━━━━━━━━━━━━━━━━

مهم‌ترین فایل هر Pack، فایل manifest.json است.

هر Behavior Pack یا Resource Pack حداقل به manifest.json نیاز دارد.

نمونه ساده Behavior Pack:

{ "format_version": 2, "header": { "name": "My Behavior Pack", "description": "My first Minecraft Bedrock Behavior Pack", "uuid": "11111111-1111-1111-1111-111111111111", "version": [1, 0, 0], "min_engine_version": [1, 21, 50] }, "modules": [ { "type": "data", "uuid": "22222222-2222-2222-2222-222222222222", "version": [1, 0, 0] } ] }

نکته بسیار مهم:

UUID هر Pack باید Unique باشد.

یعنی برای Packهای مختلف نباید UUID یکسان استفاده کنیم.

━━━━━━━━━━━━━━━━━━━━ 🎨 بخش 7 — manifest مربوط به Resource Pack ━━━━━━━━━━━━━━━━━━━━

نمونه:

{ "format_version": 2, "header": { "name": "My Resource Pack", "description": "My first Minecraft Bedrock Resource Pack", "uuid": "33333333-3333-3333-3333-333333333333", "version": [1, 0, 0], "min_engine_version": [1, 21, 50] }, "modules": [ { "type": "resources", "uuid": "44444444-4444-4444-4444-444444444444", "version": [1, 0, 0] } ] }

━━━━━━━━━━━━━━━━━━━━ 🆔 بخش 8 — UUID چیست؟ ━━━━━━━━━━━━━━━━━━━━

UUID یک شناسه منحصربه‌فرد برای Pack است.

برای هر Pack باید UUID مخصوص خودش را داشته باشیم.

مثلاً:

11111111-1111-1111-1111-111111111111

اما در پروژه واقعی نباید از UUIDهای نمونه بالا استفاده کنید.

برای هر پروژه UUID جدید تولید کنید.

━━━━━━━━━━━━━━━━━━━━ 📦 بخش 9 — ساخت اولین آیتم اختصاصی ━━━━━━━━━━━━━━━━━━━━

فرض کنیم می‌خواهیم یک آیتم به نام Moon Gem بسازیم.

ساختار Behavior Pack:

behavior_pack/ ├── manifest.json └── items/ └── moon_gem.json

و در Resource Pack:

resource_pack/ ├── manifest.json ├── textures/ │ └── items/ │ └── moon_gem.png └── textures/ └── item_texture.json

━━━━━━━━━━━━━━━━━━━━ 🧱 بخش 10 — فایل آیتم ━━━━━━━━━━━━━━━━━━━━

در فایل:

items/moon_gem.json

تعریف آیتم را قرار می‌دهیم.

نمونه:

{ "format_version": "1.21.50", "minecraft:item": { "description": { "identifier": "xmoon:moon_gem", "menu_category": { "category": "items" } }, "components": { "minecraft:max_stack_size": 64 } } }

شناسه آیتم ما:

xmoon:moon_gem

است.

قسمت xmoon نام Namespace ماست.

قسمت moon_gem نام آیتم است.

━━━━━━━━━━━━━━━━━━━━ 🖼️ بخش 11 — Texture آیتم ━━━━━━━━━━━━━━━━━━━━

برای آیتم یک تصویر PNG بسازید.

مثلاً:

moon_gem.png

و آن را در:

textures/items/

قرار دهید.

سپس Texture را در item_texture.json معرفی کنید.

نمونه:

{ "resource_pack_name": "My Resource Pack", "texture_name": "atlas.items", "texture_data": { "moon_gem": { "textures": "textures/items/moon_gem" } } }

━━━━━━━━━━━━━━━━━━━━ 🎮 بخش 12 — تست آیتم ━━━━━━━━━━━━━━━━━━━━

بعد از فعال کردن Behavior Pack و Resource Pack می‌توان آیتم را تست کرد.

برای مثال:

/give @s xmoon:moon_gem

اگر همه چیز درست باشد، آیتم به Inventory داده می‌شود.

━━━━━━━━━━━━━━━━━━━━ 🔗 بخش 13 — وصل کردن Behavior Pack و Resource Pack ━━━━━━━━━━━━━━━━━━━━

اگر Behavior Pack به Resource Pack نیاز داشته باشد، می‌توان آن‌ها را با dependency به هم متصل کرد.

در manifest مربوط به Behavior Pack می‌توان Resource Pack را به عنوان dependency معرفی کرد.

برای این کار UUID مربوط به Resource Pack را وارد می‌کنیم.

نکته:

UUID باید دقیقاً با UUID مربوط به Pack مقصد یکی باشد.

━━━━━━━━━━━━━━━━━━━━ 💻 بخش 14 — Script در Add-on ━━━━━━━━━━━━━━━━━━━━

برای ساخت سیستم‌های پیشرفته‌تر می‌توان از JavaScript/TypeScript و Script API استفاده کرد.

مثلاً می‌توان سیستم‌هایی مثل:

• سیستم Quest
• سیستم GUI
• سیستم پول
• سیستم Teleport
• سیستم Event
• سیستم مدیریت بازیکنان
• سیستم‌های اختصاصی سرور

را با Script ساخت.

━━━━━━━━━━━━━━━━━━━━ 📜 بخش 15 — ساخت Script ━━━━━━━━━━━━━━━━━━━━

در Behavior Pack پوشه زیر را بسازید:

scripts/

و داخل آن:

main.js

قرار دهید.

ساختار:

behavior_pack/ ├── manifest.json └── scripts/ └── main.js

━━━━━━━━━━━━━━━━━━━━ ⚙️ بخش 16 — معرفی Script در manifest ━━━━━━━━━━━━━━━━━━━━

برای Script باید یک module از نوع script در manifest تعریف شود.

همچنین dependency مربوط به:

@microsoft/server

یا API مناسب نسخه مورد استفاده باید به شکل صحیح تعریف شود.

نسخه Script API باید با نسخه Minecraft و API مورد استفاده سازگار باشد.

همیشه قبل از انتشار Add-on، مستندات نسخه فعلی Minecraft Bedrock را بررسی کنید.

━━━━━━━━━━━━━━━━━━━━ 🧪 بخش 17 — تست Add-on ━━━━━━━━━━━━━━━━━━━━

بعد از ساخت Pack:

1. Minecraft Bedrock را باز کنید.
2. یک World بسازید یا وارد World شوید.
3. Behavior Pack را فعال کنید.
4. Resource Pack را فعال کنید.
5. اگر Script دارید، تنظیمات لازم برای Script را مطابق نسخه فعلی فعال کنید.
6. وارد World شوید.
7. Add-on را تست کنید.

اگر چیزی کار نکرد، Console/Log را بررسی کنید.

━━━━━━━━━━━━━━━━━━━━ ❌ بخش 18 — خطاهای رایج ━━━━━━━━━━━━━━━━━━━━

خطای اول:

Pack اصلاً نمایش داده نمی‌شود.

دلایل احتمالی:

• manifest.json اشتباه است.
• JSON مشکل دارد.
• UUID اشتباه است.
• فایل در مسیر اشتباه قرار گرفته.
• نام فایل یا پوشه اشتباه است.

خطای دوم:

آیتم وجود ندارد.

دلایل احتمالی:

• identifier اشتباه است.
• فایل آیتم در مسیر اشتباه است.
• manifest مشکل دارد.
• Behavior Pack فعال نشده است.

خطای سوم:

آیتم ظاهر ندارد.

دلایل احتمالی:

• Texture اشتباه است.
• item_texture.json اشتباه است.
• نام Texture با نام معرفی‌شده یکی نیست.
• Resource Pack فعال نشده است.

خطای چهارم:

Script اجرا نمی‌شود.

دلایل احتمالی:

• module مربوط به Script در manifest وجود ندارد.
• dependency اشتباه است.
• نسخه API با نسخه Minecraft سازگار نیست.
• مسیر فایل main.js اشتباه است.
• خطای JavaScript وجود دارد.

━━━━━━━━━━━━━━━━━━━━ 📁 بخش 19 — نام‌گذاری صحیح فایل‌ها ━━━━━━━━━━━━━━━━━━━━

در Add-on نام فایل‌ها و پوشه‌ها بسیار مهم است.

مثلاً:

manifest.json

با:

Manifest.json

ممکن است یکسان در نظر گرفته نشود.

همچنین مسیر:

textures/items/

با مسیر اشتباه متفاوت است.

بنابراین نام فایل‌ها را دقیقاً مطابق ساختار مورد نیاز قرار دهید.

━━━━━━━━━━━━━━━━━━━━ 🧩 بخش 20 — ساخت یک Add-on حرفه‌ای ━━━━━━━━━━━━━━━━━━━━

برای یک Add-on حرفه‌ای بهتر است پروژه را مرتب نگه دارید.

مثلاً:

XMOON_Addon/ │ ├── BP/ │ ├── manifest.json │ ├── items/ │ ├── blocks/ │ ├── entities/ │ ├── recipes/ │ ├── functions/ │ ├── scripts/ │ └── loot_tables/ │ ├── RP/ │ ├── manifest.json │ ├── textures/ │ ├── models/ │ ├── animations/ │ ├── entity/ │ └── texts/ │ ├── README.md └── CHANGELOG.md

━━━━━━━━━━━━━━━━━━━━ 📝 بخش 21 — README ━━━━━━━━━━━━━━━━━━━━

برای پروژه‌های بزرگ بهتر است یک README داشته باشید.

مثلاً:

XMOON Add-on

Minecraft Bedrock Add-on

Version: 1.0.0

Features:

• Custom Items
• Custom Blocks
• Custom Entities
• Custom Recipes
• Custom Systems

Minecraft Version: 1.21.50

━━━━━━━━━━━━━━━━━━━━ 🔄 بخش 22 — Version ━━━━━━━━━━━━━━━━━━━━

هر بار که Add-on را آپدیت می‌کنید، بهتر است Version را افزایش دهید.

مثلاً:

[1, 0, 0]

بعد:

[1, 0, 1]

و بعد:

[1, 1, 0]

و برای نسخه بزرگ‌تر:

[2, 0, 0]

━━━━━━━━━━━━━━━━━━━━ 📦 بخش 23 — تبدیل پروژه به MCADDON ━━━━━━━━━━━━━━━━━━━━

برای انتشار Add-on می‌توان Packها را بسته‌بندی کرد.

ساختار پروژه باید صحیح باشد.

معمولاً فایل‌های Pack در ساختار درست قرار می‌گیرند و سپس بسته‌بندی می‌شوند.

پس از ساخت فایل Add-on، می‌توان آن را با Minecraft باز کرد تا Packها Import شوند.

━━━━━━━━━━━━━━━━━━━━ 🚀 بخش 24 — نکات مهم برای Add-on سازها ━━━━━━━━━━━━━━━━━━━━

1. همیشه UUID جدید برای پروژه‌های جدید بسازید.

2. JSON را با دقت بنویسید.

3. نام فایل‌ها و پوشه‌ها را دقیق وارد کنید.

4. Behavior Pack و Resource Pack را با هم هماهنگ کنید.

5. Script API را متناسب با نسخه Minecraft استفاده کنید.

6. قبل از انتشار، Add-on را در یک World آزمایشی تست کنید.

7. تغییرات را مرحله‌به‌مرحله انجام دهید.

8. اگر بعد از یک تغییر Add-on خراب شد، آخرین تغییر را بررسی کنید.

9. برای پروژه‌های بزرگ از ساختار مرتب استفاده کنید.

10. همیشه مستندات رسمی Minecraft Bedrock را برای نسخه فعلی بررسی کنید.

━━━━━━━━━━━━━━━━━━━━ ⭐ جمع‌بندی ━━━━━━━━━━━━━━━━━━━━

برای ساخت یک Add-on حرفه‌ای Minecraft Bedrock باید چند بخش اصلی را یاد بگیرید:

• Behavior Pack
• Resource Pack
• manifest.json
• UUID
• Items
• Blocks
• Entities
• Recipes
• Textures
• Models
• Animations
• Loot Tables
• Spawn Rules
• Script API

Behavior Pack بیشتر برای منطق و رفتار بازی است.

Resource Pack بیشتر برای ظاهر و منابع گرافیکی است.

manifest.json مشخص می‌کند Pack چیست و Minecraft چگونه باید آن را شناسایی و بارگذاری کند.

با ترکیب این بخش‌ها می‌توان Add-onهای بسیار پیشرفته‌ای برای Minecraft Bedrock ساخت.

با ❤️ تقدیم به کامیونیتی بدراک ایران