HoYoLab 자동 출석 (GitHub 버전)

기능 업데이트 : 2026-08-22

PC 화면에서 작업하시는 걸 추천드립니다.

검색 기능 : Ctrl+F

AI 활용해서 깃허브에서 설정 시간마다 자동으로 출석 시도 하도록 바꾼 버전입니다.
출석 시간 설정 방법은 맨 아래 [#5. 출석 시간 설정] 을 참고하시면 됩니다.
계정 여러 개 등록해서 사용 가능합니다.
작동에 문제가 생기면 메일로 연락 부탁드립니다.

← 이 모양 있는 문장 누르면 추가 설명이 나오고

┗ 다시 (▶, ▼)모양 있는 문장 누르면 닫힙니다.

#실행 결과

〔 디스코드 핸드폰 알림 〕

각각 다른 채널의 웹훅 사용 시 알림이 분리돼서 옵니다.
- 아래 사진은 1개의 채널에서 웹훅 2개를 사용함.

〔 성공 결과 디스코드 전송 〕

이미 오늘 출석 완료 ✅ 메시지는 수동 실행으로만 디스코드로 보내집니다.

〔 실패 결과 디스코드 전송 〕

실패 시 실패 이유가(쿠키 만료, API 오류, 조회 불가 등등) 작성 되어 나옵니다.
- 아래 사진은 해당 HoYo 계정에 캐릭터 조회가 안되어 실패 처리 = 실제로 부계1은 스타레일만 존재함.

자동 실행 시 출력 : 출석 성공/실패
수동 실행 시 출력 : 출석 성공/실패, 이미 출석 완료

🚨🚨#주의사항#🚨🚨

🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨

ltuid_v2, ltoken_v2 등 해당 값들은 타인에게 유출되면 게임 계정이 위험해질 수 있으니 #3. GitHub Secret 에만 등록하시길 경고해 드립니다.
- 편의를 위해 따로 보관하시더라도 유출에 유의해서 보관하시길 바랍니다.
지난 2026년 7월 14일에 공표된 PAT 유출 사태와는 무관합니다.
- PAT : 비밀번호 대신 사용하는 개인용 인증 토큰.
  - 깃허브 저장소와 외부 서비스 연결할때 사용.

🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨

#0. 준비물

깃허브 계정 [GitHub] , [로그인 페이지] , [계정 생성 페이지]
해당 페이지 우측 위 ⑂ Fork 로 저장소 및 파일 복사

디스코드 개인 서버의 웹훅 또는 타 서버의 웹훅『선택사항』
메모장 어플『선택사항』
자주 사용하지 않는 브라우저『선택사항』

#1. 디스코드 웹훅 만들기 (메모장 작성 추천)

『선택사항』

PC 화면에서만 웹후크 생성이 가능합니다.

[Discord-웹브라우저]

개인 서버 만드는 방법은 생략
채널 생성『선택사항』
해당 채널 우클릭 → 채널 편집(⚙️) → 연동 탭 → 웹후크 → 웹후크 만들기 → 웹후크 URL 복사

#2. 쿠키 값 얻기 (메모장 작성 추천)

자주 사용하지 않는 브라우저로 실행하는 것 추천.
동일 브라우저에서 HoYoLab에 재로그인 할 경우 쿠키값(ltoken_v2)이 갱신됨.

『필수사항』

HoYoLAB 로그인 [HoYoLAB]
F12 (개발자 도구) 열기
상단 Application 탭 클릭
왼쪽 Cookies → https://www.hoyolab.com 클릭
F5 (새로고침)
Name 목록에서 ltoken_v2, ltuid_v2 값을 각각 복사

각각에 해당하는 Value(값) 누르면 개발자 도구창 맨아래에 자세히 나옵니다.

ltoken_v2 = v2_CAISDGM5... (매우 긺)
ltuid_v2 = 숫자 여러개값
목록에서 안보일 시 F5 (새로고침)

#3. GitHub Secret 등록하기

『필수사항』

⑂ Fork 로 복사된 본인 저장소에서 → 상단 탭 ⚙️Settings → 왼쪽 아래 쯤에 *️⃣Secrets and variables → Actions
New repository secret (초록색) 클릭
Name : ACCOUNTS_JSON
Secret 값에는 아래 형식대로 계정 정보를 작성해서 붙여 넣은 후 등록 :

★【 HoYo 계정 1개 사용 시 코드 】★

{
 "SHOW_ALIAS_AS_IS" : "x",
 "ACCOUNTS": [
        {
         "LTUID" : "계정1의ㅤltuid_v2ㅤ값",
         "LTOKEN" : "계정1의ㅤltoken_v2ㅤ값",
         "GAMES" : [ "붕괴 3rd", "원신", "붕괴: 스타레일", "젠레스 존 제로" ],
         "DISCORD_WEBHOOK" : "계정1의ㅤ디스코드ㅤ웹훅ㅤURL",
         "NAME" : "계정1의ㅤ이름",
         "AVATAR" : "계정1의ㅤ디스코드ㅤ웹훅ㅤ프로필ㅤ이미지ㅤURL"
        }
    ]
}

★【 HoYo 계정 2개 이상 사용 시 코드 】★

{
 "SHOW_ALIAS_AS_IS" : "x",
 "ACCOUNTS": [
        {
         "LTUID" : "계정1의ㅤltuid_v2ㅤ값",
         "LTOKEN" : "계정1의ㅤltoken_v2ㅤ값",
         "GAMES" : [ "붕괴 3rd", "원신", "붕괴: 스타레일", "젠레스 존 제로" ],
         "DISCORD_WEBHOOK" : "계정1의ㅤ디스코드ㅤ웹훅ㅤURL",
         "NAME" : "계정1의ㅤ이름",
         "AVATAR" : "계정1의ㅤ디스코드ㅤ웹훅ㅤ프로필ㅤ이미지ㅤURL"
        }
        ,{
         "LTUID" : "계정2의ㅤltuid_v2ㅤ값",
         "LTOKEN" : "계정2의ㅤltoken_v2ㅤ값",
         "GAMES" : [ "붕괴 3rd", "원신", "붕괴: 스타레일", "젠레스 존 제로" ],
         "DISCORD_WEBHOOK" : "계정2의ㅤ디스코드ㅤ웹훅ㅤURL",
         "NAME" : "계정2의ㅤ이름",
         "AVATAR" : "계정2의ㅤ디스코드ㅤ웹훅ㅤ프로필ㅤ이미지ㅤURL"
        }
    ]
}

계정 더 추가 시 해당 코드 이어 붙이기.

        ,{
         "LTUID" : "ltuid_v2ㅤ값",
         "LTOKEN" : "ltoken_v2ㅤ값",
         "GAMES" : [ "붕괴 3rd", "원신", "붕괴: 스타레일", "젠레스 존 제로" ],
         "DISCORD_WEBHOOK" : "디스코드ㅤ웹훅ㅤURL",
         "NAME" : "계정ㅤ이름ㅤ지정",
         "AVATAR" : "디스코드ㅤ웹훅ㅤ프로필ㅤ이미지ㅤURL"
        }

#3-1. 코드 설명 -『필수 입력』

"SHOW_ALIAS_AS_IS" : 아래 표시 부분에 별칭을 사용할건지 여부 "o/x"
"GAMES" : 출석 원하는 게임 이름/별칭 입력
- [ "원신", "붕괴: 스타레일", "붕괴 3rd", "젠레스 존 제로" ]
- 입력 순서에 따라 사진의 출석 순서가 바뀝니다.

ㅡㅡ【 사용 가능한 별칭 】ㅡㅡ

별칭 수정 : index.js 파일의 const GAME_ALIASES 코드 참고.
- 별칭 중복 작성 주의

const GAME_ALIASES = {
  "붕괴 3rd": [ "hi3", "hi3rd", "Honkai Impact 3rd", "붕3", "붕3rd", "붕괴3rd", "3rd" ],
  "원신": [ "gl", "Genshin Impact", "겐신", "1신", "원공노", "공월", "공월의노래" ],
  "붕괴: 스타레일": [ "hsr", "Honkai: Star Rail", "붕스", "붕스타", "별", "별붕", "스타레일", "붕괴스타레일", "붕괴 : 스타레일" ],
  "젠레스 존 제로": [ "z", "zzz", "Zenless Zone Zero", "젠존제", "찢", "ㅈㅈㅈ", "젠레스존제로", "젠레스", "존", "제로" ]
};

┗ [ "붕3", "원공노", "별", "zzz" ] 이런 식으로 사용.

"LTUID" = ltuid_v2 (유저 고유 ID) ([#2. 쿠키 값 얻기] 참고)
"LTOKEN" = ltoken_v2 (로그인 쿠키값) ([#2. 쿠키 값 얻기] 참고)

#3-2. 코드 설명 -『선택사항』

미사용 시 입력 :

"NAME" : ""
"AVATAR" : ""
"DISCORD_WEBHOOK" : ""

값이 비어 있을 시 가장 마지막에 입력된 값으로 사용 됩니다.

= 모든 계정의 값이 비어야 미사용

"NAME" = 계정 분류용
"AVATAR" = 웹훅 프로필
- 일단 저는 구글 드라이브에 1:1비율 이미지 올리고 공유 상태로 전환해 사용하고 있습니다.
  - [Google Drive]
"DISCORD_WEBHOOK" = 웹훅 URL ([#1. 디스코드 웹훅 만들기] 참고)

#4. 실행 확인

『필수사항』

수동 테스트 : ⑂ Fork 로 복사된 본인 저장소의 ▶️Actions 상단 탭 → HoYoLab 자동 출석 (아무거나) → Run workflow ▼ → Run workflow
- ▶️Actions 탭에서 실행 로그 확인 가능.

#5. 출석 시간 설정

HoYoLab 출석 가능 시간 : 한국시간(KST) 01:00 = 중국시간(CST) 00:00 = UTC 16:00

『기본 설정』

매일 한국시간(KST) 01:16 ~ 05:46, 20:00 ~ 23:00. 총 8회
- 출석 성공/실패, 수동 실행만 디스코드로 전송됩니다.

『설정 수정 방법』

.github/workflows 폴더 내부의 checkin 파일의 cron 값을 수정
- KST 09:10 = UTC 00:10 = cron: "10 0 * * *"
- 시간 변환 추천 사이트 : [Datetime360]
하루에 파일 내용을 자주 바꿀 시 스케줄러가 작동 안할 수도 있습니다.
- 스케줄러 작동 안하는 하루만 수동 작동하고, UTC 기준 다음날부터 스케줄러가 작동하는지 지켜보면 됩니다.
- GitHub 서버에 사람이 많아 생긴 문제라 외부 서비스에서 GitHub API를 호출해서 workflow_dispatch를 트리거 해야합니다.
  - 외부 호출 관련은 AI한테 물어보면 답변 잘해줄겁니다 :)

끝 :)

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.gitignore		.gitignore
README.md		README.md
index.js		index.js
package.json		package.json

Navigation Menu

Repository files navigation

HoYoLab 자동 출석 (GitHub 버전)

#실행 결과

🚨🚨#주의사항#🚨🚨

#0. 준비물

#1. 디스코드 웹훅 만들기 (메모장 작성 추천)

#2. 쿠키 값 얻기 (메모장 작성 추천)

#3. GitHub Secret 등록하기

#3-1. 코드 설명 -『필수 입력』

#3-2. 코드 설명 -『선택사항』

#4. 실행 확인

#5. 출석 시간 설정

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

HoYoLab 자동 출석 (GitHub 버전)

#실행 결과

🚨🚨#주의사항#🚨🚨

#0. 준비물

#1. 디스코드 웹훅 만들기 (메모장 작성 추천)

#2. 쿠키 값 얻기 (메모장 작성 추천)

#3. GitHub Secret 등록하기

#3-1. 코드 설명 -『필수 입력』

#3-2. 코드 설명 -『선택사항』

#4. 실행 확인

#5. 출석 시간 설정

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages