> For the complete documentation index, see [llms.txt](https://dolphinserver.gitbook.io/dolphin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dolphinserver.gitbook.io/dolphin/guide/03-1/03-4.md).

# 체스트샵

> **안내**: 내 마을(Land)이나 상점가에 상자를 설치하여 3D 실물 홀로그램과 함께 24시간 무인 개인 상점을 운영할 수 있는 체스트샵 가이드입니다.\
> 🌟 **경제 시스템 바로가기**: [**🪙 경제 명령어**](/dolphin/guide/03-1.md) | [**🛒 상점**](/dolphin/guide/03-1/03-2.md) | [**⚖️ 경매장**](/dolphin/guide/03-1/03-3.md)

***

## 📑 목차 바로가기

1. [📦 체스트샵 시스템 개요](#1--체스트샵quickshop-시스템-개요)
2. [🛠️ 체스트샵 개설 및 설치 방법 (4단계)](#2-️-체스트샵-개설-및-설치-방법-4단계)
3. [🛒 체스트샵 이용 방법 (구매자 입장)](#3--체스트샵-이용-방법-구매자-입장)
4. [⚙️ 상점 관리 및 매입/판매 모드 전환 (상점주 입장)](#4-️-상점-관리-및-매입판매-모드-전환-상점주-입장)
5. [📌 체스트샵 핵심 명령어 종합 안내](#5--체스트샵-핵심-명령어-종합-안내)
6. [💡 운영 팁 및 영토 보호 연동](#6--운영-팁-및-영토-보호-연동)

***

## 1. 📦 체스트샵 시스템 개요

체스트샵은 보관함(일반 상자, 통, 셜커 상자)을 배치하고 그 위에 판매할 아이템의 3D 입체 홀로그램을 띄워, 유저들이 언제든지 찾아와 물건을 사고팔 수 있는 오프라인 개인 상점 시스템입니다.

* **24시간 자동 무인 거래**: 상점 주인이 오프라인 상태여도 손님이 찾아와 상자를 통해 언제든지 물건을 구매하거나 판매할 수 있습니다.
* **3D 실물 홀로그램**: 판매 아이템이 상자 위에 입체적으로 회전하며 품목명, 단가, 현재 잔여 재고가 홀로그램으로 투명하게 노출됩니다.
* **판매(Sell) 및 매입(Buy) 양방향 지원**: 유저들에게 물건을 파는 일반 상점뿐만 아니라, 특정 자원을 지정한 단가로 유저들에게서 사들이는 '구매 대행(매입) 상점'도 운영할 수 있습니다.

| ![판매 상점](https://2397529054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR0U5V6Ssr22x7dYGrR6U%2Fuploads%2Fgit-blob-2851a3080a0f5283713884c7c44ebeb477b69427%2Fqs_sell.png?alt=media) | ![매입 상점](https://2397529054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FR0U5V6Ssr22x7dYGrR6U%2Fuploads%2Fgit-blob-3fc086b02c1bf9b56b1ceace3d7c95116b8e6b4a%2Fqs_buy.png?alt=media) |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |

***

## 2. 🛠️ 체스트샵 개설 및 설치 방법 (4단계)

체스트샵을 설치하는 과정은 매우 간단하며 단 4단계로 완료됩니다:

1. **상자 배치**:
   * 마을이나 거점 등 상점을 열고 싶은 안전한 구역에 **일반 상자, 통(Barrel), 또는 셜커 상자**를 바닥에 설치합니다.
2. **판매 물품 보관**:
   * 상자를 열어 판매할 물품을 상자 안에 넣어둡니다.
3. **상호작용 (등록 준비)**:
   * 판매하고자 하는 물품을 손(주손)에 든 채로, 설치한 **상자를 바라보고 좌클릭 또는 우클릭**합니다.
4. **단가 입력**:
   * 채팅창에 안내 메시지가 뜨면, \*\*아이템 1개당 판매할 가격(숫자)\*\*을 채팅창에 입력합니다.
   * *예시: 채팅창에 `500` 입력 시 개당 500원에 판매하는 상점으로 즉시 개설 완료!*

***

## 3. 🛒 체스트샵 이용 방법 (구매자 입장)

다른 유저가 운영하는 체스트샵 상점을 방문했을 때의 이용 방법입니다:

* **상점 정보 상세 확인**:
  * 체스트샵 상자를 **마우스 좌클릭**하면 채팅창에 해당 상점의 품목명, 1개당 가격, 상점 주인 닉네임, 현재 잔여 재고가 상세히 출력됩니다.
* **아이템 구매하기**:
  1. 체스트샵 상자를 **마우스 우클릭**합니다.
  2. 채팅창에 \*\*구매하고자 하는 수량(숫자)\*\*을 입력합니다.
  3. 내 계좌에서 코인이 차감되며 구매한 수량만큼 아이템이 인벤토리로 즉시 지급됩니다.

***

## 4. ⚙️ 상점 관리 및 매입/판매 모드 전환 (상점주 입장)

상점 주인은 상자를 바라보고 입력하는 직관적인 한글 명령어와 표지판 상호작용을 통해 언제든지 상점을 편리하게 관리할 수 있습니다:

### ① 상자 열기 및 재고 보충/회수

* 상점 주인은 내 체스트샵 상자를 **마우스 우클릭**하여 일반 상자처럼 자유롭게 열고 닫을 수 있습니다. 판매할 물품을 넣거나 재고를 언제든지 꺼낼 수 있습니다.
* 상점에 부착된 **표지판을 우클릭**하면 상점 설정 및 제어 옵션을 확인할 수 있습니다.

### ② 매입(구매) 상점으로 전환 (`/구매상자`)

* 유저들에게 물건을 파는 것이 아니라, 유저들이 상자에 아이템을 넣고 돈을 받아가도록 하려면 상자를 바라보고 **`/구매상자`** (또는 `/구매상점`, `/qs buy`)를 입력합니다.
* *(※ 매입 상점을 운영할 때는 유저들에게 지불할 충분한 코인이 상점 주인의 계좌에 남아있어야 정상 매입됩니다.)*

### ③ 판매 상점으로 전환 (`/판매상자`)

* 매입 모드로 설정된 상점을 다시 손님에게 물건을 파는 판매 상점으로 되돌리려면 상자를 바라보고 **`/판매상자`** (또는 `/판매상점`, `/qs sell`)를 입력합니다.

### ④ 판매 가격 수정 (`/가격`)

* 상자를 바라보고 \*\*`/가격 <금액>`\*\*을 입력하면 번거롭게 상점을 허물지 않고도 즉시 1개당 단가가 변경됩니다. (예: `/가격 1200`)

### ⑤ 상점 철거 (`/상점지우기`)

* 상자를 바라보고 **`/상점지우기`** (또는 `/qs remove`)를 입력하면 체스트샵이 해제되며 일반 상자로 되돌아옵니다.

***

## 5. 📌 체스트샵 핵심 명령어 종합 안내

<table><thead><tr><th width="180">한글 명령어</th><th width="180">기본 명령어</th><th width="200">사용 형식</th><th>기능 및 설명</th></tr></thead><tbody><tr><td><strong>/구매상자</strong></td><td><code>/qs buy</code></td><td><code>/구매상자</code>, <code>/구매상점</code></td><td>바라보고 있는 상점을 <strong>매입 모드</strong>(손님에게서 아이템 구매)로 전환합니다.</td></tr><tr><td><strong>/판매상자</strong></td><td><code>/qs sell</code></td><td><code>/판매상자</code>, <code>/판매상점</code></td><td>바라보고 있는 상점을 <strong>판매 모드</strong>(손님에게 아이템 판매)로 전환합니다.</td></tr><tr><td><strong>/가격</strong></td><td><code>/qs amount</code></td><td><code>/가격 &#x3C;금액></code></td><td>바라보고 있는 상점의 아이템 1개당 거래 가격을 수정합니다. (예: <code>/가격 500</code>)</td></tr><tr><td><strong>/상점지우기</strong></td><td><code>/qs remove</code></td><td><code>/상점지우기</code></td><td>바라보고 있는 체스트샵을 해체하고 일반 상자로 환원합니다.</td></tr><tr><td><strong>/체스트샵</strong></td><td><code>/qs</code>, <code>/quickshop</code></td><td><code>/체스트샵</code></td><td>체스트샵 종합 도움말 및 관리 기능을 확인합니다.</td></tr></tbody></table>

***

## 6. 💡 운영 팁 및 영토 보호 연동

* **재고 보충 및 수거**:
  * 상점 주인은 일반 상자를 열듯 상자를 열어서 물품을 넣거나 꺼낼 수 있으며, 상자 안의 수량 변화가 홀로그램에 실시간으로 반영됩니다.
  * 재고가 0개가 되면 홀로그램에 **'품절 (Out of Stock)'** 안내가 표시되어 손님들이 헛걸음하지 않도록 돕습니다.
* **마을 영토 보호 필수 권장**:
  * 체스트샵은 외부인의 무단 파괴나 도난을 방지하기 위해 반드시 내가 소유하거나 관리하는 [**🏰 마을(Land)**](/dolphin/guide/04..md) 보호 구역 내에 설치하시기 바랍니다.