🤖 SSNYD — 섹시노예들 디스코드 봇

학교 생활을 더 편하고 재미있게 만들어주는 GSM 디스코드 봇

---

📖 소개

SSNYD는 GSM 디스코드 서버를 위해 만들어진 다목적 봇입니다.
급식·시간표·학사일정 같은 학교 정보 조회부터, 가상 화폐 경제 시스템, 카지노 미니게임, 음악 추천, 날씨/미세먼지까지 — 학교생활에 필요한 모든 것을 하나의 봇으로 해결합니다.

---

✨ 주요 기능

카테고리	설명
🍱 급식	NEIS API를 통해 오늘/내일 아침·점심·저녁 메뉴 및 칼로리 조회
📅 시간표	학년·반별 시간표 자동 조회 (서버 역할 기반 자동 인식)
📆 학사일정	당월 및 특정 월의 학교 행사·일정 조회
💰 경제	출석 보상, 노동, 잔액 확인, 송금, 지원금, 랭킹 등 서버별 독립 경제 시스템
🎰 도박	코인플립·블랙잭·바카라·룰렛 — 디스코드 버튼 기반 인터랙티브 미니게임
🎵 음악	Spotify API 연동 노래 추천 (장르별) 및 아티스트/곡 검색
🌤️ 날씨	KMA·에어코리아 API 기반 현재 기온, 체감온도, 미세먼지(PM10) 표시
⏰ 알림	특정 채널에 원하는 시간마다 메시지를 자동 전송하는 스케줄러
📊 상태	봇 업타임, 핑, 메모리, DB·NEIS API 연결 상태 실시간 확인

---

🗂️ 프로젝트 구조

SSNYD/
├── index.js              # 봇 진입점 — 이벤트 라우팅
├── db.js                 # MariaDB 커넥션 풀 관리
├── utils.js              # KST 시간, NEIS API 상수
├── webhook.js            # 봇 시작/종료 웹훅 알림
│
├── meal/                 # 급식 조회
├── timetable/            # 시간표 조회
├── academic/             # 학사일정 조회
├── casino/               # 경제 시스템 + 카지노 게임
│   ├── economy.js        #   출석, 노동, 잔액, 송금, 랭킹
│   └── games/            #   코인플립, 블랙잭, 바카라, 룰렛
├── music/                # 음악 추천 (Spotify API)
├── weather/              # 날씨·미세먼지 (KMA, AirKorea)
├── scheduler/            # 자동 메시지 스케줄러
└── status/               # 봇 상태 확인

---

📋 전체 명령어 목록

🍱 급식

명령어	설명
!밥 / !급식	오늘 급식 전체 (아침·점심·저녁)
!아침 / !오늘아침	오늘 아침 메뉴
!점심 / !오늘점심	오늘 점심 메뉴
!저녁 / !오늘저녁	오늘 저녁 메뉴
!내일아침 / !내일점심 / !내일저녁	내일 각 끼니 메뉴

📅 시간표

명령어	설명
!시간표 / !ㅅㄱㅍ	내 시간표 (서버 역할에서 학년·반 자동 인식)
!시간표 2-3	특정 학년·반 시간표

📆 학사일정

명령어	설명
!학사일정	이번 달 학교 행사·일정
!학사일정 3월	특정 월 학사일정

💰 경제

명령어	설명
!출석	하루 1회 출석 체크 → +150,000원
!일 / !노동	1분 쿨다운 노동 → +10,000~30,000원
!잔액	현재 보유 잔액 확인
!지원금	잔액 0원일 때 1시간마다 +100,000원 지급
!송금 @유저 금액	다른 유저에게 송금
!랭킹	서버 내 잔액 TOP 10 랭킹

🎰 도박 (서버별 활성화 필요)

명령어	설명
!도박 on / !도박 off	도박 기능 활성화/비활성화 (관리자 전용)
!코인 [금액]	코인플립 — 앞/뒤 선택
!블랙잭 [금액]	블랙잭 — 히트/스탠드 버튼 인터랙션
!바카라 [금액]	바카라 — 플레이어/뱅커/타이 베팅
!룰렛 [금액]	룰렛 — 빨강/검정/홀수/짝수 베팅

💡 금액 입력 시 숫자 외에도 올인, 반 을 사용할 수 있습니다.

🎵 음악

명령어	설명
!노추 / !노래 / !오노추	랜덤 노래 추천
!노추 [장르]	장르별 추천 (케이팝, 팝, 제이팝, 밴드, 힙합, 알앤비, 인디 등)
!가수 [검색어]	아티스트/곡 이름으로 검색

🌤️ 날씨

명령어	설명
!날씨 / !ㄴㅆ	현재 기온, 체감온도, 날씨 상태, 미세먼지(PM10) 표시

⏰ 알림 스케줄러

명령어	설명
!보내기	자동 메시지 설정 마법사 시작
!알림목록	현재 서버에 등록된 자동 메시지 목록 확인
!알림삭제 [번호]	특정 자동 메시지 삭제
!알림삭제전체	서버의 자동 메시지 전체 삭제
!보내기취소	설정 마법사 취소

📊 기타

명령어	설명
!상태	봇 업타임, 핑, 메모리 사용량, DB·NEIS 연결 상태
!명령어	명령어 전체 목록 보기

---

🛠️ 기술 스택

• 런타임: Node.js ≥ 18.0.0
• 디스코드 라이브러리: discord.js v14
• 데이터베이스: MariaDB (커넥션 풀)
• 외부 API:
  • 🏫 NEIS API — 급식, 시간표, 학사일정
  • 🎵 Spotify Web API — 음악 추천 및 검색
  • 🌤️ 기상청 KMA API — 날씨 정보
  • 💨 에어코리아 API — 미세먼지 정보
• 코드 품질: ESLint + Prettier

---

🚀 봇 초대

아래 링크로 서버에 바로 초대할 수 있습니다.

👉 SSNYD 봇 초대하기