Onset Developer Wiki - User contributions [en]

mariadb async query

2020-01-26T15:53:13Z

REDRUM:

{{Info|Function|Server|1.0}}
{{Notice|This function is provided by the official [[MariaDB]] plugin.}}

{{FuncDescription|Executes a query in different parallel threads. Execution of order can not be guaranteed. Better use [[mariadb_query]] if you are unsure about it.}}

{{FuncSyntax|mariadb_async_query(handle, query_str [, callback_func, callback_args...])}}

{{FuncParameters}}
{{FuncParam|handle|Connection handle.}}
{{FuncParam|query_str |The query to be executed.}}
{{FuncParamOptional|callback_func|The function that will be called when the query was executed.}}
{{FuncParamOptional|callback_args|Multiple arguments to pass to the callback_func.}}

{{FuncReturnValue|Returns '''true''' if the query was successfully queued.}}

== Example ==
<syntaxhighlight lang="Lua">
function GetCurrentPlayTime(player)
CreateTimer(function(player)
for k, v in pairs (GetAllPlayers()) do
if GetAllPlayers() == true then
local query = mariadb_prepare(sql, "SELECT * FROM accounts WHERE id = '?';",
PlayerData[v].accountid)
mariadb_async_query(sql, query, GetPlayerTime, v)
end
end
end, 15000, player)
end
AddEvent("OnPackageStart", GetCurrentPlayTime)

function GetPlayerTime(player)
local result = mariadb_get_assoc(1)
local playtime = math.tointeger(result['time']) -- total time played on the server without session time.
PlayerData[player].time = math.floor(PlayerData[player].time + (GetTimeSeconds() - PlayerData[player].play_time)) -- session play time.
PlayerData[player].play_time = GetTimeSeconds()
return PlayerData[player].time + playtime -- returns the total play time on the server.
end
</syntaxhighlight>
{{RelatedFunctions}}
__EDIT_ME__

mariadb async query

2020-01-26T15:44:19Z

REDRUM: /* Example */

GetTime

2020-01-25T01:33:03Z

REDRUM:

{{Info|Function|Client|1.0}}

{{FuncDescription|Get the client game time.}}

{{FuncSyntax|GetTime()}}

{{FuncParameters}}
{{FuncNoParam}}

{{FuncReturnValue|Returns the current game time as a floating point number.}}

== Example ==
<syntaxhighlight lang="Lua>
function OnPlayerSpawn()
AddPlayerChat("You loaded into the server in "..GetTime().." seconds.")
end
AddEvent("OnPlayerSpawn", OnPlayerSpawn)
</syntaxhighlight>

{{RelatedFunctions}}
* [[SetTime]]

GetTimeSeconds

2020-01-25T00:29:33Z

REDRUM:

{{Info|Function|Server & Client|1.0}}

{{FuncDescription|Returns the amount of time since the server started up.}}

{{FuncSyntax|GetTimeSeconds()}}

{{FuncParameters}}
{{FuncNoParam}}

{{FuncReturnValue|Returns a float value of the amount of time passed since the server started.}}

== Example ==
<syntaxhighlight lang="Lua>
AddCommand("uptime", function(player)
if GetTimeSeconds() > 3600 then
AddPlayerChat(player, "The server has been up for "..FormatTime(GetTimeSeconds()).." hours.")
elseif GetTimeSeconds() > 60 then
AddPlayerChat(player, "The server has been up for "..FormatTime(GetTimeSeconds()).." minutes.")
else
AddPlayerChat(player, "The server has been up for "..FormatTime(GetTimeSeconds()).." seconds.")
end
end)

function FormatTime(seconds)
local seconds = tonumber(seconds)

if seconds <= 0 then
return "00:00:00"
else
hours = string.format("%02.f", math.floor(seconds / 3600));
mins = string.format("%02.f", math.floor(seconds / 60 - (hours * 60)));
secs = string.format("%02.f", math.floor(seconds - hours * 3600 - mins * 60));
return hours..":"..mins..":"..secs
end
end
</syntaxhighlight>
{{RelatedFunctions}}
__EDIT_ME__

OnPlayerDeath

2020-01-24T22:46:40Z

REDRUM: /* Example */

{{Info|Event|Server & Client|1.0}}

{{FuncDescription|Calls when a player dies by any means possible. If the player wasn't killed by another player, instigator will be the same as the player.}}

{{FuncSyntax|OnPlayerDeath(player, instigator)}}

{{FuncParameters}}
{{FuncParam|player|The player that has died.}}
{{FuncParam|instigator|The player who is responsible for the death.}}

== Example ==
<syntaxhighlight lang="Lua">
function OnPlayerDeath(player, instigator)
if player == instigator then
AddPlayerChat(player, '<span color="#ff0000">You have killed yourself.</>')
else
AddPlayerChat(player, '<span color="#ff0000">You were killed by '..GetPlayerName(instigator)..'.</>')
end
end
AddEvent("OnPlayerDeath", OnPlayerDeath)
</syntaxhighlight>

{{RelatedFunctions}}
{{PlayerEvents}}

http set port

2020-01-24T22:26:32Z

REDRUM:

{{Info|Function|Server|1.0.3}}

{{FuncDescription|Sets the port of this request. For HTTP this should be 80, for HTTPS 443.}}

{{FuncSyntax|http_set_port(http, port)}}

{{FuncParameters}}
{{FuncParam|http|The http identifier.}}
{{FuncParam|port|The port of the remote server.}}

{{FuncReturnValue|Returns '''true''' on success.}}

== Example ==
<syntaxhighlight lang="Lua">
function test_post()
local r = http_create()
http_set_resolver_protocol(r, "ipv4")
http_set_protocol(r, "http")
http_set_host(r, "ptsv2.com")
http_set_port(r, 80)
http_set_target(r, "/t/ozoab-1577627726/post")
http_set_verb(r, "post")
http_set_timeout(r, 30)
http_set_version(r, 11)
http_set_keepalive(r, true)
http_set_field(r, "user-agent", "Onset Server "..GetGameVersionString())

local body = ""
body = body.."foo1="..url_encode("bar?")
body = body.."foo2="..url_encode("?d,_:%bar2?")

http_set_body(r, body)
http_set_field(r, "content-length", string.len(body))
http_set_field(r, "content-type", "application/x-www-form-urlencoded; charset=utf-8")

if http_send(r, OnPostComplete, 1, 3.14, "OK s") == false then
print("HTTP REQ NOT SENT :(")
http_destroy(r)
end
end

function OnPostComplete(a, b, c)
print("OnPostComplete", a, b, c)
end
</syntaxhighlight>

{{RelatedFunctions}}
{{HttpFunctions}}

http set host

2020-01-24T22:24:53Z

REDRUM:

{{Info|Function|Server|1.0.3}}

{{FuncDescription|Sets the host of this request which is basically the domain or IP of the remote end.}}

{{FuncSyntax|http_set_host(http, host)}}

{{FuncParameters}}
{{FuncParam|http|The http identifier.}}
{{FuncParam|host|The remote host.}}

{{FuncReturnValue|Returns '''true''' on success.}}

== Example ==
<syntaxhighlight lang="Lua">
function test_post()
local r = http_create()
http_set_resolver_protocol(r, "ipv4")
http_set_protocol(r, "http")
http_set_host(r, "ptsv2.com")
http_set_port(r, 80)
http_set_target(r, "/t/ozoab-1577627726/post")
http_set_verb(r, "post")
http_set_timeout(r, 30)
http_set_version(r, 11)
http_set_keepalive(r, true)
http_set_field(r, "user-agent", "Onset Server "..GetGameVersionString())

local body = ""
body = body.."foo1="..url_encode("bar?")
body = body.."foo2="..url_encode("?d,_:%bar2?")

http_set_body(r, body)
http_set_field(r, "content-length", string.len(body))
http_set_field(r, "content-type", "application/x-www-form-urlencoded; charset=utf-8")

if http_send(r, OnPostComplete, 1, 3.14, "OK s") == false then
print("HTTP REQ NOT SENT :(")
http_destroy(r)
end
end

function OnPostComplete(a, b, c)
print("OnPostComplete", a, b, c)
end
</syntaxhighlight>

{{RelatedFunctions}}
{{HttpFunctions}}

OnPlayWeaponHitEffects

2020-01-24T16:43:26Z

REDRUM: /* Example */

{{Info|Event|Client|1.0}}

{{FuncDescription|This event handles visual effects of weapons. The Weapons.lua contains a pre-configured event that shows the same visual hit effects as always. It is called for local and remote players. If it is called for remote players the parameters will contain the synced values from the other client.}}

{{FuncSyntax|OnPlayWeaponHitEffects(PlayerId, Weapon, HitType, HitId, StartLocation, HitLocation, HitLocationRelative, HitNormal, HitResult)}}

{{FuncParameters}}
{{FuncParam|PlayerId|The player identifier.}}
{{FuncParam|Weapon|The weapon instance.}}
{{FuncParam|HitType|https://dev.playonset.com/wiki/HitType}}
{{FuncParam|HitId|The identifier of the hit entity.}}
{{FuncParam|StartLocation|Trace start location of this bulet/hit.}}
{{FuncParam|HitLocation|Trace hit location.}}
{{FuncParam|HitLocationRelative|Hit location relative to the entity that was hit.}}
{{FuncParam|HitNormal|Bullet impact normal.}}
{{FuncParam|HitResult|Line trace result.}}

== Example ==
<syntaxhighlight lang="Lua">
AddEvent("OnPlayWeaponHitEffects", function (PlayerId, Weapon, HitType, HitId, StartLocation, HitLocation, HitLocationRelative, HitNormal, HitResult)

end)
</syntaxhighlight>

{{RelatedFunctions}}
{{PlayerClientEvents}}