Sobre o projeto

Majsoul-Plugin é um plugin multifuncional de bot QQ voltado para o jogo Majsoul (Mahjong Soul), que deve ser usado em conjunto com o TRSS-Yunzai. Funcionalidades principais: Sistema de sorteio: check-in diário para receber Jade Radiante e Pergaminhos de Busca, com suporte a sorteio único e dez sorteios consecutivos; itens duplicados obtidos são automaticamente convertidos em moedas (Pó Estelar, Pedra Estelar, Pedra do Desejo) e trocados automaticamente ao atingir a quantidade máxima; é possível trocar Fé por personagens (normal 150 / limitado 300); suporte à troca entre múltiplos banners (Caminho do Bambu, Caminho da Cerejeira, banner de colaboração, banner UP). Gerenciamento de jogadores: busca de informações de jogadores (apelido, UID, patente), com suporte a consulta por código de amigo; vinculação e gerenciamento de UID, com suporte a múltiplas contas vinculadas e troca de conta principal. Assinatura de partidas: assina partidas de quatro jogadores/três jogadores de um jogador específico, com envio automático para o grupo; partidas de quatro jogadores são verificadas a cada 3 minutos e as de três jogadores a cada 5 minutos; apenas jogadores com registros na sala Dourada ou superior podem assinar. Consulta de partidas: consulta registros de partidas recentes, com suporte a quatro e três jogadores, filtráveis por sala de patente (Sala Dourada/Sala de Jade/Sala do Trono). Consulta de dados: exibe estatísticas detalhadas como taxa de auto-tsumo, taxa de vitória e taxa de primeiro lugar; gráfico de tendência de pontuação das últimas 16 partidas; suporte a consulta de dados de salas de amigos e salas de torneio. Análise de replays com IA: envia a URL do replay para o mecanismo Mortal realizar análise com IA, gerando gráficos de análise rodada a rodada (incluindo mãos, melds e comentários da IA); suporte à visualização do gráfico de situação de uma rodada/turno específico; é necessário fazer login na conta Majsoul através da API local primeiro. Instalação: no diretório raiz do TRSS-Yunzai, clone este repositório em plugins/Majsoul-Plugin, execute pnpm install e baixe o programa da API local na página de Release, colocando-o no diretório api/ e reiniciando para usar. A funcionalidade de análise de replays requer configuração adicional do Bearer token do Replay House.