# 플러그인 쓰기

> 대화 안에서 플러그인을 설치하고, 켜고, 설정하기.

Source: https://reverie.im/ko/docs/plugins/using-plugins
Language: ko

플러그인은 대화마다 따로, 대화 사이드 패널의 **플러그인** 탭에서 설치합니다. 로그인이 필요합니다 — 안 되어 있으면 탭은 로그인 안내만 보여줍니다.

## 플러그인 설치하기 \[#install-a-plugin]

### 플러그인 탭 열기 \[#open-the-plugins-tab]

대화에서 사이드 패널을 열고 **플러그인**을 고르세요. **내 플러그인**, **공식**, **커뮤니티** 사이를 오갈 수 있습니다. **커뮤니티** 탭에는 검색창이 있고, 플러그인 이름과 설명을 훑습니다.

### 비용 예상치 읽기 \[#read-the-cost-estimate]

모든 카드에는 그 플러그인이 메시지 한 통마다 얼마를 더하는지가 크레딧으로 적혀 있습니다. 지금 이 대화가 쓰는 모델로 계산한 값입니다. 모델을 바꾸면 예상치도 바뀌고, 설치 대화상자가 그 내용을 그대로 한 번 더 보여줍니다.

### 설치 \[#install]

**설치**를 누릅니다. 설정이 있는 플러그인이면 **플러그인 설치** 대화상자가 먼저 열립니다. 항목을 채우고 저장하세요. 설정이 있는 플러그인에는 **AI 생성**도 있어서, 당신이 쓴 설명으로 그 항목들을 채워 줍니다.

### 이 대화에서 켜기 \[#enable-it-for-this-chat]

설치된 플러그인의 카드에는 스위치가 있습니다. 켜면 이 대화에서 플러그인이 돌아가고, 끄면 설치된 채로 아무것도 하지 않습니다. 설정은 언제든 **플러그인 설정**으로 다시 열 수 있고, **제거**로 지울 수 있습니다.

켜진 인터랙티브 플러그인은 메시지 상자 옆 플러그인 메뉴에 나타납니다. 그 메뉴는 인터랙티브 플러그인이 하나라도 켜져 있을 때만 있습니다.

새 대화에서는 첫 메시지를 보내기 전에 플러그인을 미리 맞춰 둘 수 있습니다. 대화가 시작되는 순간부터 적용됩니다.

## 순서 배지와 프롬프트 다섯 개 한도 \[#the-order-badge-and-the-five-prompt-limit]

켜진 플러그인마다 **#1**, **#2**, **#3**… 배지가 붙습니다. 그 숫자는 이 대화에서의 순서이고, 설치한 차례대로 매겨지며, 어떤 프롬프트 플러그인이 적용될지를 정합니다.

> **한 대화에 적용되는 프롬프트 플러그인은 많아야 다섯 개입니다.** 여섯 개를
> 켜면 그 순서에서 앞의 다섯 개가 돌고, 나머지는 말없이 건너뜁니다 — 카드에서는
> 켜진 것처럼 보이고 비용 예상치도 뜨지만, 답변에는 아무것도 보태지 않습니다.
> 도구와 인터랙티브 플러그인은 이 다섯에 들어가지 않습니다. 프롬프트 플러그인
> 하나를 끄면 그 자리가 순서상 다음 것에게 넘어가니, 어느 다섯이 이겼을지
> 궁금해하기보다 필요 없는 것을 꺼 두세요.

도구나 인터랙티브 플러그인에는 개수 제한이 없지만, 도구 플러그인은 요청마다 자기 설명을 함께 보내기 때문에 하나 늘 때마다 카드의 비용 예상치도 올라갑니다.

## 모델 지원 \[#model-support]

도구 플러그인은 도구 호출을 지원하는 모델에서만 돌아갑니다. 지원하지 않는 모델에서는 카드가 비활성화되고 **현재 모델은 도구 플러그인을 지원하지 않습니다**라고 적힙니다. 프롬프트와 인터랙티브 플러그인은 모든 모델에서 돌아갑니다. [모델 고르기 →](https://reverie.im/ko/docs/reference/choosing-a-model)

## AI 생성 패널 \[#ai-generated-panels]

일부 인터랙티브 플러그인은 일기나 상태판처럼 캐릭터가 그 자리에서 내용을 채우는 패널을 엽니다. 페이지를 생성하면 크레딧이 소모되며, 처음 한 번 패널이 확인을 요청합니다.

생성된 모든 페이지는 채팅과 함께 보관됩니다. 어떤 기기에서든 패널을 다시 열면 다시 생성하지 않고 마지막 페이지가 표시되며, 패널의 **기록** 버튼에는 이 플러그인이 이 채팅에서 만든 이전 페이지가 나열됩니다. 이전 페이지를 여는 데는 비용이 들지 않습니다. 새 페이지는 이전 페이지를 참고해 작성되므로 일기가 처음부터 다시 시작되지 않고 이어지며, 페이지에서 보낸 메시지는 캐릭터가 답할 때 당신이 읽고 있던 내용을 알 수 있게 합니다. 캐릭터는 채팅 중에도 각 패널의 최신 페이지를 기억하므로, 일기나 상태판에서 정해진 내용은 일관되게 유지됩니다. 패널 상단에서 기본 빠른 모델 대신 내 채팅 모델로 페이지를 생성하도록 바꿀 수 있고, 그룹 채팅에서는 누구의 페이지인지 고를 수 있습니다. 페이지에 입력란이 있으면 직접 쓴 말로 답할 수 있습니다. 페이지에서 한 일(뽑은 카드, 여백에 남긴 메모)은 그 페이지와 함께 보관됩니다.

포크한 채팅에는 포크 지점 이전에 만들어진 페이지가 유지됩니다. 메시지를 삭제하면 그 이후에 생성된 페이지도 함께 삭제되며, 플러그인의 기록이 길어지면 가장 오래된 페이지부터 정리됩니다. 기록 패널에서 페이지를 직접 삭제할 수도 있으며, 삭제한 페이지는 캐릭터도 더 이상 참고하지 않습니다.

## 버전과 업데이트 \[#versions-and-updates]

설치된 플러그인 카드에는 지금 돌리는 버전이 **v3**처럼 적힙니다. 제작자가 더 새 버전을 내면 그 버전을 가리키는 업데이트 버튼이 카드에 생기고, 당신이 누르기 전까지는 아무것도 바뀌지 않습니다. 당신의 대화는 설치한 바로 그 버전을, 당신 언어로 된 문구까지 그대로 계속 돌립니다.

## 캐릭터가 기본으로 주는 것 \[#character-defaults]

캐릭터 제작자는 도구와 인터랙티브 플러그인을 캐릭터에 딸려 보낼 수 있습니다. 그 캐릭터와 대화를 열면 이미 설치된 채로 와 있고, 다른 플러그인처럼 끌 수 있습니다. 같은 플러그인을 당신도 설치했다면 당신의 설정이 이깁니다.

제작자는 심사를 통과한 버전만 붙일 수 있어서, 찾아온 사람이 심사 전 초안을 돌릴 일은 없습니다.

그 밖에 미리 깔려 오는 것은 없습니다. 새 대화는 당신이 뭔가를 설치하거나 캐릭터 제작자가 붙여 두기 전까지 플러그인을 하나도 돌리지 않습니다.

## 이미지 생성 \[#image-generation]

대화 속 이미지 생성은 공식 이미지 생성 플러그인을 설치하면 켜집니다. 그 설치 대화상자는 이미지 생성에 크레딧이 든다는 확인을 요구하고, 확인하기 전까지 설치가 끝나지 않습니다. [이미지 생성 →](https://reverie.im/ko/docs/media/image-generation)

## 18세 이상 플러그인 \[#18-plugins]

공식 탭에는 **노골적 묘사**, **야한 말** 같은 18세 이상 프롬프트 플러그인도 있습니다. **콘텐츠 필터**에서 18세 이상 콘텐츠를 표시할 때만 목록에 나오고 설치할 수 있으며, 18세 이상 캐릭터와의 채팅에서만 효과가 있습니다. 다른 채팅에서는 답장에 아무것도 더하지 않습니다. 나중에 18세 이상 콘텐츠를 숨겨도 이미 설치한 채팅에서는 계속 보이므로 끄거나 제거할 수 있습니다. [환경설정 →](https://reverie.im/ko/docs/account/preferences)

## 당신이 만든 플러그인 \[#plugins-you-created]

**내 플러그인** 탭에는 당신이 쓴 플러그인을 위한 **편집**, **디버그**, **삭제**와 함께 **수익 보기**도 있습니다. 당신이 만든 플러그인을 삭제하는 것은 되돌릴 수 없고, 먼저 확인을 받습니다.

## 관련 문서 \[#related]

* [플러그인](https://reverie.im/ko/docs/plugins) — 세 가지 종류와 각각이 할 수 있는 일
* [플러그인 만들기](https://reverie.im/ko/docs/plugins/creating-plugins) — 자기 것을 쓰고 공개하기
* [사이드 패널과 설정](https://reverie.im/ko/docs/chatting/side-panel) — 같은 패널의 다른 탭들
* [크레딧](https://reverie.im/ko/docs/billing/credits) — 메시지당 비용이 어떻게 계산되는지