feat(server/impl): add GetPlayerTimeOnline native

code/components/citizen-server-gui/src/PlayerList.cpp

@@ -116,7 +116,7 @@ static const auto& CollectPlayers(fx::ServerInstanceBase* instance)
 		std::unique_lock lock(g_playerListDataMutex);
 		auto& entry = g_playerListData[client->GetGuid()];
 		entry.name = fmt::sprintf("[%d] %s", client->GetNetId(), client->GetName());
-		unsigned int secondsTotalOnline = std::chrono::duration_cast<std::chrono::seconds>(client->GetLastSeen() - client->GetFirstSeen()).count();
+		unsigned int secondsTotalOnline = client->GetSecondsOnline();
 		entry.secondsOnline = (secondsTotalOnline % 60);
 		entry.minutesOnline = ((secondsTotalOnline / 60) % 60);
 		entry.hoursOnline = (secondsTotalOnline / 3600);

code/components/citizen-server-impl/include/Client.h

@@ -213,6 +213,11 @@ namespace fx
 			return m_lastSeen;
 		}
 
+		inline unsigned int GetSecondsOnline()
+		{
+			return std::chrono::duration_cast<std::chrono::seconds>(m_lastSeen - m_firstSeen).count();
+		}
+
 		inline const std::vector<std::string>& GetIdentifiers()
 		{
 			return m_identifiers;

code/components/citizen-server-impl/src/PlayerScriptFunctions.cpp

@@ -233,4 +233,9 @@ static void CreatePlayerCommands()
 			return 0;
 		}
 	}));
+
+	fx::ScriptEngine::RegisterNativeHandler("GET_PLAYER_TIME_ONLINE", MakeClientFunction([](fx::ScriptContext& context, const fx::ClientSharedPtr& client)
+	{
+		return client->GetSecondsOnline();
+	}));
 }

ext/native-decls/GetPlayerTimeOnline.md

@@ -0,0 +1,35 @@
+---
+ns: CFX
+apiset: server
+---
+## GET_PLAYER_TIME_ONLINE
+
+```c
+int GET_PLAYER_TIME_ONLINE(char* playerSrc);
+```
+
+Gets the current time online for a specified player.
+
+## Parameters
+* **playerSrc**: A player.
+
+## Return value
+
+The current time online in seconds.
+
+## Examples
+
+```lua
+local function ShowTimeOnline()
+    local player = source
+    local secondsTotalOnline = GetPlayerTimeOnline(player)
+
+    print(("Time online : %f H %f min %f"):format(
+        (secondsTotalOnline / 3600),
+        ((secondsTotalOnline / 60) % 60),
+        (secondsTotalOnline % 60)
+    ))
+end
+
+RegisterNetEvent("myTimeOnline", ShowTimeOnline)
+```