ReHLDS Log API

MetaMod Plugin that uses JSON API to comunicate with WebServer using HTTP/S Protocol.

What that plugin do

The Plugin sends requests to a webserver using JSON format. And it can get responses from the webserver of what to do on the ReHLDS side using specific data models.

The main idea is control ReHLDS server using server or player events, that will be handled by webserver. Like create a ban system, register system, live server list or something that envolves webservers, databases, players and others.

Visit our documentation

You can learn what LogAPI can do in HLDS server, control the events, create responses and more: LogApi Wiki

Console Vriables

Console Variable	Default	Required	Description
log_api_enable	0	Yes	Enable Log API plugin 0 Disable 1 Enable
log_api_address	-	Yes	Set Log API Address Ie. https://api.yoursite.com/
log_api_timeout	5.0	Yes	Timeout in seconds to wait for response from remote server
log_api_bearer	-	No	Bearer Token to use with HTTP
log_api_delay	60.0	No	Delay to update Server Info on webserver

Enable / Disable events

To enable what event will be sent to webserver, edit events.json file. The settings will be work after server restart.

{
	"ServerActivate": 		    false,
	"ServerDeactivate": 		false,
	"ServerAlertMessage": 		false,
	"ServerInfo": 			    false,
	"ClientConnect":		    false,
	"ClientPutInServer":		false,
	"ClientDisconnect":		    false,
	"ClientKill": 			    false,
	"ClientUserInfoChanged": 	false,
	"ClientCommand": 		    false,
	"ClientSay": 			    false,
	"ClientMenuHandle":		    false
}

There is a small PHP Example

See how webserver can handle some of events using PHP. In the example, when player join in server the webserver will return a chat message to all players, and do a sv_restart command.

1. Enable ClientPutInServer event on events.json

{
	"ServerActivate": 		    false,
	"ServerDeactivate": 	    false,
	"ServerAlertMessage": 	    false,
	"ServerInfo": 			    false,
	"ClientConnect":		    false,
	"ClientPutInServer":	    true,
	"ClientDisconnect":		    false,
	"ClientKill": 			    false,
	"ClientUserInfoChanged":	false,
	"ClientCommand": 		    false,
	"ClientSay": 			    false,
	"ClientMenuHandle":		    false
}

2. Configure variables on HLDS side (At logapi.cfg file)

// Enable Log API
//
// 0 Disable
// 1 Enable
//
// Default "0"
log_api_enable "1"

// Set Log API Address
// API HTTP Address Ie. http://api.yoursite.com/
//
// Default ""
log_api_address "https://yourwebsite.com/api.php"

// Set Log API Timeout
// Timeout in seconds to wait for response from remote server
//
// Default 5.0
log_api_timeout "5.0"

// Set Log API Bearer Token
// Authentication Token or leave empty to disable
//
// Default ""
log_api_bearer "YOUR_API_TOKEN_CVAR"

// Server Info Event Delay
// Delay to update Server Info on webserver
//
// Default "60.0"
log_api_delay "60.0"

3. Let's create the api.php file (log_api_addres must be something like: https://yourwebsite.com/api.php)

<?php
// Include the LogAPI Class
include("LogApi.php");

// Execute LogAPI OnEvent
(new LogAPI)->OnEvent();

// Exit
exit;

4. The LogAPI.php class to handle HLDS server events, you can create other classes to handle events later.

<?php

class LogAPI
{
    /**
     * The log api token cvar value
     * 
     * @param string
     */
    private $logApiToken = "YOUR_API_TOKEN_CVAR";

    /**
     * On Receive Event
     */
    public function OnEvent()
    {
        // Compare HTTP_AUTHORIZATION with Bearer Token of log_api_bearer
        if (trim(str_replace('Bearer', '', $_SERVER['HTTP_AUTHORIZATION'])) == $this->logApiToken)
        {
            // Parse request as json event
            $request = json_decode(file_get_contents('php://input'), true);
            
            // If event is not empty
            if (!empty($request['Event']))
            {
                // If method exists
                if (method_exists($this, $request['Event']))
                {
                    // Process paramemeters as array
                    $parameters = array_values($request);

                    // Return from function call
                    $result = $this->{$request['Event']}(...$parameters);

                    // Set PHP to return content type as json
                    header('Content-Type: application/json');

                    // Return final result encoded as json
                    die(json_encode($result));
                }
            }
        }
        else
        {
            header("HTTP/1.1 401 Unauthorized");
        }
    }

    /**
     * On Client Put In Server
     * 
     * @param string $Event             Event Name
     * @param array $Server		Server information data
     * @param array $Player		Player information data
     * 
     * @return mixed                    Array containing LogAPI commands or null
     */
    protected function ClientPutInServer($Event, $Server, $Player)
    {
        // Print Chat
        $result["PrintChat"] =
        [
            // Entity Index (0) send message to all players
            'EntityId' => 0,

            // The message string (You can use format sequence to get colors in chat)
            'Message' => "{$Player['Name']} entered in server. Game will restart in ^35^1 seconds..."
        ];

        // Return server command to HLDS
        $result['ServerCommand'] = "sv_restart 5";

	    // Return result to api.php, result can have multiple commands at once
        return $result;
    }
}

Development Alpha Stage

Please, consider that plugin is experimental. Any feedback / request is always welcome..

Finally

A Future documentation how to use it will be provided in this repository.