244 تأثيرًا بيكسليًا، كل واحد منها قطعة كود صغيرة يمكن قراءتها

ظهر pixelfx في 30 أكتوبر وجمع 5,960 نجمة في نحو أسبوع. لا يشحن أوزانًا ولا API. يشحن 244 ملفًا، كل واحد يحتوي تأثيرًا واحدًا، كل واحد قصير بما يكفي لقراءته في جلسة.
نار وانفجارات وماء وجليد وبرق وخيال علمي وقتال متلاحم وارتطامات ومقذوفات وظهور وموت وسحر وقداسة وظل وحالات وطبيعة وطقس وواجهة وعناصر التقاط وانتقالات ومخلوقات صغيرة واثنتا عشرة حركة كاملة. كلها في `src/fx//.js`.
التوزيع مقصود: أحد عشر إلى ثلاثة عشر تأثيرًا لكل فئة، لا مئة في كومة واثنان في أخرى. مكتبة بهذا الحجم قابلة للتصفح. ومكتبة بتسعمئة مشكلة بحث.
الطريقة جاءت من مكان ما
README ينسب الفضل. المقاربة مقاربة Hugo Duprez، من مقال بعنوان «How to make (good) pixel art effects with Claude»، وتتلخص في ثلاث تعليمات: الكود طين، وثِق بعينيك، وغذِّ مراجعك.
تأثيراته المفتوحة في Sprite Fusion وضعت المعيار، و`src/core/sim.js` في هذا المستودع يعدّل كوده مع إسناد في أعلى الملفات التي تفعل ذلك. وهذا المشروع الفكرة نفسها على مقياس مكتبة، مع مهارة تُبقيها مستمرة.
سبب نجاح الكود كوسط لهذا يستحق القول. تأثير بيكسلي محاكاة صغيرة: جزيئات لها سرعة وجاذبية وعمر، تُدمج على لوحة قماش بدقة منخفضة ثم تُطابق بلوحة ألوان. مكتوبًا كبيانات مع حلقة، هو قابل للفحص والضبط والنقل. ومصدَّرًا كلوحة إطارات، هو تسلسل ثابت وكل معامل مجمّد.
ولهذا تُشغَّل التأثيرات هنا حية، وتُعاد تلوينها، وتُنعكس، وتُصدَّر. الكود هو الأصل ولوحة الإطارات منتج ثانوي.
الشخصيات تتحرك فعلًا
التفصيل الذي يفصل هذا عن حزمة جزيئات في الفقرة الثانية من README: كل تأثير يشمل شخصية يُمثَّل أداءً. يتهيأ، وينطلق، ويتجمّد عند التلامس، ويتعافى، والهدف يتلقى الضربة.
اثنتا عشرة حركة كاملة تسلسل التأثيرات في هجمات من التهيؤ إلى التعافي: إطلاق سهم، وضربة اندفاع، ورفس أرضي، ورمي كرة نار، وضربة أرضية، وضربة مقدسة، وست غيرها.
هذا حرفة تحريك معبَّرة كبنية بيانات. التأثير الذي يُشغَّل فقط يبدو جيدًا في معرض وخاطئًا في لعبة، لأن اللعبة فيها توقع ونتيجة. التهيؤ يخبر اللاعب أن شيئًا قادم. والتجمد عند التلامس هو تسجيل الإصابة. والتعافي هو الإذن بالفعل مرة أخرى.
ترميز ذلك بثلاث مراحل لكل تأثير يعني أن المكتبة تحمل معرفة توقيت لا إطارات فقط. ويعني أيضًا أن المخرج متوافق مع طريقة تسلسل حلقة اللعبة للأحداث، وهو الفرق بين أصل صالح للاستخدام وأصل يجب إعادة توقيته.
استخدام أحدها
في لعبة متصفح، أو canvas، أو Phaser، أو PixiJS، أو Kaplay، أو three.js، الاستيراد مباشر ولا تبعيات:
import { createFrame, clearFrame, createFx, composite } from "pixelfx";
import * as frostNova from "pixelfx/fx/ice/frost-nova";
كل تأثير وحدة، فالحزمة تشحن ما استُورد فقط. وهذا أهم مما يبدو: مكتبة يمكن تقليمها إلى frost nova واحدة هي مكتبة تضعها في مشروع سريع دون التفكير في الوزن.
المعرض على patch-gg.github.io/pixelfx يشغّل كل شيء دفعة واحدة، وثمة فهرس في `docs/CATALOG.md` يسرد الـ244 بالفئات. وللمحركات التي تريد إطارات لا كودًا، تصدير لوحة الإطارات يتولى ذلك.
المهارة، ومعنى «صعب الإرضاء» هنا
النصف الآخر من المستودع مهارة Claude Code تصنع تأثيرات جديدة «كما يفعل فنان بيكسل صعب الإرضاء»: مسودة، وتصيير، ونظر، وتنقيح.
هذه الحلقة هي الجزء المثير. يكتب الوكيل تأثيرًا مرشحًا، ويصيّره، وينظر إلى النتيجة، ويغيّره. والمستودع يوفّر المصيّر والمعرض اللذين يجعلان النظر ممكنًا، وهو الشرط المسبق الحقيقي. والوكيل الذي لا يرى مخرجه لا يستطيع إلا إنتاج كود يُترجم.
ملاحظة الطريقة في README، ثِق بعينيك وغذِّ مراجعك، نصيحة للإنسان كما للنموذج. المهارة تعمل لأن حلقة التغذية الراجعة بصرية ومحكمة، لا لأن النموذج ذوّاق.
ثلاث طرق للخروج من المكتبة
التصدير حيث يجب أن يبرهن كود أولًا أنه أكثر من عرض. يعرض المستودع التأثيرات كوحدات قابلة للاستيراد، وكتشغيل حي في المعرض مع تحكم التلوين والانعكاس، وكلوحات إطارات للمحركات التي تريد إطارات.
مسار لوحة الإطارات هو التنازل، وهو ما ستستخدمه معظم فرق الألعاب أولًا. اللوحة تسلسل ثابت: لا معاملات، ولا كلفة وقت تشغيل، ولا سبيل لتغيير وميض الإصابة لحظة الارتطام. وهي أيضًا ما يحتاجه محرك غير JavaScript، وما يحتاجه فنان قبل أن يقرر إن كان تأثير يستحق التكييف.
التلوين والانعكاس أهم مما يبدوان لمكتبة بـ244 تأثيرًا. تأثير جليدي واحد بأربعة تلوينات وانعكاسين هو ثمانية أصول من ملف واحد، وهكذا تغطي مكتبة صغيرة لعبة كبيرة.
لماذا تبقى المكتبة مهمة في عصر الوكلاء
الاعتراض البديهي: إن كان الوكيل يكتب أي تأثير عند الطلب، فلماذا تنزيل 244 منها؟
سببان، وكلاهما مرئي في بنية المستودع.
الأول أرضية. الوكيل المطلوب منه كرة نار سينتج كرة نار. والوكيل الذي أمامه 244 تنفيذًا مرجعيًا، كل منها مكتوب بالاصطلاحات نفسها وبنية المراحل نفسها، سينتج شيئًا يناسب المكتبة. الاصطلاحات هي الجزء الغالي في قاعدة كود مشتركة، ومجموعة أمثلة متسقة هي وسيلة نقلها.
والثاني أن بعض المعرفة ليست في الطلب. سلسلة الحركات الاثنتي عشرة بتهيؤها وتجمدها وتعافيها قرار تصميمي عن إحساس اللعبة. تستطيع وصفه بجملة، لكن القيمة في تطبيقه 244 مرة بحيث يطيع كل تأثير قواعد التوقيت نفسها.
هذا ما المكتبة: ليست كومة أصول، بل مجموعة قرارات اتُّخذت باتساق.
الرخصة وشكل الشيء
MIT. من تأليف patch-gg، ومعدّل جزئيًا من عمل Duprez المفتوح مع إسناد، وصادق بشأن ما استُعير.
المستودع عمره أسبوع، وهو من نوع المشاريع التي تميل إلى النمو، لأن المهارة تجعل إضافة التأثير 245 رخيصة. وإن نما، فالرقم المثير لن يكون عدد النجوم. بل هل سيبدو التأثير 250 مثل الـ244 الأولى، وهو الاختبار الحقيقي الوحيد لكون الاصطلاحات انتقلت أم أن الملفات نُسخت فقط.
حاليًا المستودع جواب جيد لسؤال يظهر كلما قال أحد إن الكود صيغة الأصول الجديدة. وهنا حالة يكون فيها ذلك صراحة: 244 تأثيرًا، كل واحد ملف تقرأه، وكل واحد محاكاة تعيد ضبطها، وكل ذلك صغير بما يكفي لتحمله في رأسك تأثيرًا واحدًا في المرة.
مقالات ذات صلة
الوكلاء ينتقلون إلى السحابة: المهمة تكمل بعد أن تغلق حاسوبك، بأدواتك الناقصة
المهمة تكمل في آلة سحابية بعد إغلاق الحاسوب، لكن ما تفقده هو أدواتك الداخلية، وما لم يُحل بعد هو من يوافق على الأفعال الخطرة.
إنفيديا تنشر أربعة نماذج عالم بـ16 مليار معامل، ثم إطار فك ترميز أسرع 25 مرة في الهندسة
أربعة مولّدات عالم بـ16 مليار معامل مع وصفات التدريب، وإطار فك ترميز يصدر الهندسة في طلقة واحدة. والتقييم ما زال ناقصاً.
المهارات تحتل ربع قائمة GitHub الرائجة، وكل مستودع يطلب طريقة تثبيت مختلفة
المهارة مجلد فيه تعليمات، لكن تثبيتها صار أربع طرق مختلفة، والفوضى تبدأ حين تتكرر المهارة نفسها في وكيل واحد.
نموذج بـ594 مليار معامل يتصدر النتائج، والأوزان التي تثبت ذلك ليست متاحة
نموذج قوي وأرقام جيدة ووصفة تدريب تستحق القراءة، لكن الأوزان التي تجعل الادعاء قابلاً للتحقق لم تُشحن بعد.