Lia.logger
lia.log.loadTables()
Description:
Creates the logs directory for the current active gamemode under "lilia/logs".
Parameters:
None
Returns:
nil
Realm:
Server
Internal Function:
true
Example Usage:
-- This snippet demonstrates a common usage of lia.log.loadTables
lia.log.loadTables()
lia.log.addType(logType, func, category)
Description:
Registers a new log type by associating a log generating function and a category with the log type identifier.
The registered function will be used later to generate log messages for that type.
Parameters:
logType (string) – The unique identifier for the log type.
func (function) – A function that takes a client and additional parameters, returning a log string.
category (string) – The category for the log type, used for organizing log files.
Returns:
nil
Realm:
Server
Example Usage:
-- This snippet demonstrates a common usage of lia.log.addType
lia.log.addType("mytype", function(client)
return client:Name() .. " did something"
end, "actions")
lia.log.getString(client, logType, ...)
Description:
Retrieves the log string and its associated category for a given client and log type.
It calls the registered log function with the provided parameters.
Parameters:
client (Player) – The client for which the log is generated.
logType (string) – The identifier for the log type.
... (vararg) – Additional parameters passed to the log function.
Returns:
string, string – The generated log string and its category if successful; otherwise, nil.
Realm:
Server
Internal Function:
true
Example Usage:
-- This snippet demonstrates a common usage of lia.log.getString
local str, category = lia.log.getString(client, "mytype", "info")
lia.log.add(client, logType, ...)
Description:
Generates a log string using the registered log type function, triggers the "OnServerLog" hook,
and appends the log string to a log file corresponding to its category in the logs directory.
Parameters:
client (Player) – The client associated with the log event.
logType (string) – The identifier for the log type.
... (vararg) – Additional parameters passed to the log type function.
Returns:
nil
Realm:
Server
Example Usage:
-- This snippet demonstrates a common usage of lia.log.add
lia.log.add(client, "mytype", "info")