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

# QR코드

> **SSOBIG TOOL QR 코드란?**
>
> **QR 코드 모듈**은 플레이어가 **QR 코드를 스캔하거나, 자신의 QR 코드를 통해 특정 동작을 수행**할 수 있도록 하는 기능입니다. 이를 통해 **출석 체크, 구역 이동, 자원 지급, 미션 수행** 등 다양한 상호작용을 구현할 수 있습니다.
>
> QR 코드는 **개별 생성되며**, 플레이어가 **웹 내 카메라를 이용해 스캔**하여 사용합니다.

## **핵심 기능**

* **QR 코드 생성 및 스캔 기능**
  * 플레이어가 개별 QR 코드를 생성하고, 플레이어가 이를 스캔하여 동작 수행
* **다양한 QR 코드 활용 방식**
  * **구역 이동, 팀 배정, 자원 지급, 미션 수행 등 다양한 동작을 실행**
* **스캔 데이터 추적 및 관리 가능**
  * **스캔한 플레이어 목록 및 사용 내역**을 확인하고, 필요 시 초기화 가능

***

### **QR 코드 모드**

* QR 코드에는 세 가지 모드가 있습니다.
  * **표시만**: 플레이어는 **자신의 QR 코드만 확인**할 수 있으며, 다른 QR 코드를 스캔할 수 없습니다.
  * **스캔만**: **QR 코드 스캔만 가능**하며, 자신의 QR 코드를 표시할 수 없습니다.
  * **모두**: **자신의 QR 코드를 표시하면서 동시에 다른 QR 코드도 스캔 가능**합니다.

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

### **스캔 가능 횟수**

* QR 코드가 **최대 몇 번까지 스캔될 수 있는지** 설정할 수 있습니다.
* 최소 1회부터 최대 99회까지 지정 가능하며, 설정된 횟수에 도달하면 스캔이 제한됩니다.

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

### **스캔 가능한 플레이어 필터**

* 특정 플레이어만 QR 코드를 스캔할 수 있도록 **필터를 설정**할 수 있습니다.
* 자세한 필터 설정 방법은 [**필터 시스템**](/ssobig-tool-guide/undefined-2/undefined-4.md) 페이지에서 확인하세요.
* 예: 특정 역할(예: 리더) 또는 특정 구역에 속한 플레이어만 스캔 가능하도록 설정 가능
  * 필터 조건을 만족하지 않는 플레이어가 QR 코드를 스캔하면 오류 메시지가 표시됩니다.
  * 단, **구역, 팀, 자원 QR 코드는 필터와 관계없이 스캔 가능합니다.**

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

### **재스캔 가능 여부**

* 동일한 플레이어가 같은 QR 코드를 **여러 번 스캔할 수 있도록 허용할지 여부**를 설정할 수 있습니다.
* 필요 시 1회 스캔 후 **추가 스캔 불가** 설정 가능.

### **보여준 것도 횟수 차감 여부**

* **다른 플레이어가 내 QR 코드를 스캔할 때, 해당 QR 코드의 사용 횟수를 차감할지 여부**를 설정할 수 있습니다.

### **방향 중요 여부**

* QR 코드 스캔이 **일방향인지, 양방향인지 설정**하는 기능입니다.
* 재 스캔 가능 여부를 활성화  하지 않은 상태에서는 **한 번 스캔된 플레이어 간 재스캔이 불가**합니다. (예: A → B 스캔 시, B → A 스캔 불가)
* **방향 중요 여부를 활성화하면**, 같은 플레이어끼리 **서로 스캔이 가능**해집니다.

### **구역 스캔 시 효과**

* 플레이어가 특정 **구역의 QR 코드를 스캔하면 해당 구역으로 자동 이동**됩니다.
* 예: "A구역" QR 코드 스캔 시, 플레이어가 A구역으로 자동 배치됨.

### **팀 스캔 시 효과**

* 특정 **팀의 QR 코드를 스캔하면 플레이어가 해당 팀으로 배정**됩니다.
* 예: "1팀" QR 코드 스캔 시, 플레이어가 자동으로 1팀으로 배치됨.

### **아이템 스캔 시 효과**

* 특정 **아이템(자원, 포인트 등)의 QR 코드를 스캔하면 해당 아이템이 지급**됩니다.
* 예: "점수 5점" QR 코드 스캔 시, 플레이어에게 5점이 추가됨.

> 구역, 팀, 아이템 QR 코드 생성에 대한 자세한 설명은 [구역, 팀, 아이템 QR 코드](broken://pages/o9GBHd7Gmph7uiwSTcr3) 페이지에서 확인하세요.

### **제출한 스캔 초기화**

* QR 코드의 스캔 내역을 **초기화하여 다시 사용할 수 있도록 설정**할 수 있습니다.
* 예: 모든 플레이어의 스캔 기록을 초기화하여 다시 참여할 수 있도록 설정 가능.

### **스캔 목록**

* 현재까지 **QR 코드를 스캔한 플레이어 목록을 확인**할 수 있습니다.
* **언제, 어떤 QR 코드를 스캔했는지 기록**이 남아 추적이 가능합니다.

### **스캔 순위**

* **QR 코드를 가장 많이 스캔한 플레이어 또는 가장 많이 스캔당한 플레이어를 확인**할 수 있습니다.