# 월드 템플릿

## 개요

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

## 사용 방법

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

<figure><img src="https://2697870212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhRPi87oM9ttlk5nyu7L7%2Fuploads%2Fgit-blob-220bb9fe303f4db01f943a60ffce994472781f0c%2Fimage.png?alt=media" 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="https://2697870212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhRPi87oM9ttlk5nyu7L7%2Fuploads%2FJiqG6Mv5oAk16pSzz9ag%2Fimage.png?alt=media&#x26;token=62026354-8ec3-402f-9a60-acd4244e5355" 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="https://2697870212-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhRPi87oM9ttlk5nyu7L7%2Fuploads%2FFRNtO0u36CZmF1bgL7OG%2Fimage.png?alt=media&#x26;token=aba258e4-7b8a-4f4e-96c9-4b80df6af303" alt=""><figcaption></figcaption></figure></div>