وحدة API
كصانع، يمكنك تسمية الأساليب على الوحدات عندما تقوم بكتابة منطق القدرات التي تقوم بإنشائها.
فئة الأساليب
هذه الأساليب المختلفة المتاحة لك:
unit.heal(amount)
يضيف كمية الصحة المعطاة على شكل HP.
الحالة الصحية لا يمكن تتعدى الحد الأقصى.
الحجج
الكمية (العدد): كمية من HP لإضافتها.
unit.takeDamage(amount)
خصم من كمية الصحة المعطاة على شكل HP.
إذا كانت الوحدة مقيدة، فإنه سيتم إزالة التقييد عنها عند تضررها.
لا يمكن أن تكون الحالة الصحية أقل من الصفر. إذا وصلت للصفر، الوحدة ستموت و تختفي من الطابق.
الحجج
الكمية (العدد): كمية الـ PH المحددة لخصمها.
unit.damage(receiver, amount)
يضر وحدة أخرى.
إذا ماتت الوحدة الأخرى، الذي أضرها سيربح أو يفقد نفس العدد من النقاط المساوي لعدد مكافأت الوحدة و ذالك تبعاً لما إذا كانت الوحدة صديقة أو عدوة، على التوالي.
الحجج
المتلقي (الوحدة): الوحدة المحددة لإضرارها.
الكمية (العدد): كمية الـ الضرر الذي ستلحقه بـ HP.
unit.isAlive()
يحدد ما إذا كانت الوحدة على قيد الحياة.
الوحدة على قيد الحياة إذا كان لديها موضع.
يعود
(boolean): سواء كانت الوحدة على قيد الحياة أم لا.
unit.release(unit)
الإصدارات (يحل قيد) الوحدة الأخرى.
إذا كانت الوحدة الأخرى صديقة، المحرر سيكسب عدد نقاط مساوي المكافآت المحررة من طرف الوحدة.
الحجج
المتلقي (الوحدة): الوحدة المحددة لتحريرها.
unit.unbind()
فك قيد الوحدة.
unit.bind()
تقييد الوحدة.
unit.isBound()
تحديد ما إذا كانت الوحدة مقيدة.
يعود
(boolean): سواء كانت هذه الوحدة مقيدة أم لا.
unit.earnPoints(points)
يضيف النقاط المعطاة إلى النتيجة.
الحجج
النقاط (العدد): النقاط المحددة لربحها.
unit.losePoints(points)
يخصم النقاط المعطاة من النتيجة.
الحجج
النقاط (العدد): النقاط المحددة لتضيعها.
unit.triggerEffect(effect)
مفعلات التأثير المعطى.
الحجج
التأثير (السلسلة): اسم التأثير.
unit.isUnderEffect(effect)
يحدد ما إذا كانت الوحدة تحت التأثير المعطى.
الحجج
التأثير (السلسلة): اسم التأثير.
يعود
(boolean): ما إذا كانت هذه الوحدة تحت التأثير المعطى أم لا.
unit.getOtherUnits()
يرجع الوحدات إلى الطابق الذي بدون هذه الوحدة.
يعود
(Unit[]): الوحدات الأخرى في الطابق.
unit.getSpace()
يعود إلى الحيز حيث توجد هذه الوحدة.
يعود
(الحيز): الحيز الذي تقع فيه هذه الوحدة.
unit.getSensedSpaceAt(direction, forward = 1, right = 0)
يعود إلى المكان حيث يقع فيه الحيز الذي تم استشعاره عند لافتة الاتجاه و عدد الأحياز.
استخدم هذا الأسلوب عند إرجاع الأحياز من الحواس. أعد دائما الأحياز المستشعرة إلى اللاعب.
الحجج
الاتجاه (السلسلة): الاتجاه.
إلى الأمام (العدد): عدد الأحياز الأمامية.
اليمين (العدد): عدد الأحياز على اليمين.
يعود
(حيز مستشعر): الحيز المستشعر.
unit.getSpaceAt(direction, forward = 1, right = 0)
يعود إلى المكان حيث يقع فيه الحيز الذي تم استشعاره عند لافتة الاتجاه و عدد الأحياز.
إستخدم هذا الاسلوب داخليا. لا ترجع أبدا الحيز العادي للاعب.
الحجج
الاتجاه (السلسلة): الاتجاه.
إلى الأمام (العدد): عدد الأحياز الأمامية.
اليمين (العدد): عدد الأحياز على اليمين.
يعود
(الحيز): الحيز.
unit.getDirectionOfStairs()
يقوم بإرجاع اتجاهات السلالم مع مرجع هذه الوحدة.
يعود
(سلسلة): الاتجاه النسبي لسلالم.
unit.getDirectionOf(space)
يقوم بإرجاع الحيز المعطى مع مرجع هذه الوحدة.
الحجج
الحيز (الحيز المستشعر): الحيز الذي تحصل من خلاله على الاتجاه.
يعود
(السلسلة): الاتجاه النسبي للحيز.
unit.getDistanceOf(space)
يقوم بإرجاع المسافة التي بين الحيز المعطى وهذه الوحدة.
الحجج
الحيز (الحيز المستشعر): الحيز الذي تحسب من خلاله المسافة.
يعود
(العدد): مسافة الحيز.
unit.move(direction, forward = 1, right = 0)
ينقل الوحدة في الاتجاه المعين بواسطة عدد من الأحياز.
الحجج
الاتجاه (السلسلة): الاتجاه.
إلى الأمام (العدد): عدد الأحياز الأمامية.
اليمين (العدد): عدد الأحياز على اليمين.
unit.rotate(direction)
يقوم بتدوير الوحدة إلى الاتجاه المعطى.
الحجج
الاتجاه (السلسلة): الإتجاه الذي يتم التدوير إليه.
unit.vanish()
يخفي الوحدة من الطابق.
unit.log(message)
يدون رسالة في سجل اللعب.
الحجج
الرسالة (السلسلة): الرسالة المراد حفظها.
خصائص النموذج
name (string)
اسم الوحدة.
character (string)
الشخصية التي تمثل الوحدة على خريطة الأرضية.
health (number)
إجمالي الضرر الذي قد يحدث للوحدة قبل الموت، على شكل HP.
maxHealth (number)
الحد الأقصى لقيمةالحالة الصحية.
reward (number)
عدد النقاط المراد منحها عند التفاعل.
enemy (boolean)
سواء كانت الوحدة تابعة للعدو أم لا.
bound (boolean)
سواء كانت الوحدة مقيدة أم لا.