> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/tutorials-and-examples/published-games/goal-legends.md).

# 골 레전드

서버가 운영하는 경기, 지속적인 리더보드, 단계 기반 카메라, 동기화된 공 애니메이션이 있는 멀티플레이어 페널티 슛아웃.

![Goal Legends 미리보기](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-87e13f2e322f58c64eb7133149b291704e742ea7%2FgoalLegends-preview.webp?alt=media)

멀티플레이어 페널티킥 대결 게임입니다. 다른 플레이어 또는 GL-Bot과 대결하세요. 왼쪽, 중앙, 오른쪽 중 하나를 골라 득점하거나 슛을 막으세요. 매 라운드가 끝나면 TV 중계 스타일의 리플레이가 재생되고, 관중이 실시간으로 반응합니다.

* [Decentraland에서 플레이하기](https://decentraland.org/jump?realm=goallegends.dcl.eth)

## 프로젝트 정보

**관리자:** 커뮤니티 · carlosmu

[원본 소스 보기](https://github.com/carlosmu/goal-legends-arena)

**라이선스:** [Apache-2.0 고지](https://github.com/carlosmu/goal-legends-arena/blob/master/LICENCE). 재사용하기 전에 상위 프로젝트의 조건을 확인하세요. 코드와 에셋에는 서로 다른 조건이 적용될 수 있습니다.

{% hint style="warning" %}
**커뮤니티 관리 코드 — 사용 전 검토하세요**

이 커뮤니티 프로젝트는 Decentraland Foundation 및 DAO GitHub 조직 외부에서 관리됩니다. 소스 코드와 라이브 배포 버전은 별도로 변경될 수 있습니다.

이 카탈로그에 포함되었다고 해서 보안 감사를 거쳤거나 안전성이 보장되는 것은 아닙니다. 실행하거나 재사용하기 전에 코드, 종속 항목, 설치 스크립트를 검토하세요.

[카탈로그 관련 우려 사항 신고](https://github.com/decentraland/docs/issues/new). 취약점이 의심되면 원본 프로젝트의 보안 정책을 따르세요. 공개 이슈에 익스플로잇 세부 정보나 자격 증명을 포함하지 마세요.
{% endhint %}

## 주요 기능

* **멀티플레이어 서버** 에서 경기를 실행합니다
* **저장소** 일일 및 전체 기간 PvP/PvE 순위표와 각 플레이어의 국가 국기를 위한 저장소입니다.
* **장면** **이모트**
* 킥, 다이빙, 골, 선방에 맞춰 애니메이션과 동기화되는 공 소품입니다.
* **가상 카메라** 게임플레이 화면과 모든 플레이어가 함께 보는 승자 시네마틱에 사용됩니다.
* **AvatarShape** 각 골과 선방에 반응하는 관중 NPC입니다.
* **파티클** 불꽃놀이에 사용됩니다
* 조명이 있는 포털과 **`GltfNodeModifiers`** 를 통해 다른 World로 이동할 수 있습니다.

## 코드 살펴보기

이 링크는 특정 소스 스냅샷을 가리키므로, 상위 프로젝트의 개발이 계속되어도 설명을 유용하게 참고할 수 있습니다. 학습을 위한 참고 자료이며 보안 평가 자료는 아닙니다.

### 경기 단계에 따라 카메라 전환

`initGameplayCamera` 는 클라이언트 경기 스냅샷을 바탕으로 게임플레이, 승자 또는 기본 카메라를 선택합니다. 승자 카메라는 피벗을 중심으로 회전하며, 관중은 경기 중 자유 카메라를 선택할 수 있습니다.

**프로젝트 맥락:** 다음 항목과 함께 살펴보세요: `clientSnapshot`, `GameState` 열거형, 그리고 이름이 지정된 장면 카메라 피벗.

**소스 참고:**

* [`initGameplayCamera`](https://github.com/carlosmu/goal-legends-arena/blob/5d42bba8f10ac2c3103a4e5804541c693e8528b3/src/client/gameplayCamera.ts#L109-L165)

### 게임 상태에 맞춰 소품 애니메이션 조정

`tickAnimationManager` 단계가 바뀌면 공 클립을 재생하고, 슛 방향에 따라 골 또는 선방 애니메이션을 선택하며, 클립을 전환하는 동안 잠시 소품을 숨깁니다. 이 경로는 봇 키커 전용입니다. 인간 키커는 이모트 중에 공을 들고 있습니다.

**프로젝트 맥락:** 장면의 공 모델과 이름이 지정된 애니메이션 클립에 의존합니다.

**소스 참고:**

* [`tickAnimationManager`](https://github.com/carlosmu/goal-legends-arena/blob/5d42bba8f10ac2c3103a4e5804541c693e8528b3/src/client/animationManager.ts#L78-L114)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-ko/tutorials-and-examples/published-games/goal-legends.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
