> For the complete documentation index, see [llms.txt](https://wiki.beartown.kr/beartown/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.beartown.kr/beartown/basic/subcontents/hopper.md).

# 스마트 호퍼

{% hint style="danger" %}
 스마트 호퍼 주의사항

*   스마트 호퍼는 본인이 소속되어 있는 마을에서만 설치가 가능합니다. (동맹국 설치X)
* 스마트 호퍼가 설치되어 있는 청크에 마을 권한이 삭제되면(청크 해제 및 마을나가기 등) \
  스마트 가 자동으로 드랍됩니다.\
  \ <mark style="color:red;">**자동으로 드랍된 스마트 호퍼가 삭제될 경우 복구 대상이 아닙니다.**</mark>
  {% endhint %}

<mark style="color:yellow;">**스마트 호퍼**</mark> 또는 <mark style="color:yellow;">**스마트 깔때기**</mark>는 주변에 떨어진 아이템을 자동으로 끌어모아 멀리 떨어져 있는 상자로 보낼 수 있는 호퍼예요.

바닥에 떨어진 아이템을 모아서 상자에 정리하거나 아이템을 멀리 있는 상자로 옮기는데 주로 사용합니다.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXena3K1cxPxELcg6XW_gggYMEiv-nABDci3NbD53PktctXDGKGDPd315VwymRQrfZbxzA4OdzP2xaR_1x7pEMGQqR1-RmnxZ94O9Hx_8XXLPmeaTQOnNbFi8c4dj5E90o8oRpADQw?key=vs5O34jcRImo5Wl70K92FQ" alt=""><figcaption><p>후원상점 - 권한, 소모품 UI</p></figcaption></figure>

마을 서버 및 직업서버에서만 사용 가능하며 기본적으로 서버당 10개씩 설치 가능하며 <mark style="color:green;">**`/후원상점`**</mark> - **`권한, 소모품`** - **`스마트호퍼 개수 증가`**&#xB97C; 구매하면 개수를 늘릴 수 있어요.

스마트호퍼 설정, 설치 및 파괴는 호퍼의 소유자만 가능하며 [스마트 호퍼가 설치된 구역](#user-content-fn-1)[^1]에 소속되어야 스마트 호퍼가 작동합니다.&#x20;

마을 서버에서 <mark style="color:green;">**`/호퍼구매`**</mark>를 입력하여 구매할 수 있어요.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdUbfI3C5eme7KfwptN76Zc-rc7xc9x4Hq6XjXFilxMJn5N6h4aRqKwRtDNoT7hYF_CAG8RNmV71Bqqgc6krsSGUpy9nKhszwoL8mZzDEz9D0K3gK5AU0JSvHoIdQVnlkh1UT29Aw?key=vs5O34jcRImo5Wl70K92FQ" alt=""><figcaption></figcaption></figure>

## 기본 기능

호퍼를 바라보며 우클릭 시 호퍼의 인벤토리를 확인할 수 있으며 , 좌클릭 시 스마트호퍼 업그레이드, 연결 등 세부 설정 UI를 확인할 수 있습니다.&#x20;

<figure><img src="/files/0TcwgnjM1HwwtiLuUW4f" alt=""><figcaption><p>좌클릭 시 확인 가능한 스마트 깔대기 UI</p></figcaption></figure>

파괴하려면 **`Shift`**&#xB97C; 누른 채로 파괴하면 됩니다.&#x20;

스마트 호퍼의 기능은 다음과 같습니다.&#x20;

* <mark style="color:yellow;">**일반 호퍼**</mark>와 동일한 기능
* <mark style="color:yellow;">**범위 흡입**</mark> : 흡입 반경 안에 있는 아이템을 호퍼 안으로 모아집니다. (작동하면 보라색 파티클 발생)
* 거리 먼 상자로 <mark style="color:yellow;">**아이템 이동**</mark> : 스마트호퍼 안에 있는 아이템을 연결된 상자로 옮길 수 있습니다.&#x20;
* 아이템 삭제 :  기본적으로  비활성화  되어 있는 기능이며 설정된 필터에 맞지 않는 아이템이라면 삭제합니다. <mark style="color:red;">해당 기능으로 삭제된 아이템은 복구 대상이 아닙니다.</mark>

## 업그레이드

호퍼 업그레이드를 통해 기존의 기능을 강화할 수 있습니다.  업데이트 가능한 기능은 다음과 같습니다.

* 연결 개수 : 최대로 연결 가능한 상자 개수가 늘어납니다.
* 아이템 이동 개수 : 스마트호퍼는 4초마다 아이템을 연결된 상자로 옮깁니다. 이때 옮겨지는 아이템 개수가 늘어납니다.&#x20;
* 범위 흡입 :  스마트호퍼가 더 넓은 흡입 범위를 가집니다. 상하 흡입 반경에도 영향을 미칩니다.&#x20;

> n칸의 흡입 범위를 가진다면 한 모서리의 길이가 2n+1칸인 정육면체에 드랍된 아이템을 흡입합니다.

* 최대 연결 거리 : 스마트호퍼와 연결 가능한 상자의 최대 블럭 칸 수가 늘어납니다. 스마트호퍼를 중심으로 반지름 n블록인 구 영역까지 연결할 수 있습니다.&#x20;

## 호퍼 연결

1. 스마트호퍼 UI에서 **`상자 연결`**&#xC744; **`좌클릭`** 합니다.
2. 연결할 상자를 미리 설치한 후 **`좌클릭`** 합니다. 이때 조건이 충족되지 않았다면 채팅창에 이유가 뜨기 때문에 문구를 확인한 후 필요한 호퍼 강화를 진행해야 합니다.&#x20;
3. 스마트호퍼 UI의 **`연결`**&#xC5D0;서 현재 연결된 상자 목록을 확인할 수 있어요.&#x20;

<figure><img src="/files/aTK3WCw1hwuLoX2AyTXp" alt="" width="563"><figcaption><p>호퍼 연결</p></figcaption></figure>

4. 상자 연결을 해제하고 싶다면 **`상자 연결`**&#xC744; **`우클릭`** 한 후 연결되어 있는 상자를 **`우클릭`** 하거나,  **`필터`**&#xB97C; 클릭한 후 해제할 상자에 마우스를 올리고 **`Q(버리기키)`**&#xB97C; 누릅니다.

<figure><img src="/files/e3uw4lYFx11yYGfd7ByF" alt="" width="563"><figcaption><p>호퍼 연결 해제</p></figcaption></figure>

## 필터 설정

호퍼 필터를 통해 특정 아이템만 모으거나 특정 아이템만 모으지 않을 수 있습니다. 호퍼의 필터 모드는 크게 3가지 입니다.&#x20;

* 기본 : 호퍼가 모든 아이템을 흡수하여 연결된 상자로 옮깁니다. 필터 설정을 블랙 리스트 또는 화이트 리스트로 설정하던 동일하게 작동합니다.
* <mark style="color:yellow;">**블랙 리스트**</mark> : 필터에 설정한 아이템을 호퍼가 흡수하지 않습니다.&#x20;
* <mark style="color:yellow;">**화이트 리스트**</mark> : 필터에 설정한 아이템만 호퍼가 흡수합니다. 필터에 등록되지 않은 아이템은 그 자리에 떨어진 상태로  유지됩니다.

아이템을 필터에 등록하기 위해서는 인벤토리의 아이템을 클릭하면 등록되며 필터에서 아이템을 제거하기 위해서는 마우스를 올린 후 Q(버리기키)를 누르면 됩니다.&#x20;

### 정밀 필터

필터 설정 창에서 정밀 필터를 활성화할 수 있습니다. 정밀 필터는 완전히 일치하는 아이템만 필터에 등록하는 시스템 입니다. 정밀 필터를 비활성화할 경우에는 아이템의 ID만 동일하면 같은 아이템으로 인식합니다.

> 커스텀 물고기 - 검은콩 물고기의 베이스 아이템은 대구(cod)입니다.&#x20;
>
> 정밀 필터 비활성화 시 대구(cod)와 검은콩 물고기는 동일한 아이템으로 인식합니다.&#x20;
>
> 정밀 필터 활성화 시 대구(cod)와 검은콩 물고기를 다른 아이템으로 인식합니다.&#x20;

### 필터 복사

기존에 설정한 필터를 복사 & 붙여넣기 할 수 있습니다.&#x20;

<figure><img src="/files/RxwGEkKUwjBQkxfRhOzC" alt="" width="270"><figcaption></figcaption></figure>

복사하려는 필터에서 **`Copy Filter and Mode`**&#xB97C; 우클릭 하면 복사되며 좌클릭 하면 붙여넣을 수 있습니다.&#x20;

## 기타 기능 및 주의사항

기타 기능은 다음과 같습니다.&#x20;

* 아이템 삭제 : 필터 설정에 따라 호퍼에 흡입되지 않은 아이템을 모두 삭제합니다. 삭제된 아이템은 보라색 파티클이 생성되지 않으며 삭제됩니다. <mark style="color:red;">해당 기능으로 삭제된 아이템은 복구 대상이 아닙니다.</mark>
* 흡입 ON/OFF  : 스마트 호퍼의 흡입 기능을 비활성화 시킵니다. 하지만 일반 호퍼의 기능과 연결 기능은 유지됩니다.&#x20;
* 3\) 순서에 따라 넣기 : **`스마트 호퍼 UI`** - **`연결`** - **`순서에 따라 넣기`**&#xC5D0;서 활성화할 수 있습니다. 만약 같은 아이템이 다른 두 상자에 연결되어 있다면 우선 순위가 높은 상자가 모두 차야 다음 상자에 아이템이 수납되기 시작합니다. **`Shift`** + **`좌클릭 or 우클릭`**&#xC73C;로 우선순위를 변경할 수  있습니다.&#x20;

주요한 주의사항은 다음과 같습니다.&#x20;

* 호퍼가 작동하지 않는다면 특정 상자가 꽉 찼는지 확인해주세요! 상자가 꽉 찬 후 해당 아이템이 계속 드랍된다면 호퍼가 꽉 차게 되고 호퍼 5칸이 꽉 차면 호퍼가 작동하지 않습니다.
* 스마트 호퍼는 일반 호퍼처럼 꼬리에 연결된 상자로도 아이템을 옮깁니다. 따라서 <mark style="color:yellow;">**스마트호퍼의 꼬리**</mark>의 방향을 확인해주세요.
* 스마트 호퍼는 본인이 소속되어 있는 마을에서만 설치가 가능합니다. (동맹국 설치X)
* 스마트 호퍼가 설치되어 있는 청크에 마을 권한이 삭제되면(청크 해제 및 마을나가기 등) \
  스마트호퍼 가 자동으로 드랍됩니다. <mark style="color:red;">**자동으로 드랍된 스마트 호퍼가 삭제될 경우 복구 대상이 아닙니다.**</mark>

[^1]: 마을의 영토는 기본적으로 기본 구역에 소속되어 있으며 특정 구역에서 스마트호퍼를 사용할 시 호퍼의 소유자를 /마을 초대 <닉네임> <구역 이름>으로 초대해야 합니다.