پرش به مطلب اصلی

BanEx

توضیحات​

بازیکن را با دلیل مسدود می‌کند.

نامتوضیحات
playeridشناسه بازیکن برای مسدود کردن.
const reason[]دلیل مسدودیت.

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

این تابع هیچ مقدار خاصی برنمی‌گرداند.

نکات​

هشدار

هر عملی که مستقیماً قبل از BanEx() انجام شود (مانند ارسال پیام با SendClientMessage) به بازیکن نخواهد رسید. باید از تایمر برای تأخیر مسدودیت استفاده کرد.

مثال‌ها​

public OnPlayerCommandText( playerid, cmdtext[] )
{
if (!strcmp(cmdtext, "/banme", true))
{
// بازیکنی که این دستور را اجرا کرد را مسدود می‌کند و دلیل ("Request") را شامل می‌کند
BanEx(playerid, "Request");
return 1;
}
}

// برای نمایش پیام (مثل دلیل) برای بازیکن قبل از بسته شدن اتصال
// باید از تایمر برای ایجاد تأخیر استفاده کنید. این تأخیر فقط نیاز به چند میلی‌ثانیه دارد،
// اما این مثال یک ثانیه کامل استفاده می‌کند تا مطمئن باشیم.

forward BanExPublic(playerid, reason[]);
public BanExPublic(playerid, reason[])
{
BanEx(playerid, reason);
}

stock BanExWithMessage(playerid, color, message[], reason[])
{
//reason - دلیل مسدودیت که برای BanEx استفاده می‌شود.
SendClientMessage(playerid, color, message);
SetTimerEx("BanExPublic", 1000, false, "ds", playerid, reason);
}

public OnPlayerCommandText(playerid, cmdtext[])
{
if (strcmp(cmdtext, "/banme", true) == 0)
{
//بازیکنی که این دستور را اجرا کرد را مسدود می‌کند.
BanExWithMessage(playerid, 0xFF0000FF, "You have been banned!", "Request");
return 1;
}
return 0;
}

توابع مرتبط​

  • Ban: بازیکن را از بازی در سرور مسدود می‌کند.
  • Kick: بازیکن را از سرور اخراج می‌کند.