الأدلةشرح عملي5 دقيقة للقراءةآخر تحديث 7 نوفمبر 2026

اعمل ريغ لنماذج ثلاثية الأبعاد وحرّكها من Claude Code: أعطِ وكيلك أداة ريغ، لا سكربت Blender

Q: هل يعمل خادم MCP مع عملاء غير Claude Code؟

نعم. إنه خادم MCP قياسي يعمل عبر stdio (npx afk-rig mcp)، فيشغّله Cursor و Windsurf و Claude Desktop وغيرها من عملاء MCP بالأمر نفسه مع AFK_API_KEY في بيئته.

Q: أين يتم الريغ؟

تعمل rig_model و image_to_character على خوادم afk.ai: ترفع الأداة الملف، وتنتظر، وتكتب النتيجة في مشروعك. يمر كل نموذج أولًا بفحص للمحتوى المخصص للبالغين، والنموذج الذي يرفضه الفحص يفشل ولا يكلّف شيئًا. أما أدوات الفحص والإصلاح فتعمل على حاسوبك.

أضف خادم afk-rig MCP، فيعمل Claude Code ريغ لشخصية أو حيوان أو مجسّم باستدعاء أداة واحد، ثم يفحص كل حركة ويصلح ما فيها من أخطاء.

احصل على مفتاح API طريقة الإعداد ↓

localhost:5173

claude · ~/game

> اعمل ريغ لـ models/fox.glb كحيوان رباعي الأرجل واجعله يركض في المشهد

● rig_model (path: "models/fox.glb", type: "fox", animations: ["Idle", "Walk", "Run"])

⎿

models/fox.rigged.glb · type fox · 3 animations · charge free

● Update (src/scene.js)

⎿

Updated src/scene.js with 9 additions

● عملتُ الريغ للثعلب وهو يركض الآن. وحركتا Idle و Walk في الملف أيضًا، جاهزتان للمزج.

جلسة Claude Code بعد إضافة afk-rig. الثعلب نموذج عمل له afk.ai الريغ، ويؤدي حركة Run في three.js.

اطلب من وكيل برمجة أن «يعمل ريغ لهذا النموذج ويجعله يمشي»، وغالبًا سيحاول فعل كل شيء بنفسه: سكربت Python لـ Blender يضع العظام، وأوزان تلقائية، ودورة مشي بالإطارات المفتاحية، وعرض اختباري، ثم جولة أخرى حين تنثني الركبتان في الاتجاه الخاطئ. قد يستهلك ذلك جلسة كاملة ولا يبدو صحيحًا في النهاية.

يمنحه خادم afk-rig MCP أداة واحدة بدلًا من ذلك. ترسل rig_model النموذج إلى أداة الريغ بالذكاء الاصطناعي نفسها التي يعمل بها afk.ai/rig، وتكتب ملف GLB فيه هيكل عظمي وأوزان جلد وكل الحركات الخاصة بنوع جسمه، عادةً في أقل من دقيقة. فيصرف الوكيل جهده على ما يجيده: الكود الذي يشغّل تلك الحركات في لعبتك.

لماذا يصعب الريغ اليدوي على الوكيل

يبدو الريغ مهمة برمجية، لكن معظمه تقدير لشكلٍ لا يراه الوكيل. فهو يعمل انطلاقًا من إحداثيات الرؤوس (vertices) والصناديق المحيطة (bounding boxes)، ولا يظهر أي خطأ إلا حين يتحرك شيء ما.

المفاصل: يخمّن مواضع الكتفين والوركين والركبتين. ومع شخصية ذات أسلوب فني خاص أو كلب أو تنين، كثيرًا ما تخطئ هذه التخمينات، ومفصل واحد في المكان الخطأ يفسد كل حركة بعده.
أوزان الجلد: تفشل الأوزان التلقائية في Blender مع كثير من الشبكات الحقيقية، تلك التي فيها أجزاء منفصلة أو ثقوب أو قطع متداخلة، برسالة "Bone Heat Weighting: failed to find solution for one or more bones". فيدور الوكيل في حلقة من إصلاحات الشبكة التي لا يستطيع التحقق منها بعينه.
الحركات: مشية وركضة ووقفة مقنعة تعني إطارات مفتاحية كثيرة يجب ضبطها دون مشاهدتها، وكل نوع جسم جديد يبدأ من الصفر.
التكلفة: كل محاولة تكلّف وقتًا وتوكنات، ونادرًا ما تعطي محاولتان على النموذج نفسه النتيجة نفسها.

استدعاء أداة واحد بدلًا من ذلك

تسلّم rig_model النموذج إلى أداة الريغ في afk.ai. يضع ذكاء اصطناعي مدرّب على تحديد أجزاء الجسم هيكلًا عظميًا مصممًا لذلك النوع من الأجسام، وتأتي أوزان الجلد من عملية ضُبطت على شبكات من العالم الحقيقي، والحركات صُممت لذلك الهيكل بالضبط، فتناسبه دون إعادة استهداف.

وما يعود ملف GLB قياسي يُحمَّل في three.js و Godot و Unreal و Unity (مع glTFast) و Blender. يحصل الإنسان على 66 عظمة بكل الأصابع و594 حركة، وتحصل أنواع الأجسام الأربعة عشر الأخرى على 12 إلى 128 حركة لكل منها. ولكل نماذج نوع الجسم الواحد أسماء العظام والحركات نفسها، فيحرّكها كلها متحكم واحد.

	الوكيل يعمل الريغ يدويًا	الوكيل يستدعي afk-rig
العمل	سكربتات وعروض اختبارية وإصلاحات، غالبًا على جولات كثيرة	استدعاء أداة واحد
الوقت	من دقائق إلى جلسة طويلة	عادةً من 30 ثانية إلى دقيقة
الهيكل العظمي	يُخمَّن من الإحداثيات	يضعه ذكاء اصطناعي مدرّب على تحديد أجزاء الجسم
الحركات	تُصنع بالإطارات المفتاحية واحدة تلو الأخرى	كلها مصممة لنوع الجسم

الشبكة: الفارس المزوّد بالريغ، كما يرسمه afk-rig — داخل `knight.rigged.glb`، كما يرسمه `afk-rig render`: الصور نفسها التي يحصل عليها وكيل الذكاء الاصطناعي من `render_rig`.

الهيكل العظمي: الفارس المزوّد بالريغ، كما يرسمه afk-rig — داخل `knight.rigged.glb`، كما يرسمه `afk-rig render`: الصور نفسها التي يحصل عليها وكيل الذكاء الاصطناعي من `render_rig`.

الإعداد

أنشئ مفتاح API من لوحة تحكم المطورين: سجّل الدخول بحساب Google، ثم اضغط Create key. بعد ذلك أضف الخادم إلى Claude Code:

claude mcp add afk-rig \
  --env AFK_API_KEY=afk_... \
  -- npx -y afk-rig mcp

وفي Cursor و Windsurf و Claude Desktop وغيرها من عملاء MCP، أضفه إلى mcp.json:

{
  "mcpServers": {
    "afk-rig": {
      "command": "npx",
      "args": ["-y", "afk-rig", "mcp"],
      "env": { "AFK_API_KEY": "afk_..." }
    }
  }
}

يبقى المفتاح في بيئة الخادم، فلا يدخل المحادثة أبدًا. ويحصل الوكيل على عشر أدوات: خمس تعمل الريغ في سحابة afk.ai، وخمس تفحص النموذج المزوّد بالريغ وتصلحه على حاسوبك.

afk-rig · 10 toolsconnected

في سحابة afk.aiيستخدم مفتاحك

rig_modelيعمل ريغ لملف ‎.glb أو ‎.gltf أو ‎.fbx ويكتب ملف ‎.glb المزوّد بالريغ
image_to_characterصورة تدخل، وشخصية مزوّدة بالريغ تخرج
list_body_typesأنواع الأجسام الـ 15 وحركات كل منها
get_accountعمليات الريغ المتبقية هذا الشهر
rig_statusعملية ريغ بدأت في مكان آخر

على حاسوبكمجانًا، دون مفتاح

inspect_rigما الخطأ في كل حركة، الأسوأ أولًا
render_rigصورة لأي لحظة، مع هيكلها العظمي مرسومًا فوقها
adjust_animationأدوات التحكم في التحريك من afk.ai/rig، مع إبقاء الذراعين خارج الجسم
fix_stretchingيعالج الجلد الذي يتمزق أثناء الحركة
fix_spotيعيد رسم أوزان الجلد في موضع واحد

ما يمنحه npx afk-rig mcp للوكيل. كل إصلاح يكتب ملفًا جديدًا، فلا يتغير أبدًا الملف الذي بدأ منه.

أمثلة لما تطلبه منه

بمجرد إضافته، اطلب بكلمات عادية. يختار الوكيل الأداة ونوع الجسم والحركات:

«اعمل ريغ لـ models/knight.glb كإنسان وشغّل سلسلة ضرباته بالسيف في مشهد three.js.»
«اعمل ريغ لـ models/fox.glb كحيوان رباعي الأرجل مع Idle و Walk و Run فقط، ثم أنشئ مشهد Godot يبدّل بينها.»
«اعمل ريغ لكل ملف ‎.glb في assets/props كمجسّم مع Bounce و Spin، واستخدمها للعملات والجواهر القابلة للالتقاط.»
«ما حركات نوع التنين؟ اعمل ريغ لـ dragon.glb مع حركات الطيران وأعدّ AnimationPlayer لها.»
«اعمل ريغ لـ horse.glb، ثم استورده في Unity كريغ Generic وابنِ animator controller مع Walk و Trot و Run.»
«اصنع شخصية مزوّدة بالريغ من concept/hero.png.» ليس لديك نموذج بعد؟ تصنع image_to_character نموذجًا من صورة وتعمل له ريغ، في نحو 2 إلى 3 دقائق.

humanSword combo
foxRun
objectBounce
dragonFly

ما تعود به الطلبات الأربعة الأولى، على نماذج عمل لها afk.ai الريغ: لكل نوع جسم حركاته الخاصة.

افحص ما صنعه وأصلحه

تعمل الأدوات الخمس الأخرى على حاسوبك بكود Adjust نفسه الذي يستخدمه afk.ai/rig: بلا مفتاح، وبلا أي رسوم، ولا يُرفع شيء. تجد inspect_rig الأقدام الغائصة في الأرض والجلد الممزق والأذرع التي تخترق الجسم، بدءًا بالأسوأ. وترسم render_rig أي لحظة من أي حركة، فيستطيع الوكيل أن ينظر إليها. وتصلحها adjust_animation و fix_stretching و fix_spot في ملف جديد، -v2.glb، فلا يتغير الملف الذي بدأ منه أبدًا.

وهكذا يحصل الوكيل على حلقة يستطيع تشغيلها وحده: افحص، واعرض أسوأ لحظة، وغيّر شيئًا واحدًا، ثم افحص مجددًا.

قبل: حركة Walk للفارس عند 1.633 s، كما يرسمها afk-rig — تشغيل حقيقي على الفارس أعلاه. تعمل الأدوات على حاسوبك، مجانًا، دون مفتاح API، ولا تغيّر أبدًا الملف الذي تقرؤه.

بعد: حركة Walk للفارس عند 1.633 s، كما يرسمها afk-rig — تشغيل حقيقي على الفارس أعلاه. تعمل الأدوات على حاسوبك، مجانًا، دون مفتاح API، ولا تغيّر أبدًا الملف الذي تقرؤه.

دع الوكيل يتولى الباقي

الريغ هو حيث يهدر الوكيل أكبر جهد مقابل أقل نتيجة. أما الربط فهو حيث يتألق: AnimationMixer في three.js، و AnimationPlayer في Godot، و animator controller في Unity، والمزج بين المقاطع، أو سكربت يعمل ريغ لكل نموذج تحتاجه مرحلة ما. والملف المزوّد بالريغ لا يبعد عن الحركة إلا بضعة أسطر:

const gltf = await new GLTFLoader().loadAsync('fox.rigged.glb')
scene.add(gltf.scene)
const mixer = new THREE.AnimationMixer(gltf.scene)
const run = THREE.AnimationClip.findByName(gltf.animations, 'Run')
mixer.clipAction(run).play() // then mixer.update(delta) every frame

لمعرفة كل ما يستطيع الـ API عمل ريغ له، بما في ذلك المجسّمات، راجع ما الذي يمكنك بناؤه بواجهة API للريغ من afk.ai.

أسئلة شائعة

هل يعمل خادم MCP مع عملاء غير Claude Code؟

نعم. إنه خادم MCP قياسي يعمل عبر stdio (npx afk-rig mcp)، فيشغّله Cursor و Windsurf و Claude Desktop وغيرها من عملاء MCP بالأمر نفسه مع AFK_API_KEY في بيئته.

أين يتم الريغ؟

تعمل rig_model و image_to_character على خوادم afk.ai: ترفع الأداة الملف، وتنتظر، وتكتب النتيجة في مشروعك. يمر كل نموذج أولًا بفحص للمحتوى المخصص للبالغين، والنموذج الذي يرفضه الفحص يفشل ولا يكلّف شيئًا. أما أدوات الفحص والإصلاح فتعمل على حاسوبك.

ما النماذج التي يستطيع عمل ريغ لها؟

GLB، أو glTF مع كل شيء مضمّن، أو FBX، حتى 200 MB، بما في ذلك الملفات المضغوطة بـ Draco و meshopt. اختر نوع الجسم المطابق للنموذج: human، أو fox (الحيوانات رباعية الأرجل)، أو horse (ذوات الحوافر)، أو bird، أو dragon، أو kaiju (الديناصورات)، أو spider، أو insect، أو snake، أو fish، أو turtle، أو kangaroo، أو frog، أو ghost، أو object.

كم يكلّف؟

أول 3 عمليات ريغ كل شهر مجانية، وهي الحصة نفسها التي يمنحك إياها afk.ai/rig. وبعد ذلك، تُخصم عمليات الريغ من رصيد API؛ راجع أسعار API. والريغ الفاشل لا يكلّف شيئًا، وأدوات الفحص والإصلاح مجانية دائمًا.

هل يمكنني استخدام النماذج المزوّدة بالريغ تجاريًا؟

نعم. الهياكل العظمية والحركات بترخيص CC0، ونموذجك يبقى ملكك.

أعطِ وكيلك أداة ريغ

كل الحركات الخاصة بنوع الجسم، في ملف GLB واحد، من Claude Code أو Cursor أو الطرفية أو كودك.

احصل على مفتاح API