Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Metamong-bot

데일리 스크럼 디스코드 봇. 서버(길드)마다 알림 전용 또는 스레드 생성 모드로 동작합니다.

설치

npm install

환경변수 설정

.env.example을 복사해 .env를 만들고 봇 토큰을 채워 넣습니다.

cp .env.example .env
DISCORD_TOKEN=여기에_봇_토큰_입력

config.json 설정

config.json의 GUILD_A_ID, CHANNEL_A_ID, GUILD_B_ID, CHANNEL_B_ID, ROLE_9GI_ID, ROLE_10GI_ID를 실제 길드/채널/역할 ID로 교체합니다.

{
  "timezone": "Asia/Seoul",
  "guilds": {
    "실제_길드_A_ID": { "mode": "notify", "channelId": "실제_채널_A_ID", "cron": "0 9 * * *", "mentionRoleIds": ["실제_10기_역할_ID"] },
    "실제_길드_B_ID": { "mode": "thread", "channelId": "실제_채널_B_ID", "cron": "0 9 * * *", "mentionRoleIds": ["실제_9기_역할_ID", "실제_10기_역할_ID"] }
  }
}
  • mode: "notify" — 지정 채널에 todo/did 템플릿 메시지만 전송합니다.
  • mode: "thread" — 지정 채널(텍스트 또는 포럼)에 새 스레드/포스트를 만들고 템플릿을 첫 메시지로 게시합니다.
  • cron은 길드별로 다르게 설정할 수 있으며, 기본값은 매일 오전 9시(0 9 * * *)입니다. 평일에만 보내고 싶다면 0 9 * * 1-5로 바꾸면 됩니다.
  • mentionRoleIds는 메시지 맨 위에서 태그할 역할 ID 배열입니다. 여러 개를 넣으면 모두 태그됩니다.

길드/채널/역할 ID 구하는 법

  1. 디스코드 설정 → 고급(앱 설정) → 개발자 모드를 켭니다.
  2. 서버 아이콘/채널/역할을 우클릭하면 각각 ID 복사가 나타납니다.
    • 역할 ID: 서버 설정 → 역할에서 해당 역할을 우클릭 → ID 복사 (또는 멤버 목록에서 역할 뱃지를 우클릭)

역할 멘션 관련 주의사항

  • 봇은 메시지 전송 시 allowedMentions: { roles: mentionRoleIds }를 명시적으로 지정합니다. 이 옵션이 없으면 <@&ROLE_ID> 텍스트가 있어도 실제 알림 없이 회색 텍스트로만 보일 수 있습니다.
  • 태그하려는 역할이 서버 설정에서 "@모든 멤버가 멘션 가능"으로 켜져 있지 않다면, 봇 계정에 "Mention @everyone, @here, and All Roles" 권한이 있어야 태그가 정상적으로 알림까지 갑니다. 해당 권한이 없으면 멘션 텍스트는 표시되지만 알림이 가지 않을 수 있습니다.

필요한 봇 권한

  • View Channels
  • Send Messages
  • Create Public Threads
  • Send Messages in Threads
  • Manage Threads
  • Mention @everyone, @here, and All Roles (역할이 서버에서 "누구나 멘션 가능"으로 설정되어 있다면 생략 가능)

로컬 실행

node index.js

정상적으로 로그인되면 콘솔에 [로그인 성공] 로그가 출력됩니다.

주의: 봇은 시작될 때마다(로그인 직후) cron 스케줄 등록과 별개로 등록된 모든 길드에 데일리 스크럼을 즉시 1회 자동 발송합니다([시작 시 즉시 발송] 로그). pm2의 autorestart로 인해 프로세스가 크래시 후 재시작되면 그때마다 다시 발송되니, 배포 환경에서 반복 재시작이 잦다면 알림/스레드가 중복 생성될 수 있습니다.

즉시 실행 테스트 (test-trigger.js)

cron 스케줄을 기다리지 않고 notify/thread 동작을 바로 테스트하고 싶을 때 사용합니다. config.json을 조회하지 않고 커맨드라인 인자 값 그대로 즉시 동작합니다.

node test-trigger.js <guildId> <channelId> <mode> [mentionRoleIds]
  • guildId: 로그 출력용 길드 ID (실제 동작에는 채널 ID만 사용됨)
  • channelId: 메시지를 보내거나 스레드를 생성할 채널 ID
  • mode: notify 또는 thread
  • mentionRoleIds: 태그할 역할 ID를 콤마로 구분해 나열 (생략 가능)

예시:

# notify 모드 테스트 (10기 태그)
node test-trigger.js 123456789 111111111 notify 999999999

# thread 모드 테스트 (9기, 10기 모두 태그, 역할 태그 없이도 가능)
node test-trigger.js 123456789 222222222 thread 888888888,999999999
node test-trigger.js 123456789 222222222 thread

서버 하나 안에 텍스트 채널과 포럼 채널을 각각 만들어 채널 ID만 바꿔가며 notify/thread 두 모드를 독립적으로 테스트할 수 있습니다.

pm2로 상시 실행 (배포)

pm2 start ecosystem.config.js

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages