Accessible Arena

이 모드는 무엇인가

이 모드는 트레이딩 카드 게임 Magic: The Gathering의 가장 인기 있고 초보자 친화적인 디지털 구현인 Arena를 플레이할 수 있게 해줍니다. 게임의 거의 모든 측면에 스크린 리더 전체 지원과 키보드 내비게이션을 추가합니다.

이 모드는 게임이 번역된 모든 언어를 지원합니다. 또한 게임 자체가 지원하지 않는 일부 언어도 부분적으로 커버됩니다. 이러한 언어에서는 도움말 텍스트나 UI 힌트와 같은 모드 전용 안내가 번역되며, 카드 및 게임 데이터는 게임의 기본 언어로 유지됩니다.

Magic: The Gathering이란

Magic은 Wizards of the Coast의 상표로 등록된 트레이딩 카드 게임으로, 자신이 마법사가 되어 다른 마법사들에 맞서 카드로 표현된 주문을 시전하며 플레이할 수 있습니다. Magic에는 서로 다른 게임 플레이와 분위기의 정체성을 대표하는 5가지 색이 있습니다. Hearthstone이나 Yu-Gi-Oh를 알고 있다면 많은 개념을 알아볼 수 있을 겁니다. Magic이 그 모든 게임의 조상이기 때문입니다. Magic 전반에 대해 더 알고 싶다면 게임 공식 사이트와 많은 콘텐츠 크리에이터들이 도움이 될 것입니다.

요구 사항

Windows 10 이상
Magic: The Gathering Arena (공식 Wizards 설치 프로그램 또는 Steam을 통해 설치)
스크린 리더 (NVDA와 JAWS만 테스트됨)
MelonLoader (설치 프로그램이 자동으로 처리)

설치

설치 프로그램 사용 (권장)

GitHub의 최신 릴리스에서 AccessibleArenaInstaller.exe 다운로드
MTG Arena가 실행 중이면 닫기
설치 프로그램을 실행. MTGA 설치를 감지하고, 필요한 경우 MelonLoader를 설치한 후 모드를 배포합니다
MTG Arena를 실행. 스크린 리더를 통해 "Accessible Arena v... launched"가 들려야 합니다

수동 설치

MTGA 폴더에 MelonLoader 설치
최신 릴리스에서 AccessibleArena.dll 다운로드
DLL을 MTGA Mods 폴더로 복사:
- WotC 설치: C:\Program Files\Wizards of the Coast\MTGA\Mods\
- Steam 설치: C:\Program Files (x86)\Steam\steamapps\common\MTGA\Mods\
Tolk.dll과 nvdaControllerClient64.dll이 MTGA 루트 폴더에 있는지 확인
MTG Arena 실행

제거

설치 프로그램을 다시 실행하세요. 모드가 이미 설치되어 있다면 제거 옵션이 제공됩니다. 선택적으로 MelonLoader도 제거할 수 있습니다. 수동으로 제거하려면 Mods\ 폴더에서 AccessibleArena.dll을 삭제하고 MTGA 루트 폴더에서 Tolk.dll과 nvdaControllerClient64.dll을 제거하세요.

Hearthstone에서 온 경우

Hearthstone Access를 해본 적이 있다면 타당한 이유로 많은 것들을 알아볼 수 있을 겁니다. 게임 원리가 서로 가깝기 때문만이 아니라, 제가 많은 디자인 원칙을 따랐기 때문이죠. 그래도 몇 가지는 다릅니다.

먼저 탐색해야 할 영역이 더 많습니다. Magic에는 무덤, 추방 그리고 몇몇 추가 영역이 있기 때문입니다. 여러분의 전장은 크기가 제한되어 있지 않으며, 나타날 수 있는 많은 요소들을 보다 다루기 쉽게 만드는 추가 정렬 행이 있습니다.

마나는 자동으로 증가하지 않고, 직접 적극적으로 내야 하는 다양한 색의 대지 카드에서 나옵니다. 그에 따라 마나 비용에는 무색 부분과 유색 부분이 있으며, 이를 합친 것이 카드에 대해 충족해야 하는 전체 비용 요구 사항이 됩니다.

생물을 직접 공격할 수는 없으며, 오직 상대와 매우 특정한 일부 카드(플레인즈워커와 전투)만이 공격자의 대상이 될 수 있습니다. 방어자로서 전투를 위해 공격을 방어해 생물끼리 싸우게 할지 결정해야 합니다. 방어하지 않으면 피해는 플레이어 아바타에 들어오지만, 생물은 무사히 남을 수 있습니다. 나아가 피해는 생물에 누적되지 않고 각 턴이 끝날 때, 즉 자신의 턴과 상대의 턴이 끝날 때 회복됩니다. 싸움에 응하지 않는 상대의 생물과 상호 작용하려면 특정 카드를 플레이하거나, 상대의 생명력을 강하게 압박해 생존을 위해 귀중한 생물을 희생하도록 해야 합니다.

게임에는 드로우, 주문 시전, 전투와 같은 특정 행동을 허용하는 매우 구분된 전투 페이즈가 있습니다. 그에 따라 Magic은 상대의 턴에도 행동할 수 있도록 허용하고 권장합니다. 더 이상 앉아서 일이 일어나기를 기다릴 필요가 없습니다. 상호작용형 덱을 플레이하고 적의 계획을 즉석에서 무너뜨리세요.

첫걸음

게임은 먼저 여러분에 대한 일부 데이터를 입력하고 캐릭터를 등록하도록 요구합니다. 이것은 게임 내부를 통해 작동해야 하지만, 그렇지 않은 경우 게임의 웹사이트를 대신 사용할 수 있습니다. 웹사이트는 완전히 접근 가능합니다.

게임은 Magic: The Gathering의 기초를 배우는 튜토리얼로 시작합니다. 모드는 표준 튜토리얼과 함께 스크린 리더 사용자를 위한 사용자 정의 튜토리얼 힌트를 추가합니다. 튜토리얼을 마치면 각 색에 하나씩 총 5개의 스타터 덱을 보상으로 받습니다.

여기서부터 더 많은 카드를 잠금 해제하고 게임을 배우는 여러 옵션이 있습니다:

색 챌린지: Magic의 다섯 가지 색 각각에 대한 색 챌린지를 플레이하세요. 각 챌린지는 4명의 NPC 상대와 싸우고, 마지막에 실제 플레이어와의 매치로 이어집니다.
스타터 덱 이벤트: 같은 덱 선택지를 가진 실제 사람과 10개의 이색 덱 중 하나로 대결하세요.
Jump In: 서로 다른 색과 테마의 20장 카드 패키지 두 개를 골라 덱으로 결합하고, 비슷한 선택지를 가진 실제 사람들과 대결하세요. 이 이벤트에서는 무료 토큰을 얻고 선택한 카드를 보관하게 됩니다.
Spark Ladder: 언젠가 Spark Ladder가 해제되며, 실제 상대와의 첫 랭크 매치를 하게 됩니다.

소셜 메뉴에서 메일을 확인하세요. 많은 보상과 카드 팩이 들어있습니다.

게임은 무엇을 얼마나 플레이했는지에 따라 점진적으로 모드를 해제합니다. 진행 및 목표 메뉴에서 힌트와 퀘스트를 주고, 플레이 메뉴에서는 여러분에게 관련된 모드를 강조 표시합니다. 새로운 플레이어 콘텐츠를 충분히 끝내면, 다양한 모드와 이벤트가 완전히 사용 가능해집니다.

다원 우주의 코덱스에서 게임 모드와 메커니즘에 대해 배울 수 있습니다. NPE 경험의 진행과 함께 확장됩니다.

설정 계정 아래에서 모든 튜토리얼 경험을 건너뛰고 모든 것을 강제로 잠금 해제하여 처음부터 완전한 자유를 누릴 수 있습니다. 그러나 새로운 플레이어 이벤트를 플레이하면 많은 카드를 얻을 수 있으며 신규 플레이어에게 권장됩니다. 이미 무엇을 하고 있는지 알 때만 일찍 모든 것을 해제하세요. 그렇지 않다면 초보자 콘텐츠는 충분한 재미와 학습을 제공하며 잘 안내해 줍니다.

키보드 단축키

내비게이션은 어디서나 표준 관례를 따릅니다: 방향키로 이동, Home/End로 처음/마지막으로 점프, Enter로 선택, Space로 확정, Backspace로 돌아가거나 취소. Tab/Shift+Tab도 내비게이션에 작동합니다. Page Up/Page Down으로 페이지를 변경합니다.

전역

F1: 도움말 메뉴 (현재 화면의 모든 단축키 나열)
Ctrl+F1: 현재 화면의 단축키 읽기
F2: 모드 설정
F3: 현재 화면 읽기
F4: 친구 패널 (메뉴에서) / 듀얼 채팅 (듀얼 중)
F5: 업데이트 확인 / 시작
Ctrl+R: 마지막 알림 반복

듀얼 - 영역

내 영역: C (손), G (무덤), X (추방), S (스택), W (사령관 지대) 상대 영역: Shift+G, Shift+X, Shift+W 전장: B / Shift+B (생물), A / Shift+A (대지), R / Shift+R (비생물) 영역 내: 좌/우로 이동, 상/하로 카드 상세 읽기, I로 확장 정보 Shift+상/하: 전장 행 전환

듀얼 - 정보

T: 턴/페이즈
L: 생명력
V: 플레이어 정보 영역
D / Shift+D: 서고 장수
Shift+C: 상대 손패 장수
M / Shift+M: 내 / 상대 대지 요약
K: 포커스된 카드의 카운터 정보
O: 게임 로그 (최근 듀얼 알림)
E / Shift+E: 내 / 상대 타이머

듀얼 - 타겟팅과 행동

Tab / Ctrl+Tab: 대상 순환 (전체 / 상대만)
Enter: 대상 선택
Space: 우선권 넘기기, 공격자/방어자 확정, 페이즈 진행

듀얼 - 풀 컨트롤과 페이즈 정지

P: 풀 컨트롤 토글 (임시, 페이즈 변경 시 초기화)
Shift+P: 잠긴 풀 컨트롤 토글 (영구)
Shift+Backspace: 상대 행동 시까지 패스 토글 (소프트 스킵)
Ctrl+Backspace: 턴 스킵 토글 (전체 턴 강제 스킵)
1-0: 페이즈 정지 토글 (1=유지, 2=뽑기, 3=첫 번째 본단, 4=전투 시작, 5=공격자 선언, 6=방어자 선언, 7=전투 피해, 8=전투 종료, 9=두 번째 본단, 0=종료 단계)

듀얼 - 브라우저 (점술, 감시, 멀리건)

Tab: 모든 카드 탐색
C/D: 상단/하단 영역 간 이동
Enter: 카드 배치 전환

문제 해결

게임 실행 후 음성 출력이 없음

MTG Arena를 실행하기 전에 스크린 리더가 실행 중인지 확인하세요
Tolk.dll과 nvdaControllerClient64.dll이 MTGA 루트 폴더에 있는지 확인하세요 (설치 프로그램이 자동으로 배치함)
오류에 대해서는 MTGA 폴더의 MelonLoader 로그(MelonLoader\Latest.log)를 확인하세요

게임이 시작 시 충돌하거나 모드가 로드되지 않음

MelonLoader가 설치되어 있는지 확인하세요.
게임이 최근에 업데이트되었다면 MelonLoader 또는 모드를 다시 설치해야 할 수 있습니다. 설치 프로그램을 다시 실행하세요.
AccessibleArena.dll이 MTGA 설치 내 Mods\ 폴더에 있는지 확인하세요

모드가 작동했지만 게임 업데이트 후 중단됨

MTG Arena 업데이트는 MelonLoader 파일을 덮어쓸 수 있습니다. 설치 프로그램을 다시 실행하여 MelonLoader와 모드를 모두 다시 설치하세요.
게임이 내부 구조를 크게 변경했다면 모드 업데이트가 필요할 수 있습니다. GitHub에서 새 릴리스를 확인하세요.

키보드 단축키가 작동하지 않음

게임 창이 포커스되어 있는지 확인하세요 (클릭하거나 Alt+Tab으로 전환)
F1을 눌러 모드가 활성화되었는지 확인하세요. 도움말 메뉴가 들리면 모드가 실행 중입니다.
일부 단축키는 특정 컨텍스트에서만 작동합니다 (듀얼 단축키는 듀얼 중에만 작동)

잘못된 언어

F2를 눌러 설정 메뉴를 열고, Enter를 사용해 언어를 순환하세요

Windows가 설치 프로그램이나 DLL을 안전하지 않다고 경고함

설치 프로그램과 모드 DLL은 코드 서명이 되어 있지 않습니다. 코드 서명 인증서는 연간 수백 유로가 들며, 무료 접근성 프로젝트에는 현실적이지 않습니다. 그 결과 Windows SmartScreen과 일부 백신 도구는 설치 프로그램을 처음 실행할 때 경고하거나 DLL을 "알 수 없는 게시자"로 표시합니다.

다운로드한 파일이 GitHub에 게시된 것과 일치하는지 확인하기 위해, 각 릴리스에는 AccessibleArenaInstaller.exe와 AccessibleArena.dll 모두에 대한 SHA256 체크섬이 나열되어 있습니다. 다운로드한 파일의 해시를 계산하여 비교할 수 있습니다:

PowerShell: Get-FileHash <파일명> -Algorithm SHA256
명령 프롬프트: certutil -hashfile <파일명> SHA256

해시가 릴리스 노트의 해시와 일치하면 파일은 진본입니다. SmartScreen 경고를 넘어 설치 프로그램을 실행하려면 "추가 정보"를 선택한 다음 "실행"을 선택하세요.

버그 신고

버그를 발견하면, 모드가 게시된 곳에 글을 올리거나 GitHub에 이슈를 등록할 수 있습니다.

다음 정보를 포함하세요:

버그가 발생했을 때 무엇을 하고 있었는지
무엇이 일어날 것으로 예상했는지
실제로 무엇이 일어났는지
게임 로그를 첨부하고 싶다면 게임을 닫고 MTGA 폴더의 MelonLoader 로그 파일을 공유하세요:
- WotC: C:\Program Files\Wizards of the Coast\MTGA\MelonLoader\Latest.log
- Steam: C:\Program Files (x86)\Steam\steamapps\common\MTGA\MelonLoader\Latest.log

알려진 문제

게임은 거의 모든 화면을 다루어야 하지만, 완전히 작동하지 않는 일부 엣지 케이스가 있을 수 있습니다. PayPal은 시각 장애인 사용자를 비음성 불법 캡챠로 차단하기 때문에, 게임에 실제 돈을 쓰고 싶다면 정안자의 도움을 받거나 다른 결제 방식을 사용해야 합니다. 일부 특정 이벤트는 완전히 작동하지 않을 수 있습니다. 실제 플레이어와의 드래프트는 아직 지원되지 않는 로비 화면이 있지만, 퀵드래프트에서는 인간 상대와 맞서기 전에 봇에 맞서 카드를 고르는데, 이는 작동하며 이런 유형의 경험을 좋아하는 모든 이에게 권장되는 모드입니다. 큐브 모드는 손대지 않았습니다. 그게 무엇에 관한 것인지도 잘 모르고, 게임 내 자원을 많이 소비합니다. 그래서 시간이 있거나 요청이 있을 때 작업할 예정입니다. 이모트, 펫, 카드 스타일, 칭호가 있는 게임의 코스메틱 시스템은 현재 부분적으로만 지원됩니다. 이 모드는 Windows에서 NVDA와 JAWS로만 테스트되었으며, 여전히 수정되지 않은 Tolk 라이브러리에 의존하고 있습니다. 여기서 Mac이나 Linux 호환성을 테스트할 수 없으며, Prism과 같은 크로스 플랫폼 라이브러리는 현 시점에 게임이 의존하는 구 .NET 버전을 완전히 지원하지 않았습니다. 그래서 다른 플랫폼이나 수정되지 않은 Tolk에서 완전히 지원되지 않는 아시아 스크린 리더의 테스트를 도와줄 수 있는 사람이 있어야만 더 넓은 라이브러리로 전환할 예정입니다. 그러니 이 작업을 해주길 원한다면 주저 없이 연락해 주세요.

현재 알려진 문제 목록은 KNOWN_ISSUES.md를 참조하세요.

면책 조항

다른 종류의 접근성

이 모드는 주로 어감이 좋기 때문에 Accessible Arena라고 부릅니다. 그러나 현재로서는 스크린 리더 접근성 모드일 뿐입니다. 저는 시각 장애, 운동 장애 등 더 많은 장애를 이 모드로 다루는 것에 절대적으로 관심이 있습니다. 그러나 저는 스크린 리더 접근성에만 경험이 있습니다. 예를 들어 전맹인으로서 색상이나 글꼴에 관한 질문은 저에게 완전히 추상적입니다. 그러니 그런 종류의 것을 구현해 달라고 원한다면, 자신의 필요를 명확하게 설명할 수 있고 결과를 테스트하는 데 도움을 줄 의사가 있을 때 주저 없이 연락해 주세요. 그러면 이 모드의 이름에 더 많은 진실을 주는 것을 기쁘게 생각할 것입니다.

회사 연락처

아쉽게도 Arena 팀이나 비공식 개발자 연락처에 대한 신뢰할 만한 정보를 얻지 못했습니다. 그래서 당분간 그들의 공식 커뮤니케이션 채널을 건너뛰기로 결정했습니다. 개발과 플레이를 한 3개월 동안 저는 봇 방지 시스템에 걸린 적이 없어서 그들이 우리를 모드 사용자로 감지할 수 있다고 생각하지 않습니다. 그러나 저는 단 한 사람으로서 공식 채널에서 소통하는 위험을 감수하고 싶지 않았습니다. 그러니 모드에 대해 퍼뜨리고 크고 가치 있는 커뮤니티를 만듭시다. 그러면 직접 연락을 취하기로 결정할 때 훨씬 더 나은 위치에 있게 될 것입니다. 저와 먼저 소통하지 않고 그들에게 글을 쓰려고 하지 말아 주세요. 특히 네이티브 접근성이나 제 모드를 그들의 코드베이스에 통합해 달라는 요청은 보내지 말아 주세요. 어쨌든 둘 다 일어나지 않을 것입니다.

인게임 구매

Arena에는 실제 돈과 관련된 메커니즘이 일부 있고 게임 내 통화를 구매할 수 있습니다. 이 결제 수단들은 로그인에 캡챠 보호를 포함시킨 PayPal을 제외하고는 대부분 접근 가능합니다. 결제 수단 등록을 위해 모드를 제거하고 정안자의 도움을 요청해 볼 수 있지만, Wizards of the Coast가 더욱 망가지고 잘못 구현한 접근성 악몽 같은 그들의 캡챠 때문에 이것조차 신뢰할 수 없습니다. 그러나 다른 결제 수단들은 안정적으로 작동합니다. 저와 다른 사람들은 인게임 구매를 테스트했으며 시스템 사용은 안전해야 합니다. 그러나 버그가 발생하거나 모드가 여러분을 오도할 가능성도 절대적으로 있습니다. 잘못된 것을 클릭하거나, 틀리거나 불완전한 정보를 보여주거나, Arena의 내부 변경으로 잘못된 일을 할 수 있습니다. 저는 테스트할 수 있지만, 여러분이 실제 돈으로 잘못된 것을 사지 않을 것이라고 100% 보장할 수는 없습니다. 저는 이에 대한 책임을 지지 않을 것이며, 이것이 공식 Arena 제품이 아니라는 사실 때문에 게임 회사도 그렇게 하지 않을 것입니다. 이 경우 환불을 받으려 하지 마세요. 그들은 환불해 주지 않을 것입니다.

AI 사용

이 모드의 코드는 Anthropic의 Claude 에이전트의 도움으로 100% 생성되었으며, Opus 모델을 사용했습니다: 4.5에서 시작하여 대부분의 개발은 4.6에서 이루어졌고, 릴리스를 향한 마지막 단계는 4.7에서 이루어졌습니다. 그리고 제 최대 공헌자 덕분에 Codex도 약간 사용했습니다. 저는 AI 사용의 문제점을 알고 있습니다. 그러나 모두가 이러한 소프트웨어를 훨씬 더 수상한 많은 일에 사용하는 시대이면서, 게임 업계는 우리가 원하는 품질이나 양의 접근성을 제공하지 못하고 있는 가운데, 저는 그래도 이 도구들을 사용하기로 결정했습니다.

기여 방법

기여를 받는 것이 기쁩니다. blindndangerous 덕분에 이미 다른 사람의 많은 유용한 작업이 이 모드의 일부가 되었습니다. 특히 다른 시스템 구성이나 제가 말하지 못하는 언어 수정처럼 제가 테스트할 수 없는 것들에 대한 개선과 수정에 관심이 있습니다. 그러나 기능 요청도 받습니다. 작업하기 전에 알려진 문제를 확인하세요.

일반 기여 가이드라인은 CONTRIBUTING.md를 참조
번역 도움은 CONTRIBUTING_TRANSLATIONS.md를 참조

크레딧

이제 많은 사람에게 감사 인사를 전하고 싶습니다. 다행히 이것은 저와 AI만이 블랙박스 안에서 한 일이 아니라 저를 둘러싼 네트워크 전체가 도와주고, 힘을 실어주고, 사회적이고 친절하게 대해 주었기 때문입니다. 제가 여러분을 잊었거나 다른 이름으로 알려지거나 언급되지 않길 원한다면 DM을 보내주세요.

먼저 이 작업은 제가 Accessible Arena를 위해 그저 다시 해야 했던 개척 작업을 해낸 다른 사람들의 작업에 매우 근거하고 있습니다. 디자인 면에서는 Hearthstone Access로부터 많은 것을 물려받을 수 있었습니다. 게임을 해본 모두에게 잘 알려져 있기 때문만이 아니라, 정말로 좋은 UI 디자인이기 때문입니다. 모딩 면에서는 Zax의 모딩 Discord 멤버들에게 감사하고 싶습니다. 제가 그저 설치하고 사용하기만 하면 되었던 모든 도구와 절차를 다 알아낸 것뿐만 아니라, AI 모딩에 대해 제가 알아야 할 모든 것을 직접 또는 공공장소에서 토론하거나 다른 초보자를 도우면서 가르쳐 주셨습니다. 또한 저와 제 프로젝트가 존재할 수 있는 플랫폼과 커뮤니티를 제공해 주셨습니다.

대규모 코드 기여에 대해 이 프로젝트에 많은 작업을 해 준 blindndangerous에게 감사하고 싶습니다. 프로젝트 수명 동안 그에게서 작고 성가신 것부터 더 큰 UI 제안과 게임의 전체 화면 접근성에 이르기까지 모든 종류의 문제에 대해 약 50건의 PR과 그 이상을 받은 것 같습니다. 또한 코드 품질과 유지관리성을 보장하기 위해 제 자체 리팩토링 위에 실행한 대규모 AI 코드 프로젝트용 리팩토링 프롬프트를 만든 Ahix에게도 감사드립니다.

베타 테스트, 피드백, 아이디어에 대해 감사하고 싶은 분들:

Alfi
Plüschyoda
Firefly92
Berenion
blindndangerous
Toni Barth
Chaosbringer216
ABlindFellow
SightlessKombat
hamada
Zack
glaroc
zersiax
kairos4901
patricus3

시각적 워크플로를 이해하고 몇 가지를 확인하기 위한 정안자 테스트에 감사하고 싶은 분들:

mauriceKA
VeganWolf
Lea Holstein

사용된 도구

포함된 모든 모델의 Claude
MelonLoader
IL 패치용 Harmony
스크린 리더 통신용 Tolk
게임 코드 역컴파일용 ILSpy

당신의 모더를 후원하세요

이 모드를 만드는 것은 저에게 많은 재미와 힘이 되었을 뿐만 아니라, Claude 구독을 위한 많은 시간과 실제 돈이 들었습니다. 향후 몇 년간 더 나은 개선 작업을 위해 이를 유지하고 프로젝트 유지관리를 계속할 것입니다. 그래서 일회성 또는 매월 기부를 할 의사와 능력이 있다면 여기를 확인해 보세요. 제 작업에 대한 이 인정을 매우 감사히 여기며, 이는 제가 Arena와, 바라건대 미래의 다른 대규모 프로젝트에 계속 작업할 수 있는 안정적인 기반을 제공합니다.

Ko-fi: ko-fi.com/jeanstiletto

라이선스

이 프로젝트는 GNU General Public License v3.0에 따라 라이선스됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

링크

다른 언어

FilesExpand file tree

README.ko.md

Latest commit

History