RCON

RCON

 

Source RCON プロトコルは Source Dedicated Server が使用する TCP/IP ベースの通信プロトコルで、「リモートコンソール」（RCON）経由でサーバーにコンソールコマンドを発行できます。RCON の最も一般的な使用方法は、サーバーが動作しているマシンに直接アクセスせずに、サーバーオーナーがゲームサーバーを制御できるようにすることです。

 

設定

RCON_Options では次のプロパティを設定できます:

 

• Host: サーバーのリモートアドレス。
• Port: サーバーのリスニングポート。
• Password:サーバーに対して認証するために使用するシークレット文字列。

 

Connect

サーバーへの接続/切断には Active プロパティを使用します。

ActiveがTrueに設定されると、クライアントはサーバーへの接続を試みます。 接続できれば、提供されたパスワードを使用して認証を試みます。

サーバーは認証要求に対する応答を送信します。 OnAuthenticateイベントが呼び出され、 Authenticateパラメータを使用して認証が成功したかどうかを 読み取れます。

 

コマンドを送信する

ExecCommand メソッドを使用してサーバーにコマンドを送信します。レスポンスは OnResponse イベントで利用できます。

 

oRCON := TsgcLib_RCON.Create(nil);
oRCON.RCON_Options.Host := '127.0.0.1';
oRCON.RCON_Options.Port := 25575;
oRCON.RCON_Options.Password := 'test';
oRCON.Active := True;



procedure OnAuthenticate(Sender: TObject; Authenticated: Boolean; const aPacket: TsgcRCON_Packet);
begin
  if Authenticated then
    DoLog('#authenticated')
  else
    DoLog('#not authenticated');
end;



procedure OnResponse(Sender: TObject; const aResponse: string; const aPacket: TsgcRCON_Packet);
begin
  DoLog(aResponse);
end;