디스코드 봇 & 서버쨩
공식 사바쨩 디스코드 봇과 페어링해 포트 포워딩 없이 서버를 제어하는 흐름
디스코드 봇 & 서버쨩
서버쨩(릴레이 서버)은 사바쨩의 언니로, 디스코드와 사용자 PC 사이에서 명령을 전해 줍니다. 사바쨩의 디스코드 봇은 서버쨩에서 운영되는 공식 봇입니다. 사용자는 별도로 봇을 실행하거나 디스코드 토큰을 직접 관리할 필요가 없습니다. 자기 디스코드 서버에 공식 봇을 초대하고, 사바쨩 앱에서 받은 페어링 코드로 한 번 연결해 두면 끝입니다.
1. 동작 원리
- 1사바쨩 데몬디스코드 릴레이
새 명령 기다리기 (롱폴링)
- 2디스코드디스코드 릴레이
명령 입력 /사바쨩 … 또는 채팅
- 3디스코드 릴레이사바쨩 데몬
명령 전달
- 4사바쨩 데몬
권한 확인
- 5사바쨩 데몬게임 서버
서버 실행 · 콘솔 명령
- 6사바쨩 데몬디스코드 릴레이
결과 보내기
- 7디스코드 릴레이디스코드
결과 답장
- 봇 자체는 서버쨩 안에서 동작합니다. 사용자 PC에는 봇이 설치되지 않습니다.
- 게임 서버는 사용자 PC에서 돕니다. PC의 사바쨩 데몬이 서버쨩에 long-polling으로 먼저 접속해 명령을 가져가고, 결과를 돌려보냅니다.
- 데몬은 받은 게임 명령을 stdin(서버 콘솔) → REST → RCON 순서로 보냅니다. 팰월드는 REST API를 씁니다. RCON은 RCON만 지원하는 게임에만 쓰며, 루프백(127.0.0.1)으로만 연결합니다.
- 데몬 ↔ 서버쨩 통신은 PC에서 나가는 HTTPS 뿐입니다. 공유기 포트포워딩은 필요하지 않습니다.
- 노래하는 사바쨩은 PC를 거치지 않고 서버쨩 쪽에서 바로 처리하므로 PC가 꺼져 있어도 동작합니다.
2. 페어링 흐름
페어링은 **호스트(사바쨩 데몬)**와 **노드(디스코드 서버)**를 서버쨩에 등록하는 과정입니다. 한 번 입력으로 끝납니다.
2.1 흐름 다이어그램
- 1GUI 앱사바쨩 데몬
연결 코드 요청
- 2사바쨩 데몬디스코드 릴레이
코드 발급 요청
- 3디스코드 릴레이사바쨩 데몬
코드 + 폴링 비밀값 (5분 유효)
- 4사바쨩 데몬GUI 앱
화면에 코드 표시
- 5디스코드디스코드 릴레이
/사바쨩 연결 코드:…
- 6디스코드 릴레이
PC 등록 · 노드 토큰 발급
- 7GUI 앱사바쨩 데몬
3초마다 상태 확인
- 8사바쨩 데몬디스코드 릴레이
상태 확인 (폴링 비밀값 첨부)
- 9디스코드 릴레이사바쨩 데몬
연결됨 + 노드 토큰 (한 번만)
- 10사바쨩 데몬
토큰 저장 · 릴레이 연결 시작
- 11사바쨩 데몬GUI 앱
연결됨 표시
- 페어링 코드는 32자,
pollSecret은 48자이고, 유효 시간은 5분입니다. - 토큰은 단 1회만 반환됩니다(원자 swap). GUI가 아니라 데몬이 받는 즉시
.node_token으로 저장하고 서버쨩 연결을 시작합니다. 앱은 폴링 비밀값을 내 PC의 데몬에게만 넘기고, 데몬은 이를 주소가 아니라 헤더에 실어 서버쨩으로 보냅니다. - 페어링 코드를 남이 보더라도
pollSecret이 없으면 토큰을 가로챌 수 없습니다. - 디스코드 계정 하나에 PC를 여러 대 연결할 수 있습니다. 이미 PC가 있는 계정으로 연결하면
새 PC로 연결과 예전 PC를 고르는다시 연결버튼이 나옵니다. 다시 연결하면 그 PC의 예전 토큰은 더는 쓰이지 않습니다. 디스코드 서버 하나에도 여러 사람의 PC가 붙을 수 있습니다(디스코드 연동).
2.2 앱 측 조작 절차
- 사바쨩 앱의 디스코드 화면 → 연결에서 디스코드 서버 연결을 누릅니다.
- 디스코드 서버에 공식 사바쨩 봇이 없다면 먼저 봇 초대하기로 초대합니다.
- 화면에 연결 코드와 함께 입력할 명령(
/사바쨩 연결 코드:<code>)이 나옵니다. 복사를 눌러 디스코드 채팅창에 입력합니다. - 이 명령은 그 디스코드 서버에서 서버 관리 권한이 있는 사람만 실행할 수 있습니다. 봇과의 DM에서 보내면 디스코드 서버 없이 PC만 내 계정에 연결합니다.
- 처음 쓰는 디스코드 계정이면 봇이 먼저 등록을 안내합니다.
등록하기로 웹사이트에서 약관을 확인하고 등록하면 그 답이 연결 확인으로 바뀝니다. 동의하기 전에는 PC를 연결하지 않습니다. - 봇이 연결할지 묻는 버튼을 보이면
연결을 누릅니다. 남이 준 코드를 넣으면 그 사람 PC가 내 계정에 연결되므로, 사바쨩 앱에서 직접 받은 코드일 때만 누르세요. - 앱이 3초마다 데몬을 거쳐 상태를 확인하고, 데몬이
.node_token을 저장하면 "연결됨"으로 바뀝니다.
페어링이 끝나면 데몬이 자동으로 서버쨩에 long-poll 연결을 유지합니다. 앱의 명령 전달 스위치를 끄면 PC가 디스코드 명령을 받지 않아 봇이 대답하지 않습니다.
2.3 코드 없이 다른 디스코드 서버 연결
이미 페어링해 둔 디스코드 계정이라면, 다른 디스코드 서버에서는 코드 없이 **/사바쨩 연결**만 실행해도 됩니다.
- 봇이 그 계정에 연결된 PC를 모두 그 디스코드 서버에 바로 연결합니다. PC에서 따로 수락하거나 PC를 고르지 않아도 됩니다.
- 처음 쓰는 계정이면 먼저 등록합니다. 등록하면 그 디스코드 서버도 사바쨩에 등록되고, 연결한 PC가 없으면 PC 없는 서버로 남습니다(§2.5). 등록한 계정인데 PC가 없으면 페어링 코드로 연결하라는 안내가 나옵니다.
- 이렇게 연결한 디스코드 서버에는 처음에 게임 서버가 하나도 보이지 않습니다. PC의 사바쨩 앱에서 그 디스코드 서버에 쓸 서버를 골라 주세요.
- 페어링 코드로 연결한 디스코드 서버는 앱의 디스코드 연결 화면에 있는 새 디스코드 서버에 내 서버 바로 열기 설정을 따릅니다. 켜져 있으면 모든 서버가 바로 보이고, 꺼져 있으면 직접 고릅니다.
- 코드로 연결할 때와 마찬가지로 서버 관리 권한이 필요합니다. 다른 PC가 이미 연결된 디스코드 서버라면 빼앗지 않고 내 PC를 함께 붙입니다.
2.4 연결 해제
- 앱의 연결 해제 버튼 → 데몬이 명령 전달을 멈추고
.node_token을 지웁니다. 이 PC와 모든 디스코드 서버의 연결이 끊어집니다. - 디스코드 서버 하나만 떼어 내려면 그 서버에서 **
/사바쨩 연결해제**를 실행합니다. 연결한 사람이나 디스코드 서버 주인만 쓸 수 있고, 그 서버의 채널 배정도 함께 지워집니다.
2.5 PC 없는 디스코드 서버
사바쨩 앱을 설치하지 않은 사람도 봇을 초대해 노래하는 사바쨩, 말하는 사바쨩, 읽어주는 사바쨩, 서버 관리 명령, 게임 전적을 씁니다.
- 설정은 서버쨩에 저장됩니다. 디스코드 서버 주인이나 서버 관리 권한이 있는 사람이 언어, 말하는 사바쨩·노래하는 사바쨩 채널 배정, 이모지 업스케일, 말하는 사바쨩 설정, 읽어주는 사바쨩 설정을 바꿉니다. 디스코드
/설정이나 사바쨩 웹에서 하고, 처음 바꿀 때 등록합니다. - 사바쨩 레벨(권한 사다리)과 게임 서버 명령은 없습니다. 알림·게임 채팅·상황판 채널은 PC가 보내는 것이라 배정할 수 없습니다.
- 나중에 PC를 연결하면 설정을 그대로 이어받고, 그때부터 설정의 원본은 그 PC가 됩니다.
- 노래 듣기나 대화 같은 일반 멤버 사용에는 등록이 필요 없습니다.
3. 봇 슬래시 명령
공식 봇이 노출하는 /사바쨩 명령입니다. 디스코드를 한국어가 아닌 언어로 쓰면 같은 명령이 /saba와 영어 하위 명령 이름(예: /saba connect)으로 보입니다. PC를 연결하지 않은 디스코드 서버에는 연결·웹·도움말만 보입니다. 사바쨩 설정은 모두 따로 있는 /설정 명령에 모았습니다(§3.2). 그 밖의 슬래시 명령(/tts, /전적, /청소 등)은 명령어에 있습니다.
| 명령 | 누가 | 동작 |
|---|---|---|
/사바쨩 상태 | 누구나 | 이 서버에 연결된 PC의 상태와 게임 서버별 상태(CPU·RAM) 표시 |
/사바쨩 연결 [코드] | 서버 관리 권한 | 페어링 코드로 연결. 코드를 비우면 내 계정의 PC를 모두 이 서버에 연결(§2.3). 처음이면 등록부터 |
/사바쨩 연결해제 | 연결한 사람·서버 주인 | 이 서버와 PC의 연결 해제 |
/사바쨩 권한 <레벨> [유저] | 노드 소유자 | 유저를 고르면 그 멤버에게 명령 레벨 부여(레벨 목록의 해제는 개별 레벨을 지우고 기본 레벨로 되돌림), 비우면 레벨을 따로 받지 않은 멤버의 기본 레벨(처음엔 유저). 레벨 목록은 이 서버의 권한 사다리 |
| 멤버 우클릭 → 앱 → 사바쨩 레벨 바꾸기 | 노드 소유자 | 그 멤버의 명령 레벨을 목록에서 고름(해제도 있음). /사바쨩 권한과 같은 일. 서버 관리 권한이 있는 사람에게만 메뉴가 보임 |
/사바쨩 코코낸내 | 노드 소유자 | 이 서버에서 봇을 재움 (모든 메시지 무시) |
/사바쨩 기상 | 노드 소유자 | 잠든 봇을 깨움 |
/사바쨩 웹 | 누구나 (자기 계정) | 사바쨩 웹의 일회용 링크(5분). PC가 있으면 그 PC도, 없으면 내가 관리하는 디스코드 서버 설정만. 나에게만 보임 |
/사바쨩 도움말 | 누구나 | 사바쨩 사용법과 명령 목록 표시 (나에게만 보임) |
/내사바쨩 웹 | 누구나 (자기 계정) | /사바쨩 웹과 같음. 어느 서버나 DM에서도 됨 |
/내사바쨩 내pc | 누구나 (자기 PC) | 내 디스코드 계정에 연결한 PC 목록, 이름 바꾸기·지우기 (나에게만 보임) |
/내사바쨩 에이전트 | 누구나 (자기 계정) | 내 디스코드 계정에 연결한 AI 에이전트(원격 MCP)를 보고 끊기. 없으면 에이전트에 넣을 주소를 보여 줌. DM에서도 됨, 나에게만 보임 (AI 에이전트 연결) |
/사바쨩 업데이트 | PC를 연결한 사람 | 이 서버에 연결된 PC의 사바쨩 업데이트를 확인하고, 확인 버튼을 누르면 적용 |
/내사바쨩은 내 계정에 관한 명령이라 서버 멤버 목록에 보이지 않습니다. PC를 연결하면 봇이 보여 주는 내 계정에 설치 버튼으로 사바쨩을 내 디스코드 계정에 설치하면, 어느 서버나 DM에서든 나에게만 보입니다. 봇과의 DM에서는 설치하지 않아도 /사바쨩 웹·/사바쨩 내pc·/사바쨩 에이전트로 씁니다.
PC를 연결한 디스코드 서버에서 권한·잠자기·언어·노래하는 사바쨩·읽어주는 사바쨩 설정의 원본은 PC의 사바쨩 설정이므로, 이 명령과 /설정은 PC가 켜져 있을 때 반영됩니다(PC 없는 서버는 §2.5). 같은 설정은 앱의 디스코드 서버 화면에서도 바꿀 수 있습니다. 권한은 인스턴스 탭에서 서버를 눌러 여는 레벨별 명령·멤버별 레벨 화면, 노래하는 사바쨩·읽어주는 사바쨩은 각자의 탭, 언어·접두사·슬래시 명령 모양은 봇 설정 탭입니다. 모든 디스코드 서버를 한꺼번에 재우는 것은 디스코드 → 연결 화면에서 합니다.
3.1 서버별 슬래시 명령과 작업 메뉴
연결이 끝나면 봇이 디스코드 서버마다 명령을 따로 등록합니다.
/<서버 이름> 명령:<명령>: 게임 서버 인스턴스 하나마다 명령 하나가 생깁니다. 디스코드 명령 목록에는 서버마다 한 줄만 보입니다. 명령 칸을 누르면 그 서버에서 쓸 수 있는 명령(시작·정지·상태, 작업, 모듈 명령)이 목록으로 뜨고, 글자를 치면 이름으로 추려집니다. 입력이 필요한 명령은 보내면 그 명령에 필요한 칸만 있는 입력창이 뜹니다(플레이어처럼 목록이 있는 칸은 골라서, 나머지는 직접 입력). 입력이 없는 명령은 바로 실행됩니다.- 명령 목록에는 내 레벨로 쓸 수 없는 명령과 지금 서버 상태에 맞지 않는 명령(켜진 서버의 시작, 꺼진 서버의 정지)은 빠지고, 내가 그 서버에서 최근에 쓴 명령이 먼저 나옵니다. 실제로 쓸 수 있는지는 사바쨩 앱이 다시 판단합니다.
- 작업: 사바쨩 앱이 디스코드에 연 작업(재시작·백업 등)도 같은 명령 목록에 들어갑니다. 되묻기 설정(§5)에 따라 확인이 필요한 작업은 바꿀 내용을 보여 주고, 요청한 사람이 실행 버튼을 눌러야 합니다. 사바쨩 앱 업데이트는 작업 메뉴에 없고
/사바쨩 업데이트로 합니다. - 플레이어: 접속자 확인을 지원하는 게임의 서버에만
플레이어명령이 목록에 생깁니다. 지금 접속한 사람 수와 이름을 보여 줍니다. - 주소(사바쨩 0.1.12부터): 그 서버에 접속할 주소(
IP:포트)를 부른 사람에게만 알려 줍니다. 조회 결과는 나만 보기 설정과 상관없이 늘 나에게만 보이고, 채널에 보이는 접두사 명령으로는 부르지 않습니다. 주소는 PC가 사바쨩 클라우드에 접속한 공인 주소이고, 포트는 포트 확인에 쓰는 그 서버의 공개 포트입니다(포트가 여럿이면 칸 이름을 붙입니다). 서버가 꺼져 있으면 그렇다고 덧붙입니다. 공유기 뒤에서는 포트 포워딩이 되어 있어야 친구가 들어올 수 있습니다. CLI에서는saba-chan-cli server address로 봅니다. - 백업 복원: 복원할 백업을 목록에서 고릅니다(이름을 치면 맞는 백업이 추려집니다). 서버가 켜져 있으면 먼저 끌지 묻고, **끄고 진행**을 누르면 서버를 끈 뒤 복원합니다. 복원은 위험 작업이라 실행 전에 한 번 더 확인합니다. 요청한 사람만 누를 수 있습니다.
- 켜짐 알림:
/<서버 이름>슬래시 명령, 알림의 재시작 버튼, 말하는 사바쨩으로 서버를 시작·재시작하면, 서버가 접속을 받을 수 있게 되었을 때 같은 채널에 "다 켜졌습니다"를 알립니다. 끝내 켜지지 못하면 이유를 한 줄로 알립니다. - 이 서버에 허용된 인스턴스만 나타납니다(앱의 디스코드 서버 → 인스턴스 탭).
3.2 사바쨩 설정 /설정
/설정은 이 서버의 사바쨩 설정을 한 화면에 모아 나에게만 보여 줍니다. 슬래시 명령 뒤에 흩어져 있던 설정(옛 /사바쨩 배정·언어·큰이모지·설정·읽어주기)을 모두 여기로 옮겼습니다. 잠든 서버에서도 열리므로 여기서 깨울 수도 있습니다.
- 기능마다 묶음이 있습니다: 🔊 읽어주기, 💬 말하는 사바쨩, 🎵 노래하는 사바쨩, 🎮 게임 채팅, 📣 알림·상황판, 🌐 언어·명령, 😴 잠자기, 🛡️ 권한, 🧹 자동 청소, 🖥️ 내 PC. 채널 배정은 각 기능 묶음 안에 있습니다.
- 옵션마다
전체(내 PC의 모든 서버)·서버(이 서버 전체)·나(나에게만) 표시가 붙고, 보는 사람에 따라 바꾸기·🔒 보기만·숨김으로 보입니다. 전체옵션은 노드 소유자에게만 보입니다: 💬 말하는 사바쨩의 연결(API 키·모델·이번 달 크레딧)과 🖥️ 내 PC의 PC 이름입니다. API 키는 등록했는지만 보이고 입력 창에도 채워 두지 않습니다. 새 키를 넣으면 바뀌고, 비워 두면 그대로입니다. 넣은 키는 디스코드를 거쳐 서버쨩과 PC로 가고, 다시 보이지 않습니다. 모델은 키로 쓸 수 있는 목록에서 고르고, 크레딧은 잔액(알려 주는 제공사만)과 이번 달 사용량입니다.
| 누가 | 할 수 있는 것 |
|---|---|
| 노드 소유자 (PC를 연결한 사람) | 모든 옵션을 바꾸고, 크레딧·내 레벨은 봄 |
| 디스코드 서버 주인 | 언어·명령, 잠자기, 노래하는 사바쨩, 채널 배정, 이모지 업스케일, 게임 채팅 채널 옵션을 바꾸고, 말하는 사바쨩·읽어주는 사바쨩·기본 레벨은 봄 |
| 사바쨩 레벨 관리자 | 서버 옵션을 보기만 함(자동 청소는 바꿈) |
| 유저·게스트 | 따라다니며 읽기(나만의 옵션)를 바꾸고, 호출어·잠자기 상태·내 레벨을 봄 |
- 묶음의 바꾸기 버튼을 누르면 입력 창이 열리고, 저장하면 화면이 새 값으로 바뀝니다. 바꿀 때마다 권한을 다시 확인합니다.
- PC 없는 서버(§2.5)에서는 디스코드 서버 주인이나 서버 관리 권한이 있는 사람이 노드 소유자 자리에서 바꾸고(API 키·모델은 이 서버에만 쓰입니다), 알림·게임 채팅·상황판·레벨·내 PC 묶음과 PC 명령에만 쓰이는 잠자기·호출어·명령 모양은 없습니다.
- 🧹 자동 청소는 채널마다 보관 기간이 지난 글이나 매일 정한 시각 전 글을 지웁니다. 메시지 관리 권한이 있거나 사바쨩 레벨이 관리자 이상인 사람이 바꾸고(옛
/자동청소명령을 옮겼습니다), PC 없는 서버에서도 씁니다. - 멤버 한 사람의 레벨은
/사바쨩 권한이나 멤버 우클릭 메뉴에서 정합니다. 명령마다 필요한 레벨은 🛡️ 권한의 명령별 레벨 버튼(노드 소유자만)이 여는 창에서 서버·명령·레벨을 차례로 골라 바로 바꿉니다(기본값으로는 따로 정한 레벨을 지웁니다). - 사바쨩에게 보내는 DM에서도
/설정을 열 수 있습니다. DM에는전체옵션(PC 이름, 말하는 사바쨩 API 키·모델·이번 달 크레딧)만 보이고, 서버마다 정하는 설정(따라다니며 읽기 포함)은 그 서버에서 엽니다. 내 PC를 연결한 사람만 쓰고, PC가 여러 대면 위에서 PC를 고릅니다. 바꾼 값은 그 PC로 바로 가므로 PC가 켜져 있어야 하고, 크레딧 사용량은 그 PC를 연결한 서버를 모두 더한 값입니다.
4. 채팅 명령 (접두사)
페어링이 끝나면 디스코드 채팅창에서 접두사 기반 명령으로 서버를 제어할 수 있습니다.
사바쨩 <서버> <명령> [인자…]
기본 접두사는 사바쨩 입니다. 앱의 디스코드 서버 → 봇 설정 탭 명령 접두사에서 디스코드 서버마다 바꾸거나 더할 수 있습니다.
<서버> 자리에는 인스턴스 이름, 서버별 별명, 모듈 이름이나 모듈 별명을 쓸 수 있습니다. 모든 모듈에 공통인 기본 명령:
| 명령어 | 설명 |
|---|---|
start | 서버 시작. 예: 사바쨩 minecraft start |
stop | 서버 정지 |
status | 상태 조회 |
서버와 명령을 부르는 말은 앱의 서버 화면 → 디스코드 탭에서 정합니다. 자세한 명령어 목록은 명령어 문서를 참고하세요.
5. 권한 레벨
레벨은 소유자(3) > 관리자(2) > 유저(1) > 게스트(0) > 금지(-1) 입니다. 레벨은 누적이라, 위 레벨은 아래 레벨이 쓸 수 있는 명령을 모두 씁니다.
- 소유자는 서버를 연결한 사람(노드 주인)입니다. 모든 명령을 쓸 수 있고 강등되지 않습니다.
- 명령마다 위험도(안전·주의·위험)가 있고, 기본 프리셋에서 필요한 레벨은 안전 = 게스트, 주의 = 유저, 위험 = 관리자입니다. 앱의 디스코드 서버 → 인스턴스 탭에서 서버를 눌러 레벨별 명령 계단에서 프리셋(느슨하게·기본·엄격하게)을 고르거나 명령 칩을 다른 레벨로 옮깁니다. 멤버 레벨과 기본 레벨은 같은 곳의 멤버별 레벨에서 정하고, 디스코드 서버의 모든 서버에 함께 적용됩니다.
- 도움말·목록은 금지가 아니면 누구나 씁니다. 금지 멤버는 노래하는 사바쨩·말하는 사바쨩을 포함한 봇 기능 전체를 쓸 수 없습니다.
- 말하는 사바쨩을 거친 요청은 말하는 사바쨩 상한(처음엔 게스트)을 넘지 못합니다.
되묻기: 실행 전에 요청자에게 확인 버튼으로 물을지는 앱의 디스코드 서버 → 봇 설정 탭 되묻기 카드(또는 saba-chan-cli bot confirm)에서 정합니다. 봇에게 직접 한 요청(접두사·슬래시)은 처음에 위험한 명령만, 말하는 사바쨩은 처음에 모든 명령을 묻고, 둘 다 모든 명령·주의 이상·위험한 명령만·묻지 않음 중에서 고릅니다. 명령마다 되묻기에 쓸 위험 단계를 권한 화면의 칩 편집 창에서 바꿀 수 있습니다(필요한 레벨은 바뀌지 않습니다). 말하는 사바쨩이 고른 관리 작업은 설정과 상관없이 늘 묻습니다. 확인 버튼은 요청한 사람만 누를 수 있습니다.
6. 노래하는 사바쨩
음악 재생은 서버쨩과 함께 운영되는 **공식 음악 서버(music-server)**가 담당합니다.
- 사용자가
사바쨩 재생 …같은 명령을 치면 봇이 음악 서버에 처리를 맡기고, 음악 서버가 디스코드 음성 채널로 오디오를 보냅니다. - 사용자 PC에서 ffmpeg/yt-dlp를 직접 돌릴 필요가 없습니다.
- 음악 명령은 어느 채널에서나 동작합니다.
/설정› 🎵 노래하는 사바쨩에서 노래하는 사바쨩 채널을 정하면, 그 채널에서는 접두사 없이 명령하거나 검색어만 입력해도 되고 플레이어 화면이 함께 뜹니다. - 노래하는 사바쨩은 처음부터 켜져 있으며, 앱의 디스코드 서버 → 노래하는 사바쨩 탭에서 끌 수 있습니다. 켜져 있는 서버에는
/음악슬래시 명령이 생깁니다(명령어 5절).
7. 말하는 사바쨩 (AI 대화)
- 말하는 사바쨩은 API 키를 등록하고(앱, 또는
/설정› 💬 말하는 사바쨩 › 연결) 디스코드 서버마다 켜야 동작합니다(디스코드 서버 화면의 말하는 사바쨩 탭이나/설정, 새 서버는 꺼져 있음). 키는 PC와 서버쨩에 저장되고, 등록한 뒤에는 앱에도 디스코드에도 다시 보이지 않습니다. - 쓸 도구(게임 서버 조작, 웹 검색, 롤·롤체·배그 전적, 메이플 캐릭터, 여러 게임 검색, 생활 정보, 이미지 생성)도 디스코드 서버마다 켭니다. 앱의 공통 메뉴에서 전체 허용 도구로 막은 도구는 어느 서버에서도 쓰지 않습니다. 게임 서버 도구를 켜지 않으면 서버를 다루지 않습니다.
- 말하는 사바쨩은
/설정› 💬 말하는 사바쨩에서 배정한 채널에서만 대화합니다. 다른 채널에서는 불러도 답하지 않습니다. - 말하는 사바쨩은 모듈·익스텐션이 말하는 사바쨩에게 열어 둔 액션만 쓸 수 있고, 그 밖의 요청은 거절합니다.
- 조회는 바로 실행합니다. 무언가를 바꾸는 액션은 먼저 계획으로 만들고, 되묻기 단계(§5, 처음엔 모든 명령)에 따라 확인 버튼을 거칩니다. 관리 성격인 액션은 늘 확인 버튼을 거칩니다. 확인 버튼은 요청한 사람만 누를 수 있습니다.
- 실행 권한은 말하는 사바쨩 상한(§5)을 넘지 않습니다.
- 말하는 사바쨩이 켜져 있으면, 데몬이 알아보지 못한 채팅 명령을 말하는 사바쨩이 정확한 명령으로 바꿔 한 번 더 시도합니다.
- 말하는 사바쨩에게 로그를 물으면 지난 실행 기록까지 포함해 서버 로그를 찾아 읽습니다. 로그를 파일로 달라고 하면 AI를 거치지 않고
.log파일로 첨부합니다(최대 4 MiB, 넘으면 최근 쪽만, IP·비밀값·경로는 가림).
8. 보안 모델
- 데몬은 페어링으로 받은 노드 토큰(
sbn_{hostId}.{secret})을Authorization: Bearer헤더에 실어 HTTPS로 보냅니다. 서버쨩은 저장해 둔 Argon2 해시와 이 토큰을 대조합니다. - 서버쨩은 토큰 원문을 저장하지 않고 Argon2 해시로만 대조합니다.
- 데몬은 들어오는 연결을 받지 않습니다. 게임 서버 비밀번호는 서버쨩으로 보내지 않습니다.
9. 트러블슈팅
| 증상 | 원인 / 대처 |
|---|---|
| 봇이 반응 없음 | 접두사(기본 사바쨩) 뒤에 공백이 있는지 확인. 봇이 서버에 초대되어 있고 페어링이 끝나 있어야 하며, 앱의 명령 전달이 켜져 있어야 함. /사바쨩 코코낸내로 재운 상태가 아닌지도 확인 |
사바쨩 … start → 서버를 찾을 수 없음 | 첫 단어는 서버(인스턴스 이름·별명 또는 모듈 이름·별명), 둘째 단어가 명령입니다. 같은 게임 서버가 여럿이면 인스턴스 이름이나 서버별 별명으로 불러야 함 |
| 페어링 코드 만료 | TTL 5분 초과. 앱에서 새 코드 받기 |
| 앱이 계속 "기다리는 중" | 디스코드에서 /사바쨩 연결 슬래시 명령이 실제로 실행됐는지, 서버 관리 권한이 있는지 확인 |
| 디스코드 명령이 PC에 닿지 않음 | 다른 곳에서 페어링할 때 다시 연결로 이 PC를 고르면 이 PC의 예전 연결은 끊어집니다. 이 PC에서 다시 페어링 |
더 구체적인 장애 해결 흐름은 문제 해결 문서를 참고하세요.