دستورهای ساخت سفارشی: شکل‌دار، بی‌شکل و استفاده از برچسب‌ها به‌جای فهرست کردن همه چوب‌ها

دستور ساختی با الگو که ساخته نمی‌شود معمولاً کلید اشتباه دارد یا الگوی آن با فاصله پر شده است. این JSON، ترفند برچسب برای ادغام هشت دستور ساخت در یکی و نحوه آزمایش آن است.

2026-06-29

دستورهای ساخت جزو ساده‌ترین فایل‌های datapack برای نوشتن و آسان‌ترین‌ها برای اشتباه کردن نامحسوس هستند، زیرا دستور خراب بدون خطا کار نمی‌کند — میز ساخت صرفاً هیچ واکنشی نشان نمی‌دهد.

شکل‌دار

{
  "type": "minecraft:crafting_shaped",
  "pattern": [ "SSS", "S S", "SSS" ],
  "key": { "S": "minecraft:stone" },
  "result": { "id": "minecraft:furnace", "count": 1 }
}

سه قانونی که باعث بیشترین خرابی‌ها می‌شوند:

• هر نویسه در pattern must exist in key، به‌جز فاصله، که به‌معنای خالی بودن است.
• الگو نسبی است، نه مطلق. یک دستور ساخت ۲×۲ باید به‌صورت دو ردیفِ

دوتایی نوشته شود، نه اینکه با فاصله به ۳×۳ تبدیل شود. پر کردن با فاصله باعث می‌شود فقط در همان گوشه دقیق شبکه قابل ساخت باشد.

• طول تمام ردیف‌ها باید یکسان باشد. ["SS", "S"] is invalid.

بی‌شکل

{
  "type": "minecraft:crafting_shapeless",
  "ingredients": ["minecraft:stone", "minecraft:coal"],
  "result": { "id": "minecraft:torch", "count": 4 }
}

ترتیب اهمیتی ندارد. موارد تکراری باید هرکدام جداگانه فهرست شوند — دو زغال یعنی دو ورودی.

برچسب‌ها یک خانواده را در یک دستور ساخت ادغام می‌کنند

به‌جای هشت دستور ساخت برای هشت نوع تخته‌چوب:

"key": { "P": "#minecraft:planks" }

مورد # marks an item tag. #minecraft:planks, #minecraft:logs, #minecraft:wool, #minecraft:stone_crafting_materials and dozens more already exist. Defining your own takes one file:

data/<namespace>/tags/item/my_metals.json

{ "values": ["minecraft:iron_ingot", "minecraft:gold_ingot"] }

نکته tags/item/ — singular item, plural tags. That inconsistency is real.

نتیجه همراه با مؤلفه‌ها

"result": {
  "id": "minecraft:diamond_sword",
  "count": 1,
  "components": { "minecraft:custom_name": "\"Excalibur\"", "minecraft:enchantments": { "sharpness": 5 } }
}

این‌گونه یک آیتم سفارشی بدون نیاز به مود قابل ساخت می‌شود.

سایر انواع دستور ساخت

crafting_shaped and crafting_shapeless are two of many. Also available: smelting, blasting, smoking, campfire_cooking, stonecutting, smithing_transform and smithing_trim. The cooking types take cookingtime and experience; stonecutting takes a single ingredient and a count.

آزمایش

/reload then try the grid. If nothing happens:

1. هنگام reload چت را بررسی کنید — JSON نامعتبر در آنجا گزارش می‌شود.
2. /recipe give @s <namespace>:<recipe> — if the recipe id is wrong, this errors, which

به شما می‌گوید که فایل اصلاً خوانده نمی‌شود.

1. باز شدن دستور ساخت از وجود داشتن آن جداست. یک دستور ساخت در شبکه کار می‌کند حتی اگر

هرگز در کتاب دستور ساخت نمایش داده نشود.

ساخت JSON برای دستور ساخت، predicate و kit با بررسی کلیدها و برچسب‌ها در سازنده‌های JSON دیتاپک.