server

Options and examples

 ### Interval Function for Executing Actions at Specified Time Intervals ###

  The `QT.SetInterval` function allows you to execute an action at a set time interval (in seconds, which you configure).
  Each interval is assigned a unique ID for easy identification, allowing you to stop it later if needed.

  ## Function Parameters: ##
  - id: A unique identifier (string or number) used to index the interval. This is useful for tracking or stopping the interval later.
  - time: The time interval in milliseconds. You can convert this time based on your needs.

  ## Example Usage: ##
  QT.SetInterval("motel_days_remover", 60000, function()
      local hour, minute = TimeFunction()
  
      if hour == 23 and minute == 0 then
          for k, v in pairs(Motels) do 
              RemoveDay(v["doors"], k)
          end
      end
  end)
  
  -- To stop the interval:
  QT.ClearInterval("motel_days_remover") -- Stops the interval with the unique id

  ### Adding Commands with QT.AddCommand ###

  The `QT.AddCommand` function allows you to create custom commands that can be executed in the game, either on the server or client side. 
  This function simplifies the process of registering commands and associating them with specific handler functions.

  ## Function Parameters: ##
  - name: A string representing the name of the command you want to register (e.g., "myCommand").
  - handler: A function that will be called when the command is executed. 
    This function receives three parameters:
    - source: The ID of the player who executed the command (server-side only).
    - args: A table containing the arguments passed to the command.
    - rawCommand: The original command string as entered by the player.
  - restricted: A boolean value indicating whether the command should be restricted to specific user roles (e.g., admins). 
    Set to `true` to restrict, or `false` for public access.

  ## Usage Example (Server Side): ##
  -- This example shows how to register a command that can be used by players.
  QT.AddCommand("giveitem", function(source, args, rawCommand)
      -- Logic to give an item to the player
      local itemName = args[1] -- The item name from the command
      -- Code to give the item to the player using their source ID
  end, false) -- Allows all players to use this command

   ## Usage Example (Client Side): ##
  -- On the client side, you can also use the same command to trigger specific actions.
  QT.AddCommand("heal", function(args, rawCommand)
      local playerId = PlayerPedId() 
  end) 

  ## Note: ##
  -- Ensure that your handler functions contain appropriate logic to handle the command.
  -- Use restrictions wisely to control access to commands, especially for sensitive actions.

### Retrieving Player Identifiers with QT.GetIdentifier ###

  The `QT.GetIdentifier` function is used to retrieve a specific identifier for a player based on the provided type. 
  This function is particularly useful for getting identifiers such as Discord, Steam, license, or IP addresses.

  ## Function Parameters: ##
  - type: A string representing the type of identifier you want to retrieve. Valid types include:
    - "discord"  : For retrieving the player's Discord identifier.
    - "steam"    : For retrieving the player's Steam identifier.
    - "license"   : For retrieving the player's game license identifier.
    - "ip"       : For retrieving the player's IP address.
  - id: A number representing the player source (player ID) from which to fetch the identifiers. This is typically passed from server-side events.

  ## Usage Example: ##
  -- This example shows how to get the Discord identifier for a player.
  local playerSource = 1 -- Example player source ID
  local discordId = QT.GetIdentifier("discord", playerSource)

  if discordId then
      print("Player's Discord ID: " .. discordId)
  else
      print("Discord ID not found for player.")
  end

  ## Note: ##
  -- The function iterates through all identifiers associated with the specified player source ID.
  -- If an identifier of the specified type is found, it returns that identifier; otherwise, it returns false.
  -- Ensure to handle the return value appropriately to avoid errors when an identifier is not found.

  ### Registering Server Callbacks with QT.RegisterServerCall ###

  The `QT.RegisterServerCall` function allows you to register a callback function on the server that can be triggered from the client side. 
  This is useful for handling requests or actions initiated by the client and processing them on the server.

  ## Function Parameters: ##
  - name: A string representing the name of the server call you want to register. This name will be used when triggering the callback from the client.
  - cb: A function that will be executed when the server call is triggered. 
    This function can accept parameters as needed to handle the specific request.

  ## Usage Example: ##
  -- This example shows how to register a server call that processes player data.
  QT.RegisterServerCall("getPlayerData", function(source, args)
      -- Logic to retrieve player data
      local playerId = source -- Get the player ID
      local playerData = GetPlayerData(playerId) -- Assume this function retrieves data for the player
      return playerData -- Return the player data back to the client
  end)

  -- On the client side, you would trigger this server call like this:
  QT.TriggerServerCall("getPlayerData", function(data)
      if data then
          print("Player data received: ", data)
      else
          print("Failed to retrieve player data.")
      end
  end)

  ## Note: ##
  -- The registered callback will be executed on the server when the corresponding client call is made.
  -- Ensure to manage the data flow correctly between the client and server to avoid issues.
  -- Make sure to use unique names for server calls to prevent conflicts with other callbacks.

 ### Optimized Table Insert Function ###

  The `QT.Insert` function is used to insert elements into a table, similar to the standard `table.insert` function, 
  but with an optimized and faster response time, reducing execution time by several milliseconds.

  ## Function Parameters: ##
  - SomeTable: The table into which the new element will be inserted.
  - value: The value (or multiple values) that you want to insert into the table.

  ## Usage Example: ##
  QT.Insert(SomeTable, { value = 1, value2 = 2 } )
  
  -- This function works similarly to the standard `table.insert` but is more optimized.
  -- It inserts a table containing values into `SomeTable`.