본문으로 건너뛰기

문서

Garita 시작하기.

첫걸음, 모듈마다 요청하는 권한, 쓸 수 있는 명령어를 정리했어요. 권한 표는 코드 안의 모듈 등록부에서 바로 만들어져요.

시작하기

  1. 이용 권한 받기

    “Discord에 추가”를 누르고 서버를 고르세요. Discord가 요청하는 권한을 보여 줄 거예요.

    Discord에 추가 (새 탭에서 열려요)
  2. Garita 역할 위치 정하기

    서버 설정 → 역할에서 Garita의 역할을, Garita가 관리해야 하는 역할들보다 위로 올려 주세요. Discord에서는 봇이 자기보다 높은 역할에 아무것도 할 수 없어요.

  3. 대시보드 열기

    Discord 계정으로 로그인하고 설정할 서버를 고르세요.

  4. 필요한 것만 켜기

    모듈을 켜기 전에 빠진 권한이 무엇인지 알려 줘요. 보안부터 시작해 보세요.

  5. 관찰 모드로 시작하기

    허니팟은 처벌 없이 기록만 하면서 시작해요. 기록된 내용을 확인한 뒤 /honeypot enable 명령어로 켜세요.

모듈별 권한과 인텐트

모듈마다 동작하는 데 필요한 봇 권한과, 귀 기울여 듣는 게이트웨이 이벤트(인텐트)예요. Garita는 모듈을 켜기 전과 모든 동작 전에 권한을 확인해요.

특수 권한으로 표시된 인텐트(멤버, 메시지 내용)는 개발자 포털에서 켜야 하고, 서버가 100개를 넘으면 Discord의 승인이 필요해요.

모듈별 권한과 인텐트 (모듈 등록부에서 자동 생성)
모듈봇 권한인텐트
보안
허니팟
  • 채널 보기
  • 메시지 보내기
  • 링크 첨부
  • 파일 첨부
  • 멤버 차단하기
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 차단과 감사 로그GuildModeration
레이드 방어
  • 역할 관리하기
  • 채널 관리하기
  • 멤버 추방하기
  • 멤버 타임아웃하기
  • 서버 관리하기
  • 서버, 채널, 역할Guilds
  • 멤버GuildMembers특수 권한
  • 서버 메시지GuildMessages
누크 방어
  • 감사 로그 보기
  • 역할 관리하기
  • 채널 관리하기
  • 서버, 채널, 역할Guilds
  • 차단과 감사 로그GuildModeration
인증
  • 역할 관리하기
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
  • 멤버GuildMembers특수 권한
관리
자동 관리
  • 메시지 관리하기
  • 멤버 타임아웃하기
  • 서버 관리하기
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 메시지 내용MessageContent특수 권한
  • AutoMod 실행AutoModerationExecution
관리
  • 멤버 추방하기
  • 멤버 차단하기
  • 멤버 타임아웃하기
  • 메시지 관리하기
  • 메시지 기록 보기
  • 서버, 채널, 역할Guilds
  • 차단과 감사 로그GuildModeration
로그
  • 채널 보기
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
  • 차단과 감사 로그GuildModeration
  • 서버 메시지GuildMessages
  • 음성 상태GuildVoiceStates
커뮤니티
환영 인사
  • 채널 보기
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
  • 멤버GuildMembers특수 권한
역할과 온보딩
  • 역할 관리하기
  • 메시지 보내기
  • 서버, 채널, 역할Guilds
  • 멤버GuildMembers특수 권한
  • 반응GuildMessageReactions
초대 추적기
  • 서버 관리하기
  • 서버, 채널, 역할Guilds
  • 초대GuildInvites
  • 멤버GuildMembers특수 권한
화이트리스트 시험
  • 역할 관리하기
  • 메시지 보내기
  • 링크 첨부
  • 비공개 스레드 만들기
  • 스레드에서 메시지 보내기
  • 스레드 관리하기
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 메시지 내용MessageContent특수 권한
서버 수익화
  • 역할 관리하기
  • 서버, 채널, 역할Guilds
  • 멤버GuildMembers특수 권한
참여
레벨
  • 역할 관리하기
  • 메시지 보내기
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 음성 상태GuildVoiceStates
가상 경제
  • 역할 관리하기
  • 메시지 보내기
  • 서버, 채널, 역할Guilds
경품 추첨
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
투표
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
이벤트와 알림
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
생일
  • 메시지 보내기
  • 역할 관리하기
  • 서버, 채널, 역할Guilds
스타보드
  • 메시지 보내기
  • 링크 첨부
  • 메시지 기록 보기
  • 서버, 채널, 역할Guilds
  • 반응GuildMessageReactions
업적
  • 메시지 보내기
  • 역할 관리하기
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 음성 상태GuildVoiceStates
  • 멤버GuildMembers특수 권한
  • 반응GuildMessageReactions
게임
  • 메시지 보내기
  • 링크 첨부
  • 파일 첨부
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
음악
  • 채널 보기
  • 메시지 보내기
  • 링크 첨부
  • 연결
  • 말하기
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 음성 상태GuildVoiceStates
음성 효과
  • 채널 보기
  • 메시지 보내기
  • 링크 첨부
  • 연결
  • 말하기
  • 서버, 채널, 역할Guilds
  • 음성 상태GuildVoiceStates
지원
티켓과 이의 신청
  • 채널 관리하기
  • 역할 관리하기
  • 메시지 보내기
  • 링크 첨부
  • 메시지 기록 보기
  • 파일 첨부
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
  • 메시지 내용MessageContent특수 권한
소셜 알림
소셜 알림
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
시세
  • 채널 보기
  • 메시지 보내기
  • 링크 첨부
  • 파일 첨부
  • 서버, 채널, 역할Guilds
유틸리티
임시 음성 채널
  • 채널 관리하기
  • 멤버 이동
  • 연결
  • 서버, 채널, 역할Guilds
  • 음성 상태GuildVoiceStates
자동화
  • 역할 관리하기
  • 메시지 보내기
  • 서버, 채널, 역할Guilds
사용자 지정 명령어
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
  • 서버 메시지GuildMessages
임베드 빌더
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
통계 채널
  • 채널 관리하기
  • 채널 보기
  • 연결
  • 서버, 채널, 역할Guilds
이모지
  • 표현 만들기
  • 표현 관리하기
  • 서버, 채널, 역할Guilds
검색
  • 메시지 보내기
  • 링크 첨부
  • 서버, 채널, 역할Guilds
녹음
  • 채널 보기
  • 연결
  • 메시지 보내기
  • 링크 첨부
  • 별명 변경하기
  • 서버, 채널, 역할Guilds
  • 음성 상태GuildVoiceStates
플랫폼
통계추가 권한 없음
  • 서버, 채널, 역할Guilds
백업
  • 역할 관리하기
  • 채널 관리하기
  • 서버, 채널, 역할Guilds
봇 꾸미기
  • 별명 변경하기
  • 파일 첨부
  • 서버, 채널, 역할Guilds

명령어

지금 코드에서 쓸 수 있는 슬래시 명령어예요. 다른 모듈은 준비가 되면 각자 명령어를 정리해 둘게요.

명령어
명령어하는 일쓸 수 있는 사람
/help도움말과 유용한 링크.모두
/ping봇의 응답 속도와 상태.모두
/honeypot setup함정 채널, 조치, 메시지 삭제 범위 설정 (관찰 모드로 시작).권한이 있는 운영진
/honeypot publish경고문을 올리거나 다시 올려요.권한이 있는 운영진
/honeypot enable처벌 모드나 관찰 모드로 함정을 켜요. 한 번 더 확인해요.권한이 있는 운영진
/honeypot status설정과 숫자 확인.권한이 있는 운영진
/honeypot disable함정을 꺼요 (진행 중인 소프트밴은 끝까지 처리해요).권한이 있는 운영진

Discord 앱이 스페인어로 설정되어 있으면 명령어가 /ayuda, /honeypot configurar, publicar, activar, estado, desactivar로 보여요.