Skip to content

Commit 2baacf1

Browse files
AmyrAhmadyAmyrAhmady
committed
translate 56 functions into persian
1 parent cb736b2 commit 2baacf1

Some content is hidden

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

56 files changed

+3023
-0
lines changed

‎frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/AddCharModel.md‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: AddCharModel
3+
sidebar_label: AddCharModel
4+
description: یک مدل کاراکتر سفارشی جدید برای دانلود اضافه می‌کند.
5+
tags: ["custom skin", "char model"]
6+
---
7+
8+
<VersionWarn version='SA-MP 0.3.DL R1' />
9+
10+
## توضیحات
11+
12+
یک مدل کاراکتر سفارشی جدید برای دانلود اضافه می‌کند. فایل‌های مدل در Documents\GTA San Andreas User Files\SAMP\cache بازیکن در پوشه IP و Port سرور با نام فایل به شکل CRC ذخیره خواهند شد.
13+
14+
| نام | توضیحات |
15+
| ---------------------- | -------------------------------------------------------------------------------------------------------------- |
16+
| baseid | ID مدل اسکین پایه برای استفاده (رفتار کاراکتر و کاراکتر اصلی برای استفاده زمانی که دانلود شکست بخورد). |
17+
| newid | ID مدل اسکین جدید در محدوده 20001 تا 30000 (10000 slot) برای استفاده بعدی با SetPlayerSkin |
18+
| const dff[] | نام فایل کالیژن مدل .dff که به طور پیش‌فرض در پوشه models سرور قرار دارد (تنظیمات artpath). |
19+
| const textureLibrary[] | نام فایل texture مدل .txd که به طور پیش‌فرض در پوشه models سرور قرار دارد (تنظیمات artpath). |
20+
21+
## مقدار بازگشتی
22+
23+
**1:** تابع با موفقیت اجرا شد.
24+
25+
**0:** تابع در اجرا شکست خورد.
26+
27+
## مثال‌ها
28+
29+
```c
30+
public OnGameModeInit()
31+
{
32+
AddCharModel(305, 20001, "lvpdpc2.dff", "lvpdpc2.txd");
33+
AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd");
34+
return 1;
35+
}
36+
```
37+
38+
```c
39+
AddCharModel(305, 20001, "lvpdpc2.dff", "lvpdpc2.txd");
40+
AddCharModel(305, 20002, "lapdpd2.dff", "lapdpd2.txd");
41+
```
42+
43+
## نکات
44+
45+
:::tip
46+
47+
ابتدا باید **useartwork** یا **artwork.enable** در تنظیمات سرور فعال شود تا این کار کند.
48+
49+
:::
50+
51+
:::warning
52+
53+
در حال حاضر هیچ محدودیتی برای زمان فراخوانی این تابع وجود ندارد، اما بدانید که اگر آن‌ها را داخل [OnFilterScriptInit](../callbacks/OnFilterScriptInit)/[OnGameModeInit](../callbacks/OnGameModeInit) فراخوانی نکنید، خطر این وجود دارد که برخی بازیکن‌ها که از قبل در سرور هستند مدل‌ها را دانلود نکرده باشند.
54+
55+
:::
56+
57+
## توابع مرتبط
58+
59+
- [SetPlayerSkin](SetPlayerSkin): اسکین بازیکن را تنظیم کنید.

‎frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/AddMenuItem.md‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: AddMenuItem
3+
sidebar_label: AddMenuItem
4+
description: آیتمی به منوی مشخص شده اضافه می‌کند.
5+
tags: ["menu"]
6+
---
7+
8+
## توضیحات
9+
10+
آیتمی به منوی مشخص شده اضافه می‌کند.
11+
12+
| نام | توضیحات |
13+
| ---------------- | ------------------------------------------ |
14+
| Menu:menuid | ID منو برای اضافه کردن آیتم. |
15+
| column | ستونی که آیتم به آن اضافه شود. |
16+
| const title[] | عنوان آیتم منوی جدید. |
17+
| OPEN_MP_TAGS:... | تعداد نامحدود آرگومان از هر tag. |
18+
19+
## مقدار بازگشتی
20+
21+
ایندکس ردیفی که این آیتم به آن اضافه شد.
22+
23+
## مثال‌ها
24+
25+
```c
26+
new Menu:gExampleMenu;
27+
28+
public OnGameModeInit()
29+
{
30+
gExampleMenu = CreateMenu("Your Menu", 2, 200.0, 100.0, 150.0, 150.0);
31+
AddMenuItem(gExampleMenu, 0, "item 1");
32+
AddMenuItem(gExampleMenu, 0, "item 2");
33+
return 1;
34+
}
35+
```
36+
37+
## نکات
38+
39+
:::tip
40+
41+
- هنگام پاس دادن ID منوی نامعتبر crash می‌کند.
42+
- فقط می‌توانید 12 آیتم در هر منو داشته باشید (13امی به سمت راست header نام ستون می‌رود (رنگی)، 14امی و بالاتر اصلاً نمایش داده نمی‌شوند).
43+
- فقط می‌توانید از 2 ستون استفاده کنید (0 و 1).
44+
- فقط می‌توانید 8 کد رنگ در هر آیتم اضافه کنید (~r~, ~g~ و غیره). حداکثر طول آیتم منو 31 نماد است.
45+
46+
:::
47+
48+
## توابع مرتبط
49+
50+
- [CreateMenu](CreateMenu): منو ایجاد کنید.
51+
- [SetMenuColumnHeader](SetMenuColumnHeader): header یکی از ستون‌ها را در منو تنظیم کنید.
52+
- [DestroyMenu](DestroyMenu): منو را نابود کنید.
53+
- [IsMenuRowDisabled](IsMenuRowDisabled): بررسی کنید که آیا ردیف منو غیرفعال است.
54+
55+
## callback های مرتبط
56+
57+
- [OnPlayerSelectedMenuRow](../callbacks/OnPlayerSelectedMenuRow): زمانی فراخوانی می‌شود که بازیکن ردیفی در منو انتخاب کند.
58+
- [OnPlayerExitedMenu](../callbacks/OnPlayerExitedMenu): زمانی فراخوانی می‌شود که بازیکن از منو خارج شود.

‎frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClass.md‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
---
2+
title: AddPlayerClass
3+
sidebar_label: AddPlayerClass
4+
description: کلاسی به انتخاب کلاس اضافه می‌کند.
5+
tags: ["player", "class"]
6+
---
7+
8+
## توضیحات
9+
10+
کلاسی به انتخاب کلاس اضافه می‌کند. کلاس‌ها استفاده می‌شوند تا بازیکن‌ها بتوانند با اسکینی از انتخاب خودشان spawn شوند.
11+
12+
| نام | توضیحات |
13+
| -------------- | ---------------------------------------------------------------- |
14+
| skin | [اسکینی](../resources/skins) که بازیکن با آن spawn خواهد شد. |
15+
| Float:spawnX | مختصات X نقطه spawn این کلاس. |
16+
| Float:spawnY | مختصات Y نقطه spawn این کلاس. |
17+
| Float:spawnZ | مختصات Z نقطه spawn این کلاس. |
18+
| Float:angle | جهتی که بازیکن باید بعد از spawn رو به آن باشد. |
19+
| WEAPON:weapon1 | اولین سلاح spawn برای بازیکن. |
20+
| ammo1 | مقدار مهمات برای سلاح spawn اصلی. |
21+
| WEAPON:weapon2 | دومین سلاح spawn برای بازیکن. |
22+
| ammo2 | مقدار مهمات برای دومین سلاح spawn. |
23+
| WEAPON:weapon3 | سومین سلاح spawn برای بازیکن. |
24+
| ammo3 | مقدار مهمات برای سومین سلاح spawn. |
25+
26+
## مقدار بازگشتی
27+
28+
ID کلاسی که همین الان اضافه شد.
29+
30+
319 اگر محدودیت کلاس (320) رسیده باشد. بالاترین ID کلاس ممکن 319 است.
31+
32+
## مثال‌ها
33+
34+
```c
35+
public OnGameModeInit()
36+
{
37+
// بازیکن‌ها می‌توانند با اسکین CJ (0) یا اسکین The Truth (1) spawn شوند.
38+
AddPlayerClass(0, 1958.33, 1343.12, 15.36, 269.15, WEAPON_SAWEDOFF, 36, WEAPON_UZI, 150, WEAPON_BRASSKNUCKLE, 1); // CJ
39+
AddPlayerClass(1, 1958.33, 1343.12, 15.36, 269.15, WEAPON_SAWEDOFF, 36, WEAPON_UZI, 150, WEAPON_BRASSKNUCKLE, 1); // The Truth
40+
return 1;
41+
}
42+
```
43+
44+
## نکات
45+
46+
:::tip
47+
48+
حداکثر ID کلاس 319 است (شروع از 0، پس مجموعاً 320 کلاس). وقتی این حد رسیده باشد، هر کلاس اضافی که اضافه شود ID 319 را جایگزین خواهد کرد.
49+
50+
:::
51+
52+
## توابع مرتبط
53+
54+
- [AddPlayerClassEx](AddPlayerClassEx): کلاسی با تیم پیش‌فرض اضافه کنید.
55+
- [GetAvailableClasses](GetAvailableClasses): تعداد کلاس‌های تعریف شده را دریافت کنید.
56+
- [EditPlayerClass](EditPlayerClass): داده کلاس را ویرایش کنید.
57+
- [SetSpawnInfo](SetSpawnInfo): تنظیمات spawn بازیکن را تنظیم کنید.
58+
- [SetPlayerSkin](SetPlayerSkin): اسکین بازیکن را تنظیم کنید.
59+
60+
## منابع مرتبط
61+
62+
- [Skin IDs](../resources/skins)
63+
- [Weapon IDs](../resources/weaponids)

‎frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/AddPlayerClassEx.md‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: AddPlayerClassEx
3+
sidebar_label: AddPlayerClassEx
4+
description: این تابع دقیقاً مشابه تابع AddPlayerClass است، با اضافه شدن پارامتر team.
5+
tags: ["player", "class"]
6+
---
7+
8+
## توضیحات
9+
10+
این تابع دقیقاً مشابه تابع AddPlayerClass است، با اضافه شدن پارامتر team.
11+
12+
| نام | توضیحات |
13+
| -------------- | ---------------------------------------------------------------- |
14+
| team | تیمی که می‌خواهید بازیکن در آن spawn شود. |
15+
| skin | [اسکینی](../resources/skins) که بازیکن با آن spawn خواهد شد. |
16+
| Float:spawnX | مختصات X نقطه spawn این کلاس. |
17+
| Float:spawnY | مختصات Y نقطه spawn این کلاس. |
18+
| Float:spawnZ | مختصات Z نقطه spawn این کلاس. |
19+
| Float:angle | جهتی که بازیکن باید بعد از spawn رو به آن باشد. |
20+
| WEAPON:weapon1 | اولین سلاح spawn برای بازیکن. |
21+
| ammo1 | مقدار مهمات برای سلاح spawn اصلی. |
22+
| WEAPON:weapon2 | دومین سلاح spawn برای بازیکن. |
23+
| ammo2 | مقدار مهمات برای دومین سلاح spawn. |
24+
| WEAPON:weapon3 | سومین سلاح spawn برای بازیکن. |
25+
| ammo3 | مقدار مهمات برای سومین سلاح spawn. |
26+
27+
## مقدار بازگشتی
28+
29+
ID کلاسی که همین الان اضافه شد.
30+
31+
319 اگر محدودیت کلاس (320) رسیده باشد. بالاترین ID کلاس ممکن 319 است.
32+
33+
## مثال‌ها
34+
35+
```c
36+
public OnGameModeInit()
37+
{
38+
// بازیکن‌ها می‌توانند spawn شوند به عنوان:
39+
// اسکین CJ (ID 0) در تیم 1.
40+
// اسکین The Truth (ID 1) در تیم 2.
41+
AddPlayerClassEx(1, 0, 1958.33, 1343.12, 15.36, 269.15, WEAPON_SAWEDOFF, 36, WEAPON_UZI, 150, WEAPON_FIST, 0); // CJ
42+
AddPlayerClassEx(2, 1, 1958.33, 1343.12, 15.36, 269.15, WEAPON_SAWEDOFF, 36, WEAPON_UZI, 150, WEAPON_FIST, 0); // The Truth
43+
return 1;
44+
}
45+
```
46+
47+
## نکات
48+
49+
:::tip
50+
51+
حداکثر ID کلاس 319 است (شروع از 0، پس مجموعاً 320 کلاس). وقتی این حد رسیده باشد، هر کلاس اضافی که اضافه شود ID 319 را جایگزین خواهد کرد.
52+
53+
:::
54+
55+
## توابع مرتبط
56+
57+
- [AddPlayerClass](AddPlayerClass): کلاس اضافه کنید.
58+
- [GetAvailableClasses](GetAvailableClasses): تعداد کلاس‌های تعریف شده را دریافت کنید.
59+
- [EditPlayerClass](EditPlayerClass): داده کلاس را ویرایش کنید.
60+
- [SetSpawnInfo](SetSpawnInfo): تنظیمات spawn بازیکن را تنظیم کنید.
61+
- [SetPlayerTeam](SetPlayerTeam): تیم بازیکن را تنظیم کنید.
62+
- [SetPlayerSkin](SetPlayerSkin): اسکین بازیکن را تنظیم کنید.
63+
64+
## منابع مرتبط
65+
66+
- [Skin IDs](../resources/skins)
67+
- [Weapon IDs](../resources/weaponids)

‎frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/AddServerRule.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: AddServerRule
3+
sidebar_label: AddServerRule
4+
description: قانون سرور اضافه می‌کند.
5+
tags: ["rule"]
6+
---
7+
8+
<VersionWarn version='omp v1.1.0.2612' />
9+
10+
## توضیحات
11+
12+
قانون سرور اضافه می‌کند.
13+
14+
| نام | توضیحات |
15+
| ---------------- | ------------------------------------------ |
16+
| const rule[] | نام قانون سرور برای اضافه کردن. |
17+
| const format[] | مقدار قانون سرور. |
18+
| OPEN_MP_TAGS:... | تعداد نامحدود آرگومان از هر tag. |
19+
20+
## مقدار بازگشتی
21+
22+
true اگر تابع با موفقیت اجرا شود، در غیر این صورت false.
23+
24+
## مثال‌ها
25+
26+
```c
27+
public OnGameModeInit()
28+
{
29+
AddServerRule("discord", "discord.gg/samp");
30+
return 1;
31+
}
32+
```
33+
34+
## توابع مرتبط
35+
36+
- [RemoveServerRule](RemoveServerRule): قانون سرور را حذف کنید.
37+
- [IsValidServerRule](IsValidServerRule): بررسی می‌کند که آیا قانون سرور داده شده معتبر است.

‎frontend/i18n/fa/docusaurus-plugin-content-docs/current/scripting/functions/AddSimpleModel.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
title: AddSimpleModel
3+
sidebar_label: AddSimpleModel
4+
description: مدل object ساده سفارشی جدیدی برای دانلود اضافه می‌کند.
5+
tags: ["custom model", "simple model"]
6+
---
7+
8+
<VersionWarn version='SA-MP 0.3.DL R1' />
9+
10+
## توضیحات
11+
12+
مدل object ساده سفارشی جدیدی برای دانلود اضافه می‌کند. فایل‌های مدل در Documents\GTA San Andreas User Files\SAMP\cache بازیکن در پوشه IP و Port سرور با نام فایل به شکل CRC ذخیره خواهند شد.
13+
14+
| نام | توضیحات |
15+
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------- |
16+
| virtualWorld | ID دنیای مجازی برای در دسترس قرار دادن مدل. از -1 برای همه دنیاها استفاده کنید. |
17+
| baseid | ID مدل object پایه برای استفاده (object اصلی برای استفاده زمانی که دانلود شکست بخورد). |
18+
| newid | ID مدل object جدید در محدوده -1000 تا -30000 (29000 slot) برای استفاده بعدی با CreateObject یا CreatePlayerObject. |
19+
| const dff[] | نام فایل کالیژن مدل .dff که به طور پیش‌فرض در پوشه models سرور قرار دارد (تنظیمات artpath) |
20+
| const textureLibrary[] | نام فایل texture مدل .txd که به طور پیش‌فرض در پوشه models سرور قرار دارد (تنظیمات artpath). |
21+
22+
## مقدار بازگشتی
23+
24+
**1:** تابع با موفقیت اجرا شد.
25+
26+
**0:** تابع در اجرا شکست خورد.
27+
28+
## مثال‌ها
29+
30+
```c
31+
public OnGameModeInit()
32+
{
33+
AddSimpleModel(-1, 19379, -2000, "wallzzz.dff", "wallzzz.txd");
34+
return 1;
35+
}
36+
```
37+
38+
```c
39+
AddSimpleModel(-1, 19379, -2000, "wallzzz.dff", "wallzzz.txd");
40+
```
41+
42+
## نکات
43+
44+
:::tip
45+
46+
ابتدا باید **useartwork** یا **artwork.enable** در تنظیمات سرور فعال شود تا این کار کند.
47+
48+
وقتی `virtualworld` تنظیم شود، مدل‌ها یک بار دانلود خواهند شد که بازیکن وارد دنیای خاص شود.
49+
50+
:::
51+
52+
:::warning
53+
54+
در حال حاضر هیچ محدودیتی برای زمان فراخوانی این تابع وجود ندارد، اما بدانید که اگر آن‌ها را داخل [OnFilterScriptInit](../callbacks/OnFilterScriptInit)/[OnGameModeInit](../callbacks/OnGameModeInit) فراخوانی نکنید، خطر این وجود دارد که برخی بازیکن‌ها که از قبل در سرور هستند مدل‌ها را دانلود نکرده باشند.
55+
56+
:::
57+
58+
## توابع مرتبط
59+
60+
- [IsValidCustomModel](IsValidCustomModel): بررسی می‌کند که آیا ID مدل سفارشی معتبر است.
61+
- [GetCustomModelPath](GetCustomModelPath): مسیر مدل سفارشی را دریافت کنید.
62+
63+
## callback های مرتبط
64+
65+
- [OnPlayerFinishedDownloading](../callbacks/OnPlayerFinishedDownloading): زمانی فراخوانی می‌شود که بازیکن دانلود مدل‌های سفارشی را تمام کند.

0 commit comments

Comments
 (0)