위키 / Core Features / 커스텀 명령어

커스텀 명령어

업데이트한 사람 Maxime_48 · 2시간 전 · 조회수: 104

언어: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

커스텀 명령어를 쓰면 서버에서 쓸 나만의 슬래시 명령어를 만들 수 있어요. 멤버가 /yourcommand를 실행하면 봇이 여러분이 정의한 메시지나 임베드로 답해요. 코딩은 필요 없고, 모든 것은 웹 대시보드에서 관리해요.

텍스트 응답과 임베드 응답 두 개의 명령어, 그리고 각각의 쿨다운과 역할 제한이 보이는 커스텀 명령어 페이지


⚡ 작동 방식

  1. 서버에서 커스텀 명령어 기능을 켭니다.
  2. 전용 커스텀 명령어 페이지를 엽니다.
  3. 새 명령어를 클릭하고, 이름을 정하고 응답을 작성합니다.
  4. 저장하면 명령어가 서버에 자동으로 등록돼요.

멤버는 잠시 후부터 사용할 수 있어요. 명령어를 추가, 편집, 삭제할 때마다 YAWBDB가 서버의 명령어를 대신 다시 등록해 줘요.

/rules보다 !rules가 편한가요? 기능 → 텍스트 명령어에서 텍스트 접두사를 설정하면, 이 페이지의 모든 명령어가 간단한 응답이든 그래프 모드든 그 접두사로도 응답해요. 자세한 내용과 접두사로 쓸 수 없는 목록은 텍스트 명령어와 접두사에서 확인하세요.


✍️ 명령어 만들기

각 명령어에는 다음이 있어요.

  • 명령어 이름 - 멤버가 슬래시 뒤에 입력하는 이름이에요(/rules, /socials 등). 영문 소문자, 숫자, -, _만 쓸 수 있고 최대 32자예요.
  • 설명 - Discord에서 명령어를 둘러볼 때 표시되는 짧은 문구예요.
  • 명령어 유형 - 간단한 응답(텍스트 또는 임베드이며 대부분의 경우를 충족해요) 또는 고급 그래프(시각적 노드 편집기이며 아래에서 설명해요)예요.
  • 응답 유형 - 간단한 명령어에서 일반 텍스트 메시지와 풍부한 임베드 중에서 골라요.

텍스트 응답

봇이 보낼 메시지를 적기만 하면 돼요. 빠른 답변, 링크, 서버 정보에 알맞아요.

임베드 응답

다음 요소로 서식이 있는 카드를 만들어요.

  • 제목과 설명
  • 색상(16진수, 예: #5865F2)
  • 이미지와 썸네일(URL)
  • 푸터 텍스트

임베드에는 제목이나 설명이 최소한 하나는 있어야 해요.


🧩 고급 모드: 명령어 그래프

명령어를 **고급 (그래프)**로 바꾸면 레벨링 보상 그래프와 같은 시각적 노드 편집기에서 동작을 설계할 수 있어요. 고정된 응답 대신 노드를 이어 붙여요.

  • 트리거 - 모든 그래프는 명령어 사용됨 트리거로 시작해요. 멤버가 명령어를 실행할 때마다 작동해요.
  • 조건 - 역할 보유 / 역할 미보유, 서버 부스터, 시간대, 요일, 서버 및 계정 나이, 레벨 범위, XP 범위, 연속 기록, 프레스티지.
  • 로직 - AND / OR / NOT 게이트, 랜덤 분기, 지연, 쿨다운, 순서.
  • 액션 - 답장(돌려보내는 메시지이며 필수예요), 역할 부여/제거/교체, XP 부여, DM 전송, 채널에 게시, 채널 잠금/해제, 칭호 부여, 임시 XP 배수.

답장 액션

명령어 그래프에는 답장 액션이 최소 하나 있어야 해요. 멤버에게 보이는 메시지가 바로 이거예요. 답장에는 동적 변수를 쓸 수 있어요. {username}, {level}, {xp}, {streak}, {prestige}, {server}예요. 어떤 실행에서 조건이 모든 답장을 걸러 내면, 봇은 그냥 ✓로 명령어를 확인해 줘요.

{prestige}는 프레스티지 보유 조건과 잘 어울려요. 프레스티지 등급에 따라 답장을 분기하고, 메시지에 그 등급의 이름을 넣어 보세요.

서로 다른 분기에 답장 액션을 여러 개 추가할 수도 있어요. 예를 들어 부스터에게는 다른 답변을 주거나, 여러 응답 중 하나를 무작위로 고를 수 있어요.

✨ 어시스턴트에게 맡기기

그래프 어시스턴트는 설명을 바탕으로 명령어 그래프 초안을 만들어서 검토할 수 있게 제안해 줘요.

ℹ️ 카드가 여기서 무엇을 할 수 있는지 확인하기

모든 카드에는 (i) 버튼이 있어서 카드가 무엇을 읽는지, 어떤 필드가 있으면 아무 동작도 하지 않게 되는지, 그리고 그 카드에서 쓸 수 있는 변수를 보여 줘요. 특히 명령어 그래프에서 열어 볼 만해요. 명령어는 레벨링 이벤트보다 가진 정보가 적기 때문이에요.

패널은 쓸 수 없는 것을 취소선으로 표시해서, 절대 작동하지 않는 그래프에서 뒤늦게 알게 되는 일 없이 한눈에 볼 수 있어요. 명령어는 멤버의 레벨, XP, 연속 기록, 프레스티지, 역할, 계정 나이, 서버 체류 기간을 알지만, 그 값들이 이전에 얼마였는지는 알지 못하고 XP 이벤트나 Wordle 맥락도 없어요. 그래서 XP 임계값 같이 변화를 기준으로 하는 카드는 여기서 비교할 대상이 없어요.

패널에 대한 전체 설명은 보상 그래프에서 확인하세요.

아이디어

  • /daily - 쿨다운 노드(24시간)를 거쳐 XP 부여 + 답장("Here's your daily bonus!")으로 이어져요. 쿨다운 중에는 보상 분기를 건너뛰고 봇이 ✓로만 확인해 줘요.
  • /color - 역할 조건을 확인한 뒤, 여러 색상 역할 중 하나를 무작위로 부여하고 답장으로 확인해 줘요.
  • /vip - 부스터 전용 분기에서 채널을 잠금 해제하고 비공개로 답해요.

그래프 편집기는 데스크톱 화면이 필요해요. 모바일에서는 읽기 전용 요약이 표시돼요.


⚙️ 옵션

옵션 하는 일
역할로 제한 선택한 역할 중 하나를 가진 멤버만 명령어를 사용할 수 있어요. 비워 두면 모두 사용할 수 있어요.
쿨다운 멤버별 사용 간 최소 대기 시간(초)이에요. 0은 쿨다운이 없다는 뜻이에요.
실행한 멤버에게만 응답 표시 응답이 명령어를 실행한 사람에게만 비공개로(일회성으로) 표시돼요.
활성화됨 삭제하지 않고 명령어를 켜거나 꺼요.

🚫 예약된 이름

커스텀 명령어는 봇의 기본 제공 명령어가 이미 쓰고 있는 이름(rank, leaderboard, report, ticket, wordle, voice 등)을 다시 쓸 수 없어요. 이름이 이미 사용 중이면 대시보드가 알려 줘요.

각 명령어 이름은 서버 안에서 고유해야 해요.


📦 제한

설정에 따라 서버당 커스텀 명령어 수가 제한될 수 있어요. 제한이 있는 경우 페이지에 현재 개수와 제한이 함께 표시돼요. Discord 자체도 서버당 명령어 총수에 상한이 있고, 이 상한은 봇의 기본 제공 명령어와 함께 계산돼요.


👍 권장 설정

  1. 기능을 켜고 커스텀 명령어 페이지를 엽니다.
  2. 처음에는 간단한 /rules나 /info 텍스트 명령어를 만들어 보세요.
  3. /socials처럼 좀 더 풍성한 내용에는 임베드 명령어를 추가하세요.
  4. 스태프 전용 명령어에는 역할로 제한을 쓰세요.
  5. 사람들이 남발할 수 있는 명령어에는 작은 쿨다운을 추가하세요.

💡 모범 사례

  • 멤버가 쉽게 짐작할 수 있도록 이름은 짧고 예측하기 쉽게 지으세요.
  • 요청한 사람만 볼 필요가 있는 답변에는 일회성 응답을 쓰세요.
  • 재미용이거나 시끄러운 명령어에는 쿨다운을 추가하세요.
  • 가끔만 필요한 명령어는 삭제하지 말고 비활성화하세요.