Witch Rift · 설치와 사용

WEB 0.1 · 기존 v63 매칭 규칙 / 한국 시간 기준

1. 지금 시험할 수 있는 기능

개인 시험 사이트에서 샘플 10명으로 팀을 만들 수 있습니다. 참가자를 직접 등록하거나 기존 EXE의 XML 백업을 가져올 수도 있습니다. 데이터는 개인 시험 사이트의 저장소에 저장됩니다. 실제 디스코드 자동 모집은 아래 배포를 마친 후 작동합니다.

  1. 팀 매칭 → 샘플로 시험하기 → 팀 매칭 시작.
  2. 후보를 선택하고 주라인 수, 유리 라인 수, 보정 합계를 비교합니다.
  3. 두 선수를 차례로 누르면 교체됩니다. 조건 위반은 빨간색으로 표시하고 교체를 취소하지 않습니다.
  4. 팀 확정 → 세트 결과 입력 → 결과 기록. 경기·쿠폰 기록에서 취소할 수 있습니다.
  5. 실제 데이터로 넘어가기 전에 연결·설정 → 샘플 데이터 비우기를 누르세요.

2. 필요한 계정과 프로그램

매칭 계산은 관리자가 연 브라우저에서 실행합니다. 아무도 웹을 열지 않은 상태에서 자동 팀 편성은 하지 않습니다. 투표 게시와 응답 저장은 PC가 꺼져 있어도 작동합니다. 무료 할당량 초과 시 요청이 실패할 수 있으며 영구 무료나 무중단을 보장하지 않습니다.

3. 파일 압축 풀기

무료 서버 배포 파일을 내려받아 전체 폴더를 압축 해제하세요. cloudflare-worker, lib, public 폴더의 상대 위치를 유지하세요. cloudflare-worker 폴더에서 터미널을 엽니다.

npm install
npx wrangler login
npx wrangler d1 create witch-rift

반환된 database_id를 cloudflare-worker/wrangler.jsonc의 REPLACE_WITH_DATABASE_ID에 넣습니다. 다른 ID를 추측해서 입력하지 마세요.

npx wrangler d1 migrations apply witch-rift --remote

4. 디스코드 봇 만들기

  1. Discord Developer Portal → New Application → 원하는 이름으로 생성.
  2. General Information에서 Public Key를 확인합니다.
  3. Bot에서 토큰을 발급합니다. 토큰은 서버 비밀 설정에만 입력하세요.
  4. OAuth2 URL Generator에서 bot 범위를 선택하고 View Channels, Send Messages 권한을 선택합니다. Administrator 전체 권한은 필요 없습니다.
  5. 생성된 초대 주소로 본인 디스코드 서버에 봇을 추가합니다.
  6. 디스코드 사용자 설정 → 고급 → 개발자 모드를 켭니다. 서버 이름과 모집 채널을 우클릭해서 각각 ID를 복사합니다.
  7. wrangler.jsonc의 DISCORD_GUILD_ID에 서버 ID, DISCORD_CHANNEL_ID에 채널 ID를 입력합니다.

5. 비밀값을 서버에 등록

아래 명령은 각각 실행하면 값을 입력할 수 있습니다. 비밀값은 소스 파일, 공유 ZIP, 채팅에 적지 마세요. ADMIN_TOKEN은 본인만 아는 24자 이상의 무작위 문자열을 사용합니다.

npx wrangler secret put ADMIN_TOKEN
npx wrangler secret put DISCORD_BOT_TOKEN
npx wrangler secret put DISCORD_PUBLIC_KEY
npx wrangler deploy

배포가 끝나면 https://…workers.dev 주소가 나옵니다. 봇의 Interactions Endpoint URL에 아래 형식으로 입력하고 저장합니다.

https://본인-worker.workers.dev/discord/interactions

저장이 안 되면 Public Key 오타, 배포 성공 여부, 정확한 경로를 확인하세요. 별도 Gateway 상시 연결이나 Message Content Intent는 이 봇에서 필요하지 않습니다.

6. 관리 화면과 공용 저장소 연결

  1. 배포된 Worker 주소를 브라우저에서 엽니다. 인증 전에는 연결 안내가 표시됩니다.
  2. 연결·설정 → Worker 주소와 ADMIN_TOKEN 입력 → 봇 서버 연결.
  3. 최신 EXE에서 ‘백업 저장’한 XML 파일을 초기 가져오기 합니다. 첨부된 오래된 Excel은 자동으로 사용하지 않습니다.
  4. 참가자 관리에서 각 사람의 디스코드 사용자 ID를 한 번 연결합니다. 이름·닉네임이 바뀌어도 ID로 식별합니다.
  5. 모집 시작과 마감 시간 설정 후 자동 모집 사용을 켜고 저장합니다. 기본 제안값은 18:00~21:00이며 자동 모집은 처음에 꺼져 있습니다.

개인 시험 사이트와 실제 봇 서버의 저장소는 별도입니다. 시험 사이트에서 준비한 데이터를 가져가려면 웹 데이터 백업 JSON을 다운로드하고 봇 서버의 빈 저장소에 웹 백업 가져오기를 사용하세요. 관리자 키는 현재 페이지 메모리에만 남으므로 새로고침하면 다시 입력해야 합니다.

7. 실제 운영 순서

  1. 5분 간격 예약 실행이 한국 시간 설정을 확인해 매일 한 번 모집을 게시합니다. 설정한 시각 직후 최대 약 5분 이내 실행되며 예약 지연 가능성은 있습니다.
  2. 참가자는 디스코드 참가·불참·늦참 버튼을 누릅니다. 늦참은 22:30 형식의 시간을 입력합니다. 마감 전 마지막 응답이 반영됩니다.
  3. 관리자는 참가 모집에서 응답을 확인합니다. 미연결 계정은 사용자 ID를 연결합니다.
  4. 팀 매칭 → 투표 명단 적용. ‘참가’만 자동 선택하고 늦참은 관리자가 도착 시간을 보고 직접 선택합니다. 10명을 초과하면 10명으로 줄여야 계산할 수 있습니다.
  5. 같은팀 R/G/B 그룹과 당일 가능 라인을 설정 → 팀 매칭 시작 → 후보 비교 → 확정.
  6. ‘디스코드에 팀 게시’로 확정 팀을 채널에 올립니다.
  7. 결과 기록 후 쿠폰 적립·점수·전적을 확인합니다. 잘못 기록하면 기록 취소를 사용하세요.

오늘 모집 게시 버튼은 실제 메시지를 보냅니다. 하루에 한 번만 생성되며, 전송 실패 이력이 있으면 DB의 polls 상태를 확인하고 재게시 전에 채널에 메시지가 실제 생성되지 않았는지 확인하세요.

8. 기존 규칙과 범위

항목현재 동작
우선순위주라인 수 최대 → 최대 라인 격차 → 라인 격차 합 → 보정 합계 차 → 골결 차 → 비선호 수 → 비선호 수 차 → 부라인 수.
바텀원딜 × [1+0.5(0.3u+0.7u³)], u=(서폿−5)/5. 서폿 중복 합산 없음.
강제 조건불가능 라인 제외, 같은팀 그룹 유지, 유리 라인 수 차이 ≤1. 격차 1 이내 해가 없을 때만 격차 제한을 완화합니다.
MMR매칭에 사용하지 않습니다. 기존 누적 점수는 기록 용도로 유지합니다.
결과 2:11승/1패, 총 3경기. 쿠폰은 부라인 3장·비선호 9장.
기존 기록XML의 통계·잔액을 시작값으로 유지. 원본 XML은 웹 백업에 보관. 과거 개별 기록 취소는 기존 EXE에서 처리합니다.
계정 권한이번 웹 버전은 관리자 운영용입니다. 참가자는 디스코드 투표만 사용합니다. 기존 EXE의 다중 관리자 권한·변경 검토·한줄평 프로필은 아직 웹으로 이식하지 않았습니다.
EXE 동기화자동 양방향 동기화 없음. 웹 기록은 기존 EXE/Google Drive에 자동 반영되지 않습니다.

9. 확인할 시험

코드 테스트와 빌드는 완료 여부를 전달받은 결과 기준으로 확인하세요. 실제 봇 계정 연결과 Windows/휴대폰 화면 시험은 별도입니다.

공식 참고 문서

Cloudflare 예약 실행 · 무료 실행 제한 · Discord 상호작용