명령어 레퍼런스
만든 테이블마다 테이블 이름을 딴 슬래시 명령어가 생기고, 아래 하위 명령어를 쓸 수 있어요. <table> 부분은 테이블의 명령어 이름으로 바꿔 주세요. 예: /inventory
빠른 참조
/<table> add쓰기/<table> query읽기/<table> update쓰기/<table> delete관리/<table> view읽기/<table> leaderboard읽기/<table> saved-view읽기/<table> bulk-update관리/<table> bulk-delete관리/<table> add
쓰기새 행을 추가해요. 모든 테이블에는 테이블 이름을 딴 명령어가 생기고, 각 열은 옵션이 돼요. 필수 열이 먼저 나오며 반드시 입력해야 하고, 선택 열은 건너뛸 수 있어요.
구문
/<table> add <column>:<value> <column>:<value> ...
예시
/inventory add item:Diamond Sword quantity:3 rarity:Epic
- •명령어를 실행한 Discord 사용자가 행과 함께 저장돼요.
- •봇이 확인 메시지와 함께 저장된 값을 보여 줘요.
- •플랜마다 테이블당 행 한도가 있어요(Free는 100개). 테이블이 가득 차면 봇이 알려 줘요.
/<table> query
읽기테이블을 검색해요. 모든 열은 선택 필터이고, 전부 비워 두면 행 목록을 보여 줘요.
구문
/<table> query [<column>:<value> ...] [limit:<1-25>]
예시
/inventory query rarity:Epic limit:10
- •텍스트 열은 입력한 내용이 값에 포함되어 있으면 일치해요. 다른 열 유형은 정확히 일치해야 해요.
- •기본 10개, 최대 25개까지 결과를 보여 줘요.
/<table> update
쓰기기존 행을 변경해요. 자동 완성 목록에서 행을 고른 다음, 바꾸고 싶은 열만 입력해 주세요.
구문
/<table> update row:<row> <column>:<new_value> ...
예시
/inventory update row:Health Potion quantity:9
- •입력하지 않은 열은 현재 값이 그대로 유지돼요.
- •숫자 열이 있는 테이블에서는 _mode 옵션으로 숫자를 설정할지, 늘릴지, 줄일지 정해요.
/<table> delete
관리행 하나를 삭제해요. 봇이 먼저 버튼으로 확인을 요청해요.
구문
/<table> delete row:<row>
예시
/inventory delete row:Rope
- •삭제된 행은 테이블에서 바로 사라지고 30일 후 영구적으로 지워져요.
/<table> view
읽기행 하나의 모든 열을 임베드 하나에 보여 줘요.
구문
/<table> view row:<row>
예시
/inventory view row:Diamond Sword
- •행을 만든 사람, 만든 시각, 마지막으로 수정한 시각도 보여 줘요.
/<table> leaderboard
읽기숫자 열을 기준으로 높은 순서대로 행의 순위를 매겨요. 상위 3개에는 메달이 붙어요.
구문
/<table> leaderboard column:<number_column> [limit:<1-25>]
예시
/xp leaderboard column:XP limit:10
- •숫자 열이 하나 이상 있는 테이블에만 추가돼요.
- •기본 10위, 최대 25위까지 보여 줘요.
- •각 점수는 행의 첫 번째 텍스트 열 또는 멤버 열 옆에 표시돼요.
/<table> saved-view
읽기대시보드에서 이 테이블에 설정한 저장된 보기를 실행해요.
구문
/<table> saved-view name:<view> [limit:<1-25>]
예시
/inventory saved-view name:Epic items
- •저장된 보기가 하나 이상 있는 테이블에만 추가돼요.
/<table> bulk-update
관리다른 열이 특정 값과 일치하는 모든 행에서 열 하나를 변경해요. Pro와 Max 플랜 전용이에요.
구문
/<table> bulk-update filter:<column> value:<match> set-column:<column> set-value:<new_value>
예시
/inventory bulk-update filter:item value:Rope set-column:rarity set-value:Common
- •봇이 일치하는 행 수를 보여 주고, 변경하기 전에 확인을 요청해요.
/<table> bulk-delete
관리열이 특정 값과 일치하는 모든 행을 삭제해요. Pro와 Max 플랜 전용이에요.
구문
/<table> bulk-delete filter:<column> value:<match>
예시
/inventory bulk-delete filter:rarity value:Common
- •봇이 일치하는 행 수를 보여 주고, 삭제하기 전에 확인을 요청해요.
모든 명령어 공통 동작
- 나만 보이는 오류 — 권한 오류와 입력값 검증 실패는 명령어를 실행한 사용자에게만 보이는 메시지(임시 메시지)로 표시돼서 채널이 깔끔하게 유지돼요.
- 자동 완성 — 선택지 열은 옵션을 선택 목록으로 보여 줘요. 행 옵션과 저장된 보기 옵션은 입력하는 동안 일치하는 항목을 추천해요.
- 속도 제한 — 남용을 막기 위해 명령어는 사용자당 10초에 5번으로 제한돼요. 일반적인 사용량보다 훨씬 넉넉해요.
- 임베드 — 모든 응답은 깔끔하게 정리된 Discord 임베드로 표시돼요. 데이터는 명령어에 따라 표나 키-값 쌍으로 보여요.
- 권한 — 테이블에 역할을 지정하기 전까지는 모든 멤버가 그 테이블의 모든 명령어를 실행할 수 있어요. 역할을 지정하면 목록에 있는 역할을 가진 멤버만 테이블을 사용할 수 있어요. 읽기는 query, view, leaderboard, saved-view를, 쓰기는 여기에 add와 update를, 관리는 delete와 일괄 명령어를 추가로 허용해요. Discord 관리자는 언제나 모든 명령어를 실행할 수 있어요.
- 전역 명령어 —
/help는 서버의 테이블 목록을 보여 주고,/ping은 봇이 온라인인지 확인하며,/delete-my-data는 모든 서버에서 내가 만든 행을 삭제해요.