PC용 GameMaker 개발: 시작

아티클
05/09/2023

이 항목을 사용하여 Microsoft Store 게시할 GameMaker 게임을 준비합니다.

필수 소프트웨어
GameMaker Studio 2
GameMaker Studio 2 - GDK 확장
GDK 확장 빌드
파트너 센터에서 제품 만들기
GDK 확장 테스트
MicrosoftGame.config 업데이트 중
GDK 확장을 사용자 고유의 프로젝트에 통합
게임에서 Xbox 서비스 테스트
게시

필수 소프트웨어

GDK와 함께 GameMaker Studio 2를 사용하려면 다음 도구와 SDK를 설치해야 합니다.

VS2019
GDK
CMAKE
- 시스템 경로를 업데이트하도록 설치 관리자를 설정해야 합니다. 그렇지 않으면 확장 프로젝트가 CMake를 찾을 수 없습니다.

GameMaker Studio 2

GameMaker Studio 2가 아직 설치되어 있지 않은 경우 https://www.yoyogames.com/에서 다운로드하여 설치합니다.

GameMaker Studio 2 - GDK 확장

GameMaker Studio 2에서 GDK를 사용하려면 GameMaker Studio 2 GDK 확장이 필요합니다.
GameMaker Studio 2 GDK 확장에 대한 원본 및 설정 지침은 여기에서 확인할 수 있습니다.
https://github.com/YoYoGames/GDKExtension

리포지토리의 루트에 있는 추가 정보 파일에 나열된 단계를 수행합니다. GDKExtension 리포지토리를 복제할 때 --recurse-submodules 스위치를 사용하여 하위 모듈을 포함하거나 솔루션을 빌드하려고 할 때 필요한 파일이 누락되는지 확인하세요.

확장에는 GDK_Project_GMS2/datafiles/GDK_Extension_Documentation.pdf 아래에 설계 가이드와 빠른 시작 가이드가 있습니다. 이 가이드에는 Game Maker Studio용 GDK 확장 API에 대한 설명서가 포함되어 있습니다.

GDK 확장 빌드

필요한 소프트웨어를 모두 갖추고 Game Maker Studio 2 GDK 확장 리포지토리를 복제했으면 Visual Studio 2019 및 GDKExtension.sln을 사용하여 확장 리포지토리의 DLL 하위 디렉터리에서 확장을 빌드할 수 있습니다. 자세한 빌드 지침은 GDK_Project_GMS2/datafiles/GDK_Extension_Documentation.pdf의 빌드 가이드를 참조하세요.

파트너 센터에서 제품 만들기

Xbox 서비스 기능을 테스트하거나 게임을 Microsoft Store 게시하기 전에 파트너 센터 Xbox 서비스 지원 제품을 만들어야 합니다. 파트너 센터에 대한 자세한 내용은 관리 파트너를 위해 파트너 센터에서 앱 또는 게임 설정을 참조하세요.

GDK 확장 테스트

GDK 확장 리포지토리에는 GDK 플러그인과 Game Maker Studio 2 프로젝트의 통합을 시연하는 샘플 프로젝트가 있습니다. 샘플 프로젝트 파일은 GDK_Project_GMS2/GDK_Project_GMS2.ypp에서 찾을 수 있습니다. 샘플 프로젝트를 빌드할 때(Build->Create Executable) Package as Zip 옵션을 선택해야 앱을 설치하려면 MSIXVC 패키지가 필요합니다. Package as Installer(패키지를 설치 관리자로)를 사용하면 MSIXVC 패키지가 생성되지 않으며 앱이 Xbox 서비스에 제대로 액세스할 수 없습니다.

빌드가 완료되면 생성된 .zip 파일과 MSIXVC 패키지가 포함된 패키지와 동일한 이름의 하위 디렉터리가 포함된 파일 탐색기 창이 열립니다. Game Maker Studio 출력 창을 보면 MSIXVC 패키지의 출력 경로가 표시된 선도 표시됩니다. 예:

C:\Users\your-user-name\XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc-pkg

Xbox 서비스에 액세스할 수 있도록 샘플 프로젝트를 실행하려면 패키지 이름과 함께 wdapp install을(를) 사용하여 패키지를 설치해야 합니다. 예:

wdapp install XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc.msixvc

패키지가 설치되면 Windows 단추를 사용하여 패키지를 시작할 수 있습니다.

MicrosoftGame.config 업데이트 중

샘플 프로젝트는 기본 MicrosoftGame.config 파일을 사용합니다. 프로젝트의 파트너 센터 구성 정보를 사용하여 샘플 또는 GameMaker Studio 프로젝트를 테스트하려면 MicrosoftGame.config 파일을 업데이트해야 합니다.

샘플의 구성 파일은 GDK_Project_GMS2\datafiles\MicrosoftGame.config에서 찾을 수 있습니다.

Xbox 서비스 기능을 사용하려면 파트너 센터 프로젝트 ID 세부 정보로 프로젝트의 MicrosoftGame.config를 업데이트해야 합니다.

파트너 센터 대시보드로 이동합니다.
제품 목록에서 게임을 선택합니다.
게임 설정 탭을 선택하고 ID 세부 정보를 선택합니다.
세부 정보 표시를 선택하요 ID 세부 정보 섹션을 확장합니다.
Identity details 섹션의 표에서 다음 값을 사용한 다음 파트너 센터에서 해당 값을 MicrosoftGame.config의 해당 요소 및 필드에 복사합니다.

파트너 센터의 이름	MicrosoftGame.config
Xbox 타이틀 ID	TitleId
Package/Identity/Name	ID->이름
Package/Identity/Publisher	ID->게시자
Xbox 서비스 -> Xbox 설정 -> MSAAppId	MSAAppId

예를 들어 파트너 센터에서 다음 ID 세부 정보를 사용하면 MicrosoftGame.config가 아래 샘플과 같이 표시됩니다.

파트너 센터의 이름	예제 값
Xbox 타이틀 ID	64353034
Package/Identity/Name	41336MicrosoftATG.Achievements2017Redux
Package/Identity/Publisher	CN=A4954634-DF4B-47C7-AB70-D3215D246AF1
Xbox 서비스 -> Xbox 설정 -> MSAAppId	0000000000000000

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">

  <Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />


  <TitleId>64353034</TitleId>
  <MSAAppId>0000000000000000</MSAAppId>
  
  <ExecutableList>
    <Executable Name="Achievements2017_desktop.exe"
                TargetDeviceFamily="PC"
                Id="Game"/>
  </ExecutableList>
  
  <ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
                PublisherDisplayName="Xbox Advanced Technology Group"
                StoreLogo="Assets\StoreLogo.png"
                Square150x150Logo="Assets\Logo.png"
                Square44x44Logo="Assets\SmallLogo.png"
                Square480x480Logo="Assets\LargeLogo.png"
                Description="Achievements2017"
                ForegroundText="dark"
                BackgroundColor="#000000"
                SplashScreenImage="Assets\SplashScreen.png"/>
</Game>

MicrosoftGame.config의 값에 대한 추가 정보는 MicrosoftGame.config 개요를 참조하세요.

GDK 확장을 사용자 고유의 프로젝트에 통합

GameMaker Studio GDK 확장을 구축하고 샘플 프로젝트를 성공적으로 테스트하면 확장 기능을 자신의 프로젝트에 통합할 준비가 됩니다.

최소한 다음 함수를 호출하여 프로젝트를 GDK와 통합해야 합니다.

GDK를 초기화하려면 gdk_init를 호출해야 합니다. 다른 GDK 기능을 사용하려면 먼저 gdk_init 함수를 호출해야 합니다.
GDK가 활성 상태인 동안 각 프레임에 대해 gdk_update를 한 번 호출해야 합니다.
프로젝트가 GDK를 사용하여 완료되고 다른 GDK 기능이 사용되지 않으면 gdk_quit를 호출하여 정리해야 합니다.

또한 GDK 확장에는 GDK 기능에 대한 액세스를 제공하는 다음과 같은 모듈이 있습니다.

기본 모듈은 플레이어의 사용자/계정 선택을 제어하는 기능을 제공합니다.
저장소 모듈은 사용자와 관련된 데이터를 로드하고 저장하는 기능을 제공합니다.
Xbox 서비스 모듈은 통계, 순위표, 도전 과제, 리치 프레즌스를 포함한 Xbox 서비스의 기능을 사용할 수 있는 기능을 제공합니다.
앱 내 구매 모듈은 프로젝트에서 사용자 구매를 제어하는 기능을 제공합니다.

확장 리포지토리에 포함된 가이드는 GDK 확장 API 섹션에서 GDK 기능에 대한 설명서를 제공합니다. GDK_Project_GMS2/datafiles/GDK_Extension_Documentation.pdf에서 가이드를 찾을 수 있습니다.

게임에서 Xbox 서비스 테스트

게임에서 도전 과제와 같은 Xbox 서비스 기능을 테스트하려면 샌드박스를 사용하고 해당 샌드박스에 액세스할 수 있는 계정을 테스트해야 합니다.

테스트 계정 만들기

게임에서 Xbox 서비스 기능을 테스트하려면 개발 샌드박스에 액세스할 수 있는 테스트 계정을 만들어야 합니다. 테스트 계정 만들기에 대한 자세한 내용은 테스트 계정 만들기를 참조하세요.

샌드박스 전환

테스트 계정을 만들었으면 다음 단계에 따라 계정을 사용하여 샌드박스에 액세스합니다.

샌드박스 ID를 찾으려면 파트너 센터로 이동합니다.
Xbox 서비스를 선택하고 Gameplay Settings(게임플레이 설정)를 선택합니다.

참고 항목

샌드박스 ID는 첫 번째 탭에 있으며 “ABCDEF.0”과 같이 이름이 지정됩니다.
시작 메뉴를 엽니다.
Microsoft GDK Command Prompts를 입력하고 키보드의 Enter 키를 누릅니다.
첫 번째 명령 프롬프트를 엽니다.
명령 프롬프트에 XblPCSandbox.exe [샌드박스 ID]를 입력합니다.
명령 프롬프트에서 여러 개 앱이 시작되면 테스트 계정을 사용하여 Xbox 앱에 로그인합니다.

성공적으로 로그인할 수 있으면 테스트 계정을 만들고 테스트를 시작하기 위해 샌드박스로 변경한 것입니다.

샌드박스에 대한 자세한 내용은 Xbox 서비스 샌드박스 개요를 참조하세요.

게시

게임을 게시할 준비를 하려면 다음을 수행해야 합니다.

GDK와 게임 통합 완료
파트너 센터에서 생성한 프로젝트의 올바른 값으로 MicrosoftGame.config 파일을 업데이트했습니다.
GameMaker Studio에서 Package as Zip(패키지를 Zip으로)을 사용하여 MSIXVC 패키지를 만듭니다.

이 두 가지 요구 사항을 완료하면 게시할 준비가 된 것입니다. 게임을 제출하려면 파트너 센터로 이동하고 UI의 지침에 따릅니다.

다음을 통해 공유