Nakama
- 추천0
- GitHub 별14K
- 게임라이선스Apache-2.0
소셜·실시간 게임을 위한 오픈소스 게임 서버. 멀티플레이, 매치메이킹, 리더보드, 채팅, 친구·그룹 기능을 제공해요
요약
소셜·실시간 게임을 위한 오픈소스 게임 서버. 멀티플레이, 매치메이킹, 리더보드, 채팅, 친구·그룹 기능을 제공해요
설명

기능
- 사용자 - 소셜 네트워크, 이메일, 기기 ID로 새 사용자를 등록하고 로그인시킵니다.
- 저장소 - 사용자 기록, 설정, 그 밖의 객체를 컬렉션에 저장합니다.
- 소셜 - 사용자가 친구와 연결하고 그룹에 가입할 수 있습니다. 내장된 소셜 그래프로 사용자들이 어떻게 이어져 있는지 볼 수 있습니다.
- 채팅 - 사용자 간 1:1, 그룹, 전체 채팅. 채팅 기록을 위해 메시지를 보관합니다.
- 멀티플레이 - 실시간 또는 턴제의 능동·수동 멀티플레이.
- 리더보드 - 동적, 시즌제, 상위 멤버 조회, 사용자 주변 멤버 조회. 필요한 만큼 만들 수 있습니다.
- 토너먼트 - 플레이어를 초대해 상품을 두고 함께 겨루게 합니다. 여러 개를 이어 리그를 만들 수 있습니다.
- 파티 - 게임에 팀 플레이를 더합니다. 사용자가 파티를 만들고 파티원과 소통할 수 있습니다.
- 구매 검증 - 앱 내 구매와 구독을 검증합니다.
- 앱 내 알림 - 연결된 클라이언트 소켓에 메시지와 알림을 보냅니다.
- 런타임 코드 - Lua, TypeScript/JavaScript, 또는 네이티브 Go 코드로 만든 사용자 정의 로직으로 서버를 확장합니다.
- 매치메이커, 대시보드, 지표, 그리고 그 밖에도 많습니다.
전 세계의 야심찬 게임 스튜디오와 앱 개발자들이 쓰는, 상용 서비스 수준의 서버로 확장 가능한 게임과 앱을 만드세요. 자세한 내용은 문서를 보고 개발자 커뮤니티에 참여하세요.
시작하기
이 서버는 로컬 개발용으로 설정하고 실행하기 간단하며 어떤 클라우드 제공업체에도 배포할 수 있습니다. 운영 환경 배포 권장 사항은 배포 안내를 보세요. Nakama 서버는 데이터베이스로 CockroachDB나 다른 Postgres 와이어 호환 서버가 필요합니다.
Docker
서버와 데이터베이스를 실행하는 가장 빠른 방법은 Docker입니다. Docker를 설치하고 데몬을 시작하세요.
-
docker-compose 파일을 만들어 프로젝트 폴더에 두세요.
-
docker-compose -f ./docker-compose.yml up을 실행해 컨테이너 이미지를 받고 서버를 실행하세요.
더 자세한 안내는 Docker 빠른 시작 가이드를 보세요.
Nakama Docker 이미지는 Docker Hub에서 관리되며, 서버의 최신 기능을 위해 프리릴리스 이미지가 가끔 게시됩니다.
바이너리
플랫폼용 네이티브 바이너리로 서버를 실행할 수도 있습니다.
-
데이터베이스 안내에 따라 데이터베이스를 시작하세요.
-
데이터베이스 스키마를 설정하거나 업그레이드하는 마이그레이션을 실행하세요.
nakama migrate up --database.address "root@127.0.0.1:26257" -
Nakama를 시작하고 데이터베이스에 연결하세요.
nakama --database.address "root@127.0.0.1:26257"
연결되면 서버가 쓰는 모든 설정을 설명하는 서버 출력이 보입니다.
{"level":"info","ts":"2018-04-29T10:14:41.249+0100","msg":"Node","name":"nakama","version":"2.0.0+7e18b09","runtime":"go1.10.1","cpu":4}
{"level":"info","ts":"2018-04-29T10:14:41.249+0100","msg":"Database connections","dsns":["root@127.0.0.1:26257"]}
...
사용법
Nakama는 여러 게임플레이와 앱 사용 사례에 맞게 최적화된 다양한 프로토콜을 지원합니다. 요청/응답에는 GRPC나 HTTP1.1+JSON 대체 방식(REST)을 쓸 수 있고, 실시간 통신에는 WebSockets나 rUDP를 쓸 수 있습니다.
예를 들어 REST API로 기기 식별자를 써서 사용자 계정을 인증하는 방법입니다.
curl "127.0.0.1:7350/v2/account/authenticate/device?create=true" \
--user "defaultkey:" \
--data '{"id": "someuniqueidentifier"}'
응답:
{
"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1MjQ5OTU2NDksInVpZCI6Ijk5Y2Q1YzUyLWE5ODgtNGI2NC04YThhLTVmMTM5YTg4MTgxMiIsInVzbiI6InhBb1RxTUVSdFgifQ.-3_rXNYx3Q4jKuS7RkxeMWBzMNAm0vl93QxzRI8p_IY"
}
GitHub에는 문서와 함께 공식 클라이언트 라이브러리가 여럿 있습니다. 현재 지원하는 플랫폼과 언어는 .NET(C#), Unity 엔진, JavaScript, Java(Android 포함), Unreal 엔진, Godot, Defold, Swift(iOS 포함)입니다. 클라이언트를 기여하거나 요청하고 싶다면 알려 주세요.
Nakama 콘솔
이 서버는 팀이 쓸 수 있는 웹 UI를 제공합니다. 서버 API로 저장된 여러 데이터를 살펴보고, 가벼운 서비스 지표를 보고, 플레이어 데이터를 관리하고, 저장소 객체를 고치고, 권한 프로필로 운영 환경 접근을 제한하고, 진행 중인 멀티플레이 매치 같은 실시간 기능을 한눈에 볼 수 있습니다. 서버 바이너리 하나에 내장되어 있어 따로 설치할 필요가 없습니다.
브라우저에서 http://127.0.0.1:7351로 들어가 볼 수 있습니다.
스크린샷 보기





배포
Nakama는 Google Cloud, Azure, AWS, Digital Ocean, Heroku, 또는 자체 프라이빗 클라우드 같은 어떤 클라우드 제공업체에도 배포할 수 있습니다. Nakama와 CockroachDB는 별도의 노드로 설정하고 준비해야 합니다.
CockroachDB의 운영 환경 권장 최소 인프라는 이 문서에 정리되어 있고, Nakama는 Google Cloud의 "g1-small" 정도로 작은 인스턴스에서도 돌릴 수 있지만 운영 환경에서는 최소 "n1-standard-1"을 권장합니다. 구체적인 하드웨어 요구사항은 쓰는 서버 기능에 따라 달라집니다. 어떤 서버를 돌려야 할지 도움과 조언이 필요하면 문의해 주세요.
Heroic Cloud
Heroic Labs의 Heroic Cloud로 배포하면 서버의 개발, 새 기능, 유지 보수를 후원할 수 있습니다. 이 서비스는 가동 시간, 복제, 백업, 로그, 데이터 업그레이드 등 운영 환경 서버에 필요한 모든 작업을 맡아 줍니다.
자세한 내용은 Heroic Cloud 서비스를 확인하세요.
기여하기
개발 로드맵은 GitHub 이슈로 관리하며 풀 리퀘스트는 언제나 환영합니다. 이슈 트래커에 없는 기능을 추가하고 싶다면 이슈를 열어 논의를 시작하거나 커뮤니티 포럼에서 이야기해 주세요.
간단 빌드
빌드에 필요한 모든 의존성은 Go 프로젝트의 일부로 포함되어 있습니다. 최신 Go 툴체인을 쓰기를 권하며, 예전 GOPATH 안에 코드를 두지 마세요.
-
소스 트리를 내려받으세요.
git clone "https://github.com/heroiclabs/nakama" nakama cd nakama -
소스에서 프로젝트를 빌드하세요.
go build -trimpath -mod=vendor ./nakama --version
전체 소스 빌드
이 코드베이스는 프로젝트의 일부로 Protocol Buffers, GRPC, GRPC-Gateway, buf, OpenAPI 스펙을 씁니다. 이 의존성들은 소스로 생성되어 저장소에 커밋되어 있어 기여자가 쉽게 빌드할 수 있습니다.
코드베이스를 빌드하고 모든 소스를 생성하려면 다음 단계를 따르세요.
-
buf를 설치하세요. protoc 플러그인은
apigrpc/apigrpc.gen.yaml과console/console.gen.yaml에 고정된 버전의 원격 플러그인으로 실행됩니다. -
프로토콜 버퍼와 게이트웨이 코드를 다시 생성하세요.
# 셸 스크립트를 실행합니다: ./buf.sh -
코드베이스를 빌드하세요.
go build -trimpath -mod=vendor
테스트
모든 단위 테스트와 통합 테스트를 실행하려면 다음을 실행하세요.
docker-compose -f ./docker-compose-tests.yml up --build --abort-on-container-exit; docker-compose -f ./docker-compose-tests.yml down -v
이렇게 하면 Nakama와 데이터베이스 인스턴스가 있는 격리된 환경을 만들고, 모든 테스트를 실행한 뒤 환경을 지웁니다.
라이선스
이 프로젝트는 Apache-2 라이선스를 따릅니다.
저장소: heroiclabs/nakama · 라이선스: Apache-2.0
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0