أدلة / البناء والموارد

استبدال الأصوات بحزمة موارد: sounds.json ومتطلّب ملفات .ogg

ماينكرافت لا تشغّل سوى Ogg Vorbis، وحدث الصوت ليس ملفًا. إليك ملف الربط، وكيفية إضافة صوت بدل استبداله، ولماذا يخرج صوتك صامتًا.

2026-06-25

فشل استبدال الأصوات يحدث بصمت أكثر من أي ميزة أخرى في حزم الموارد، وهو في الغالبية العظمى من الحالات واحد من أمرين: صيغة صوتية خاطئة، أو سوء فهم لما يعنيه حدث الصوت.

Ogg Vorbis فقط

ماينكرافت تشغّل .ogg (Vorbis) ولا شيء غيرها. ملف .mp3 أو .wav يُعاد تسميته إلى .ogg لن يُشغَّل — يجب أن يكون الحاوي فعليًا من نوع Ogg.

كذلك يهمّ الفرق بين أحادي القناة ومتعدد القنوات: الملفات أحادية القناة فقط هي التي تُموضَع في الفضاء ثلاثي الأبعاد. أما الملف متعدد القنوات فيُشغَّل بمستوى صوت ثابت في كل مكان، وهذا مناسب للموسيقى وغير مناسب لصوت كتلة. إذا بدا صوت السندان المخصّص لك وكأنه يتبعك أينما ذهبت، فهو متعدد القنوات.

حدث الصوت اسم، لا ملف

entity.pig.ambient هو حدث. يُربَط بقائمة من الملفات، يُختار منها ملف واحد عشوائيًا في كل مرة. استبدال صوت خنزير يعني إعادة تعريف الحدث، لا إسقاط ملف في مكان ما.

assets/minecraft/
├── sounds.json
└── sounds/custom/my_pig.ogg

{
  "entity.pig.ambient": {
    "replace": true,
    "sounds": [ "custom/my_pig" ]
  }
}

ثلاث تفاصيل:

• replace: true يتخلّص من القائمة الأصلية. إذا تركته خارجًا، فسيُضاف صوتك إلى المسبح، فيُشغَّل أحيانًا ويُشغَّل الأصل في غير ذلك. السلوكان مفيدان؛ والافتراضي هو الإضافة.
• المسارات تحذف sounds/ و.ogg. custom/my_pig يُحَلّ إلى assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json يقع في جذر assets/minecraft، لا داخل sounds/.

خيارات لكل ملف

"sounds": [
  { "name": "custom/my_pig", "volume": 0.8, "pitch": 1.2, "weight": 3, "stream": false }
]

• weight يرجّح الاختيار العشوائي داخل القائمة.
• stream: true لأي شيء يتجاوز بضع ثوانٍ — الموسيقى والأسطوانات. الملفات الطويلة غير المتدفقة تُحمَّل كاملة في الذاكرة وقد تُجمّد العميل.
• volume لا يمكن أن يتجاوز 1.0. الصوت الأعلى يعني ملف مصدر أعلى.

إضافة صوت جديد كليًا

استخدم نطاقك الخاص حتى لا يتصادم شيء:

assets/my_pack/sounds.json
assets/my_pack/sounds/spell.ogg

{ "spell": { "sounds": ["spell"] } }

ثم /playsound my_pack:spell master @a ~ ~ ~ 1 1. أحداث الصوت المخصّصة تعمل مع /playsound، وفي صناديق الموسيقى عبر تعريف أغنية صندوق موسيقى، وفي كتل النوتات عبر مكوّن note_block_sound لرأس اللاعب؛ لكنها لا ترتبط تلقائيًا بأي فعل في اللعبة.

لماذا هو صامت

1. ليس Ogg Vorbis حقيقيًا.
2. المسار يتضمّن sounds/ أو .ogg.
3. sounds.json ليس JSON صالحًا — فاصلة زائدة تُفسد الملف بأكمله، فيصمت كل صوت في الحزمة، لا الجديد فقط.
4. pack.mcmeta قديم — الإصدار 26.x يتطلّب min_format وmax_format، والحزمة التي تخلو منهما تظهر كغير متوافقة.

أوراق مرجعية سريعة لبنية مجلد الحزمة، وإعادة ربط أحداث الصوت، والأنسجة المتحركة موجودة في أدوات مرجع حزم الموارد.

أدوات مرجعية لحزم الموارد →