ما هي واجهة برمجة البرمجيات التركيبية؟
واجهة برمجة البرمجيات التركيبية هي عبارة عن نظام إنشاء ألعاب صغيرة مبني داخل ترانسفورمايس, يسمح للمستخدمين بإنشاء ألعاب صغيرة ضمن ترانسفورمايس عن طريق وضع برامج نصيّة محددة في وحدة التحكم الظاهرة بعد إدخال الإيعاز /lua.

ما هو البرنامج التركيبي؟
البرنامج التركيبي هو الاسم الذي يطلق على البرنامج النصي الذي يعمل بالغرفة, أو ببساطة لعبة صغيرة.

ما هي أنواع البرمجيات التركيبية؟
هناك ثلاثة أنواع أساسية من البرمجيات التركيبية؛ البرمجيات الرسمية المعتمدة, البرمجيات المعتمدة غير الرسمية, والبرمجيات غير المعتمدة.
• البرمجيات غير المعتمدة هو الاسم الذي يطلق على البرنامج النصي الذي يعمل في غرفة ما والذي لم تتم الموافقة عليه من قبل مسؤول (إداري).
• البرمجيات الرسمية تظهر في قائمة أنماط اللعبة, تسمح للاعبين بكسب 1 جبنة كل دقيقتان, ويمكن تحميلها في بيت القبيلة من خلال الإيعاز /module [اسم البرنامج التركيبي], وتعمل في جميع الغرف التي تبدأ بـ #اسم البرنامج التركيبي.
• البرمجيات غير الرسمية المعتمدة يمكن تحميلها في بيت القبيلة من خلال الإيعاز /module [اسم البرنامج التركيبي], وتعمل في جميع الغرف التي تبدأ بـ #اسم البرنامج التركيبي.

ما الاختلاف بين الغرف العادية وغرف البرمجيات التركيبية؟
هناك العديد من الاختلافات بين الغرف العادية وغرف البرمجيات التركيبية, نذكر أهمّها:
• يتم تعطيل جميع إحصائيات الملف الشخصي (كالجبنة المتحصل عليها أولاً, إلخ)
• يتم تعطيل الإيعاز /mort.
• يتم تعطيل نظام تفادي الرسالتين المكررتين (أي يتم تعطيل "هذه الرسالة مطابقة للرسالة الأخيرة")

من يستطيع استخدام واجهة برمجة البرمجيات التركيبية؟
يمكن لأي شخص استخدامها في بيت القبيلة, ولكن يجب أن يكون لدى هذا الشخص أكثر من 1000 جبنة و أن يكون لديه الإذن لاستخدام الإيعاز /np (أي تشغيل خرائط جديدة في بيت القبيلة), وأنه لم يتم حظره لاستخدامه أحد برامج القرصنة أو الغش.
بالإضافة إلى ذلك, يمكن للاعبين في فريق البرمجيات التركيبية استخدامها في أي غرفة تبدأ بـ #.

ما هي البرمجيات التركيبية الرسمية حالياً؟
يمكنك الدخول إلى "نمط اللعبة" أو إدخال الإيعاز /module لترى قائمة البرمجيات التركيبية الرسمية. الرقم بعد اسم البرنامج (أو اللعبة الصغيرة) هو عدد اللاعبين الموجودين حالياً في غرف هذه اللعبة الصغيرة.


ما هي البرمجيات التركيبية المعتمدة حالياً؟
يمكنك الإطّلاع على قائمة تحوي جميع البرمجيات التركيبية الرسمية باستخدام الطرق المذكورة في السؤال السابق, على الرغم من أن معظم اسمائم مذكورة أدناه.

#campal
#deathmatch
#deploy
#derby
#domination
#elimination
#fight
#football
#hidenseek
#infected
#pewpew
#pictionary
#playground
#powerup
#ratapult
#traitor


في حين أنه لا يوجد قائمة للألعاب المعتمدة غير الرسمية داخل اللعبة, بعضهم مذكور هنا.

#utility
#labyrinth
#spiritual
#bafflua
#control
#lagball
#survive
#dancedance
#keyhunt
#tagging
#palette
#playground


ما هو الفرق بين هذا و البوتّات (اللاعبون الآليون)؟
في حين أن البوتّات تعتمد على برنامج طرف ثالث للاتصال بمخدم اللعبة و غير مضمونة أن تكون دائماً متصلة بالانترنت, واجهة برمجة الألعاب الصغيرة مبنية داخل ترانسفورمايس وجميع البرمجيات التركيبية الرسمية يجب أن تكون متاحة, حتى بعد إجراء إعادة تشغيل للعبة مباشرةً.
البوتّات (حتى بوتّات المشرفين) لديها سيطرة أقل على الغرفة ويمكن فقط أن تؤدي المهام التي يمكن للمستخدمين العاديين أو المشرفين القيام بها, التي لم يتم تصميمها لألعاب الصغيرة.

هل هناك قائمة توضح إمكانيات واجهة برمجة الألعاب الصغيرة؟
هناك قائمة رسمية لإمكانيات وصلاحيات ووظائف واجهة برمجة الألعاب الصغيرة هنا. على الرغم من أن هذه القائمة إنجليزية, سيتم استحداث قائمة عربية قريباً.

من في فريق البرمجيات التركيبية؟
قائمة أعضاء فريق البرمجيات التركيبية خاصة, ولكن يمكنك الاتصال بأي من الأعضاء المذكورة اسمائهم أدناه إذا كانت لديك أي استفسارات حول البرمجيات التركيبية ككل. أعضاء الفريق قادرون على تشغيل الألعاب الصغيرة في الغرف التي تبدأ بـ #, ولكن ليست وظيفتهم تشغيل الألعاب الصغيرة للاعبين الآخرين.
• Jordynl
• Shamousey
• Thewav
• Makinit
• Safwanrockz

كيف يمكنني الانضمام إلى فريق البرمجيات التركيبية؟
توجد بضعة شروط للانضمام إلى فريق البرمجيات التركيبية:
• أن تكون لديك معرفة سابقة للبرمجة بشكلٍ عام, و معرفة للبرمجة بلغة الـ Lua بشكلٍ خاص.
• أن تتحدث باللغة الإنجليزية بطلاقة, للتواصل مع أعضاء الفريق الآخرين.
• سيتم أخذ سجل العواقب الخاص بك (على المنتديات وفي اللعبة) بعين الاعتبار.
لا يوجد شرط عمري للانضمام إلى فريق البرمجيات التركيبية, على عكس مناصب موظفي ترانسفورمايس؛ أي يمكنك الانضمام مهما كان عمرك.
للتقدم, أقرأ هذا الموضوع.

أين يمكنني الحصول على مساعدة في البرمجة؟
إذا كنت تحتاج إلى مساعدة في تطوير الألعاب الصغيرة وبرمجة البرمجيات التركيبية, ضع استفسارك في هذا الموضوع! بالمثل, يمكنك وضع استفسارك باللغة الإنجليزية في هذا الموضوع أيضاً.

كيف يمكنني الحصول على موافقة للعبةٍ صغيرة طورتها بنفسي؟
فقط أعضاء فريق البرمجيات التركيبية يمكنهم إدارة الألعاب الصغيرة. إذا كنت ترغب في الحصول على موافقة للعبتك الصغيرة, يمكنك إمّا تقديم طلب للانضمام إلى الفريق أو الطلب من أحد أعضاء الفريق لتشغيلها لك.

لماذا يتم تعطيل وظائف معينة في بيت القبيلة؟
في حين أن تلك الوظائف مدرجة في قائمة وظائف الواجهة, هناك بعض الوظائف التي لا تتوفر عند استخدام واجهة برمجة الألعاب الصغيرة في بيت القبيلة.
• tfm.exec.chatMessage: يتم تعطيل هذه الوظيفة لمنع انتحال الشخصيات وإزعاج الناس.
• system.newTimer و system.removeTimer: يتم تعطيل هاتين الوظفيتين نظراً لكونهما ثقيلتان على موارد المخدم الخاص باللعبة.
• system.loadFile و system.saveFile: يتم تعطيل اتين الوظفيتين نظراً لاستخدامهم للكثير من مساحات التخزين.
• tfm.exec.addImage و tfm.exec.removeImage: يتم تعطيل اتين الوظفيتين بسبب الانتهاكات المحتملة بوضع صور غير لائقة.
• tfm.exec.setRoomMaxPlayers: لا تعطي هذه الوظيفة خطأ, لكن لا تعمل في بيت القبيلة أي لا تمنع اللاعبين من الانضمام إلى غرفة بيت القبيلة.

ما هي الـ Lua؟
Lua (قادمة من كلمة "قمر" في اللغة البرتغالية) هي لغة برمجة خفيفة صممت لتكون لغة برمجة نصية ذات دلالات موسّعة.

لماذا تم استخدام لغة البرمجة Lua, ولم يتم استخدام بعض اللغات الأخرى؟
نظراً لكونها خفيفة ذات تركيب سهل التعلم, ومصمّمة ليتم استخدامها كلغة برمجة لواجهات برمجة التطبيقات التي توضع في برامج أخرى. هذه اللغة معروفة جيداً وتحوي على العديد من قوائم الوظائف والصلاحيات الخاصة بهذه اللغة على شبكة الأنترنت.

يتم تشغيل البرمجيات التركيبية أساساً عن طريق الأحداث (Events), أي يتم تشغيل كل البرنامج النصي في حدث. تحتوي واجهة برمجة الألعاب الصغيرة على العديد من الأحداث المتعلقة باللعبة التي يمكنك استخدامها, فعلى سبيل المثال كتابة !أمر ما. (كـ !shaman في #utility), أو عندما ينضم لاعب ما إلى اللعبة, أو عندما يضغط لاعب ما مفتاح معين, أو عندما يحصل على الجبن, والكثير من الأحداث. سوف يتم تشغيل أي شيء ليس داخل دالة (وظيفة) ما بمجرد تشغيل البرنامج النصي.

يمكنك استخدام حدث ما عن طريق تعيينها كدالة.

function eventPlayerGetCheese(name) -- الحدث لحصول لاعب ما على الجبنة.
--يمكنك فعل ما تشاء هنا, وسيتم تطبيقه عند حصول لاعب ما على الجبنة.
end

فعلى سبيل المثال:

function eventPlayerGetCheese(name)
print("لقد حصل اللاعب "..name.." على الجبنة!")
end

هذا البرنامج النصي سيكتب "لقد حصل اللاعب (اللاعب المحدد) على الجبنة!" بمجرد حصول أحد اللاعبين على الجبنة.

بالنسبة إلى الوظائف, كل وظيفة تحتوي على عوامل متغيرة, توجد بين الأقواس. فعلى سبيل المثال:

tfm.exec.newGame(عدد صحيح: رمز الخارطة)

يمكنك عن طريق هذه الوظيفة تشغيل خارطة ما, على شرط أن يكون رمز الخارطة مجرداً من الرمز @. فعلى سبيل المثال:

tfm.exec.newGame(0)

هذا البرنامج النصي سيشغل الخارطة 0.