GetPlayerHealth

توضیحات

این تابع امکان دریافت سلامتی یک بازیکن را فراهم می‌کند. برای چیزهایی مثل تشخیص تقلب مفید است.

نام	توضیحات
playerid	شناسه بازیکن.
&Float:health	متغیر Float برای ذخیره سلامتی، که با reference پاس می‌شود.

مقدار بازگشتی

true - موفقیت‌آمیز

false - عدم موفقیت (مثلاً بازیکن متصل نیست).

سلامتی بازیکن در متغیر مشخص شده ذخیره می‌شود.

مثال‌ها

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (strcmp(cmdtext, "/doctor", true) == 0)
    {
        // سلامتی بازیکن را روی 50 تنظیم می‌کند اگر قبلاً
        // از 50 کمتر بوده، به محض تایپ /doctor
        
        new Float:health;
        GetPlayerHealth(playerid, health);
        
        if (health < 50.0)
        {
            SetPlayerHealth(playerid, 50.0);
        }
        return 1;
    }
    return 0;
}

نکات

هشدار

اگرچه سلامتی را می‌توان در سمت سرور روی مقادیر نزدیک به بی‌نهایت تنظیم کرد، کلاینت‌ها فقط مقادیر تا 255 را گزارش می‌دهند. هر چیز بالاتر دور می‌زند؛ 256 به 0 تبدیل می‌شود، 257 به 1 و این طور ادامه پیدا می‌کند. سلامتی به صورت رند شده به عدد صحیح دریافت می‌شود: 50.15 تنظیم کنید، اما 50.0 دریافت می‌کنید.

تابع‌های مرتبط

• SetPlayerHealth: سلامتی یک بازیکن را تنظیم می‌کند.
• GetVehicleHealth: سلامتی یک وسیله نقلیه را بررسی می‌کند.
• GetPlayerArmour: مقدار زره یک بازیکن را بدست می‌آورد.