# Tool

## 개요

`Tool`은 캐릭터가 직접 장착하여 사용할 수 있도록 설계된 `Instance`입니다. 이를 활용하면 캐릭터는 무기나 장비를 손에 들거나, 포션과 같은 아이템의 사용을 구현할 수 있습니다. `Tool`은 장착과 해제의 과정을 통해 캐릭터와 상호작용하며, 다양한 게임플레이 시나리오에서 중요한 역할을 수행합니다.

## Tool의 동작 원리

* `Tool`은 캐릭터 모델과 직접 상호작용하여 장착과 해제를 구현합니다.
* 캐릭터의 **오른손**에 장착되며, 이를 위해 반드시 **Handle** Part를 생성해야 합니다.
* `Handle`이 없는 Tool을 만들 수는 있지만, 스크립트를 통해서만 장착시킬 수 있습니다.
* `Handle`을 기준으로 Tool을 구성하는 MeshPart 및 다른 Part의적절한 위치 조정을 할 수 있습니다.

## Tool의 속성

아래는 주요 속성 및 관련 설명입니다:

| 속성                       | 설명                                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **TextureId**            | Backpack GUI에서 보여지는 Tool의 이미지를 지정합니다.                                                                               |
| **CanBeDropped**         | `Tool`의 Parent를 Workspace로 변경 하였을 때, 자동으로 플레이어 앞으로 `Tool`을 드롭여부를 결정합니다.                                             |
| **Enabled**              | Enabled 속성은 Tool을 플레이어가 사용할 수 있는지 여부를 설정하며, false로 설정하면 Tool의 활성화/비활성화 메서드와 관련된 이벤트가 차단되어 플레이어가 Tool을 사용할 수 없게 됩니다. |
| **Grip**                 | 현재 지원되지 않습니다.                                                                                                       |
| **ManualActivationOnly** | ManualActivationOnly 속성은 Tool:Activate()를 스크립트에서 명시적으로 호출해야만 Tool.Activated 이벤트가 발생하도록 제어할지 여부를 결정합니다.              |

## Tool의 사용 방법

### 1. Tool 인스턴스 생성

1. **레벨 브라우저(Workspace)**에서 `Tool` 인스턴스를 생성합니다.

   <div align="left"><figure><img src="/files/z4e4QgwiDo1hHZn4z36x" alt=""><figcaption></figcaption></figure></div>
2. `Tool` 하위에 `Part`를 생성 후, 해당 이름을 `Handle`로 수정합니다.

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

   <div align="left"><figure><img src="/files/W1zfO4O0Z0A4xR6iFON7" alt=""><figcaption></figcaption></figure></div>
3. 손에 장착될 도구인 `MeshPart` 또는 `Part`를 `Handle` 하위에 배치하고, 도구의 손잡이 위치를 기준으로 `CFrame`을 조정하여 올바른 장착 위치를 설정합니다.

   <figure><img src="/files/cURmBE0u5zWzRHteT6jN" alt=""><figcaption><p><br></p></figcaption></figure>

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

### 2. Tool 장착 테스트

1. 게임을 실행하고 캐릭터를 조작합니다.
2. `Workspace`에 배치한 `Tool`을 캐릭터가 **Touch(접촉)** 하도록 만듭니다.
3. `Handle`에 접촉하면 캐릭터가 해당 `Tool`을 오른손에 들게 됩니다.

   * 정상적인 위치에 장착되지 않을 경우, `Handle` 하위의 `MeshPart` 또는 `Part`의 위치와 방향을 수정하여 재조정합니다.

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

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

## 스크립트를 통한 Tool 장착 및 해제

### 스크립트를 사용해야 하는 경우

어떤 트리거(Trigger)나 조건을 만족할 때만 `Tool`을 장착해야 하는 상황이 있을 수 있습니다. 이 경우, 스크립트를 통해 프로그래밍적으로 `Tool`을 장착하거나 해제할 수 있습니다.

### Tool 장착을 위한 방법

스크립트를 활용하면 아래 두 가지 방식으로 `Tool`을 캐릭터에게 장착할 수 있습니다:

1. **Humanoid:EquipTool** 메서드를 호출
   * 다음 메서드를 통해 캐릭터가 직접 `Tool`을 장착하도록 구현할 수 있습니다.
   * 예제 코드:

```lua
local function Equip(player)
     local character = player.Character
     local humanoid = character:FindFirstChild("Humanoid")
     local myTool = game.Workspace:FindFirstChild("MyTool")

     if humanoid and myTool then
         humanoid:EquipTool(myTool)
     end
end
```

2. **Tool.Parent 변경**

* `Tool`의 부모 오브젝트를 직접 변경하여 장착하도록 설정할 수 있습니다.
* 예제 코드:

```lua
local function Equip(player)
     local myTool = game.Workspace:FindFirstChild("MyTool")
     local character = player.Character

     if character and myTool then
         myTool.Parent = Character
     end
end
```

### Tool 해제

`Tool`을 해제하는 방법은 크게 두 가지입니다:

1. **기본 해제**: 캐릭터가 `Tool` 해제 후 `Backpack`에 다시 보관됩니다.
2. **삭제(Destroy)**: 필요 없는 `Tool` 인스턴스를 삭제할 수도 있습니다.
   * 예제 코드:

```lua
     local myTool = game.Workspace:FindFirstChild("MyTool")
     if myTool then
         myTool:Destroy()
     end
```

3. **내려놓기(Drop)** :CanBeDropped가 True인 경우 Tool의 Parent를 Workspace로 지정하여 플레이어 앞에 내려놓을 수 있습니다.
   * 예제 코드:

```lua
     local myTool = game.Workspace:FindFirstChild("MyTool")
     if myTool then
         myTool.Parent = game.Workspace
     end
```

## 이벤트를 활용한 Tool 상호작용 응용

`Tool`에는 장착 시 호출되는 다양한 **이벤트**가 존재합니다. 이를 활용하면 캐릭터가 특정 `Tool`을 장착할 때 특정한 **시각 효과(VFX)**&#xB098; 동작을 추가적으로 구현할 수 있습니다.

1. **ParticleEmitter 생성**: `Handle`또는 파티클 효과가 나타나야 하는 위지에 `ParticleEmitter`를 추가합니다.

   <figure><img src="/files/pwy6FxYbqfWdD9mzRUpD" alt=""><figcaption></figcaption></figure>
2. **ParticleEmitter 속성 편집** : 패티클의 크기, 방향, 파티클 개수 등 파티클 관련 설정을 조정합니다.
3. **ParticleEmitter Enabled 비활성화** : 완성된 `ParticleEmitter` Enabled를 false로 변경하여 장착 전에는 파티클 효과가 발생하지 않도록 합니다.
4. **스크립트 작성**: 무기가 장착되었을 때에만 `ParticleEmitter` 활성화 되도록 스크립트를 작성합니다.

```lua
local Tool = script.Parent
local Emitter = Tool.Handle.LightSaber.ParticleEmitter
Tool.Equipped:Connect(function()   
     if Emitter then
         Emitter.Enabled = true
     end
 end)
 
 Tool.Unequipped:Connect(function()   
     if Emitter then
         Emitter.Enabled = false
     end
 end)
```

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhRPi87oM9ttlk5nyu7L7%2Fuploads%2Fhxyq40FEzff4Dt6vmed4%2F2025-02-17%2021-57-57.mp4?alt=media&token=84dba803-dd83-4e5a-a322-f09d3715f46d>" %}


---

# 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/object/tool.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.