게임 & API
설명
사용자 가이드
게임 API를 서버에 연결하세요. 멤버는 자신의 계정을 연동해 통계를 확인하고, 게임 서버 상태를 추적하며, 순위표에서 서로를 비교할 수 있습니다. 23개 게임이 바로 사용할 수 있도록 기본 제공되며, 직접 다른 게임을 추가할 수도 있습니다.
기능
- 각 멤버가 게임 계정을 서버에 연동할 수 있습니다.
- 요청 시 플레이어 통계를 표시합니다.
- 게임의 서버 상태를 계속 갱신되는 메시지로 게시하고, 음성 채널 카운터의 이름을 변경할 수 있습니다.
- 게임 소식을 채널에 자동으로 전달합니다.
- 계정을 연동한 멤버들의 순위표를 생성합니다.
- 일부 게임의 데이터베이스에서 검색을 제공합니다.
- 구성기를 이용하면 코드를 작성하지 않고도 JSON을 반환하는 모든 API를 연결할 수 있습니다.
빠른 시작(관리자)
- 대시보드에서 게임 & API 모듈의 카탈로그 탭을 엽니다.
- 원하는 게임을 찾아 활성화를 클릭합니다. 게임 설정이 곧바로 열립니다.
- 게임에 「키 필요」 표시가 있으면 API 키 카드에 키를 붙여넣습니다. 「TennoCore 키」라고 표시되면 이미 키가 제공되므로 따로 할 일이 없습니다.
- 필요하면 자동화를 활성화합니다. 소식, 상태, 순위표 각각에 채널과 간격을 지정합니다.
- 테스트 버튼으로 API가 응답하는지 확인한 뒤 저장합니다.
- 멤버에게
/game list를 안내하세요. 사용 가능한 게임을 확인하고/game link로 계정을 연동할 수 있습니다.
명령어
모든 명령어는 전체 멤버가 사용할 수 있으며, 계정 연동과 관련된 경우 비공개로 응답합니다.
| 명령어 | 설명 |
|---|---|
/game list | 서버에 활성화된 게임과 각 게임의 기능 목록 표시. |
/game link | 선택한 게임에 계정을 연동하는 양식 표시. |
/game unlink | 해당 게임의 계정 연동 해제. |
/game stats | 멤버의 통계 표시(기본값은 본인). |
/game status | 게임 서버 상태 표시. |
/game lookup | 게임 데이터베이스에서 항목 검색. |
/game leaderboard | 계정을 연동한 서버 멤버의 순위 표시. |
기본 제공 게임
23개의 커넥터가 제공됩니다. 각 커넥터는 하나 이상의 기능을 제공합니다: 플레이어 통계, 서버 상태, 소식, 검색.
| 게임 | 기능 | API 키 |
|---|---|---|
| Apex Legends | 플레이어 통계 | 필요 |
| Brawl Stars | 플레이어 통계 | 필요 |
| Chess.com | 플레이어 통계 | 불필요 |
| Clash Royale | 플레이어 통계 | 필요 |
| Destiny 2 | 플레이어 통계 | 필요 |
| Epic Games – 무료 게임 | 소식 | 불필요 |
| Fortnite | 플레이어 통계 | 필요 |
| Free-To-Game – F2P 출시 | 소식, 검색 | 불필요 |
| Genshin Impact | 플레이어 통계 | 불필요 |
| Hypixel (Minecraft) | 플레이어 통계 | 필요 |
| League of Legends | 플레이어 통계, 서버 상태 | 필요 |
| Lichess | 플레이어 통계 | 불필요 |
| Minecraft – 플레이어 | 플레이어 통계 | 불필요 |
| Minecraft – 서버 | 서버 상태 | 불필요 |
| osu! | 플레이어 통계 | 필요 |
| Pokédex (PokéAPI) | 검색 | 불필요 |
| RAWG – 게임 데이터베이스 | 검색, 소식 | 필요 |
| Roblox | 플레이어 통계 | 불필요 |
| 상태 (일반 Statuspage) | 서버 상태 | 불필요 |
| Steam – 게임 소식 | 소식 | 불필요 |
| Steam – 프로필 | 플레이어 통계 | 필요 |
| Valorant | 플레이어 통계 | 필요 |
| Warframe – 월드 | 서버 상태, 소식 | 불필요 |
대시보드 설정
모듈은 다섯 개의 탭으로 구성됩니다.
- 카탈로그 — 사용 가능한 모든 게임으로, 카테고리나 이름으로 필터링할 수 있습니다. 각 카드에는 게임의 기능과 키 필요 여부가 표시됩니다. 활성화, 복제(기존 커넥터를 기반으로 시작) 버튼과 API 문서 링크가 있습니다.
- 내 게임 — 이 서버에 활성화된 게임의 상태, 작동 중인 자동화, 연동된 계정 수, 키 출처, 최근 발생한 오류를 표시합니다. 구성 버튼을 누르면 설정이 열립니다.
- 일반: 게임 활성 또는 일시정지 상태, 계정을 연동한 멤버에게 자동 부여할 역할.
- API 키: 여러분의 키. 암호화되어 저장되며 다시 표시되지 않습니다. 변경하지 않으려면 비워 두세요.
- 커넥터 매개변수: 게임별 고유 설정(Steam 애플리케이션 ID, 지역 등).
- 소식: 채널, 간격(5~1440분, 기본 30), 필요 시 역할 멘션.
- 상태: 패널 채널, 간격(기본 10분), 사용할 이름 형식이 지정된 음성 채널 카운터.
- 순위표: 채널, 간격(기본 60분), 기준 통계 안내.
- 각 자동화에는 지금 게시 버튼이 있습니다.
- 구성기 — 자체 커넥터를 만듭니다. 일반 정보, 인증, 멤버에게 요청할 항목, 호출 단계, 생성할 메시지의 구성을 지정합니다. 테스트 벤치는 실제 호출을 실행해 응답 구조를 트리로 표시합니다. 값을 클릭하면 해당 경로가 복사되어 표시 설정에 재사용할 수 있습니다.
- 플레이어 — 서버의 모든 연동 계정 목록. 멤버의 연동을 해제할 수 있습니다.
- 로그 — API로 나간 최근 50건의 호출과 각각의 소요 시간, 결과, 오류 상세.
알아두면 좋은 점
- 게임은 활성화해야 사용할 수 있습니다. 명령어 자동 완성은 활성화된 게임만, 그리고 해당 명령어와 호환되는 게임만 제안합니다. 소식만 제공하는 게임은
/game stats에 나타나지 않습니다. - 연동은 즉시 검증됩니다.
/game link는 실제로 API를 호출합니다. 계정을 찾지 못하면 아무것도 저장되지 않고 멤버는 게임이 반환한 오류를 받습니다. 따라서 연동된 계정은 항상 정상 작동하는 계정입니다. - 연동 양식은 Discord의 제한에 따라 5개 항목까지만 사용할 수 있습니다.
- API 키 하이브리드 방식: 여러분의 키가 항상 우선하며, 없을 경우 TennoCore의 전역 키가 있으면 사용됩니다. 자신의 키를 등록하면 독립적인 할당량을 사용할 수 있습니다. 등록된 키는 인터페이스에 다시 표시되지 않습니다.
- 할당량: 커넥터마다 호출 제한이 정해져 있습니다(일반적으로 서버당 분당 30회). 초과하면 봇이 1분 기다려야 한다고 응답합니다. 응답은 몇 분간 캐시되므로 반복 요청을 흡수합니다.
- 순위표: 최대 40개의 연동 계정을 조회하고 상위 20개를 표시합니다. 서버 할당량을 소진하지 않기 위해 호출 간격을 의도적으로 벌리므로, 연동된 멤버가 많다면 간격을 넉넉히 설정하세요. 커넥터에 기준 통계가 정의되어 있지 않으면 순위표는 비어 있게 됩니다.
- 소식 피드의 첫 실행: 아무것도 게시되지 않고 봇이 기존 이력만 기록합니다. 채널이 넘치지 않도록 의도한 동작이며, 다음 실행부터 게시가 시작됩니다.
- 음성 채널 카운터: Discord는 10분당 이름 변경 2회만 허용합니다. 간격이 너무 짧으면 Discord가 조용히 무시합니다.
/game list는 최대 25개 게임을, 자동 완성은 최대 25개 항목을 표시합니다.- 게임을 제거하면 해당 게임의 설정과 소식 이력이 삭제되지만, 멤버의 연동 계정은 유지됩니다.
- 이 모듈의 메시지는 Discord의 새 표시 형식을 사용합니다. 각 항목이 한 줄을 차지하며, 여러 열로 배치되지 않습니다.
- 자체 커넥터: 호출 주소는 공개 API를 가리켜야 합니다. 내부 또는 사설 주소는 보안상 거부됩니다.
- 호출 로그는 7일간 보관됩니다.
- 이 모듈은 대시보드의 「개발 중」 카테고리에 있으며, 인터페이스가 계속 변경될 수 있습니다.