Source RCON 프로토콜

바이너리 RCON 프로토콜로 Source 엔진 게임 서버(Counter-Strike, Garry's Mod, ARK, Rust, Minecraft, ...)에 인증된 원격 콘솔 명령을 전송하세요.

TsgcLib_RCON

Source RCON 바이너리 프로토콜용 TCP 클라이언트 — 서버 비밀번호로 인증하고 exec 명령을 전송하며 응답을 파싱해요.

컴포넌트 클래스

TsgcLib_RCON

플랫폼

Windows, macOS, Linux, iOS, Android

에디션

Standard / Professional / Enterprise

호스트와 비밀번호 설정, 명령 전송

TsgcLib_RCON에서 호스트, 포트, 비밀번호를 설정한 후 연결하고 인증한 다음, 콘솔 명령마다 ExecCommand를 호출하세요.

uses
  sgcLibs;

var
  RCON: TsgcLib_RCON;
begin
  RCON := TsgcLib_RCON.Create(nil);
  RCON.Host     := 'gameserver.example.com';
  RCON.Port     := 27015;
  RCON.Password := 'rcon-password';

  RCON.OnResponse := procedure(Sender: TObject;
    const aResponse: string; const aPacket: TsgcRCON_Packet)
  begin
    Memo1.Lines.Add(aResponse);
  end;

  RCON.Connect;
  RCON.ExecCommand('status');
  RCON.ExecCommand('sv_gravity 800');
end;
// uses: sgcLibs
TsgcLib_RCON *RCON = new TsgcLib_RCON(this);
RCON->Host     = "gameserver.example.com";
RCON->Port     = 27015;
RCON->Password = "rcon-password";

RCON->Connect();
RCON->ExecCommand("status");

내부 구성

일반 TCP 위에서 Valve Source RCON 바이너리 프로토콜(SERVERDATA_AUTH / SERVERDATA_EXECCOMMAND)을 구현해요.

인증

Connect 시 컴포넌트는 구성된 비밀번호로 SERVERDATA_AUTH 패킷을 보내고 SERVERDATA_AUTH_RESPONSE를 기다려요. OnAuthenticate는 성공 또는 실패를 알려줘요.

명령 실행

ExecCommand는 요청된 콘솔 명령과 함께 SERVERDATA_EXECCOMMAND를 전송해요. 서버 응답은 파싱된 패킷 본문과 함께 OnResponse로 도착해요.

다중 패킷 응답

Source RCON은 큰 응답을 여러 패킷에 걸쳐 분할해요 — 컴포넌트는 빈 응답 센티넬 기법으로 이를 재조립해 하나의 연결된 문자열로 제공해요.

광범위한 게임 지원

Source RCON 프로토콜을 구현하는 모든 서버에서 작동해요: Counter-Strike, Garry's Mod, ARK: Survival Evolved, Rust, Squad, Project Zomboid, Minecraft(플러그인 경유) 등.

일반 TCP, 일반 텍스트

이 사이트의 WebSocket 컴포넌트와 달리 RCON은 원시 TCP 컴포넌트예요(바이너리 리틀 엔디안 프레이밍). WebSocket 전송은 필요하지 않아요.

복원력

원격 연결 끊김이나 비밀번호 거부를 처리하려면 OnDisconnectOnError를 후크하세요. 재인증하려면 Connect를 다시 호출하세요.

사양 및 참고 자료

이 컴포넌트가 구현하는 프로토콜의 공식 출처.

문서 및 데모

컴포넌트 레퍼런스로 바로 이동하고, 실행 가능한 데모 프로젝트를 받고, 체험판을 다운로드하세요.

온라인 도움말 — RCON 이 컴포넌트의 전체 속성, 메서드, 이벤트 레퍼런스.
데모 프로젝트 — Demos\50.Other\02.RCON 실행 가능한 예제 프로젝트. sgcWebSockets 패키지에 포함돼 있어요 — 아래에서 체험판을 다운로드하세요.
기술 문서 (PDF) 이 컴포넌트의 기능, 빠른 시작, Delphi 및 C++ Builder 코드 샘플, 1차 출처 참고 자료.
사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서.

게임 서버를 원격 관리할 준비가 되셨나요?

무료 체험판을 다운로드해 Delphi 애플리케이션에서 RCON 명령을 실행하세요.