Discord 플러그인
Discord는 StarLight용 플러그인으로, 디스코드 챗봇 API의 이벤트를 수신 및 사용할 수 있게 합니다.
사용방법
- 플러그인 탭의 스토어에서 Discord 플러그인을 설치합니다.
- StarLight를 재시작합니다.
- Discord 플러그인의 초기 설정에 본인의 봇 토큰을 입력합니다. 봇 토큰은 디스코드 개발자 포털의 Bot > Token에서 복사할 수 있습니다. 초기 설정은 앱 시작 시 표시되며, 플러그인 탭의 Discord 플러그인 카드에서 다시 열 수 있습니다.
- 이벤트를 수신할 프로젝트의 설정에 들어가 받을 이벤트의 Discord 항목에서
onMessageCreate(event)를 선택합니다.
위 과정을 실행하면 해당 프로젝트의 onMessageCreate 함수가 디스코드 메시지 수신 시 호출됩니다.
주의
메시지의 내용을 수신하려면 디스코드 개발자 포털의 Bot > Privileged Gateway Intents에서 Message Content Intent를 활성화해야 합니다.
정보
NeonJS 프로젝트에서는 export function onMessageCreate(event) { }와 같이 함수를 export해야 호출됩니다.
Event 수신
본 플러그인은 내부적으로 JDA 라이브러리를 사용합니다. 따라서 onMessageCreate의 매개변수인 event는 JDA의 MessageReceivedEvent 객체입니다.
자세한 사항은 JDA의
Javadoc을
참고하세요. 스크립트에서 Discord.getApi()를 호출하면 플러그인이 사용하는 JDA의 JDA 객체를 얻을 수 있습니다.
카카오톡봇 이벤트로 수신
플러그인 설정의 이벤트 항목에서 아래 옵션을 활성화하면, 카카오톡봇과 같은 함수로 디스코드 메시지를 수신할 수 있습니다. 이 경우에도 프로젝트의 받을 이벤트에서 Discord 항목의 해당 이벤트를 선택해야 합니다.
- onMessage 이벤트 사용: 디스코드 메시지 수신 시
onMessage함수를 호출합니다.event는 StarLight의Message객체입니다. - 레거시(response) 이벤트 사용: 디스코드 메시지 수신 시
response함수를 호출합니다. onMessage 이벤트 사용이 활성화된 경우에만 사용할 수 있습니다.
예제
단순 수신&답장
JavaScript
function onMessageCreate(event) {
if (event.getAuthor().isBot()) return;
if (event.getMessage().getContentRaw() !== "!ping") return;
event.getChannel().sendMessage("Pong!").queue();
}수신&답장 심화
JavaScript
function onMessageCreate(event) {
if (event.getAuthor().isBot()) return;
if (event.getMessage().getContentRaw() !== "!ping") return;
const start = Date.now();
event.getChannel().sendMessage("안녕하세요, " + event.getAuthor().getName() + "님!").queue();
event.getChannel().sendMessage("Pong!").queue((msg) => {
msg.editMessage("핑은 " + (Date.now() - start) + "ms 에요!").queue();
});
}