← 블로그

게임 서버 없이 Godot 게임을 멀티플레이어로

· Hibira

Godot 4용 순수 GDScript Hibira 애드온을 만들었습니다. 방, 채팅, 플레이어 위치 동기화를 지원하고 웹 내보내기에서도 동작합니다. 만든 이유, 동작 방식, 5분 만에 돌아가는 데모까지.

어느 날 팀의 누군가가 물었습니다. "Godot에서 Pusher 프로토콜을 쓸 수 있나요?"

답은 '아니요'였습니다. Godot 4에는 WebSocket이 내장되어 있고 고수준 멀티플레이어 API도 갖춰져 있지만, 둘 다 게임 서버를 직접 운영하거나 플레이어 중 한 명이 호스트가 된다는 전제입니다. 작은 팀이 멀티플레이어에서 가장 막히는 지점이 바로 여기입니다. 게임은 다 만들었는데, 서버를 세우고, 포트를 열고, NAT를 다루는 법을 익혀야 하고, 몇 명이 플레이할지도 모르는 머신에 매달 비용을 내야 합니다.

저희는 다른 방식을 원했습니다. 게임에는 클라이언트만 넣고, 관리형 실시간 서비스에 연결해서 방, 접속자 목록, 플레이어 사이의 메시지는 그 서비스가 전달하게 하는 것이죠. 그래서 Hibira의 Godot 애드온을 만들었습니다. 순수 GDScript로 작성되어 네이티브 확장이 필요 없으니, 웹을 포함해 Godot가 내보낼 수 있는 모든 플랫폼에서 동작합니다.

같은 방에 왼쪽은 Godot 플레이어, 오른쪽은 브라우저 플레이어.
같은 방에 왼쪽은 Godot 플레이어, 오른쪽은 브라우저 플레이어.

작은 멀티플레이어 게임에 정말 필요한 것

모든 멀티플레이어 게임이 슈팅 게임은 아닙니다. 주변의 인디 게임과 게임잼 작품을 살펴보니 멀티플레이어 기능은 대부분 이런 것들이었습니다.

  • 로비와 방: 방을 만들고, 코드를 받아 친구에게 보내고, 모두가 '준비'를 누를 때까지 기다리기.
  • 누가 접속해 있는지: 방에 누가 있는지, 누가 막 들어왔고 누가 나갔는지, 누가 방장인지.
  • 채팅: '상대가 입력 중…' 표시까지.
  • 가벼운 동기화: 협동 게임에서 모두의 위치, 파티 게임에서 누가 먼저 눌렀는지, 턴제 게임의 다음 수.

공통점은 메시지가 작고, 필요한 속도가 슈팅 게임처럼 1밀리초를 다투는 속도가 아니라 '사람이 느끼기에 빠른' 속도라는 것입니다. WebSocket 하나와 '채널' 모델로 잘 다룰 수 있는 것들이고, 바로 Pusher 프로토콜이 잘하는 일입니다.

왜 Pusher 프로토콜인가

Pusher 프로토콜은 10년 넘게 쓰여 왔고 모델이 단순합니다. 클라이언트가 채널을 구독하고, 서버나 다른 클라이언트가 그 채널로 이벤트를 보냅니다. 게임에서 유용한 것은 presence 채널입니다.

  • 구독은 여러분의 백엔드가 서명하므로, 누가 어느 방에 들어갈 수 있는지는 여러분이 정합니다.
  • 채널은 현재 멤버 목록과 누가 들어오고 나갔는지를 모두에게 알려 줍니다.
  • 플레이어끼리 client 이벤트를 직접 주고받을 수 있고, 서버는 모든 이벤트에 보낸 사람의 user_id를 붙입니다.

마지막 점이 핵심입니다. user_id는 클라이언트가 직접 채우는 것이 아니라 서버가 붙이므로, '플레이어 A가 여기로 이동했다'는 메시지가 오면 그것이 정말 플레이어 A에게서 왔다는 것을 알 수 있습니다. 뒤에서 소개할 위치 동기화는 이 보장 위에 만들어졌습니다.

또 다른 장점은 프로토콜이 같으면 웹과 게임이 서로 통한다는 것입니다. 웹용 로비 SDK @hibira-io/lobby도 같은 이벤트를 쓰므로, 위 스크린샷처럼 Godot 플레이어와 브라우저 플레이어가 같은 방에 들어올 수 있습니다.

동작 방식

Godot 게임HibiraClient
서명 요청
여러분의 백엔드app secret으로 presence 채널 서명
Godot 게임HibiraClient
WebSocket
Hibira방, 멤버 목록, 이벤트 전달
WebSocket
다른 플레이어Godot 또는 브라우저
게임은 Hibira에만 연결하고, 백엔드는 서명만 맡습니다

애드온의 주요 구성 요소는 네 가지입니다.

  • HibiraClient: Godot 내장 WebSocketPeer 위에 만든 Pusher 프로토콜 v7 클라이언트입니다. 연결, 구독, ping/pong, 연결이 끊긴 뒤의 자동 재연결과 재구독을 맡습니다.
  • HibiraChannel: 하나의 채널입니다. bind()로 이벤트를 받고 trigger()로 client 이벤트를 보내며, presence 채널에는 멤버 목록과 입장·퇴장 signal이 더해집니다.
  • HibiraRoom: presence 채널을 게임 방으로 만듭니다. 자리, 방장, 준비 상태, 방 설정, 강퇴, 게임 시작, 그리고 입력 중 표시가 있는 채팅까지.
  • HibiraSync: 0.2.0에서 새로 추가된 노드입니다. 캐릭터 아래에 두면 그 위치가 다른 플레이어의 화면에 나타납니다.

app secret은 처음부터 끝까지 게임에 들어가지 않습니다. 내보낸 게임은 누구나 풀어 볼 수 있으니 서명은 반드시 백엔드에서 해야 합니다. pusher-js나 Laravel Echo와 똑같은 방식입니다. 이미 웹 버전이 있다면 그 인증 엔드포인트를 그대로 쓸 수 있습니다.

HibiraSync: 붙이기만 하면 동기화

협동 게임에서 가장 흔한 요구는 '내가 어디 있는지 다른 사람에게 보여 주기'입니다. 저희는 이것을 노드 하나로 끝내고 싶었습니다. player.tscn의 CharacterBody2D 아래에 HibiraSync를 두고, 채널 이름을 presence-match-1로, 동기화할 속성을 position과 rotation으로 정한 뒤 각 플레이어를 이렇게 생성합니다.

func spawn(user_id: String) -> void:
	var p := PLAYER.instantiate()
	p.name = user_id
	p.get_node("HibiraSync").owner_id = user_id # 누가 조종하는지
	add_child(p)

내부에서는 몇 가지 일이 일어납니다.

  • 소유자만 움직일 수 있습니다. 노드마다 owner_id가 있고, 소유자가 아닌 사람에게서 온 값은 버립니다. 서버가 user_id를 붙여 주기 때문에 가능한 일입니다.
  • 씬 전체가 메시지 하나입니다. 한 채널에서 동기화하는 노드는 tick마다 client 이벤트 하나로 묶여 전송되며, 기본값은 초당 8회입니다. Hibira의 client 이벤트 한도는 연결당 초당 10건이므로, 씬에서 동기화하는 노드가 몇 개든 한도를 넘지 않습니다.
  • 바뀐 값만 보냅니다. 캐릭터가 가만히 있으면 아무것도 보내지 않고, 누군가 방에 새로 들어오면 그 사람을 위해 전부 다시 보냅니다.
  • 받은 값으로 부드럽게 이동합니다. 초당 8번의 업데이트를 그대로 적용하면 캐릭터가 뚝뚝 끊겨 움직입니다. 그래서 받은 값을 목표로 삼고 매 프레임 조금씩 다가가며, 각도와 쿼터니언에도 맞는 보간이 있습니다.
플레이어 A의 게임Hibira플레이어 B의 게임client-hibira-sync{"s": {"A/Player": {"position": [...]}}}같은 이벤트user_id: "A"를 붙여서플레이어 B는 user_id가 노드의 소유자인지 확인한 뒤 캐릭터를 부드럽게 이동시킵니다
tick 하나에서 일어나는 일
Playground: 같은 방의 두 브라우저 창이 각자 점 하나를 움직이고, 다른 쪽의 점이 부드럽게 따라옵니다.

분명히 해 두자면, HibiraSync는 파티 게임, 협동 게임, 보드게임처럼 '친구끼리 하는' 게임에 맞습니다. 각 플레이어가 자기 캐릭터를 완전히 제어합니다. 서버 권한(server-authoritative) 방식의 넷코드가 아니므로, 부정행위를 막아야 하는 대전 게임에는 여전히 서버 쪽 판정이 필요합니다.

5분 만에 시작하기

  1. GitHub에서 addons/hibira를 내려받아 프로젝트의 addons/ 폴더에 넣고, 프로젝트 → 프로젝트 설정 → 플러그인에서 Hibira Realtime을 켭니다.
  2. addons/hibira/demo/playground.tscn을 열고 F6을 누릅니다. 설정 없이 공개 데모 앱에 연결되고, 네 글자 코드의 방이 만들어집니다.
  3. 디버그 → 실행 인스턴스 사용자 지정에서 인스턴스 수를 2로 바꾸고 다시 실행하면, 한 방에서 점 두 개가 움직이는 것을 볼 수 있습니다.

브라우저에서 바로 해 보려면 온라인 playground를 여세요. 같은 씬을 웹용으로 내보낸 것입니다. 방 코드가 담긴 링크를 친구에게 보내면 친구도 같은 방에 들어옵니다. playground는 창마다 새 플레이어입니다. 직접 만든 게임에서는 같은 사용자로 로그인한 두 창이 방에서 한 명의 멤버로 집계되므로, 두 계정으로 테스트하세요. 예를 들어 다른 브라우저나 시크릿 창을 쓰면 됩니다.

자신의 앱을 쓸 때는 먼저 Hibira 관리 화면에서 준비합니다. 앱의 Overview → Credentials에서 key를 복사하고(secret은 앱을 만들 때 한 번만 표시되며 백엔드에만 둡니다), Settings → Allow client events를 켭니다. 웹으로 내보낸다면 페이지의 오리진(예: https://yourname.itch.io)을 Settings → Allowed origins에 추가하세요. 무료 플랜에서는 *를 쓸 수 없고, 오리진을 추가하지 않으면 브라우저가 연결하지 못합니다. 인증 엔드포인트는 Pusher 호환 백엔드라면 어디서든 presence- 채널에 서명할 수 있고, Node라면 @hibira-io/lobby의 authorizeRoom()을 그대로 쓰면 됩니다.

그다음 프로젝트 설정의 Hibira 항목에 app key와 인증 엔드포인트만 입력하면 됩니다. 애드온이 Hibira라는 autoload를 추가해 게임이 시작될 때 자동으로 연결하므로, 어느 스크립트에서든 바로 쓸 수 있습니다.

func _ready() -> void:
	var lobby := HibiraRoom.join(Hibira, "presence-room-ABCD", {"capacity": 4})
	lobby.message_received.connect(func(m): print(m.info.name, ": ", m.text))
	lobby.started.connect(func(data, _by): start_game(data))

완성된 예제: 반응 속도 게임

부품을 조합하면 정말 게임이 되는지 확인하려고 4인용 반응 속도 게임을 만들었습니다. 방 목록, 네 자리, 방장, 준비, 강퇴, 방 채팅, 그리고 다섯 라운드의 'GO!가 보이면 먼저 누르기'입니다.

방 목록: 방을 만들거나, 코드로 친구의 방에 들어갑니다.
방 목록: 방을 만들거나, 코드로 친구의 방에 들어갑니다.
게임 화면: 방장이 시작하면 탭할 때마다 방 채널에 client 이벤트가 하나씩 전송됩니다.
게임 화면: 방장이 시작하면 탭할 때마다 방 채널에 client 이벤트가 하나씩 전송됩니다.

웹 버전 로비 예제와 같은 이벤트를 쓰므로 Godot 플레이어와 브라우저 플레이어가 함께 플레이할 수 있습니다. 전체 소스는 examples/godot-lobby에 있습니다.

비용과 한도

  • client 이벤트는 몇 명이 받든 메시지 한 건으로 셉니다. 네 명이 다섯 라운드를 해도 수십 건 정도입니다. 무료 플랜은 하루 20만 건이라 프로토타입과 작은 테스트에는 충분합니다.
  • HibiraSync는 기본적으로 초당 최대 8건(프로젝트 설정에서 바꿀 수 있고 최대 10)이며, 변화가 있을 때만 보냅니다. 네 명이 계속 움직여도 한 시간에 최대 약 11만 건이고, 가만히 있는 동안은 세지 않습니다.
  • 무료 플랜에서 이벤트 하나의 데이터는 최대 4 KB입니다(유료 플랜은 더 큽니다). HibiraSync는 배치를 이 크기보다 작게 나눠 보내므로, 긴 문자열 같은 단일 값은 작게 유지하세요.
  • presence 채널은 최대 100명까지라 방으로는 충분합니다. 수천 명이 모이는 로비 같은 큰 공간에는 일반 채널과 서버에서의 브로드캐스트를 함께 쓰세요.

앞으로

애드온은 GitHub에서 받을 수 있고, Godot Asset Library 등록도 신청해 두었습니다. 다음으로는 종단 간 암호화 채널과 사용자 로그인(pusher:signin)을 추가하려고 합니다.

Godot로 멀티플레이어 게임을 만들고 있다면 한번 써 보세요. 여러분의 게임에 무엇이 필요한지 꼭 듣고 싶습니다.