majsoul-plugin

Majsoul-Plugin은 작혼 마작(Majsoul)을 위한 다기능 QQ 봇 플러그인으로, TRSS-Yunzai와 함께 사용해야 합니다. 핵심 기능: 가챠 시스템: 매일 체크인으로 휘옥과 탐색 두루마리를 받으며, 단차와 십연차를 지원합니다. 중복 아이템을 뽑으면 자동으로 화폐(별의 가루, 별의 돌, 소원석)로 전환되며, 한도에 도달하면 자동으로 교환됩니다. 신앙으로 작사(일반 150/한정 300)를 교환할 수 있습니다. 다중 가챠 풀 전환(대나무숲의 길, 벚꽃의 길, 콜라보 풀, UP 풀)을 지원합니다. 플레이어 관리: 플레이어 정보(닉네임, UID, 단위)를 검색하고, 친구 코드 조회를 지원합니다. UID 바인딩 및 관리, 다중 계정 바인딩과 주 계정 전환을 지원합니다. 대국 구독: 지정 플레이어의 사마/삼마 대국을 구독하면 자동으로 그룹 채팅에 푸시됩니다. 사마는 3분마다, 삼마는 5분마다 확인합니다. 금의 방 이상에서 기록이 있는 플레이어만 구독할 수 있습니다. 대국 조회: 최근 대국 기록을 조회하며, 사마와 삼마를 지원하고, 단위장별 필터(금의 방/옥의 방/왕좌의 방)가 가능합니다. 데이터 조회: 쯔모율, 화료율, 1위율 등 상세 전적을 표시합니다. 최근 16경기 점수 추이 차트를 제공합니다. 우인장과 대회장 데이터 조회를 지원합니다. AI 작혼 분석: 작혼 URL을 Mortal 엔진에 제출하여 AI 분석을 진행하고, 국별로 분석 이미지(패, 부로, AI 코멘트 포함)를 생성합니다. 지정 국/순의 장황도를 조회할 수 있습니다. 먼저 로컬 API를 통해 작혼 계정에 로그인해야 합니다. 설치 방법: TRSS-Yunzai 루트 디렉토리에서 이 저장소를 plugins/Majsoul-Plugin에 클론하고, pnpm install을 실행한 후, Release 페이지에서 로컬 API 프로그램을 다운로드하여 api/ 디렉토리에 배치하고 재시작하면 사용할 수 있습니다. 작혼 분석 기능은 추가로 작혼옥 Bearer token을 설정해야 합니다.