محرر .mcstructure — ملفات بنية Bedrock

يدعم Minecraft Bedrock Edition وJava Edition — وجميع برمجيات الخوادم لكليهما، الشائعة والنادرة: Vanilla, Paper, Spigot, Purpur, Folia, Fabric, Forge, NeoForge, Mohist, Sponge, Bedrock Dedicated Server, PocketMine-MP, Nukkit, PowerNukkitX, Cloudburst, Dragonfly, Endstone, LeviLamina وغيرها. القائمة الكاملة.

ملف .mcstructure هو NBT غير مضغوط بترتيب بايتات little-endian تكتبه كتلة بنية في Bedrock. أفلت ملفًا أدناه لقراءة أبعاده ولوحة الكتل وفهارس الكتل وبيانات كيانات الكتل، وتعديل أي منها، ثم تنزيل الملف مجددًا بالترميز نفسه — وهذا ما يحتاجه صانعو الإضافات والخرائط لتصحيح بنية من دون إعادة فتح العالم.

كتل البنيةإضافات Bedrockحزم السلوكNBT بترتيب little-endian

أفلت ملف .mcstructure هنا

level.dat · .nbt · .mcstructure · .schem · .schematic · .dat · بيانات مقاطع مستخرجة

ما الذي يوجد داخل .mcstructure

الوسمالنوعما الذي يحتويه
format_versionIntمراجعة تنسيق البنية، وقيمتها 1 في الملفات الحالية
sizeقائمة من Intأبعاد الحجم الملتقط على المحاور X وY وZ
structure_world_originقائمة من Intالموضع الذي التُقطت منه البنية في العالم
structureCompoundتوجد هنا جميع البيانات التالية
structure.block_indicesقائمة من Int[]طبقتان من فهارس اللوحة — للكتل والتشبع بالماء عادةً؛ وتعني -1 «اترك الموجود في الموضع كما هو»
structure.entitiesقائمة من Compoundالكيانات التي التُقطت مع البنية
structure.palette.default.block_paletteقائمة من Compoundكل حالة كتلة مميزة: name وstates وversion
structure.palette.default.block_position_dataCompoundبيانات NBT لكيان الكتلة، ومفتاحها الفهرس المسطح للموضع

تسير الفهارس في block_indices وفق X ثم Z ثم Y، ويكون الفهرس المسطح (x * sizeZ + z) * sizeY + y داخل قائمة اللوحة. يتيح لك هذا الربط إصلاح كتلة واحدة مضبوطة خطأ من دون إعادة إنشاء البنية.

التعديلات الشائعة هنا

  • استبدال نوع كتلة في جميع المواضع بتعديل إدخال واحد في block_palette؛ فتتغير معه كل المواضع التي تشير إلى ذلك الفهرس.
  • تصحيح حالة كتلة مثل قيمة facing خاطئة أو قيمة waterlogged غير مقصودة داخل مركب states.
  • إزالة الكيانات التي التُقطت بالخطأ، وذلك بحذف إدخالاتها من قائمة entities.
  • إصلاح بيانات كيان كتلة — مثل محتويات الصندوق ونص اللافتة وإعدادات المولّد — داخل block_position_data.
  • التحقق من ختم الإصدار في إدخالات اللوحة عندما يؤدي تحديث اللعبة إلى استيراد البنية بكتل خاطئة.

أماكن وجود الملفات

تحفظ كتل البنية الملفات في مجلد structures/ داخل مجلد العالم، بأسماء من النمط <namespace>_<name>.mcstructure. وتضعها حزم السلوك في مجلد structures/ داخل الحزمة، حيث تحمّلها اللعبة بحسب مساحة الاسم. يستخدم الموضعان التنسيق نفسه، ويمكن فتح ملفاتهما هنا.

المكافئ في Java Edition هو ملف البنية .nbt المضغوط بـ gzip والمرمّز بترتيب big-endian؛ وهو ترميز مختلف بتخطيط وسوم مختلف. تشرح صفحة محرر Java هذه الملفات، ويمكن لهذا المحرر فتحها أيضًا.

الأسئلة الشائعة

هل يمكنني تحويل .mcstructure إلى بنية Java بصيغة .nbt؟

يمكن للمحرر إعادة ترميز البايتات إلى big-endian مضغوط بـ gzip، لكن تخطيط الوسوم مختلف؛ إذ تستخدم بُنى Java الوسمين palette/blocks بمفاتيح وأسماء كتل مختلفة. يمكن قراءة الملف المعاد ترميزه، لكنه ليس بنية Java صالحة.

لماذا لا يكون ملف .mcstructure مضغوطًا؟

يكتب Bedrock ملفات البنية بصيغة NBT خام بترتيب little-endian ومن دون غلاف gzip. هذا طبيعي؛ ويكتشفه المحرر على أنه Bedrock الخام.

ماذا يعني الفهرس -1 في block_indices؟

يشير إلى موضع لا تعدّله البنية، ولذلك تبقى الكتلة الموجودة في العالم عند وضع البنية.

هل يمكن تغيير حجم البنية بتعديل size؟

ليس وحده؛ يحتوي block_indices إدخالًا لكل موضع، ولذلك يجب أن يطابق طول المصفوفة الحجم الجديد تمامًا. يؤدي تغيير size وحده إلى ملف ترفضه اللعبة.

أدوات مرتبطة