Skip to content

Commit b5dc9f4

Browse files
committed
129 more farsi functions
1 parent 716052e commit b5dc9f4

File tree

129 files changed

+6018
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

129 files changed

+6018
-0
lines changed
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: GetPVarFloat
3+
sidebar_label: GetPVarFloat
4+
description: یه متغیر بازیکن رو به صورت float دریافت می‌کنه.
5+
tags: ["player variable", "pvar"]
6+
---
7+
8+
## توضیحات
9+
10+
یه متغیر بازیکن رو به صورت float دریافت می‌کنه.
11+
12+
| نام | توضیحات |
13+
| ------------ | ----------------------------------------------------------- |
14+
| playerid | ID بازیکنی که می‌خوای متغیرش رو دریافت کنی. |
15+
| const pvar[] | اسم متغیر بازیکن. |
16+
17+
## مقادیر برگشتی
18+
19+
مقدار float از متغیر بازیکن مشخص شده
20+
21+
## مثال‌ها
22+
23+
```c
24+
LoadPlayerPos(playerid)
25+
{
26+
new Float:x, Float:y, Float:z;
27+
28+
x = GetPVarFloat(playerid, "Xpos");
29+
y = GetPVarFloat(playerid, "Ypos");
30+
z = GetPVarFloat(playerid, "Zpos");
31+
32+
SetPlayerPos(playerid, x, y, z);
33+
return 1;
34+
}
35+
```
36+
37+
## نکات
38+
39+
:::tip
40+
41+
متغیرها تا بعد از فراخوانی [OnPlayerDisconnect](../callbacks/OnPlayerDisconnect) ریست نمی‌شن، پس تو OnPlayerDisconnect هنوز قابل دسترسین.
42+
43+
:::
44+
45+
## توابع مرتبط
46+
47+
- [SetPVarInt](SetPVarInt): تنظیم یه integer برای متغیر بازیکن.
48+
- [GetPVarInt](GetPVarInt): دریافت integer قبلاً تنظیم شده از متغیر بازیکن.
49+
- [SetPVarString](SetPVarString): تنظیم یه string برای متغیر بازیکن.
50+
- [GetPVarString](GetPVarString): دریافت string قبلاً تنظیم شده از متغیر بازیکن.
51+
- [SetPVarFloat](SetPVarFloat): تنظیم یه float برای متغیر بازیکن.
52+
- [DeletePVar](DeletePVar): حذف یه متغیر بازیکن.
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: GetPVarInt
3+
sidebar_label: GetPVarInt
4+
description: مقدار یه متغیر بازیکن integer رو دریافت می‌کنه.
5+
tags: ["player variable", "pvar"]
6+
---
7+
8+
## توضیحات
9+
10+
مقدار یه متغیر بازیکن integer رو دریافت می‌کنه.
11+
12+
| نام | توضیحات |
13+
| ------------ | ---------------------------------------------------------------------------------------------- |
14+
| playerid | ID بازیکنی که می‌خوای متغیرش رو دریافت کنی. |
15+
| const pvar[] | اسم متغیر بازیکن (case-insensitive).<br />تو [SetPVarInt](SetPVarInt) تعیین می‌شه. |
16+
17+
## مقادیر برگشتی
18+
19+
مقدار integer متغیر بازیکن مشخص شده.
20+
21+
هنوز 0 برمی‌گردونه اگه متغیر تنظیم نشده باشه، یا بازیکن وجود نداشته باشه.
22+
23+
## مثال‌ها
24+
25+
```c
26+
public OnPlayerSpawn(playerid)
27+
{
28+
SetPVarInt(playerid, "Level", 20);
29+
return 1;
30+
}
31+
32+
public OnPlayerDisconnect(playerid, reason)
33+
{
34+
printf("Level: %d", GetPVarInt(playerid, "Level")); // get the saved value ('Level')
35+
// will print 'Level: 20'
36+
return 1;
37+
}
38+
```
39+
40+
## نکات
41+
42+
:::tip
43+
44+
متغیرها تا بعد از فراخوانی [OnPlayerDisconnect](../callbacks/OnPlayerDisconnect) ریست نمی‌شن، پس تو OnPlayerDisconnect هنوز قابل دسترسین.
45+
46+
:::
47+
48+
## توابع مرتبط
49+
50+
- [SetPVarInt](SetPVarInt): تنظیم یه integer برای متغیر بازیکن.
51+
- [SetPVarString](SetPVarString): تنظیم یه string برای متغیر بازیکن.
52+
- [GetPVarString](GetPVarString): دریافت string قبلاً تنظیم شده از متغیر بازیکن.
53+
- [SetPVarFloat](SetPVarFloat): تنظیم یه float برای متغیر بازیکن.
54+
- [GetPVarFloat](GetPVarFloat): دریافت float قبلاً تنظیم شده از متغیر بازیکن.
55+
- [DeletePVar](DeletePVar): حذف یه متغیر بازیکن.
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
title: GetPVarNameAtIndex
3+
sidebar_label: GetPVarNameAtIndex
4+
description: اسم pVar یه بازیکن رو از طریق index دریافت می‌کنه.
5+
tags: ["player variable", "pvar"]
6+
---
7+
8+
## توضیحات
9+
10+
اسم pVar یه بازیکن رو از طریق index دریافت می‌کنه.
11+
12+
| نام | توضیحات |
13+
| ---------------------- | -------------------------------------------------------------- |
14+
| playerid | ID بازیکنی که می‌خوای اسم متغیرش رو دریافت کنی. |
15+
| index | index متغیر بازیکن. |
16+
| output[] | یه string برای ذخیره اسم pVar که به صورت reference پاس داده می‌شه. |
17+
| size = sizeof (output) | حداکثر طول string برگردونده شده. |
18+
19+
## مقادیر برگشتی
20+
21+
این تابع مقدار مشخصی برنمی‌گردونه.
22+
23+
## توابع مرتبط
24+
25+
- [GetPVarType](GetPVarType): دریافت نوع متغیر بازیکن.
26+
- [GetPVarInt](GetPVarInt): دریافت integer قبلاً تنظیم شده از متغیر بازیکن.
27+
- [GetPVarFloat](GetPVarFloat): دریافت float قبلاً تنظیم شده از متغیر بازیکن.
28+
- [GetPVarString](GetPVarString): دریافت string قبلاً تنظیم شده از متغیر بازیکن.
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: GetPVarString
3+
sidebar_label: GetPVarString
4+
description: یه متغیر بازیکن رو به صورت string دریافت می‌کنه.
5+
tags: ["player variable", "pvar"]
6+
---
7+
8+
## توضیحات
9+
10+
یه متغیر بازیکن رو به صورت string دریافت می‌کنه.
11+
12+
| نام | توضیحات |
13+
| --------------------- | ----------------------------------------------------------------------- |
14+
| playerid | ID بازیکنی که می‌خوای متغیرش رو دریافت کنی. |
15+
| const pvar[] | اسم متغیر بازیکن که توسط [SetPVarString](SetPVarString) تنظیم شده. |
16+
| output[] | آرایه‌ای برای ذخیره مقدار string که به صورت reference پاس داده می‌شه. |
17+
| len = sizeof (output) | حداکثر طول string برگردونده شده. |
18+
19+
## مقادیر برگشتی
20+
21+
طول string.
22+
23+
## مثال‌ها
24+
25+
```c
26+
public OnPlayerConnect(playerid,reason)
27+
{
28+
new playerName[MAX_PLAYER_NAME];
29+
GetPlayerName(playerid, playerName, MAX_PLAYER_NAME);
30+
SetPVarString(playerid, "PlayerName", playerName);
31+
return 1;
32+
}
33+
34+
public OnPlayerDeath(playerid, killerid, WEAPON:reason)
35+
{
36+
new playerName[MAX_PLAYER_NAME];
37+
GetPVarString(playerid, "PlayerName", playerName, sizeof(playerName));
38+
39+
printf("%s died.", playerName);
40+
}
41+
```
42+
43+
## نکات
44+
45+
:::tip
46+
47+
اگه طول string صفر باشه (مقدار تنظیم نشده)، متن `output` آپدیت یا تنظیم نمی‌شه و با داده‌های قدیمی باقی می‌مونه، که اگه این رفتار مطلوب نیست، باید متغیر رو صاف کنی اگه [GetPVarString](GetPVarString) صفر برگردونه.
48+
49+
:::
50+
51+
## توابع مرتبط
52+
53+
- [SetPVarString](SetPVarString): تنظیم یه string برای متغیر بازیکن.
54+
- [SetPVarInt](SetPVarInt): تنظیم یه integer برای متغیر بازیکن.
55+
- [GetPVarInt](GetPVarInt): دریافت integer قبلاً تنظیم شده از متغیر بازیکن.
56+
- [SetPVarFloat](SetPVarFloat): تنظیم یه float برای متغیر بازیکن.
57+
- [GetPVarFloat](GetPVarFloat): دریافت float قبلاً تنظیم شده از متغیر بازیکن.
58+
- [DeletePVar](DeletePVar): حذف یه متغیر بازیکن.
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: GetPVarType
3+
sidebar_label: GetPVarType
4+
description: نوع (integer، float یا string) یه متغیر بازیکن رو دریافت می‌کنه.
5+
tags: ["player variable", "pvar"]
6+
---
7+
8+
## توضیحات
9+
10+
نوع (integer، float یا string) یه متغیر بازیکن رو دریافت می‌کنه.
11+
12+
| نام | توضیحات |
13+
| ------------ | -------------------------------------------------------------- |
14+
| playerid | ID بازیکنی که می‌خوای نوع متغیرش رو دریافت کنی. |
15+
| const pvar[] | اسم متغیر بازیکنی که می‌خوای نوع‌ش رو بگیری. |
16+
17+
## مقادیر برگشتی
18+
19+
نوع PVar رو برمی‌گردونه. جدول زیر رو ببین.
20+
21+
## مثال‌ها
22+
23+
```c
24+
stock PrintPVar(playerid, varname[])
25+
{
26+
switch(GetPVarType(playerid, varname))
27+
{
28+
case PLAYER_VARTYPE_NONE:
29+
{
30+
return 0;
31+
}
32+
case PLAYER_VARTYPE_INT:
33+
{
34+
printf("Integer PVar '%s': %i", varname, GetPVarInt(playerid, varname));
35+
}
36+
case PLAYER_VARTYPE_FLOAT:
37+
{
38+
printf("Float PVar '%s': %f", varname, GetPVarFloat(playerid, varname));
39+
}
40+
case PLAYER_VARTYPE_STRING:
41+
{
42+
new varstring[256];
43+
GetPVarString(playerid, varname, varstring);
44+
45+
printf("String PVar '%s': %s", varname, varstring);
46+
}
47+
}
48+
return 1;
49+
}
50+
51+
public OnPlayerConnect(playerid)
52+
{
53+
SetPVarInt(playerid, "Level", 20);
54+
55+
PrintPVar(playerid, "Level"); // Output: "Integer PVar 'Level': 20"
56+
return 1;
57+
}
58+
```
59+
60+
## توابع مرتبط
61+
62+
- [SetPVarInt](SetPVarInt): تنظیم یه integer برای متغیر بازیکن.
63+
- [GetPVarInt](GetPVarInt): دریافت integer قبلاً تنظیم شده از متغیر بازیکن.
64+
- [SetPVarString](SetPVarString): تنظیم یه string برای متغیر بازیکن.
65+
- [GetPVarString](GetPVarString): دریافت string قبلاً تنظیم شده از متغیر بازیکن.
66+
- [SetPVarFloat](SetPVarFloat): تنظیم یه float برای متغیر بازیکن.
67+
- [GetPVarFloat](GetPVarFloat): دریافت float قبلاً تنظیم شده از متغیر بازیکن.
68+
- [DeletePVar](DeletePVar): حذف یه متغیر بازیکن.
69+
70+
## منابع مرتبط
71+
72+
- [Player Variable Types](../resources/pvartypes)
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: GetPVarsUpperIndex
3+
sidebar_label: GetPVarsUpperIndex
4+
description: هر PVar (متغیر بازیکن) یه شناسه منحصر به فرد برای lookup داره، این تابع بالاترین ID تنظیم شده برای یه بازیکن رو برمی‌گردونه.
5+
tags: ["player variable", "pvar"]
6+
---
7+
8+
## توضیحات
9+
10+
هر PVar (متغیر بازیکن) یه شناسه منحصر به فرد برای lookup داره، این تابع بالاترین ID تنظیم شده برای یه بازیکن رو برمی‌گردونه.
11+
12+
| نام | توضیحات |
13+
| -------- | ---------------------------------------------------- |
14+
| playerid | ID بازیکنی که می‌خوای بالاترین index PVar رو ازش بگیری. |
15+
16+
## مقادیر برگشتی
17+
18+
بالاترین ID تنظیم شده PVar.
19+
20+
## مثال‌ها
21+
22+
```c
23+
// Store the upper index in the variable 'PVarUpperIndex' + 1
24+
new PVarUpperIndex = GetPVarsUpperIndex(playerid) + 1;
25+
26+
// This pVarCount variable will store how many pVars a player has set as we count them.
27+
new pVarCount;
28+
29+
new pVarName[128];
30+
31+
for(new i = 0; i != PVarUpperIndex; i++) // Loop through all pVar IDs under the upper index
32+
{
33+
// At first, we need to get PVar name
34+
GetPVarNameAtIndex(playerid, i, pVarName, sizeof(pVarName));
35+
36+
// If the var is set (type not 0), increment pVarCount.
37+
if (GetPVarType(playerid, pVarName) != 0)
38+
{
39+
pVarCount++;
40+
}
41+
}
42+
43+
new szString[128];
44+
format(szString, sizeof(szString), "You have %i player-variables set. Upper index (highest ID): %i.", pVarCount, PVarUpperIndex-1);
45+
SendClientMessage(playerid, -1, szString);
46+
```
47+
48+
## توابع مرتبط
49+
50+
- [GetPVarNameAtIndex](GetPVarNameAtIndex): دریافت اسم متغیر بازیکن از index اش.
51+
- [GetPVarType](GetPVarType): دریافت نوع متغیر بازیکن.
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: GetPlayerDialogID
3+
sidebar_label: GetPlayerDialogID
4+
description: دریافت ID دیالوگ نمایش داده شده به بازیکن.
5+
tags: ["player", "dialog"]
6+
---
7+
8+
<VersionWarn version='omp v1.1.0.2612' />
9+
10+
## توضیحات
11+
12+
دریافت ID دیالوگ نمایش داده شده به بازیکن.
13+
14+
| نام | توضیحات |
15+
|----------|-----------------------|
16+
| playerid | ID بازیکن. |
17+
18+
## مقادیر برگشتی
19+
20+
ID دیالوگ را برمی گرداند.
21+
22+
یا **INVALID_DIALOG_ID** اگر بازیکن متصل نباشد یا هیچ دیالوگی باز نداشته باشد.
23+
24+
## مثال‌ها
25+
26+
```c
27+
new dialogID = GetPlayerDialogID(playerid);
28+
if (dialogID != INVALID_DIALOG_ID)
29+
{
30+
// The player has an open dialog
31+
}
32+
```
33+
34+
## توابع مرتبط
35+
36+
- [GetPlayerDialogData](GetPlayerDialogData): دریافت داده‌های دیالوگ نمایش داده شده به بازیکن.
37+
- [ShowPlayerDialog](ShowPlayerDialog): نمایش دیالوگ به بازیکن (فقط یکی در هر زمان).
38+
39+
## کالبک‌های مرتبط
40+
41+
- [OnDialogResponse](../callbacks/OnDialogResponse): زمانی که بازیکن به دیالوگ پاسخ می‌دهد فراخوانی می‌شود.

0 commit comments

Comments
 (0)