Default value of timers (#820)

Timers need to be reset to 0
openmultiplayer · Jan 10, 2024 · 287b8ef · 287b8ef
1 parent 09db433
commit 287b8ef
Show file tree

Hide file tree

Showing 6 changed files with 16 additions and 16 deletions.
diff --git a/docs/scripting/functions/GetPlayerPing.md b/docs/scripting/functions/GetPlayerPing.md
@@ -20,9 +20,9 @@ The current ping of the player (expressed in milliseconds).
 
 ```c
 // Declare an array of all possible timer identifiers for timers for kicking players with
-// generally high ping with default value of -1
+// generally high ping with default value of 0
 new
-    gPlayerPingTimer[MAX_PLAYERS] = {-1, ...};
+    gPlayerPingTimer[MAX_PLAYERS] = {0, ...};
 
 // A constant (nice documentation :))
 const
@@ -38,7 +38,7 @@ public OnPlayerDisconnect(playerid, reason)
 {
     // Kill the timer and reset the value to invalid
     KillTimer(gPlayerPingTimer[playerid]);
-    gPlayerPingTimer[playerid] = -1;
+    gPlayerPingTimer[playerid] = 0;
 }
 
 // A forwarded function (callback)

diff --git a/docs/scripting/functions/KillTimer.md b/docs/scripting/functions/KillTimer.md
@@ -20,7 +20,7 @@ This function always returns 0.
 
 ```c
 new
-    gConnectTimer[MAX_PLAYERS] = {-1, ...};
+    gConnectTimer[MAX_PLAYERS] = {0, ...};
 
 public OnPlayerConnect(playerid)
 {
@@ -32,7 +32,7 @@ public OnPlayerConnect(playerid)
 public OnPlayerDisconnect(playerid)
 {
     KillTimer(gConnectTimer[playerid]);
-    gConnectTimer[playerid] = -1;
+    gConnectTimer[playerid] = 0;
     return 1;
 }
 

diff --git a/docs/scripting/functions/SetVehicleParamsEx.md b/docs/scripting/functions/SetVehicleParamsEx.md
@@ -32,7 +32,7 @@ Sets a vehicle's parameters for all players.
 ```c
 // On top of our script, declaring a global variable
 new
-    gVehicleAlarmTimer[MAX_VEHICLES] = {-1, ...};
+    gVehicleAlarmTimer[MAX_VEHICLES] = {0, ...};
 
 // If setting a single parameter, you should obtain the current parameters so they aren't ALL changed
 new
@@ -50,7 +50,7 @@ SetVehicleParamsEx_Fixed(vehicleid, &engine, &lights, &alarm, &doors, &bonnet, &
     {
         // Kill the timer, reset the timer identifier and then restart it if it was already running
         KillTimer(gVehicleAlarmTimer[vehicleid]);
-        gVehicleAlarmTimer[vehicleid] = -1;
+        gVehicleAlarmTimer[vehicleid] = 0;
         gVehicleAlarmTimer[vehicleid] = SetTimerEx("DisableVehicleAlarm", 20000, false, "d", vehicleid);
     }
 }
@@ -68,7 +68,7 @@ public DisableVehicleAlarm(vehicleid)
     }
 
     // Reset the timer identifier
-    gVehicleAlarmTimer[vehicleid] = -1;
+    gVehicleAlarmTimer[vehicleid] = 0;
 }
 ```
 

diff --git a/docs/translations/bs/scripting/functions/KillTimer.md b/docs/translations/bs/scripting/functions/KillTimer.md
@@ -20,7 +20,7 @@ Ova funkcija uvijek returna/vraća 0.
 
 ```c
 new
-    gConnectTimer[MAX_PLAYERS] = {-1, ...};
+    gConnectTimer[MAX_PLAYERS] = {0, ...};
 
 public OnPlayerConnect(playerid)
 {
@@ -32,7 +32,7 @@ public OnPlayerConnect(playerid)
 public OnPlayerDisconnect(playerid)
 {
     KillTimer(gConnectTimer[playerid]);
-    gConnectTimer[playerid] = -1;
+    gConnectTimer[playerid] = 0;
     return 1;
 }
 

diff --git a/docs/translations/bs/scripting/functions/SetVehicleParamsEx.md b/docs/translations/bs/scripting/functions/SetVehicleParamsEx.md
@@ -36,7 +36,7 @@ Postavlja parametre vozila za sve igrače.
 ```c
 // Na vrhu naše skripte, deklarišemo globalnu varijablu
 new
-    gVehicleAlarmTimer[MAX_VEHICLES] = {-1, ...};
+    gVehicleAlarmTimer[MAX_VEHICLES] = {0, ...};
 
 // Ako postavljate jedan parametar, trebali biste dobiti trenutne parametre kako se ne bi SVE promijenili
 new
@@ -54,7 +54,7 @@ SetVehicleParamsEx_Fixed(vehicleid, &engine, &lights, &alarm, &doors, &bonnet, &
     {
         // Ubij tajmer, resetirajte identifikator tajmera, a zatim ga ponovo pokrenite ako je već bio pokrenut
         KillTimer(gVehicleAlarmTimer[vehicleid]);
-        gVehicleAlarmTimer[vehicleid] = -1;
+        gVehicleAlarmTimer[vehicleid] = 0;
         gVehicleAlarmTimer[vehicleid] = SetTimerEx("DisableVehicleAlarm", 20000, false, "d", vehicleid);
     }
 }
@@ -72,7 +72,7 @@ public DisableVehicleAlarm(vehicleid)
     }
 
     // Reset the timer identifier
-    gVehicleAlarmTimer[vehicleid] = -1;
+    gVehicleAlarmTimer[vehicleid] = 0;
 }
 ```
 

diff --git a/docs/translations/th/scripting/functions/GetPlayerPing.md b/docs/translations/th/scripting/functions/GetPlayerPing.md
@@ -20,9 +20,9 @@ The current ping of the player (expressed in milliseconds).
 
 ```c
 // Declare an array of all possible timer identifiers for timers for kicking players with
-// generally high ping with default value of -1
+// generally high ping with default value of 0
 new
-    gPlayerPingTimer[MAX_PLAYERS] = {-1, ...};
+    gPlayerPingTimer[MAX_PLAYERS] = {0, ...};
 
 // A constant (nice documentation :))
 const
@@ -38,7 +38,7 @@ public OnPlayerDisconnect(playerid, reason)
 {
     // Kill the timer and reset the value to invalid
     KillTimer(gPlayerPingTimer[playerid]);
-    gPlayerPingTimer[playerid] = -1;
+    gPlayerPingTimer[playerid] = 0;
 }
 
 // A forwarded function (callback)