커스텀 봇 | Noxyr 문서

커스텀 봇이란

커스텀 봇은 내가 소유한 봇 토큰으로 실행되는 Noxyr예요. 멤버에게는 내 이름과 아바타가 보이지만, 코드, 설정, 데이터베이스는 모두 Noxyr의 것이에요. 대시보드에서 바꾼 내용은 두 봇에 모두 적용되고, 아무것도 중복으로 만들어지지 않아요.

Noxyr가 자체 노드 중 하나에서 호스팅해 줘요. 각 서버는 정확히 하나의 봇이 담당해요. 커스텀 봇이 있는 서버에서는 Noxyr가 물러나 응답을 멈추고, 없는 서버에서는 평소처럼 응답해요. Discord 계정 하나당 커스텀 봇 하나를 만들 수 있고, 같은 봇을 내가 관리하는 여러 서버에서 사용할 수 있어요.

필요한 것

Top.gg 투표 1회: Noxyr에 투표하면 설정 양식이 12시간 동안 열려요. 이것이 전부예요. 유료 요금제는 없어요.
나만의 애플리케이션: Discord Developer Portal에서 만들어 주세요. Noxyr의 토큰과 사용자 토큰은 받아들이지 않아요.
특권 인텐트 2개: Bot → Privileged Gateway Intents에서 Server Members Intent와 Message Content Intent를 모두 켜 주세요. 대시보드는 토큰을 받기 전에 이것을 확인해요.
서버에 Noxyr가 있어야 해요: 커스텀 봇은 Noxyr의 설정과 데이터베이스를 사용하므로, 커스텀 봇이 서비스하는 모든 서버에 Noxyr가 남아 있어야 해요.
관리자: 대시보드에서 서버를 열 수 있는 사람만 해당 서버의 커스텀 봇을 설정할 수 있어요.

설정 방법

Top.gg에서 Noxyr에 투표한 뒤, 서버 대시보드에서 Custom Bot을 열어 주세요.
Developer Portal에서 새 애플리케이션을 누르고 봇이 쓸 이름을 입력해 주세요. Bot 탭에서 아바타를 설정하고 특권 인텐트 두 개를 모두 켜 주세요.
토큰 재설정(Reset Token)을 누르고 토큰을 한 번 복사해서 커스텀 봇 페이지에 붙여 넣어 주세요. 토큰은 암호화되어 저장되며, 웹사이트와 내 봇을 실행하는 노드만 읽을 수 있어요.
호스트를 고르세요(자동 선택은 여유 있는 가장 빠른 노드를 골라요). 그다음 “Start my bot하기”를 누르세요.
페이지에 나오는 초대 링크를 사용해 주세요. 약 20초 뒤 봇이 온라인이 되고, Noxyr 명령어를 봇 자신의 이름으로 등록해요.

토큰을 붙여 넣은 사람만 나중에 토큰을 교체할 수 있어요. 서버의 다른 관리자는 봇을 볼 수 있지만, 내 이름으로 다른 토큰을 넣을 수는 없어요.

투표 기간, 유예 기간, 알림

투표 1회로 커스텀 봇이 12시간 동안 잠금 해제돼요. Top.gg에서 투표할 수 있는 주기도 12시간이에요. 이 기간이 끝나면 74시간의 유예 기간이 시작돼요. 이 동안에도 봇은 계속 실행되지만, 다시 투표하기 전까지 Custom Bot 페이지는 잠겨요.

마지막 투표 24시간 뒤(유예 기간 12시간 차)에 알림 DM이 도착하며, 중단 시점까지 남은 시간을 알려 줘요. 유예 기간까지 끝나면 봇이 오프라인이 되고 서버에서 명령어가 제거돼요. 아무것도 삭제되지 않아요. 토큰, 설정, 모든 티켓·상품·인보이스는 그대로 남아 있고, 투표 한 번이면 모두 다시 켜져요.

투표 기간: 투표 후 12시간. 두 개의 타이머가 Custom Bot 페이지에서 실시간으로 줄어들어요.
유예 기간: 투표 기간이 끝난 뒤 74시간. 봇은 켜져 있고 대시보드는 잠겨요.
알림 DM: 기간마다 한 번, 투표 24시간 뒤에 보내요.
꺼짐: 유예 기간이 끝난 뒤예요. 다시 투표하면 봇이 자동으로 재시작돼요.

투표 없이 시간 늘리기

커스텀 봇을 계속 실행하는 방법은 투표만 있는 것이 아니에요. 아래 각 옵션은 남은 시간 위에 추가 시간을 더해 주므로 낭비되는 시간이 없어요. 시간 얻기 페이지(커스텀 봇 → Get more time)에서 카운트다운, 각 옵션의 진행 상황, 지금까지 적립된 모든 시간을 확인할 수 있어요.

Noxyr Rush: 웹사이트의 브라우저 미니 게임이에요. 한 번의 게임에서 3,000점을 얻으면 12시간을 받아요. 게임 시간은 한 번에 최대 12시간까지 보유할 수 있고, 모두 사용하면 다시 얻을 수 있어요. 커스텀 봇을 운영하는 계정만 시간을 얻을 수 있으며, 모든 플레이는 서버에서 검증돼요.
친구 초대하기: 시간 얻기 페이지에서 추천 링크를 공유하세요. 친구가 첫 커스텀 봇을 설정하면 두 사람 모두 12시간을 받아요. 친구 한 명당 한 번만 적용되고, 친구의 Discord 계정이 생성된 지 30일 이상이어야 해요. 30일마다 최대 10명의 친구에게서 보상을 받을 수 있어요.
버그 제보와 제안: Support Center를 통해 제출해 주세요. Noxyr 팀이 승인하면 제보 1건당 12시간을 받아요.
팀에서 주는 시간: Noxyr 팀은 장애가 있었던 경우 등에 직접 시간을 추가해 줄 수 있어요.

Noxyr가 서버에서 제거된 경우

커스텀 봇은 Noxyr가 서버에 있어야 동작하므로, Noxyr를 내보내면 1분 안팎에 그 서버의 커스텀 봇이 멈춰요. 봇은 Noxyr를 내보낸 사람에게 DM을 보내고, 그 사람이 봇 소유자와 다르면 소유자에게도 초대 링크와 함께 DM을 보내요.

Noxyr를 다시 초대하면 커스텀 봇이 자동으로 다시 시작돼요. 이 이유로 멈춘 동안에는 다른 봇이 아직 실행 중이 아닌 한 투표 기간이 소모되지 않고 일시 정지돼요.

투표 기간을 다른 사람에게 넘기기

투표하는 사람과 봇의 주인이 같은 계정일 필요는 없어요. Custom Bot 페이지에서 남은 투표 기간을 다른 Discord 사용자의 사용자 ID로 넘길 수 있어요. 전부 넘기거나 원하는 시간만큼 넘길 수 있어요.

넘겨받은 시간은 그 사람이 이미 가진 시간 위에 더해지므로, 양도 때문에 손해를 보는 일은 없어요. 내 유예 기간은 그대로 남아서 내 봇이 중간에 멈추지 않아요. 두 사람 모두 무엇이 얼마나 옮겨졌는지 알려 주는 DM을 받아요.

활성 투표 기간만 넘길 수 있어요. 유예 기간에 들어가면 넘길 시간이 남아 있지 않아요. 5분 미만의 양도는 거부돼요.

문제 해결

"Discord가 이 토큰을 거부했어요" (게이트웨이 코드 4004): Developer Portal에서 토큰이 재설정되어 이전 토큰은 더 이상 쓸 수 없어요. 봇은 Custom Bot 페이지에서 토큰 재설정을 다시 누르고 새 토큰을 붙여 넣기 전까지 꺼져 있어요.
"Discord가 연결을 거부했어요" (게이트웨이 코드 4013 / 4014): 설정 후에 특권 인텐트가 꺼졌어요. Server Members Intent와 Message Content Intent를 다시 켠 뒤, 대시보드에서 봇을 다시 켜 주세요.
"Top.gg에서 먼저 투표하세요": 투표 기간이 끝났어요. 투표한 뒤 다시 시도해 주세요. 투표하면 페이지가 바로 잠금 해제돼요.
"그 봇은 이미 다른 사람 서버의 커스텀 봇이에요": 애플리케이션 하나는 소유자 한 명에게만 속할 수 있어요. 나를 위한 새 애플리케이션을 만들어 주세요.
"이미 … 실행 중이에요": 계정당 커스텀 봇은 하나예요. 이 서버에서도 기존 봇을 쓰거나(페이지에서 제안해요), 먼저 삭제해 주세요.
Change Node 버튼이 비활성화되어 있어요: 노드를 옮길 때마다 Discord에 새로 로그인해야 해서, 노드를 옮긴 뒤 5분 동안은 다시 옮길 수 없어요.
상태에 "suspended"가 표시돼요: 투표 기간과 유예 기간이 모두 끝났거나, Noxyr가 서버에서 제거되었어요. 페이지의 상태 메시지에 어떤 이유인지 나와요.