> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ko/docs/sample-projects/godot/arena-shooter.md).

# 아레나 슈터

Edgegap Arena Shooter 샘플을 사용하여, 전용 서버와 매치메이킹 기능을 갖춘 Godot 4 멀티플레이어 아레나 슈터를 Edgegap에서 호스팅하세요.

Edgegap에서 Godot 프로젝트를 호스팅하는 방법을 다음 기술을 사용해 살펴보세요 [슈퍼 스타 파이터](https://github.com/DumpsterFireLabs/SuperStarFighter) 덤프스터 파이어 랩스의 탑다운 아레나 슈터입니다.

플레이어가 **매치 찾기**, 그 [Edgegap 매치메이커](https://docs.edgegap.com/ko/learn/matchmaking.md) 가 그들을 그룹화해 가까운 곳에 전용 서버를 시작하고, 매치가 끝나면 서버가 스스로 중지됩니다.

이 샘플은 다음을 보여줍니다:

* **Godot 4.7.2** GDScript로 만든 게임을 헤드리스 Linux 전용 서버로 내보낸,
* **서버 권위형 네트코드** 를 하나의 WebSocket 포트로 사용합니다 - 서버가 전체 시뮬레이션을 실행하고, 클라이언트는 `wss://`,
* **Edgegap 매치메이커** 통합 - 클라이언트가 티켓을 생성하고, 서버를 기다린 다음, 서버에 참여합니다,
* **서버 자동 중지** - 서버가 매치 후, 또는 아무도 참여하지 않으면 자체 배포를 중지합니다,
* **NPC 채우기** - NPC가 비어 있는 자리를 채워, 혼자 온 플레이어도 매치를 즐길 수 있습니다.

{% hint style="success" %}
참조 [EDGEGAP.md](https://github.com/edgegap/game-sample-godot-arena-shooter/blob/main/EDGEGAP.md) 에서 Edgegap 파일과 서버 설정의 전체 목록을 확인하세요.
{% endhint %}

## ✔️ 준비

시작하기 전에 다음이 필요합니다:

* [아레나 슈터 샘플 프로젝트](https://github.com/edgegap/game-sample-godot-arena-shooter) (Edgegap용으로 수정됨),
* Godot 4.7.2 - 샘플이 자체 복사본을 다운로드합니다(아래 참조),
* Python 3 - 샘플의 빌드 스크립트를 실행하는 데 필요합니다.

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Docker Desktop(또는 Docker CLI) 설치</a></summary>

* [공식 소스에서 Docker Desktop을 설치하세요](https://www.docker.com/products/docker-desktop/) (계정이 필요하지 않습니다).
* 설치를 완료한 후 컴퓨터를 다시 시작하세요.

</details>

☑️ 고정된 Godot 버전과 내보내기 템플릿을 무시된 `.tools` 폴더에 다운로드하려면, 저장소 루트에서 PowerShell을 실행하세요:

{% code collapsedlinecount="10" %}

```powershell
.\tools\bootstrap.ps1
```

{% endcode %}

시스템 전체에는 아무것도 설치되지 않습니다.

## ⚡ 배포 및 연결

### 1. 서버 이미지 빌드

☑️ 시작하려면 다음이 필요합니다. [Edgegap 무료 계정 생성](https://app.edgegap.com/auth/register)하세요. 신용카드는 필요 없습니다.

☑️ 다음을 찾으세요: [컨테이너 레지스트리](https://docs.edgegap.com/ko/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials) 프로젝트 이름과 자격 증명을 확인한 다음, 다음으로 로그인하세요: `docker login registry.edgegap.com`.

☑️ Linux 전용 서버를 내보낸 뒤, 이미지를 빌드하고 푸시하세요:

{% code collapsedlinecount="10" %}

```bash
python tools/build.py bootstrap
python tools/build.py build server-linux-x64 --skip-gate
docker build --platform linux/amd64 -f edgegap/Dockerfile -t registry.edgegap.com/<project>/arena-shooter:<tag> builds/beta-19/server-linux-x86_64
docker push registry.edgegap.com/<project>/arena-shooter:<tag>
```

{% endcode %}

{% hint style="danger" %}
:x: **금지 - 기존 태그를 덮어쓰거나 다음을 사용하지 마세요. `latest`  태그** - 이렇게 하면 오래된 캐시가 배포됩니다.\
:white\_check\_mark: **권장 - 버전 태그를 항상 올리고** 새 빌드를 배포하세요.
{% endhint %}

서버는 WebSocket 포트에서 수신합니다 `7000`. Edgegap 배포 외부에서는 업스트림 게임과 정확히 동일하게 동작합니다.

✅ 이제 다음 단계로 진행할 수 있습니다.

### 2. 앱 버전 만들기

☑️ [애플리케이션 생성](https://app.edgegap.com/application-management/applications/list) 이름: `godot-arena-shooter`, 그리고 버전 이름 `v1` 을 다음과 함께:

* 귀하의 `registry.edgegap.com/<project>/arena-shooter:<tag>` 이미지,
* Edgegap이 이미지를 가져올 수 있도록 컨테이너 레지스트리 사용자 이름과 토큰,
* 리소스 0.5 vCPU 및 1GB 메모리,
* [포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#port-mapping) `7000`, 이름: `gameport`, 프로토콜 **WS**, **TLS 업그레이드** 를 활성화합니다.

{% hint style="warning" %}
클라이언트는 다음으로 연결합니다: `wss://`, 따라서 **TLS 업그레이드는 활성화되어야 합니다**, 그렇지 않으면 클라이언트가 연결할 수 없습니다. 다음을 참조하세요: [웹소켓(WS) 및 보안 웹소켓(WSS)](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#websockets-ws-and-secure-websockets-wss).
{% endhint %}

선택적으로, 앱 버전에 환경 변수를 설정하세요:

* `EDGEGAP_NPC_FILL` - 이 수만큼의 함선까지 NPC로 매치를 채웁니다(기본값 `4`, `0` NPC 비활성화),
* `EDGEGAP_START_GRACE` - 첫 번째 플레이어가 참가한 후 모든 매칭된 플레이어를 기다리는 시간(초)(기본값 `30`),
* `EDGEGAP_JOIN_TIMEOUT` - 빈 서버가 스스로 중지되기까지의 시간(초)(기본값 `120`),
* `EDGEGAP_ROUNDS_TO_WIN` - 매치 승리에 필요한 라운드 수(기본값 `3`).

✅ 이제 다음 단계로 진행할 수 있습니다.

### 3. 매치메이커 만들기

☑️ 열기 [매치메이커](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list) 대시보드의 페이지에서 클릭하세요 **생성**.

☑️ 업로드 `edgegap/matchmaker-config.json` 샘플에서. 다음을 변경하세요: `application.name` 및 `application.version` 가 다르면.

이 구성에는 하나의 `캐주얼` 프로필이 있으며, 2\~4명의 플레이어를 지원합니다. 30초 동안 기다린 후에는 한 명의 플레이어만 단독으로 매칭될 수 있습니다.

☑️ 클릭 **생성 및 시작**을 누르고 매치메이커가 준비될 때까지 기다리세요.

☑️ 매치메이커의 다음을 복사하세요: **API URL** 및 **Auth 토큰**.

✅ 이제 다음 단계로 진행할 수 있습니다.

### 4. 클라이언트 연결

☑️ 매치메이커 URL과 Auth 토큰을 다음에 붙여넣으세요: `src/client/edgegap/edgegap_settings.gd`:

{% code collapsedlinecount="10" %}

```gdscript
const MATCHMAKER_URL := "https://<your-matchmaker-url>"
const MATCHMAKER_AUTH_TOKEN := "<your-auth-token>"
```

{% endcode %}

다음도 설정할 수 있습니다: `EDGEGAP_MATCHMAKER_URL` 및 `EDGEGAP_MATCHMAKER_TOKEN` 클라이언트를 실행할 때 환경 변수를 설정합니다.

{% hint style="info" %}
Auth 토큰은 매치메이커에만 속하며 Edgegap 계정에는 접근 권한을 주지 않으므로, 게임 클라이언트에 포함해 배포해도 안전합니다. **Edgegap API 토큰은 절대 클라이언트에 넣지 마세요.**
{% endhint %}

☑️ 다음으로 Windows 클라이언트를 빌드하세요: `python tools/build.py build windows --skip-gate`, 또는 실행: `.\tools\start-client.ps1`.

☑️ 두 클라이언트를 시작하고 둘 다에서 **매치 찾기** 를 누르세요.

두 클라이언트는 같은 서버를 받아 그 서버에 참여합니다. 매치는 모든 매칭된 플레이어가 들어오거나, 첫 번째 플레이어가 참가한 지 30초 후 시작되며, 빈 자리는 NPC로 채워집니다.

🙌 Edgegap에서 첫 번째 매치메이드 배포를 축하합니다!

## 🔄 매치 수명 주기

1. 클라이언트가 다음을 사용해 티켓을 생성합니다: `캐주얼` 프로필, 그런 다음 서버가 할당될 때까지 2초마다 확인합니다.
2. 매치메이커가 다음을 배포합니다: `godot-arena-shooter` 플레이어 근처에. 서버는 다음에서 몇 명의 플레이어가 매칭되었는지 읽습니다: [`MM_TICKET_IDS`](https://docs.edgegap.com/ko/learn/matchmaking/matchmaker-in-depth.md#injected-variables).
3. 클라이언트가 다음에 참여합니다: `wss://<host>:<external port>` 게임의 직접 연결 코드를 통해. 로비 비밀번호는 배포의 요청 ID이므로, 매칭된 플레이어만 들어올 수 있습니다.
4. 서버가 매치를 시작하고 빈 자리를 최대 4척까지 NPC로 채웁니다.
5. 최종 결과 20초 후, 서버가 다음을 호출합니다: `ARBITRIUM_DELETE_URL` 을 호출하여 배포를 중지합니다. 또한 120초 안에 아무도 참여하지 않거나 모두가 30초 동안 떠나면 중지됩니다.

각 배포는 하나의 매치를 실행합니다. 매치 후 플레이어는 다시 **매치 찾기** 를 누릅니다.

참조 [매치메이킹](https://docs.edgegap.com/ko/learn/matchmaking.md) 및 [배포](https://docs.edgegap.com/ko/learn/orchestration/deployments.md) 자세히 알아보세요.

## 🎵 업스트림과의 변경 사항

업스트림 에셋 라이선스는 수정되지 않은 빌드에 대해 게임 이름, 음악, 스튜디오 로고를 보유합니다. 이 포크는 Edgegap Arena Shooter로 이름이 바뀌었으며, 음악과 로고가 제거되었습니다. 음향 효과는 코드에서 생성되며 여전히 재생됩니다.
