# 월드 템플릿

## 개요

주요 기능이 사전에 포함된 월드 템플릿을 활용하면, 별도의 스크립트 작성 없이도 손쉽게 게임을 제작할 수 있습니다. 예를 들어 TPS 템플릿을 사용할 경우, 캐릭터 조작, TPS 시점 카메라, 총기 시스템 등 핵심 기능들이 기본으로 제공되어 별도의 구현 없이도 바로 테스트와 개발이 가능합니다.

## 사용 방법

월드 템플릿은 OVERDARE Studio의 첫 화면에서 **Start with Template 섹션**에 표시됩니다. 사용할 템플릿을 클릭하면 해당 템플릿을 복제하여 새로운 프로젝트를 생성할 수 있습니다.

<figure><img src="/files/4yf268JsgKfBYprxWDCf" alt=""><figcaption></figcaption></figure>

## 템플릿 종류

<table><thead><tr><th width="158.4736328125">템플릿</th><th width="352.9473876953125">설명</th><th>용도</th></tr></thead><tbody><tr><td>Island</td><td>계절 변화와 기본 지형을 체험할 수 있는 섬 맵. 표지판을 따라 다양한 계절 스타일을 탐색할 수 있고, 에셋 스토어와 오브젝트 교체 학습 가능</td><td>튜토리얼, 기초 학습, 소셜 맵</td></tr><tr><td>Lobby</td><td>상점, 점수판 등의 모듈이 포함된 로비. 게임의 시작 지점으로 활용할 수 있고, 별도 구현 없이 사용 가능</td><td>대기실, 게임 허브, 커뮤니티 공간</td></tr><tr><td>TPS</td><td>사격, 조준, 카메라 제어용 모듈 스크립트 및 무기 시스템이 포함된 3인칭 슈팅 게임용 템플릿. 프로토타입 제작에 적합.</td><td>TPS 슈팅 게임, 전투 기반 게임</td></tr><tr><td>Potion Factory</td><td>완성된 포션 공장 배경 제공. 크래프팅, 판타지 등 다양한 장르에 활용 가능.</td><td>배경 세트, 크래프팅, 판타지/공장 시뮬</td></tr><tr><td>Jungle</td><td>울창한 숲 환경의 서바이벌 맵으로, 탐험, 사냥, 자원 수집을 위한 전용 소품 및 애니메이션 포함.</td><td>서바이벌, 탐험, 헌팅</td></tr><tr><td>Obby</td><td>다양한 동적 장애물이 포함된 오비 맵으로, 움직이는 기둥, 회전 디스크, 흔들리는 추 등으로 구성. 속도·배치를 자유롭게 조정해 원하는 난이도와 스타일로 코스 구성 가능.</td><td>오비, 레이스, 장애물, 파쿠르, 모듈</td></tr><tr><td>TPA</td><td>3인칭 액션 게임 제작용 템플릿.<br>ActionSequence 기반 전투 시스템과 근접·원거리 액션 포함.<br>빠른 프로토타이핑과 확장에 적합.</td><td>TPA, 액션, 전투, 어드벤처</td></tr></tbody></table>

## 템플릿에 포함된 주요 기능

### Island

<table><thead><tr><th width="463.24560546875">기능</th><th width="279.87725830078125">관련 스크립트</th></tr></thead><tbody><tr><td>의자</td><td>ChairManager<br>SittingSystem</td></tr><tr><td>캠프파이어</td><td>CampfireTrigger</td></tr><tr><td>낚시</td><td>FishingAreaTrigger<br>FishingSystem</td></tr><tr><td>시간 변경</td><td>TimeSetSwitch<br>TimeFlowSwitchTrigger<br>TimeResetTrigger</td></tr></tbody></table>

### Lobby

<table><thead><tr><th width="463.24560546875">기능</th><th width="279.87725830078125">관련 스크립트</th></tr></thead><tbody><tr><td>클라이밍 비활성화</td><td>ClimbDisabler</td></tr><tr><td>의자</td><td>ChairManager<br>SittingSystem</td></tr><tr><td>점수판</td><td>ScorePart<br>Scoreboard<br>ScoreboardUI</td></tr><tr><td>상점 UI</td><td>ShopOpenTrigger<br>ShopUI<br>Shop</td></tr></tbody></table>

### TPS

<table><thead><tr><th width="463.24560546875">기능</th><th width="279.87725830078125">관련 스크립트</th></tr></thead><tbody><tr><td>발사/장전 버튼의 UI 위치 및 크기, 이미지 설정</td><td>Config</td></tr><tr><td>3인칭 카메라 설정</td><td>OSSy_TPS_Camera</td></tr><tr><td>탄환 복제, 피격 데미지 처리, 이펙트 등을 서버에서 관리하고 관련 이벤트를 모든 클라이언트에 브로드캐스트하는 전투 네트워크 이벤트 핸들러</td><td>BulletReplicate</td></tr><tr><td>무기 장착, 발사, 재장전, 조준, 반동, GUI 업데이트 등 TPS 전투 시스템을 로컬에서 제어</td><td>OSSy_Client</td></tr><tr><td>다른 플레이어의 총격, 피격, 이펙트, 등 전투 관련 클라이언트 이벤트를 수신하고 탄환 생성 및 시각/청각 효과를 로컬에서 동기화 처리하는 이벤트 핸들러</td><td>OSSy_EventHandler</td></tr><tr><td>발사 속도, 반동, 탄 수, 탄 퍼짐 등 무기 데이터 설정</td><td>WeaponData</td></tr><tr><td>애니메이션 설정 관련 모듈</td><td>BasicAnimantionData<br>AnimantionData<br>MotionSyncModule</td></tr><tr><td>애니메이션 동기화</td><td>LocomotionSync<br>OSSy_MotionSync</td></tr><tr><td>애니메이션 컨트롤러</td><td>CharacterAnimationManager</td></tr><tr><td>무기 리스폰</td><td>Spawner</td></tr></tbody></table>

### Potion Factory

<table><thead><tr><th width="463.24560546875">기능</th><th width="279.87725830078125">관련 스크립트</th></tr></thead><tbody><tr><td>클라이밍 비활성화</td><td>ClimbDisabler</td></tr></tbody></table>

### Jungle

해당 맵에는 스크립트 기능이 포함되어 있지 않습니다.

### Obby

<table><thead><tr><th width="463.24560546875">기능</th><th width="279.87725830078125">관련 스크립트</th></tr></thead><tbody><tr><td>플레이어 입장 시 초기화 처리, 리스폰 시간 및 체크포인트 위치 설정</td><td>GameSetting</td></tr><tr><td>Timer 및 Goal UI 처리</td><td>HUDScript</td></tr><tr><td>게임 경과 시간 측정</td><td>Stopwatch</td></tr><tr><td>해당 Part에 닿은 캐릭터 Kill 처리</td><td>KillPart</td></tr><tr><td>해당 Part에 닿은 플레이어에게 체크포인트 정보 설정</td><td>Checkpoint</td></tr><tr><td>달리기 시작 및 종료 처리</td><td>StartLine / GoalLine</td></tr><tr><td>Part 이동 처리</td><td>MovePart</td></tr><tr><td>Part 회전 처리</td><td>SpinPart / RotaryHammer / SwingPart</td></tr><tr><td>해당 Part에 닿은 캐릭터에게 뒤로 밀려나는 넉백 효과 적용</td><td>ImpactPart</td></tr><tr><td>위에서 아래로 순서대로 떨어지는 장애물 처리</td><td>FallingBalls</td></tr><tr><td>해당 Part에 캐릭터가 닿으면 사라졌다가 일정 시간 후 다시 생성</td><td>DisappearPart</td></tr></tbody></table>

### TPA

TPA 템플릿은 캐릭터, 전투, UI 시스템이 분리된 **모듈형 구조**를 기반으로 하며, 각 시스템이 독립적으로 확장 및 유지보수될 수 있도록 설계되어 있습니다. 이러한 구조를 보다 쉽게 이해할 수 있도록 프로젝트 내에는 전체 흐름과 구조를 설명하는 **가이드 문서가 포함**되어 있으며, 이를 중심으로 이해하는 것을 권장합니다.

프로젝트 폴더에는 템플릿 전반을 이해하기 위한 **가이드 문서(Docs/Beginner Guide.html)**&#xAC00; 제공되므로, 가장 먼저 해당 문서를 확인하는 것을 권장합니다.

<figure><img src="/files/Gmq6HUwjVnMmglbtoscn" alt=""><figcaption></figcaption></figure>

```
Docs/
├── Beginner Guide.html                  TPA 게임 만들기 초보 튜토리얼 
├── Beginner Guide.md                    위와 같은 내용의 마크다운 원문
└── Reference/
    ├── 00_Project_Overview.md           TPA 템플릿 개요, 포함 콘텐츠·기술 스택(MVC·데이터 기반 등) 요약
    ├── 01_Character_Guide.md            CharDB 기준 플레이어블 캐릭터(펀치·검·건 등) 스펙·설명
    ├── 02_Weapon_Skill_Guide.md         WeaponDB·SkillDB 기준 무기·스킬 슬롯·콤보 등 데이터 가이드
    ├── 03_UI_Controls_Guide.md          스킬 버튼 배치·입력·아이콘(AssetDB) 등 UI·조작 설명
    ├── 04_Level_Browser_Structure.md    레벨 브라우저에서 보는 서비스·ReplicatedStorage 폴더 구조
    ├── 05_Action_Sequence_Guide.md      포함된 액션 시퀀스 에셋·트랙 타입(애니·히트·카메라 등) 설명
    ├── 06_Extension_Guide.md            데이터·플러그인만으로 캐릭터·무기·스킬 확장하는 방법 요약표
    └── Reference Guide.html             Reference 시리즈(00~06)를 묶은 가이드
```

또한 맵 내부에도 가이드(Workspace/Docs)가 포함되어 있어, 스튜디오 환경에서도 필요 시 바로 참고할 수 있습니다.

<div align="left"><figure><img src="/files/6UaUrEfNruFfJV4nbdVj" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/manual/studio-manual/get-started/world-template.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.