GS2 STUDIO 베타

게임 서버 기능의 선택부터데이터 입력, 반영까지.

GS2 Studio는 Game Server Services(GS2)를 사용하는 게임의 서버 측을 구성하기 위한 데스크톱 애플리케이션입니다. 가챠, 로그인 보너스 등의 기능을 추가하고 마스터 데이터를 표 형식으로 입력하면, GS2 배포 및 Unity용 코드 생성까지 일련의 과정으로 진행할 수 있습니다.

GS2 Studio는 현재 베타 버전입니다. 버그 및 요청 사항은 포럼을 통해 보내 주시기 바랍니다.

GS2 Studio 심플 모드에서 스토어 상품의 마스터 데이터를 표 형식으로 편집하는 화면

HOW IT WORKS

심플 모드라면 3단계로 완료

서버에 관한 지식이 없어도 화면의 안내에 따라 진행하기만 하면 됩니다.

  1. 01

    기능 추가

    캐릭터, 가챠 등 구현하고자 하는 기능을 카탈로그에서 선택합니다. 필요한 표와 서버 설정, 전제가 되는 기능도 함께 추가됩니다.

  2. 02

    데이터 입력

    기능에 포함된 마스터 데이터 표에 게임 데이터를 입력합니다.

  3. 03

    반영

    GS2에 배포하고 Unity 프로젝트에 C# 코드와 에셋을 생성합니다.

FEATURES

GS2 Studio의 주요 기능

기능 선택부터 데이터 입력, 설계, 시각화, 코드 생성, 배포까지, 게임 서버 구축에 필요한 작업을 하나의 애플리케이션에서 수행할 수 있습니다.

01 FEATURE PACKAGES

카탈로그에서 필요한 기능 선택

퀘스트, 로그인 보너스, 가챠, 랭킹, 길드 등 게임에서 자주 사용되는 기능이 "기능 패키지"로 제공됩니다. 패키지를 선택하여 추가하는 것만으로 해당 기능에 필요한 마스터 데이터 표와 GS2 서버 설정이 프로젝트에 포함됩니다.

  • 다른 기능을 전제로 하는 기능은 필요한 기능이 함께 추가됩니다(예: 캐릭터 가챠를 추가하면 캐릭터 및 통화 상점도 함께 추가됩니다)
  • 이름 또는 설명으로 기능을 검색할 수 있습니다
  • 공개 카탈로그 외에 npm 또는 GitHub로 배포되는 패키지도 추가할 수 있습니다
기능 추가 화면. 캐릭터, 파티 편성, 장비 등의 기능이 카드 형식으로 표시되어 있습니다

02 MASTER DATA

표 형식의 마스터 데이터 입력

기능별로 필요한 설정값은 스프레드시트 형식의 표에서 편집합니다. 다른 표의 행을 참조하는 열은 후보 목록에서 선택할 수 있어 ID 입력 오류를 방지할 수 있습니다.

  • 행 추가·복사·붙여넣기 및 실행 취소·다시 실행을 지원합니다
  • 입력값의 문제는 행 단위로 표시되며, 배포에 필요한 데이터가 입력되지 않은 표는 홈 화면에서 안내합니다
  • 서버에 저장하는 열 외에 Unity 에셋(ScriptableObject)으로만 배포하는 열을 추가할 수 있습니다
로그인 보너스 표. 일자별 보상 종류와 수량이 행 단위로 입력되어 있습니다

03 DATA MODEL & ACTIONS

데이터 타입 및 서비스 간 처리 설계

어드밴스드 모드에서는 게임에서 사용하는 데이터 타입(도메인 모델)과 그 속성을 정의할 수 있습니다. 보상 지급이나 비용 소비와 같이 여러 GS2 서비스에 걸친 처리는 "액션 변환"으로 획득·소비·검증의 종류별로 정의합니다.

  • 액션 변환은 파라미터를 입력받아 GS2 액션으로 변환하여 출력합니다
  • 의존 패키지의 타입을 확장하여 프로젝트 고유의 속성을 추가할 수 있습니다
  • 타입과 속성에는 언어별 표시 이름과 설명을 설정할 수 있습니다
액션 변환 편집 화면. 파라미터 목록과 출력되는 GS2 액션이 표시되어 있습니다

04 VISUALIZE

리소스 흐름 및 의존 관계 시각화

이코노미 플로에서는 통화, 아이템 등의 리소스를 어디에서 획득하고 어디에서 소비하는지 그래프로 표시합니다. 의존 관계 그래프에서는 패키지와 리소스 간의 연결 관계를 확인할 수 있습니다.

  • 인스턴스·리소스·패키지/서비스·패키지의 네 가지 단위로 전환하여 표시할 수 있습니다
  • 노드 또는 엣지를 선택하면 인접한 노드가 강조 표시됩니다
  • 참조가 모호한 부분 등은 진단 결과 목록에서 확인할 수 있습니다
이코노미 플로 그래프. 리소스를 주고받는 패키지가 선으로 연결되어 있습니다

05 UNITY

Unity용 C# 코드 생성

프로젝트 정의를 바탕으로 Unity용 C# 코드를 생성합니다. Unity 프로젝트를 지정하면 생성된 코드와 에셋을 해당 프로젝트에 바로 출력합니다.

  • 생성된 컴포넌트를 GameObject에 추가하고 Inspector에서 연결하는 것만으로 표의 내용을 UI에 표시할 수 있습니다(GS2-Bind 사용)
  • GS2-Bind 및 필요한 GS2 SDK가 설치되어 있지 않은 경우, Unity 프로젝트 갱신 시 자동으로 추가합니다
  • 생성되는 코드는 애플리케이션에서 미리 보기로 확인할 수 있습니다
C# 코드 생성 화면. Character 타입에서 생성된 C# 코드의 미리 보기가 표시되어 있습니다

06 DEPLOY

애플리케이션에서 GS2로 배포

마스터 데이터와 서버 설정은 GS2-Deploy 템플릿으로 통합하여 GS2에 배포합니다. 배포 전에 서버와의 차이를 확인할 수 있으며, 변경된 항목만 출력됩니다.

  • 필수 마스터 데이터가 입력되지 않은 경우 등에는 배포를 중단하여 서버의 리소스가 의도치 않게 삭제되는 것을 방지합니다
  • 최초 배포 시에는 GS2 계정 로그인이 필요합니다
  • 배포용 템플릿을 파일로 내보낼 수도 있습니다
반영 화면. 서버 반영과 Unity 프로젝트 갱신이 각각 카드 형식으로 표시되어 있습니다

PACKAGES

추가할 수 있는 기능 패키지

공개 카탈로그에 등록된 기능 패키지입니다.

캐릭터

  • 캐릭터
  • 캐릭터 도감
  • 파티 편성
  • 장비
  • 캐릭터 강화
  • 캐릭터 한계 돌파
  • 스킬 트리
  • 장비 인챈트
  • 장비 장착

경제

  • 통화
  • 아이템
  • 스태미나
  • 방치 보상
  • 횟수 제한
  • 광고
  • 퀘스트
  • 미션
  • 로그인 보너스
  • 버프

상점

  • 캐릭터 가챠
  • 통화 상점
  • 스태미나 상점
  • 구독

운영

  • 랭킹
  • 길드 랭킹
  • 공지·수신함
  • 시리얼 코드
  • 버전 관리

소셜

  • 길드
  • 친구·프로필

기반

  • 계정 이전 설정
  • 스케줄 기반

애플리케이션의 "기능 추가" 화면에는 해당 시점의 최신 카탈로그가 표시됩니다.

MODES

심플 모드와 어드밴스드 모드

화면 오른쪽 상단의 스위치로 언제든지 전환할 수 있습니다.

심플 모드

"기능 추가 → 데이터 입력 → 반영"의 흐름에 특화된 화면입니다. 홈 화면에서 다음 작업을 안내하며, 초기 설정의 진행 상황도 확인할 수 있습니다.

어드밴스드 모드

패키지 구성, 도메인 모델, GS2 리소스, 액션 변환, UI 컴포넌트까지 상세하게 편집할 수 있습니다. 심플 모드에서 해결할 수 없는 문제도 이 모드에서 수정할 수 있습니다.

기타

  • 표시 언어: 일본어 및 영어 지원
  • 라이트/다크 테마 지원
  • macOS·Windows·Linux 버전 제공

DOWNLOAD

사용 환경에 맞는 버전 다운로드

모든 링크는 항상 최신 릴리스의 설치 파일로 연결됩니다.

macOS

  • Apple 실리콘

    macOS 13 이상
    디스크 이미지(.dmg)

    다운로드

Windows

  • x64

    Windows 10 이상
    설치 프로그램(.exe)

    다운로드
  • ARM64

    ARM64용 Windows
    설치 프로그램(.exe)

    다운로드

Linux

  • macOS 버전은 Apple 실리콘(M 시리즈) 탑재 Mac 전용입니다. Intel 프로세서 탑재 Mac용 빌드는 제공하지 않습니다.
  • 애플리케이션의 표시 언어는 일본어와 영어를 지원합니다.
  • SHA-256 체크섬(SHA256SUMS)

INSTALL

설치 안내

macOS

디스크 이미지를 열고 GS2 Studio를 "응용 프로그램" 폴더로 옮깁니다.

macOS 버전은 Apple의 서명 및 공증(Notarization)을 받았습니다.

Windows

다운로드한 설치 프로그램을 실행합니다.

Windows 설치 프로그램은 현재 코드 서명이 되어 있지 않아 Microsoft Defender SmartScreen이 "Windows의 PC 보호" 화면을 표시할 수 있습니다. 이 경우 "추가 정보"를 선택한 후 "실행"을 클릭하면 설치를 계속할 수 있습니다.

Linux

다운로드한 AppImage에 실행 권한을 부여한 후 실행합니다(ARM64 버전의 경우 파일 이름의 x64를 arm64로 바꾸어 입력하시기 바랍니다).

chmod +x GS2-Studio-*-linux-x64.AppImage
./GS2-Studio-*-linux-x64.AppImage

Linux(libfuse2)

Ubuntu 22.04 이상 등 일부 배포판에서는 AppImage 실행에 libfuse2가 필요합니다. 애플리케이션이 실행되지 않는 경우 설치해 주시기 바랍니다.

# Ubuntu 22.04
sudo apt install libfuse2
# Ubuntu 24.04+
sudo apt install libfuse2t64

다운로드한 파일 확인

SHA256SUMS에는 각 설치 파일의 SHA-256 해시가 기재되어 있습니다. 직접 계산한 값과 일치하는지 확인해 주시기 바랍니다.

# macOS
shasum -a 256 GS2-Studio-*.dmg
# Linux
sha256sum GS2-Studio-*.AppImage
# Windows (PowerShell)
Get-FileHash .\GS2-Studio-*.exe -Algorithm SHA256

SHA256SUMS 열기