Accessible Arena

O que é este mod

Este mod permite jogar o Arena, a representação digital mais popular e mais amigável para iniciantes do jogo de cartas colecionáveis Magic: The Gathering. Ele adiciona suporte completo a leitores de tela e navegação por teclado a quase todos os aspectos do jogo.

O mod dá suporte a todas as línguas em que o jogo foi traduzido. Além disso, alguns idiomas que o próprio jogo não suporta são parcialmente cobertos: neles, avisos específicos do mod, como textos de ajuda e dicas de interface, são traduzidos, enquanto os dados das cartas e do jogo permanecem no idioma padrão do jogo.

O que é Magic: The Gathering

Magic é um jogo de cartas colecionáveis, marca registrada da Wizards of the Coast, que permite jogar como um mago contra outros magos, lançando mágicas representadas pelas cartas. Existem 5 cores em Magic, que representam diferentes identidades de jogabilidade e ambientação. Se você conhece Hearthstone ou Yu-Gi-Oh, vai reconhecer muitos conceitos, porque Magic é o ancestral de todos esses jogos. Se você quiser aprender mais sobre Magic em geral, o site oficial do jogo e muitos criadores de conteúdo vão te ajudar.

Requisitos

Instalação

Usando o instalador (recomendado)

  1. Baixe o AccessibleArenaInstaller.exe do lançamento mais recente no GitHub
  2. Feche o MTG Arena se estiver aberto
  3. Execute o instalador. Ele vai detectar sua instalação do MTGA, instalar o MelonLoader se necessário e implantar o mod
  4. Abra o MTG Arena. Você deve ouvir “Accessible Arena v… launched” pelo seu leitor de tela

Instalação manual

  1. Instale o MelonLoader na sua pasta do MTGA
  2. Baixe AccessibleArena.dll do lançamento mais recente
  3. Copie a DLL para a pasta Mods do MTGA:
    • Instalação WotC: C:\Program Files\Wizards of the Coast\MTGA\Mods\
    • Instalação Steam: C:\Program Files (x86)\Steam\steamapps\common\MTGA\Mods\
  4. Garanta que Tolk.dll e nvdaControllerClient64.dll estejam na pasta raiz do MTGA
  5. Abra o MTG Arena

Desinstalação

Execute o instalador de novo. Se o mod já estiver instalado, ele oferecerá uma opção de desinstalação. Opcionalmente você também pode remover o MelonLoader. Para desinstalar manualmente, apague AccessibleArena.dll da pasta Mods\ e remova Tolk.dll e nvdaControllerClient64.dll da pasta raiz do MTGA.

Se você vem do Hearthstone

Se você jogou Hearthstone Access, vai reconhecer muitas coisas por bons motivos, pois não só os princípios de jogo são próximos entre si, como eu segui muitos princípios de design. Mesmo assim, algumas coisas são diferentes.

Primeiro, você tem mais zonas para navegar, pois Magic conhece cemitério, exílio e algumas zonas extras. Seu campo de batalha não é limitado em tamanho e tem linhas adicionais de ordenação para tornar mais gerenciável a massa de coisas que pode aparecer.

Sua mana não sobe automaticamente, mas vem de cartas de terreno de cores diferentes que você tem que jogar ativamente. Assim, os custos de mana têm partes incolores e coloridas que, somadas, dão os requisitos completos de custo de uma carta que você precisa cumprir.

Você não pode atacar criaturas diretamente; apenas os oponentes e algumas cartas muito específicas (planinautas e batalhas) podem ser alvo dos atacantes. Como defensor, você tem que decidir se quer bloquear um ataque para fazer as criaturas lutarem. Se você não bloquear, o dano atingirá seu avatar de jogador, mas suas criaturas podem permanecer intactas. Além disso, o dano não se acumula nas criaturas, mas é curado ao fim de cada turno, tanto no fim do seu turno quanto no do oponente. Para interagir com as criaturas do oponente que se recusam a lutar com você, você precisa jogar cartas específicas ou pressionar tanto os pontos de vida do seu oponente que ele não tenha escolha a não ser sacrificar criaturas valiosas para sobreviver.

O jogo tem fases de batalha muito bem distintas que permitem ações específicas como comprar, conjurar mágicas ou lutar. Assim, Magic permite e estimula que você faça coisas no turno do oponente. Não fique mais sentado esperando enquanto as coisas acontecem. Jogue um deck interativo e destrua os planos inimigos na hora.

Primeiros passos

O jogo primeiro pede que você forneça alguns dados sobre si e registre um personagem. Isso deveria funcionar pelos mecanismos internos do jogo, mas se não funcionar você pode alternativamente usar o site do jogo para fazer isso, ele é totalmente acessível.

O jogo começa com um tutorial no qual você aprende o básico de Magic: The Gathering. O mod adiciona dicas de tutorial personalizadas para usuários de leitores de tela ao lado do tutorial padrão. Depois de terminar o tutorial, você é recompensado com 5 decks iniciais, um para cada cor.

A partir daí, você tem várias opções para desbloquear mais cartas e aprender o jogo:

Confira seu correio no menu social, pois ele contém muitas recompensas e pacotes de cartas.

O jogo desbloqueia modos gradualmente com base no que e no quanto você joga. Ele dá dicas e missões no menu de progresso e objetivos, e destaca para você os modos relevantes no menu jogar. Depois que você terminar conteúdo suficiente para novos jogadores, todos os diferentes modos e eventos ficam totalmente disponíveis.

No Códex do Multiverso, você pode aprender sobre modos de jogo e mecânicas. Ele se expande com o progresso na experiência NPE.

Em configurações de conta, você pode pular todas as experiências de tutorial e forçar o desbloqueio de tudo para ter total liberdade desde o início. Contudo, jogar os eventos de novo jogador dá muitas cartas e é recomendado para novos jogadores. Só desbloqueie tudo cedo se já souber o que está fazendo. Caso contrário, o conteúdo para iniciantes oferece bastante diversão e aprendizado enquanto te guia bem.

Atalhos de teclado

A navegação segue convenções padrão em todo lugar: Setas para mover, Home/End para ir ao primeiro/último, Enter para selecionar, Espaço para confirmar, Backspace para voltar ou cancelar. Tab/Shift+Tab também funciona para navegação. Page Up/Page Down muda de página.

Global

Duelos - Zonas

Suas zonas: C (Mão), G (Cemitério), X (Exílio), S (Pilha), W (Zona de Comando) Zonas do oponente: Shift+G, Shift+X, Shift+W Campo de batalha: B / Shift+B (Criaturas), A / Shift+A (Terrenos), R / Shift+R (Não criaturas) Dentro das zonas: Esquerda/Direita para navegar, Cima/Baixo para ler detalhes da carta, I para informações estendidas Shift+Cima/Baixo: Alternar linhas do campo de batalha

Duelos - Informações

Duelos - Alvos e ações

Duelos - Full control e paradas de fase

Duelos - Navegadores (Scry, Surveil, Mulligan)

Solução de problemas

Sem fala depois de abrir o jogo

O jogo trava ao iniciar ou o mod não carrega

O mod estava funcionando, mas parou depois de uma atualização do jogo

Atalhos de teclado não funcionam

Idioma errado

Windows avisa que o instalador ou a DLL não são seguros

O instalador e a DLL do mod não são assinados digitalmente. Certificados de assinatura de código custam algumas centenas de euros por ano, o que não é realista para um projeto de acessibilidade gratuito. Por isso, o Windows SmartScreen e alguns antivírus vão te avisar ao rodar o instalador pela primeira vez, ou marcar a DLL como “editor desconhecido”.

Para verificar se o arquivo que você baixou corresponde ao publicado no GitHub, cada lançamento lista uma soma de verificação SHA256 tanto para AccessibleArenaInstaller.exe quanto para AccessibleArena.dll. Você pode calcular o hash do arquivo baixado e comparar:

Se o hash bater com o das notas de lançamento, o arquivo é autêntico. Para rodar o instalador apesar do aviso do SmartScreen, escolha “Mais informações” e depois “Executar mesmo assim”.

Relatar bugs

Se encontrar um bug, você pode postar no lugar onde encontrou o mod publicado, ou abrir uma issue no GitHub.

Inclua as seguintes informações:

Problemas conhecidos

O jogo deveria cobrir quase todas as telas, mas pode haver alguns casos extremos que não funcionam totalmente. O PayPal bloqueia usuários cegos com um captcha ilegal não sonoro, então você terá de usar ajuda de alguém com visão ou outros métodos de pagamento se quiser gastar dinheiro real no jogo. Alguns eventos específicos podem não estar totalmente funcionais. O draft agora funciona, tanto o quickdraft (onde você escolhe cartas contra bots) quanto os drafts contra jogadores reais, incluindo a tela de lobby de preparação e o cronômetro de escolha. O modo Cube não foi tocado. Eu nem sei direito do que se trata e ele custa muitos recursos do jogo. Então vou fazer isso se tiver tempo ou sob pedido. O sistema cosmético do jogo com Emotes, Mascotes, estilos de carta e títulos só é parcialmente suportado por enquanto. O mod é testado apenas em Windows com NVDA e JAWS e ainda depende da biblioteca Tolk sem modificações. Eu não consigo testar a compatibilidade com Mac ou Linux aqui, e bibliotecas multiplataforma como Prism não suportavam totalmente as versões antigas de .NET das quais o jogo depende neste momento. Então só vou mudar para uma biblioteca mais ampla se houver pessoas que possam ajudar a testar outras plataformas ou leitores de tela asiáticos que não são totalmente suportados pelo Tolk sem modificações. Então não hesite em me contatar se quiser que eu trabalhe nisso.

Para a lista atual de problemas conhecidos, veja KNOWN_ISSUES.md.

Isenções

Outras acessibilidades

Este mod se chama Accessible Arena principalmente porque soa bem. Mas no momento, isso é apenas um mod de acessibilidade para leitores de tela. Estou absolutamente interessado em cobrir mais deficiências com este mod, deficiências visuais, motoras etc. Mas só tenho experiência em acessibilidade para leitores de tela. Como pessoa totalmente cega, por exemplo, questões de coloração e fontes são totalmente abstratas para mim. Então, se você quiser algo desse tipo implementado, por favor não hesite em me contatar se conseguir descrever claramente suas necessidades e estiver disposto a me ajudar a testar os resultados. Aí ficarei feliz em dar mais verdade ao nome deste mod.

Contato com a empresa

Infelizmente não consegui obter insights confiáveis sobre a equipe do Arena ou contatos informais com desenvolvedores. Então decidi pular seus canais oficiais de comunicação por enquanto. Em 3 meses construindo e jogando eu nunca esbarrei em nenhum sistema de proteção contra bots, então não acho que eles consigam nos detectar como usuários do mod. Mas eu não quis correr o risco de comunicar em canais oficiais como pessoa sozinha. Então espalhem a palavra sobre o mod e vamos construir uma comunidade grande e valiosa. Aí teremos uma posição muito melhor se decidirmos entrar em contato diretamente. Só não tente escrever para eles sem falar comigo primeiro. Especialmente não mande pedidos de acessibilidade nativa ou de integração do meu mod à base de código deles. Nenhum dos dois vai acontecer de qualquer jeito.

Compras no jogo

O Arena tem algumas mecânicas de dinheiro real e você pode comprar uma moeda do jogo. Esses métodos de pagamento são em sua maioria acessíveis, exceto o PayPal, porque eles incluíram proteção captcha no login. Você pode tentar desinstalar o mod para o cadastro do método de pagamento e pedir ajuda de alguém com visão, mas mesmo isso é pouco confiável por causa do pesadelo de acessibilidade que é o captcha deles, ainda mais quebrado e mal implementado pela Wizards of the Coast. Mas outros métodos de pagamento funcionam de forma estável. Eu e outros testamos a compra no jogo de coisas e o uso do sistema deve ser seguro. Mas é absolutamente possível que ocorram bugs ou mesmo que o mod te induza ao erro. Pode clicar nas coisas erradas, mostrar informações erradas ou incompletas, fazer coisas erradas por causa de mudanças internas do Arena. Eu poderia testar, mas não posso garantir 100% de que você não compraria as coisas erradas com seu dinheiro real. Eu não vou assumir responsabilidade por isso e, dado que este não é um produto oficial do Arena, a empresa do jogo também não vai. Por favor, nem tente pedir reembolso nesse caso, eles não vão dar.

Uso de IA

O código deste mod foi criado 100% com a ajuda do agente Claude da Anthropic, usando os modelos Opus: começou no 4.5, a maior parte do desenvolvimento aconteceu no 4.6 e os últimos passos rumo ao lançamento foram feitos no 4.7. E, graças ao meu maior colaborador, um pouco de Codex também. Estou ciente dos problemas do uso de IA. Mas em um tempo em que todos usam essas ferramentas para fazer muita coisa bem mais duvidosa, enquanto a indústria de jogos não conseguiu nos dar a acessibilidade que queremos em termos de qualidade ou quantidade, eu ainda assim decidi usar as ferramentas.

Como contribuir

Aceito contribuições com prazer e, com blindndangerous, muito trabalho útil de outra pessoa já faz parte deste mod. Estou especialmente interessado em melhorias e correções para coisas que não consigo testar, como diferentes configurações de sistema, correção de idiomas que não falo etc. Mas aceito também pedidos de funcionalidades. Antes de trabalhar em algo, confira os problemas conhecidos.

Créditos

E agora quero agradecer a muitas pessoas, porque felizmente isto não foi apenas eu e a IA em uma caixa preta, mas toda uma rede ao meu redor, ajudando, fortalecendo, sendo simplesmente social e gentil. Por favor, me mande DM se eu te esqueci ou se você quer ser conhecido por um nome diferente ou não ser mencionado.

Primeiro, este trabalho se apoia muito no trabalho de outras pessoas que fizeram as coisas pioneiras que eu só tive que refazer para o Accessible Arena. Em termos de design, é o Hearthstone Access, do qual pude herdar muito, não só por ser bem conhecido de quem jogou o jogo, mas porque é realmente um bom design de UI. Em termos de modding, quero agradecer aos membros do Discord de modding do Zax. Vocês não só desvendaram todas essas coisas, todas as ferramentas e procedimentos que eu só precisei instalar e usar. Vocês me ensinaram tudo o que eu precisava saber sobre modding com IA, seja diretamente ou discutindo coisas em público ou ajudando outros iniciantes. Além disso, deram a mim e ao meu projeto uma plataforma e comunidade em que podemos existir.

Para grandes contribuições de código, quero agradecer a blindndangerous, que também fez muito trabalho neste projeto. Durante a vida do projeto acho que recebi cerca de 50 PRs e mais dele sobre todo tipo de problemas, das pequenas coisas chatas de resolver até sugestões maiores de UI e acessibilidade de telas inteiras do jogo. Agradecimentos também ao Ahix, que criou prompts de refatoração para grandes projetos feitos com IA que eu rodei sobre minhas próprias refatorações para garantir qualidade e manutenibilidade do código.

Por contribuições de código, quero agradecer:

Por testar as betas, dar feedback e ideias, quero agradecer:

Por testes com pessoas videntes para entender fluxos visuais e confirmar algumas coisas, quero agradecer:

Ferramentas usadas

Apoie seu modder

Criar este mod não foi só muita diversão e fortalecimento para mim, mas me custou muito tempo e muito dinheiro real em assinaturas do Claude. Vou mantê-las para trabalhar em mais melhorias e manter o projeto nos próximos anos. Então, se você estiver disposto e puder fazer uma doação única ou mesmo mensal, dê uma olhada aqui. Apreciaria muito esse reconhecimento pelo meu trabalho, pois ele me dá uma base estável para continuar trabalhando no Arena e, tomara, em outros grandes projetos no futuro.

Ko-fi: ko-fi.com/jeanstiletto

Licença

Este projeto é licenciado sob a GNU General Public License v3.0. Veja o arquivo LICENSE para detalhes.

Links

Outros idiomas

English Deutsch Español Français Italiano 日本語 한국어 Polski Русский 简体中文 繁體中文