# Gun Toy

### 총 토이 종류

* **Rifle** : 소총 토이에요.

![](/files/K8dltIbaUpDShtMCM9G4)     ![](/files/oQQ15hv8tUDEDsLSBJTE)

* **SniperRifle** : 저격용 총 토이에요.

![](/files/w3Rq2JY4wc1HDag6P1nq)     ![](/files/h4fmGUJGA2TVYTdnqOxs)

* **Launcher** : 포탄을 발사하는 총 토이에요.

![](/files/gsABSTrR1ciuUY6CKHyA)     ![](/files/e1hlOmWzMBYWZep3anb5)

* **Rocket** : 로켓포를 발사하는 총 토이에요.

![](/files/iXvNKUv16loBrvbLX1A7)     ![](/files/keSV1ZjHqeLhu8P8u601)

* **Pistol** : 권총 토이에요.

![](/files/V82GkWahBRQEjQfwQQHr)     ![](/files/Ah2bPWlo3HBGMecfKVH4)

* **Gatling** : 기관총 토이에요.

![](/files/jZRmgsm824KMzQMcQjeb)     ![](/files/603hoGgYcbDP4mRNKpfW)

* **Flamethrower** : 화염 방사기 토이에요.

![](/files/32Tb1v2T3MhPJ8IdvCJQ)     ![](/files/rWqyfGQQwQJb747ili42)

* **Blaster** : SF 전자 총 토이에요.

![](/files/XE9twkdczN69i8zqzq92)     ![](/files/44UanDiFrTov7Zpx9BLc)

* **PowerDevice** : 전류를 발사하는 총 토이에요.

![](/files/nqWOZAxiTe4tCQqMI2uF)     ![](/files/yrUWFw3kz1mVLBDKf4D9)

* **WaterGun\_Gatling** : Gatling의 물총 버전이에요.

![](/files/fuudYkcJ8QJk5zVUSH42)     ![](/files/PM20Q8ys0Mza2ho8YhID)

* **WaterGun\_Launcher** : Launcher의 물총 버전이에요.

![](/files/RPR8MJWogkJQy54saRHk)     ![](/files/scSy7Si3y1TD3kjlYTwB)

* **WaterGun\_Pistol** : Pistol의 물총 버전이에요.

![](/files/vp1EoMyqpYtHSOUWiN8n)     ![](/files/yc0Fd5lLy6xrjPvriIKp)

* **RealHealGun** : 탄을 맞은 캐릭터의 HP 를 회복시켜요.

![](/files/6gLUbFdYwfJkOdKX7kU1)     ![](/files/FjG9tXYFkCrwOng6W70J)

***

###

### 총 토이 사용법

* PC

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

* Mobile

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

**참고❕**

→ **스코프(줌) 기능**은 **Rifle / SniferRifle** 에서만 사용할 수 있어요.

→ **PC용 스코프(줌)의 단축키**는 **AddOn > KeyToUse 프로퍼티**에서 변경할 수 있어요.

***

### 총 장착 시 카메라 설정

총 토이의 PlayerSetting > IsChangeCam 프로퍼티가 체크된 상태라면,

**총 토이를 장착할 때 기존 카메라에서 총 토이 전용 카메라로 전환돼요.**

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

그래서 카메라 뷰를 새롭게 설정한 월드에서는, 총을 장착했을 때 원하는 시점이 나오지 않을 수 있어요.

총을 장착했을 때 월드의 기본 카메라 설정을 따르고 싶다면

**PlayerSetting > IsChangeCam 프로퍼티의 체크를 풀어주세요.**

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

**1인칭 뷰인 Easy\_FPS 월드**에서 제공하는 **총 토이의 PlayerSetting 프로퍼티 설정**을 참고해주세요.

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

***

***

### 속성 가이드

**총 토이 구성**&#x20;

<figure><img src="/files/jU5q29Cx7btgoLycc19W" alt="" width="563"><figcaption></figcaption></figure>

* Base : 총/총알 모델링, SFX, 총 획득 콜라이더가 있는 그룹이에요.
* Body : 각종 정보 UI (총/총알/재장전) , 재장전에 관한 그룹이에요.
* Barrel : 조준 UI, 피격에 관한 그룹이에요.
* Effect : 피격 시 데미지, 넉백에 관한 그룹이에요.
* AddOn : 줌 (스코프) 에 관한 그룹이에요.
* PlayerSetting : 총 장착 시 애니메이션/카메라 변경에 관한 그룹이에요.
* GunAgent : 각각의 총 토이가 가진 Client/Server 스크립트에서, 총 종류에 맞게 참조하는 모듈이에요.

**GunAgent**&#x20;

* 총 동작을 관리하는 모듈로, 모든 총이 같은 GunAgent 를 가지고 있어요.
* 모든 총 아이템은 GunAgent 를 참조하는 프로퍼티를 가지고 있어요.

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

💥  **GunAgent 폴더를 삭제하면 총 토이가 동작하지 않으니 유의하세요.**

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

**속성 목록** (공통 사항)

<table><thead><tr><th width="151">객체</th><th width="165">속성</th><th>설명</th></tr></thead><tbody><tr><td>Body</td><td>InputDelay</td><td>마우스를 누르고 총이 나갈 때까지 걸리는 시간</td></tr><tr><td></td><td>FireAmount</td><td>마우스를 누르고 있는 동안 발사 될 총알 수 (연사)</td></tr><tr><td></td><td>MaxBullet</td><td>최대 보유 가능한 탄환 수</td></tr><tr><td></td><td>InitBullet</td><td>현재 가지고 있는 탄환 수</td></tr><tr><td></td><td>BulletType</td><td>탄환 보급 상자 사용 시 탄의 종류를 구분하기 위한 항목</td></tr><tr><td></td><td>ReloadBullet</td><td>재장전 시 장전될 탄환 수</td></tr><tr><td></td><td>ReloadTime</td><td>재장전 시간 (단위 : 초)</td></tr><tr><td></td><td>FireRate</td><td>연사 딜레이</td></tr><tr><td>Barrel</td><td>BulletDistance</td><td>총알 사거리</td></tr><tr><td></td><td>BulletSpeed</td><td>총알이 사거리에 닿는 시간 ( 값이 적을수록 빨라짐)</td></tr><tr><td></td><td>ShakeTime</td><td>사격 시 카메라 흔들림 시간</td></tr><tr><td></td><td>ShakeScale</td><td>사격 시 카메라 흔들림 정도</td></tr><tr><td></td><td>DefaultAim</td><td>에임의 기본 최소 각도</td></tr><tr><td></td><td>MaxAim</td><td>확대 가능한 에임의 최대 크기</td></tr><tr><td></td><td>AimAdd</td><td>연사 시 0.1초마다 커지는 에임의 크기</td></tr><tr><td></td><td>AimRecover</td><td>연사 종료 시 0.1초마다 줄어드는 에임 크기</td></tr><tr><td></td><td>IsStraight</td><td>발사 위치 보정 여부</td></tr><tr><td>Effect</td><td>Damage</td><td>피격 시 데미지</td></tr><tr><td></td><td>KnockBackPower</td><td>피격 시 밀려나는 힘 (0이면 미사용)</td></tr><tr><td></td><td>IsAddKDPoint</td><td>Global_PointKD 함수 사용 시 킬데스 점수 추가할지 여부</td></tr><tr><td>AddOn</td><td>ZoomFOV</td><td>마우스 우클릭 시 카메라 줌의 크기 ( 클수록 더 확대됨)</td></tr><tr><td></td><td>KeyToUse</td><td>줌 키 버튼 설정</td></tr><tr><td>PlayerSetting</td><td>IsChangeAni</td><td>무기를 장착할 때 애니메이션 변경 여부</td></tr><tr><td></td><td>IsChangeCam</td><td>무기를 장착할 때 카메라 변경 여부</td></tr></tbody></table>

**(예외) 충전식으로 장전하는 총의 Body 속성**

* 총 List : PortalDevice / WaterGun\_Gatling / WaterGun\_Launcher / WaterGun\_Pistol

<table><thead><tr><th width="123">객체</th><th width="167">속성</th><th>설명</th></tr></thead><tbody><tr><td>Body</td><td>InputDelay</td><td>마우스를 누르고 총이 나갈 때까지 걸리는 시간</td></tr><tr><td></td><td>FireAmount</td><td>마우스를 누르고 있는 동안 발사 될 총알 수 (연사)</td></tr><tr><td></td><td>MaxBullet</td><td>최대 보유 가능한 탄환 수</td></tr><tr><td></td><td>InitBullet</td><td>현재 가지고 있는 탄환 수</td></tr><tr><td></td><td><mark style="background-color:yellow;">FireRate</mark></td><td>연사 딜레이</td></tr><tr><td></td><td><mark style="background-color:yellow;">ChargingDelay</mark></td><td>총을 발사하지 않고 몇 초 지나면 충전 시작할지 (단위:초)</td></tr><tr><td></td><td><mark style="background-color:yellow;">ChargingTic</mark></td><td>충전이 시작되면 몇 초 간격으로 충전할지 (단위:초)</td></tr><tr><td></td><td><mark style="background-color:yellow;">ChargingBullet</mark></td><td>한번 충전 될 때마다 충전될 탄환량</td></tr></tbody></table>

**(예외) Effect 추가 속성**

* 총 List : Launcher / Rochet / FlameThrower / PowerDevice / WaterGun\_Launcher

<table><thead><tr><th width="123">객체</th><th width="167">속성</th><th>설명</th></tr></thead><tbody><tr><td>Effect</td><td>위 공통 사항 동일</td><td></td></tr><tr><td></td><td>EffectRadius</td><td>충돌 좌표를 중심으로 효과를 줄 반지름 크기</td></tr></tbody></table>

**(예외) Barrel 속성**

* 총 List **:** Launcher / WaterGun\_Launcher

<table><thead><tr><th width="123">객체</th><th width="167">속성</th><th>설명</th></tr></thead><tbody><tr><td>Barrel</td><td>BulletDistance</td><td>마우스를 누르고 총이 나갈 때까지 걸리는 시간</td></tr><tr><td></td><td>BulletSpeed</td><td>마우스를 누르고 있는 동안 발사 될 총알 수 (연사)</td></tr><tr><td></td><td>ShakeTime</td><td>최대 보유 가능한 탄환 수</td></tr><tr><td></td><td>ShakeScale</td><td>현재 가지고 있는 탄환 수</td></tr><tr><td></td><td><mark style="background-color:yellow;">BulletWeight</mark></td><td>연사 딜레이</td></tr><tr><td></td><td><mark style="background-color:yellow;">LaunchAngle</mark></td><td>총을 발사하지 않고 몇 초 지나면 충전 시작할지 (단위:초)</td></tr><tr><td></td><td>IsStraight</td><td>충전이 시작되면 몇 초 간격으로 충전할지 (단위:초)</td></tr></tbody></table>


---

# 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://ditoland-utplus.gitbook.io/ditoland/manual/gun-toy.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.