게임 아이디어와 기능

다음에 추가할 기능

그룹

선택한 프로젝트의 길드, 클랜, 팀을 역할과 함께 관리합니다.

SDK: develop 브랜치플레이어 세션 필요
Godot
그룹 일러스트
확인할 수 있는 결과

시간 초과나 충돌 시 원래 작업을 보존하고 현재 상태를 확인하세요. 새 리비전으로 자동 재시도하지 마세요.

동영상 준비 중

이 단계의 동영상은 아직 없습니다. 안내와 MCP 요청은 바로 사용할 수 있습니다.

그룹

같은 프로젝트 준비

  1. 게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

    그룹 →
  2. 첫 요청에는 추가 정의가 필요하지 않습니다. 일치하는 게임 데이터가 없으면 빈 결과도 정상입니다.

    그룹은 게임 안에서 생성하고 관리합니다.

    첫 예제는 데이터를 읽습니다. 그룹, 매치, 오브젝트를 생성하지 않습니다. 빈 목록도 정상적인 첫 응답입니다.

이 기능 구현하기

가이드는 미리 볼 수 있습니다. 실행하려면 활성 프로젝트 키가 필요합니다. 프로젝트 준비

SDK 설치와 프로젝트 설정 가져오기가 완료되고 플레이어가 로그인해야 합니다.

이 SDK 예제는 develop을 사용합니다. 필요한 API가 설치된 SDK에 있는지 확인하세요.

빠른 시작으로 원하는 플레이어를 연결하세요. 명시적인 버튼이나 씬 동작에서 read_my_groups()을 호출하세요. 파일을 여는 것만으로는 요청을 보내지 않습니다.

GDScript
res://scripts/groups.gd
horizOn 호출
1extends Node
2​
3# Restore the existing matching player and connect in the Quickstart first.
4# Invoke explicitly from a player action, not from a poll or page loop.
5func read_my_groups() -> void:
6 var user = Horizon.auth.getCurrentUser()
7 if user == null:
8 return
9 var result = await Horizon.groups.getGroups(user.userId)
10 if not result.success:
11 push_warning(result.errorCode)
12 return
13 print("Player revision: ", result.data.revision)
14 for group in result.data.groups:
15 print(group.id, " ", group.myRole, " revision=", group.revision)
16 # result.data.limits contains all current limits; retained groups are not truncated.
17 # getMembers(userId, groupId, "", 1) reads one page. Keep its revision/cursor.
18 # Restart explicitly on a changed revision; optional createdAt is not epoch zero.
19# Full durable mutations: addons/horizon_sdk/examples/features/groups_example.gd.
20# Keep the original revision/requestId; unknown create requires explicit reconciliation.
전체 SDK 예제 열기 ↗

새 기능을 테스트하세요.

시간 초과나 충돌 시 원래 작업을 보존하고 현재 상태를 확인하세요. 새 리비전으로 자동 재시도하지 마세요.

게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

엔드포인트
  • GET/groups
  • GET/groups/{groupId}
  • GET/groups/{groupId}/members
  • GET/groups/{groupId}/pending
  • POST/groups
  • PUT/groups/{groupId}
  • POST/groups/{groupId}/join
  • POST/groups/{groupId}/request
  • POST/groups/{groupId}/invite
  • POST/groups/{groupId}/accept-invite
  • POST/groups/{groupId}/decline-invite
  • POST/groups/{groupId}/cancel-invite
  • POST/groups/{groupId}/accept-request
  • POST/groups/{groupId}/decline-request
  • POST/groups/{groupId}/cancel-request
  • POST/groups/{groupId}/leave
  • POST/groups/{groupId}/remove
  • POST/groups/{groupId}/role
  • POST/groups/{groupId}/transfer
  • POST/groups/{groupId}/delete
API 레퍼런스의 모든 엔드포인트
리더보드 일러스트
다음 단계에 대한 추천

모든 라운드에 최고 점수를 더하세요.

라운드가 끝나면 점수를 저장하고 선두를 보여주세요. 기존 연결과 플레이어 세션을 계속 사용하세요.