> 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/fastlane-bowling.md).

# 패스트레인 볼링

서버에서 시뮬레이션하는 물리, 지속적인 진행, 배치된 상태 업데이트, 모바일용으로 스케일된 파티클 이펙트가 있는 멀티플레이어 볼링.

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

Cannon-ES가 제공하는 사실적인 물리 엔진을 갖춘 멀티플레이어 볼링 게임입니다. 여러 게임이 공유 공간의 각기 다른 레인에서 진행됩니다.

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

## 프로젝트 정보

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

[원본 소스 보기](https://github.com/stom66/dcl-bowling)

**라이선스:** [CC BY-NC-ND 4.0](https://github.com/stom66/dcl-bowling/blob/main/LICENSE.md). 재사용하기 전에 상위 프로젝트의 이용 약관을 확인하세요. 코드와 에셋에는 서로 다른 조건이 적용될 수 있습니다.

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

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

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

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

## 주요 기능

* [**Cannon-ES**](https://github.com/pmndrs/cannon-es) **물리 엔진을** 멀티플레이어 서버에서 실행하고, 클라이언트는 압축된 키프레임을 재생합니다.
* **플레이어 진행 상황, 통계, 기본 설정, 인벤토리, 주간/전체 기간 리더보드를 위한** 저장소입니다.
* 회전하는 그림자 마스크와 공을 따라가는 스포트라이트를 갖춘 **동적 조명** 입니다.
* **모바일에서는 파티클 수를 줄인** 파티클 궤적 및 잠금 해제 효과입니다.
* **도착 장면의 플라이인, 조준, 투구 재생을 위한** 가상 카메라입니다.
* **`GltfNodeModifiers`** 를 사용해 네온 텍스처의 UV를 스크롤합니다.
* SDK가 제어하는 **glTF 애니메이션은** 레인 범퍼, 카운트다운, 점수 효과에 사용됩니다.

## 코드 살펴보기

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

### 동기화된 상태 변경을 클라이언트 이벤트로 묶기

에서 `LaneWatcher.onLaneChanged`는 변경된 레인을 집계하고 한 번의 플러시를 예약합니다. `flush` 는 각 레인의 스냅샷을 읽고 상태 이벤트와 단계 전환 이벤트를 내보냅니다. 이 흐름을 따라가며 장면이 동기화된 컴포넌트를 클라이언트 반응에 연결하는 방식을 살펴보세요.

**프로젝트 맥락:** 프로젝트의 `LaneStore` 및 이벤트 버스 정의와 함께 읽어 보세요.

**소스 참고:**

* [`LaneWatcher.onLaneChanged`](https://github.com/stom66/dcl-bowling/blob/25c5a7f9152835c190d9d20fa18b6010d0c6ce50/dcl/src/client/laneWatcher.ts#L79-L90)
* [`flush`](https://github.com/stom66/dcl-bowling/blob/25c5a7f9152835c190d9d20fa18b6010d0c6ce50/dcl/src/client/laneWatcher.ts#L132-L153)

### 모바일에 맞춰 파티클 효과 크기 조정

`getParticleRatio` 와 `scaleConfig` 는 원래 설정을 유지하면서 모바일 비율을 사용해 방출 속도, 파티클 한도, 버스트 수를 조정합니다. `spawn` 은 선택적으로 부모를 지정하고 시간에 따라 정리되도록 새 이미터에 해당 설정을 적용합니다.

**프로젝트 맥락:** 하나의 효과 설정을 여러 기기에서 활용하는 방법을 살펴볼 때 유용합니다.

**소스 참고:**

* [`getParticleRatio` 와 `scaleConfig`](https://github.com/stom66/dcl-bowling/blob/25c5a7f9152835c190d9d20fa18b6010d0c6ce50/dcl/src/client/particleSpawner.ts#L176-L218)
* [`spawn`](https://github.com/stom66/dcl-bowling/blob/25c5a7f9152835c190d9d20fa18b6010d0c6ce50/dcl/src/client/particleSpawner.ts#L91-L121)


---

# 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/fastlane-bowling.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.
