Skip to content

Commit 32806c1

Browse files
committed
translate first chunk of Dutch scripting functions
1 parent b764c31 commit 32806c1

25 files changed

+1145
-0
lines changed
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: GetPlayerArmour
3+
sidebar_label: GetPlayerArmour
4+
description: Haal de armour van een speler op.
5+
tags: ["player"]
6+
---
7+
8+
## Beschrijving
9+
10+
Sla de armour van een speler op in een variabele.
11+
12+
| Naam | Beschrijving |
13+
| ---- | ------------ |
14+
| playerid | ID van de speler. |
15+
| &Float:armour | Float‑referentie om armour in op te slaan. |
16+
17+
## Retourneert
18+
19+
**1** bij succes, **0** bij falen (niet verbonden). Armour wordt in de variabele geplaatst.
20+
21+
## Voorbeeld
22+
23+
```c
24+
public OnPlayerCommandText(playerid, cmdtext[])
25+
{
26+
if (!strcmp(cmdtext, "/myarmour", true))
27+
{
28+
new s[40];
29+
new Float:armour;
30+
GetPlayerArmour(playerid, armour);
31+
format(s, sizeof(s), "SERVER: Your armour is %.2f percent", armour);
32+
SendClientMessage(playerid, 0xFFFFFFAA, s);
33+
return 1;
34+
}
35+
return 0;
36+
}
37+
```
38+
39+
## Opmerkingen
40+
41+
De client rapporteert waarden tot maximaal 255; hogere waarden lopen over (256→0, 257→1, …). Bij het opvragen wordt de waarde afgerond naar een geheel getal.
42+
43+
## Gerelateerd
44+
45+
- [SetPlayerArmour](SetPlayerArmour)
46+
- [GetPlayerHealth](GetPlayerHealth)
47+
- [GetVehicleHealth](GetVehicleHealth)
48+
49+
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: GetPlayerFacingAngle
3+
sidebar_label: GetPlayerFacingAngle
4+
description: Haal de kijkhoek (rotatie) van een speler op.
5+
tags: ["player"]
6+
---
7+
8+
## Beschrijving
9+
10+
Haal de rotatie op waar de speler naartoe kijkt.
11+
12+
| Naam | Beschrijving |
13+
| ---- | ------------ |
14+
| playerid | Speler waarvan je de rotatie wilt. |
15+
| &Float:angle | Float‑referentie om de rotatie in op te slaan. |
16+
17+
## Retourneert
18+
19+
**true** bij succes, **false** als de speler niet bestaat. De rotatie wordt in de variabele opgeslagen.
20+
21+
## Voorbeeld
22+
23+
```c
24+
public OnPlayerCommandText(playerid, cmdtext[])
25+
{
26+
if (!strcmp(cmdtext, "/angle", true))
27+
{
28+
new Float:angle, s[64];
29+
GetPlayerFacingAngle(playerid, angle);
30+
format(s, sizeof(s), "Your facing angle: %0.2f", angle);
31+
SendClientMessage(playerid, -1, s);
32+
return 1;
33+
}
34+
return 0;
35+
}
36+
```
37+
38+
## Opmerkingen
39+
40+
- In voertuigen is de teruggegeven rotatie vaak onjuist; gebruik [GetVehicleZAngle](GetVehicleZAngle).
41+
- Hoeken zijn in GTA:SA gespiegeld: 90° is West (i.p.v. Oost). Converteer met `360 - angle`.
42+
43+
## Gerelateerd
44+
45+
- [GetVehicleZAngle](GetVehicleZAngle)
46+
- [SetPlayerFacingAngle](SetPlayerFacingAngle)
47+
- [GetPlayerRotationQuat](GetPlayerRotationQuat)
48+
49+
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: GetPlayerHealth
3+
sidebar_label: GetPlayerHealth
4+
description: Haal de health van een speler op.
5+
tags: ["player"]
6+
---
7+
8+
## Beschrijving
9+
10+
Haal de health van een speler op (nuttig o.a. voor cheat‑detectie).
11+
12+
| Naam | Beschrijving |
13+
| ---- | ------------ |
14+
| playerid | ID van de speler. |
15+
| &Float:health | Float‑referentie om health in op te slaan. |
16+
17+
## Retourneert
18+
19+
**true** bij succes, **false** bij falen (niet verbonden). Health wordt in de variabele geplaatst.
20+
21+
## Voorbeeld
22+
23+
```c
24+
public OnPlayerCommandText(playerid, cmdtext[])
25+
{
26+
if (!strcmp(cmdtext, "/doctor", true))
27+
{
28+
new Float:hp;
29+
GetPlayerHealth(playerid, hp);
30+
if (hp < 50.0) SetPlayerHealth(playerid, 50.0);
31+
return 1;
32+
}
33+
return 0;
34+
}
35+
```
36+
37+
## Opmerkingen
38+
39+
De client rapporteert waarden tot maximaal 255; hogere waarden lopen over (256→0, 257→1, …). Bij het opvragen wordt de waarde afgerond naar een geheel getal.
40+
41+
## Gerelateerd
42+
43+
- [SetPlayerHealth](SetPlayerHealth)
44+
- [GetVehicleHealth](GetVehicleHealth)
45+
- [GetPlayerArmour](GetPlayerArmour)
46+
47+
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: GetPlayerInterior
3+
sidebar_label: GetPlayerInterior
4+
description: Haal het huidige interior van een speler op.
5+
tags: ["player"]
6+
---
7+
8+
## Beschrijving
9+
10+
Geeft de huidige interior‑ID van de speler terug.
11+
12+
| Naam | Beschrijving |
13+
| ---- | ------------ |
14+
| playerid | Speler waarvan je het interior wilt. |
15+
16+
## Retourneert
17+
18+
De interior‑ID waarin de speler zich bevindt.
19+
20+
## Voorbeeld
21+
22+
```c
23+
public OnPlayerCommandText(playerid, cmdtext[])
24+
{
25+
if (!strcmp(cmdtext, "/int", true))
26+
{
27+
new s[64];
28+
format(s, sizeof(s), "You are in interior %i", GetPlayerInterior(playerid));
29+
SendClientMessage(playerid, 0xFF8000FF, s);
30+
return 1;
31+
}
32+
return 0;
33+
}
34+
```
35+
36+
## Opmerkingen
37+
38+
Retourneert altijd interior 0 voor NPC's.
39+
40+
## Gerelateerd
41+
42+
- [SetPlayerInterior](SetPlayerInterior)
43+
- [GetPlayerVirtualWorld](GetPlayerVirtualWorld)
44+
45+
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: GetPlayerIp
3+
sidebar_label: GetPlayerIp
4+
description: Haal het IP‑adres van een speler op.
5+
tags: ["player", "ip address"]
6+
---
7+
8+
## Beschrijving
9+
10+
Haal het IP‑adres van de opgegeven speler op en sla het op in een string.
11+
12+
| Naam | Beschrijving |
13+
| ---- | ------------ |
14+
| playerid | ID van de speler. |
15+
| ip[] | Buffer om het IP in op te slaan (by reference). |
16+
| len = sizeof (ip) | Maximale lengte (aanbevolen 16). |
17+
18+
## Retourneert
19+
20+
Het IP wordt in de array opgeslagen.
21+
22+
## Voorbeeld
23+
24+
```c
25+
public OnPlayerConnect(playerid)
26+
{
27+
new ipAddress[16];
28+
GetPlayerIp(playerid, ipAddress, sizeof(ipAddress));
29+
if (!strcmp(ipAddress, "127.0.0.1"))
30+
{
31+
SendClientMessage(playerid, 0xFFFFFFFF, "Welcome to your server, master :)");
32+
}
33+
return 1;
34+
}
35+
```
36+
37+
## Opmerkingen
38+
39+
- PAWN is case‑sensitive: `GetPlayerIP` werkt niet.
40+
- SA‑MP server: werkt niet in [OnPlayerDisconnect](../callbacks/OnPlayerDisconnect); gebruik [OnPlayerConnect](../callbacks/OnPlayerConnect). In open.mp werkt dit wél in `OnPlayerDisconnect`.
41+
42+
## Gerelateerd
43+
44+
- [NetStats_GetIpPort](NetStats_GetIpPort)
45+
- [GetPlayerRawIp](GetPlayerRawIp)
46+
- [GetPlayerName](GetPlayerName)
47+
- [GetPlayerPing](GetPlayerPing)
48+
- [GetPlayerVersion](GetPlayerVersion)
49+
50+
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: GetPlayerKeys
3+
sidebar_label: GetPlayerKeys
4+
description: Controleer welke functietoetsen een speler indrukt.
5+
tags: ["player"]
6+
---
7+
8+
## Beschrijving
9+
10+
Lees de huidige key‑states van een speler.
11+
12+
| Naam | Beschrijving |
13+
| ---- | ------------ |
14+
| playerid | ID van de speler. |
15+
| &KEY:keys | Bitmask met key‑states (zie [Keys](../resources/keys)). |
16+
| updown | Up/down‑state. |
17+
| leftright | Left/right‑state. |
18+
19+
## Retourneert
20+
21+
Keys worden in de opgegeven variabelen opgeslagen.
22+
23+
## Voorbeeld
24+
25+
```c
26+
public OnPlayerUpdate(playerid)
27+
{
28+
new KEY:keys, updown, leftright;
29+
GetPlayerKeys(playerid, keys, updown, leftright);
30+
if (updown == KEY_UP) SendClientMessage(playerid, -1, "UP");
31+
else if (updown == KEY_DOWN) SendClientMessage(playerid, -1, "DOWN");
32+
if (leftright == KEY_LEFT) SendClientMessage(playerid, -1, "LEFT");
33+
else if (leftright == KEY_RIGHT) SendClientMessage(playerid, -1, "RIGHT");
34+
return 1;
35+
}
36+
```
37+
38+
## Opmerkingen
39+
40+
Alleen de FUNCTIE van toetsen wordt gedetecteerd; niet de fysieke toets. Bijvoorbeeld SPRINT i.p.v. SPATIE. In voertuigen worden A en D niet herkend; W en S wel via `keys`.
41+
42+
## Gerelateerd
43+
44+
- [Keys](../resources/keys)
45+
46+
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: GetPlayerName
3+
sidebar_label: GetPlayerName
4+
description: Haal de naam van een speler op.
5+
tags: ["player"]
6+
---
7+
8+
## Beschrijving
9+
10+
Haal de naam van een speler op.
11+
12+
| Naam | Beschrijving |
13+
| ------- | ------------ |
14+
| playerid | ID van de speler waarvan je de naam wilt ophalen. |
15+
| name[] | Buffer om de naam in op te slaan (by reference). |
16+
| len | Maximale lengte van de string (aanbevolen MAX_PLAYER_NAME + 1). |
17+
18+
## Retourneert
19+
20+
De lengte van de spelersnaam, of 0 als de speler niet bestaat.
21+
22+
## Voorbeeld
23+
24+
```c
25+
public OnPlayerConnect(playerid)
26+
{
27+
new name[MAX_PLAYER_NAME + 1];
28+
GetPlayerName(playerid, name, sizeof(name));
29+
30+
new msg[128];
31+
format(msg, sizeof(msg), "%s has joined the server.", name);
32+
SendClientMessageToAll(0xC4C4C4FF, msg);
33+
return 1;
34+
}
35+
```
36+
37+
## Opmerkingen
38+
39+
Een naam kan tot 24 tekens lang zijn via [SetPlayerName](SetPlayerName). De client kan alleen joinen met 3–20 tekens; anders wordt de verbinding geweigerd.
40+
41+
## Gerelateerd
42+
43+
- [SetPlayerName](SetPlayerName)
44+
- [IsValidNickName](IsValidNickName)
45+
- [GetPlayerIp](GetPlayerIp)
46+
- [GetPlayerPing](GetPlayerPing)
47+
- [GetPlayerScore](GetPlayerScore)
48+
- [GetPlayerVersion](GetPlayerVersion)
49+
50+

0 commit comments

Comments
 (0)