SOPIAv3SOPIAv3

명령어 꾸미기

채팅 명령어의 출력 형식을 자유롭게 커스터마이징하세요

명령어 꾸미기

채팅 명령어의 출력 형식을 자유롭게 커스터마이징하여 방송 스타일에 맞는 고유한 명령어를 만들 수 있습니다.

모든 명령어는 변수를 사용하여 동적인 정보를 표시할 수 있습니다.

주요 기능

지원되는 명령어

21개의 채팅 명령어를 커스터마이징할 수 있습니다.

애청지수

  • !내정보 - 본인 정보 조회
  • !내정보 생성 - 프로필 생성
  • !내정보 삭제 - 프로필 삭제
  • !상점 - 점수 증가
  • !감점 - 점수 감소
  • !랭크 - 순위 조회

룰렛

  • !룰렛 - 룰렛 목록 및 실행
  • !룰렛 목록 - 룰렛 아이템 목록
  • !룰렛 실행 - 룰렛 실행
  • !룰렛 전체 - 모든 룰렛 실행
  • !룰렛 자동 - 자동 룰렛 실행
  • !킵 - 킵 아이템 목록
  • !사용 - 킵 아이템 사용

복권

  • !복권 - 복권 실행
  • !복권 자동 - 자동 복권 실행
  • !복권지급 전체 - 전체 지급
  • !복권지급 - 개별 지급
  • !복권양도 - 복권 양도

사용자 & 실드

  • !고유닉 - 고유닉 조회
  • !실드 - 실드 조회
  • !실드 변경 - 실드 증감 (관리자)

핵심 기능

  • 실시간 편집 - 각 명령어의 템플릿을 실시간으로 수정
  • 🎨 변수 시스템 - 동적 정보를 표시할 수 있는 변수 제공
  • 👁️ 미리보기 - 실제 출력 결과를 미리 확인
  • 💾 즉시 적용 - 저장 시 바로 반영 (재시작 불필요)
  • 🔄 기본값 복원 - 언제든지 초기 상태로 되돌리기

시작하기

페이지 접근

좌측 사이드바에서 "명령어 꾸미기" 메뉴를 클릭합니다.

명령어 꾸미기 메뉴

명령어 선택

왼쪽 목록에서 수정하고 싶은 명령어를 선택합니다.

명령어 목록

템플릿 수정

우측 편집 영역에서 템플릿을 자유롭게 수정합니다.

템플릿 편집

에디터 하단의 변수 버튼을 클릭하면 커서 위치에 변수가 삽입됩니다.

미리보기 및 저장

미리보기 버튼으로 결과를 확인하고, 저장 버튼으로 변경사항을 저장합니다.

미리보기

변수 사용하기

공통 변수

모든 명령어에서 사용 가능한 기본 변수입니다.

변수설명
{nickname}사용자 닉네임
{tag}사용자 고유닉

변수는 중괄호 {} 안에 변수명을 입력하여 사용합니다. 예: {nickname}

명령어별 전용 변수

각 명령어마다 사용 가능한 고유 변수가 있습니다. 편집기에서 변수 버튼에 마우스를 올리면 설명을 확인할 수 있습니다.

애청지수 관련 변수

  • {rank} - 순위
  • {score} - 애청지수 (경험치)
  • {level} - 레벨 (예: 5.23)
  • {chat_count} - 채팅 횟수
  • {like_count} - 좋아요 횟수
  • {spoon_count} - 스푼 개수
  • {roulette_tickets} - 룰렛 티켓 수
  • {lottery_tickets} - 복권 티켓 수

룰렛 관련 변수

  • {template_index} - 템플릿 번호
  • {template_name} - 템플릿 이름
  • {template_id} - 템플릿 ID
  • {template_description} - 템플릿 설명
  • {item_index} - 아이템 번호
  • {item_label} - 아이템 이름
  • {item_count} - 아이템 개수
  • {total_spins} - 총 실행 횟수

복권 관련 변수

  • {user_numbers} - 선택한 숫자
  • {winning_numbers} - 당첨 숫자
  • {matched_count} - 맞춘 개수
  • {reward} - 보상 점수
  • {total_played} - 실행한 복권 수
  • {total_reward} - 총 보상 점수
  • {my_tickets} - 내 보유 티켓 수

실드 관련 변수

  • {shield_count} - 실드 개수
  • {change} - 변경량 (절댓값)
  • {action} - 동작 (증가/감소)

템플릿 구조

명령어의 복잡도에 따라 다양한 템플릿 구조를 제공합니다.

단일 템플릿

간단한 메시지 하나로 구성된 명령어입니다.

📋 편집 가능한 필드
└─ template (기본 출력 메시지)

예시 명령어: !실드, !고유닉

다중 메시지 템플릿

성공/실패 등 여러 상황에 대한 메시지를 각각 설정할 수 있습니다.

📋 편집 가능한 필드
├─ success (성공 메시지)
├─ error_already_exists (이미 존재하는 경우)
├─ error_not_found (찾을 수 없는 경우)
└─ error_failed (실패한 경우)

예시 명령어: !내정보 생성, !상점, !감점

리스트 구조 템플릿

헤더와 반복되는 아이템으로 구성됩니다.

📋 편집 가능한 필드
├─ header (헤더 메시지)
└─ item (반복되는 아이템 템플릿)

예시 명령어: !룰렛 자동, !킵

미리보기 기능은 헤더와 아이템을 합쳐서 보여줍니다. 아이템은 3개씩 반복되어 표시됩니다.

스타일 예시

다양한 스타일로 명령어를 꾸며보세요.

{nickname}님 정보
레벨 {level} | 순위 {rank}위
채팅 {chat_count}회 | 하트 {like_count}회
✨━━━━━━━━━━━━━━━━━✨
👤 {nickname}님의 프로필
✨━━━━━━━━━━━━━━━━━✨

🏆 랭킹: {rank}위
⭐ 레벨: {level}
💬 채팅: {chat_count}회
❤️ 하트: {like_count}회

✨━━━━━━━━━━━━━━━━━✨
{nickname} | Lv.{level} | {rank}위
🎮 {nickname}님은 레벨 {level}!
━━━━━━━━━━━━━━━
📊 순위: {rank}위
💭 채팅 {chat_count}회로 {like_count}❤️를 받았어요!

변수 삽입

  1. 에디터에서 원하는 위치에 커서를 놓습니다
  2. 하단의 변수 버튼을 클릭합니다
  3. 변수가 커서 위치에 자동으로 삽입됩니다

변수 버튼에 마우스를 올리면 툴팁으로 변수의 설명을 확인할 수 있습니다.

미리보기

각 필드마다 미리보기 버튼이 제공됩니다.

  • 단일 필드: 해당 필드만 미리보기
  • 리스트 구조: 헤더 + 아이템 3개가 합쳐진 형태로 미리보기

미리보기는 샘플 데이터로 표시됩니다. 실제 값과 다를 수 있습니다.

문제 해결

변수가 치환되지 않아요

  • 변수 이름의 철자를 확인하세요 (예: {nickname})
  • 중괄호 {}가 정확히 입력되었는지 확인하세요
  • 해당 명령어에서 지원하는 변수인지 확인하세요

편집기 하단의 변수 목록을 참고하면 사용 가능한 변수를 확인할 수 있습니다.

개행이 안 돼요

  • \n을 직접 입력하지 마세요
  • Enter 키로 개행을 입력하면 자동으로 처리됩니다

🎉 명령어 꾸미기로 청취자들에게 더 나은 경험을 제공하세요!